Adrian Alonso

How-to get the XML representacion of a DSL Model Element

adalon — Sun, 20 Apr 2008 15:59:07 GMT

Today I had to find out how to get the XML representacion of a DSL Model Element. Here you have an extension method for Model Elements (mels) that gets the concrete serializer using the Domain XML Serializer Directory and the Domain Class Id of the target Model Element (mel).

        public static string GetXML(this ModelElement mel)
        {
            StringBuilder xml = new StringBuilder();
            
            DomainXmlSerializerDirectory directory = new DomainXmlSerializerDirectory();
            directory.AddBehavior(CoreDesignSurfaceSerializationBehavior.Instance);
            directory.AddBehavior(<#Yours DSL Serialization Behavior goes here #>.Instance);
            // Gets the serializer of the Mel

            DomainClassXmlSerializer serializer = directory.GetSerializer(mel.GetDomainClass().Id);

            if (serializer != null)
            {
                using (XmlWriter writer = XmlWriter.Create(new StringWriter(xml)))
                {
                    serializer.Write(new SerializationContext(directory), mel, writer);
                }
            }
            else
            {
                Trace.TraceWarning(Resources.UnableToGetSerializer, mel.GetType().Name);
            }

            return xml.ToString();
        }

HTH,

Adrian

Clarius T4 Editor is out!

adalon — Thu, 18 Oct 2007 11:56:00 GMT

The beta version is available at http://www.t4editor.net. You can go, download it and provide some feedback at the Clarius T4 Forum which will be very valuable for us (Clarius) to prioritize the most important features for the RTM version!

Here is you have the links:

Victor's officil announcement
Clarius T4 Editor Site
Clarius T4 Editor Forums
Clarius T4 Editor Download

Thanks!

Clarius is Hiring!

adalon — Wed, 17 Oct 2007 15:47:02 GMT

As Pablo said in his post Clarius is looking for candidates to fill Senior Dev Positions. You can check the details in Pablo's post too and if you are interested you can ping Pablo, me (alo AT clariusconsulting DOT net or through the contact form of this blog) or send your resume directly to Clarius job alias (which you can find in www.clariusconsulting.net).

Thanks!

runas cmd makes your life easier

adalon — Thu, 27 Sep 2007 18:37:36 GMT

This week I had to temporaly use a different user on my machine. So at first I thought I had to move all my settings (outlook profile, firefox bookmarks, vms, etc) from my primary user to this new one. This is not a nice task. Hopefully I remembered the runas command which allowed me to run the above programs (indeed I'm currently creating this post running WLW using runas) as my primary user from the new user session. IMO this is definitily a very good tip if you have the same scenario in the feature.

Read source code to be a better developer

adalon — Wed, 26 Sep 2007 14:37:00 GMT

I want to give it a try. My idea is to take a look at one or two projects every week and post some conclusions of what I could learn of them. Here you have for example the latest Scott Hanselman's post showing his weekly results. So if you have in mind a really cool source code stuff, please feel free to ping me (leaving a comment to this post or using the contact me link) and let me know where I can get it! Thanks!

Adding a custom VS Task List Token

adalon — Tue, 11 Sep 2007 14:44:21 GMT

You probably used the TODO task list token to add a comment about what it should be done. But what about if you want to use a custom token to add a different kind of comment; for example a Review(x) comment. VS allows you to add custom task list token via Tools->Options->Environment->Task List as it's shown in the following screenshot:

So then you will able to add the Review comments and these will be appearing in the Task List comments section:

TCI - Toolbox Controls Installer

adalon — Fri, 07 Sep 2007 17:35:00 GMT

TCI is a VS Package that is provided by the VS SDK as a redist. TCI allows you to easily add your custom Control to the VS Toolbox. For a brief introduction to TCI you can check the VS SDK documentation. Here I will try to cover what is happening under cover:

When you want to add your custom control to the VS toolbox using the TCI VS Package all you need is to tell TCI where the assembly containing the control is and notify to TCI this event incrementing a registry key. Probably the easier way to achieve these requirements is using a WIX-based installer (as the SDK sample does).

In order to tell TCI where your control is you can use the the fully qualified type name if you are installing the control in the GAC as following:

Or provide a location where the assembly containing the control is using the CodeBase value:

Finally you have to include the MSM containing the custom actions which notify TCI that a new Control has been installed:

The custom action will increment or decrement the "Default Items" value of the following registry entry:

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\9.0\Packages\{2c298b35-07da-45f1-96a3-be55d91c8d7a}\Toolbox]
"Default Items"=dword:00000001

Note that the {2c298b35-07da-45f1-96a3-be55d91c8d7a} is the GUID for the TCI VS Package.

It's important to check if the TCI Redist is already installed before installing your custom controls if you targeting VS 2500. It's not necessary for VS codename "Orcas" because TCI Package is already installed. You can find the TCI VS Package in the VS's Private Assemblies directory.

Why a good error message is important

adalon — Mon, 27 Aug 2007 17:41:00 GMT

This post was originally published at http://adrianalonso.blogspot.com

I was trying to change my private email in one of the forums I'm subscripted. The thing is that after clicking the save button it said:

"Sorry, an Error has Occurred"

"Unfortunately an error has occurred during the processing of your page request. If you were attempting to submit a new post, your post may not have been recorded. Please accept our apologies for the inconvenience."

And some links to go back, help, etc. No helpful at all. I searched through the forum posts to find out if someone had has the same issue and I found that the private email address couldn't be duplicated. In that moment I remembered I had another user with that address so I could take the steps to be able to change it in a few seconds. If the error message had been something like "The email address is being used by another user. Please choose a different mail and try again" it would be a significant save of time.

The cause of the error is probably due to they are not validating the email address, so after receiving the generic sql error they show the generic (not useful at all) "Sorry, and Error has Occurred".

"Organize Usings" in VS code name "Orcas" ala Eclipse

adalon — Thu, 16 Aug 2007 00:56:00 GMT

This post was originally published at http://adrianalonso.blogspot.com

Those that have used Eclipse will probably miss the ctrl+shift+o shortcut ("Organize Imports") when you switch to VS. But now VS code name "Orcas" provides a "new" feature (which unofficially existed in Whidbey) that allows you to remove and sort usings:

So if you don't want miss the Eclipse feature anymore you can add the shortcut going to Tools->Options->Environment->Keyboard

Search the RemoveAndSort command and press the ctrl+shift+o combination. Note that the shorcut is currently used by the OpenProject command and it will lost if you confirm to use the combination for the RemoveAndSort command.

GAX 1.3 is out!

adalon — Mon, 06 Aug 2007 01:01:00 GMT

This post was originally published at http://adrianalonso.blogspot.com

This new version of GAX is a must if you are thinking to develop Guidance Packages using VS Codename "Orcas" (previous version of GAX didn't work with the latest version of VS) and it will also provide some new features if your are developing with VS 2005.

A welcomed “fix” is the enhancement of the registration process. Now it's smarter about whether to install VB templates based on the presence of VB as a Visual Studio's product. This means that if your Guidance Package contains VB templates (.vstemplates for VB projects or items) you won't need to add conditional logic in your installer to avoid the registration failure when the package is being installed or registered.

The GAX installer is also improved to use WIX technology but the GAT installer project that is unfolded when you create a new Guidance Package using GAT is still the same VS Setup Project.

At last, the Experimental Hive registration is now a built-in feature in GAX allowing you to register your Guidance Packages in both Normal and Experimental hives.

So it seems that this CTP is a necessary and welcomed update for the runtime but not for the UX of developing Guidance Packages.

Here you have the links:

- Grigory Melnik's announcement
- GAX July 2007 CTP download
- GAT July 2007 CTP download

Microsoft Volta

adalon — Wed, 01 Aug 2007 21:51:00 GMT

This post was originally published at http://adrianalonso.blogspot.com

What Microsoft Volta is? Take a look at these videos in channel 9:

1. Eirk Meijer: Volta - Wrapping the Cloud with .NET - Part 1
2. Eirk Meijer: Volta - Wrapping the Cloud with .NET - Part 2

From the video introduction:

"Volta is an evolving research project focused on exploring ways to innovate data-intensive programming models. Volta is currently exploring a lean-programming inspired toolkit for building web-based and mobile applications by stretching the .NET programming model to cover the Cloud.

Volta is exploring innovation that empowers programmers to delay decisions about tier-splitting to the last possible responsible moment by using either code refactoring or declarative annotations. "

Enjoy!

SFT Setup Project: Deploying many Guidance Packages and many DSLs with a single MSI!

adalon — Thu, 07 Jun 2007 12:27:00 GMT

This post was originally published at http://adrianalonso.blogspot.com

Clarius SFT June CTP is available. You can check Victor's blog in order to get an overview of the new features included in this drop. One of this new features is the capability of creating a Setup Project to generate a single MSI that installs many Guidance Packages and many DSLs. Let's take a look at how this feature works:

SFT Setup Project Feature:

This new feature allows you to create a new C# or VB wix-based project selecting which Guidance Packages or DSLs you want to include in your MSI. After running the wizard you will get a single project whose output will be a single MSI.

Here is an example:

1. In this sample we have a solution that contains the following projects:

a. A class diagram DSL project
b. A minimal language DSL project
c. A GAT-based Guidance Package
d. A SFT-based Guidance Package

The SFT Setup Project wizard is launched adding a new project to the solution. You can select between C# and VB project types.

2. The wizard is very simple. You just need to select the guidance packages and DSLs that will be included in the MSI and click finish.

3. Finally a new project will be added to the solution. At this point you should be able to build the project in order to get the MSI.

Basically you will find 3 groups of files in the SFT Setup Project:

1. Main Setup files
2. Guidance Packages files: Containg a few files by Guidance Package. You can take a look at my previous post showing how each Guidance Package setup is generated.
3. DSLs files: Each DSL setup is generated in the same way as the DSL Setup Project provided by the DSL SDK does. We chose this implementation because if you already know how to customize the DSL Setup Project you won't need to expend time understanding this new feature of SFT!

(1) Main Setup Files:
SetupMetadata.items: This is the file where you can customize the metadata for Guidance Packages, DSLs and define the projects that will be built before generating the MSI.
Setup.wxs: This is probably the most important file because it contains the setup product definition, the directory tree structure, the features (or the feature references), custom actions and the UI definition.
UI.wxs: This contains the UI definition. This is probably the main file you will need to customize to include your own branding.
Strings.wxl: Wix localization stuff file.
License\License.rtf: The license file for your Guidance Package.
Bitmaps Folder: Image files for the installer wizard branding.

Where to download SFT? Follow this link! http://www.softwarefactoriestoolkit.net/
And please let us know your feedback about you want to include or improve in the next drops! You can ping us through the Guidance Automation Forum or directly to alo -AT- clariusconsulting -DOT- net.

HowTo: Application Block Software Factory (ABSF) Part III: An example

adalon — Wed, 11 Apr 2007 01:18:00 GMT

This post was originally published at http://adrianalonso.blogspot.com

After an introduction to ABSF and a explanation about providers, here you have an example of how an application block and a provider library can be created. What I did was to take snapshots of the solution after executing each recipe:

1. New Animal Application Block
2. New Provider Factory and Base 'Animal'
3. New Provider (Typed) 'Dog'
4. New Provider (Untyped) 'Monkey'
5. New Design-Time Base Provider Node 'AnimalNode'
6. New Design-Time Provider Node 'DogNode'
7. New Provider Library
8. New Provider (Typed) 'Cat'
9. New Design-Time Provider Node 'CatNode'

The example is based on the Animal Application Block of Brian Button. Brian and Tom did a series of webcasts explaining the Entlib Core and Design-Time creating an Animal Application Block. You can download the webcasts from here and here.

The idea is that you can open each snapshot and take a look at what stuff is created after executing each recipe. In order to build the snapshots, you will have to copy the Common.dll, Configuration.Design.dll and ObjectBuilder.dll to the lib folder of each snapshot. I recommend you to unzip the snapshots in a directory near the root (c:\) because of the path length restriction (you won't be able to build the snapshots if the path is longer than 248 characters)

Finally here you have the link to the snapshots!

Enjoy!

Enterprise Library 3.0 Released!

adalon — Fri, 06 Apr 2007 14:39:00 GMT

This post was originally published at http://adrianalonso.blogspot.com

I've been part of this excited project mostly developing the Application Block Software Factory (ABSF) and some parts of the Validation Application Block (VAB) (which core and intergation support was developed by Fernando). I want to thanks all to let me be part of this great experience and learn a lot from this spectacular people.

You can download it, start using it and provide feedback! Here you have the links:

Download: http://www.microsoft.com/downloads/details.aspx?FamilyID=62ef5f79-daf2-43af-9897-d926f03b9e60&displaylang=en
Codeplex community site: http://www.codeplex.com/entlib
Tom Hollander's Blog: http://blogs.msdn.com/tomholl/
Olaf's Blog: http://bloggingabout.net/blogs/olaf

Enjoy!

.Net Generic Finder (VS Automation Model Usage)

adalon — Wed, 04 Apr 2007 22:04:00 GMT

This post was originally published at http://adrianalonso.blogspot.com

I know there are Find/FindAll methods in the System.Collection.* namespace but what I was looking for is something quite different. Here is more or less the scenario:

Suppose you have objects that can be any of the following interfaces: Solution (S), Project (P) or ProjectItem (PI). You don't have a common super type to treat all as polymorphic objects. So if you have a collection of them (Objects) you are not able to have Collection<T> where T is { S | P | PI } because you could have a mix of them (of course at least you have a Collection<Object> but in this case we would not need Generics anyway).

I wanted a finder that allows me to search for an object in this object collection but using the benefits of Generics. I wanted to use the most abstract representation of a collection I could have and I decided to use an IEnumerable parameter. Then I needed to define a Predicate<T> and what I am going to expect is a T or IEnumerable<T> result.

For example: If the col is = { S1, P1, P2, P3, PI1, PI2, PI3 }

The following tests should pass:

1. Finder.FindAll<Solution>(col, delegate( return Predicates.GetNullPredicate<T>())) contains {S1}
2. Finder.FindAll<Project>(col, delegate( return Predicates.GetNullPredicate<T>())) contains {P1, P2, P3}
3. Finder.FindAll<ProjectItem>(col, delegate( return Predicates.GetNullPredicate<T>())) contains {PI1, PI2, PI3}

So I am able to get a IEnumerable<T> where T is { S | P | PI }. I could also specify any other predicate to evaluate specific properties of each T. Notice that I am using the Predicates.Is<T> helper method I published in my previous post to validate if the predicate can be evaluated. I am also using the yield support to collect the result.

public static class Finder
{
    public static T Find<T>(IEnumerable elements, Predicate<T> predicate) where T : class
    {
        IEnumerator<T> enumerator = Find(elements, predicate, true).GetEnumerator();
        return enumerator.MoveNext() ? enumerator.Current : null;
    }

    public static IEnumerable<T> FindAll<T>(IEnumerable elements, Predicate<T> predicate) where T : class
    {
        return Find<T>(elements, predicate, false);
    }

    private static IEnumerable<T> Find<T>(IEnumerable elements, Predicate<T> predicate, bool returnFirst) where T : class
    {
        if (null != elements)
        {
            foreach (object element in elements)
            {
                if (Predicates.Is<T>(element, predicate))
                {
                    yield return (T)element;
                    if (returnFirst) yield break;
                }
            }
        }
        yield break;
    }
}