Edit: Because this is my first day to ever work with EF, my first attempt at this was more complicated (you can see this evolution at the gist).  After removing my useless code, you can see it’s just Entity Framework.  Sadly I can’t take any credit.  Still – this IS cool.  Fast, super easy, typed queries with only framework dependencies.  I was surprised to see it supported the mapping-less projections.  Perfect for all of those fancy persistent view model scenarios all the cool CQRS kids are doing.

using System;
using System.Collections.Generic;
using System.Data.Entity;

public static class Effin
{
    public static IEnumerable<T> Query<T>
        (this string connectionStringName, string sql, 
        params object[] parameters)
    {
        return new DbContext(connectionStringName)
            .Database.SqlQuery<T>(sql, parameters);
    }
}

public class Example
{
    public void UsingEffin()
    {
        IEnumerable<Name> names = 
            "data".Query<Name>("select FirstName from Person");

        foreach (var name in names)
        {
            Console.WriteLine(name.FirstName);
        }
    }

    public class Name
    {
        public string FirstName { get; set; }
    }
}

True story: a team building a system.  They decide that one chunk of code might be valuable in another project or two.  So they extract it into a library and open source it.

Project complete, team reorganizes and begins a couple new projects.  Both new projects depend on that library.  For awhile everything is great.

Sooner or later someone needs to make a change.  It’s sort of a pain, because the source code is in another IDE configuration.  Actually it’s been awhile since anyone worked on it and it’s hard to find a developer on the team who has that version of the IDE installed.  But the change happens, painful as it may be, because it has to.

Someone later gets lazy.  They build it locally and copy the assemblies directly into the lib folder.  Now the library was compiled from source code that’s not in the version control system.  This is spinning out of control.  Or maybe that was intentional – because the other team is using the library too, but they have different needs and we’ve sort of been in a mutually-assured-destruction paralysis about what changes to make.

Eventually someone realizes the solution is not to depend on this library, the compiled bits, but to just copy the source code over.  We need to make our tweaks, they need to make their tweaks.  It makes sense.   So we lose our code reuse; does anyone care? 

This dirty-feeling code copying can be a good idea for a non-technical reason:  it emphasizes that the important element of reuse is the human expertise to understand, create, use and modify a solution that solves a particular problem.

Turns out NuGet is great for this.  I noticed that Rob Conery packaged his Massive library as just a file.  A source code file.  Not a .dll.  Great idea, and I immediately thought of all the code that I want to share among many projects but also have the flexibility to change, now – without context switching or fear of repercussions.

You just put the files in a Content subdirectory and the NuGet process will shove them in the project root or App_Code or wherever.

I did the same with a little utility class that we use a lot, and I’m going to do it some more. 

For many teams, a hosted NuGet feed with content files is the new helper library.

Speaking of NerdDinner, Scott asked me to use it to create an AutoMapper example.

AutoMapper, the brainchild of Jimmy Bogard, is an object-to-object mapper.  What that means is up to you – but we’ll use it here to map from the domain model to a view model.  The view model is an object heirarchy that represents the screen.  It’s as dumb as possible, just like the view.

We get a lot of nice things out of it and it helps us go faster.  You can read more about it AutoMapper from Jimmy or at the website on Codeplex.

For starters, NerdDinner isn’t the best scenario in which to apply AutoMapper.  NerdDinner is very small so there’s not much reuse to harvest. For example, if you format dates the same way a million times you can use AutoMapper to only write that formatting code once.  In a small application you may format dates two ways and only use the resulting text in two views.  It doesn’t make a lot of sense to extract a class just for that – it will seem like a lot of overhead. 

Also NerdDinner doesn’t have a rich domain model – there’s just not that much to do.  So the AutoMapper feature of flattening complex hierarchies can’t be appreciated.

I posted the result of this quick and dirty spike as a sample project – hopefully this will help you get started looking at it.

First, I copypasted a class to bootstrap AutoMapper:

namespace NerdDinner.Helpers.AutoMapper
{
    public class AutoMapperConfiguration
    {
        public static void Configure()
        {
            Mapper.Initialize(x => x.AddProfile<ViewModelProfile>());
        }
    }
}

.. which will be called when the application starts:

void Application_Start()
{
    AutoMapperConfiguration.Configure();

    RegisterRoutes(RouteTable.Routes);

    ViewEngines.Engines.Clear();
    ViewEngines.Engines.Add(new MobileCapableWebFormViewEngine());
}

I copypasted another class that will check the mapping configuration for errors, providing fast feedback should I make a mistake.

[TestClass]
public class AutoMapperConfigurationTester
{
    [TestMethod]
    public void Should_map_dtos()
    {
        AutoMapperConfiguration.Configure();
        Mapper.AssertConfigurationIsValid();
    }
}

Now I’m ready to begin creating the view model and configuring AutoMapper.

To design a view model, start with the screen.  What’s displayed will be represented in the model.  Again: the view model is an object hierarchy that represents the user interface.  I picked the Dinner Details screen, by the way.

The current model being used by the view was the Dinner entity itself.  There was a lot of formatting in the view and a lot of duplication.

Almost every property was surrounded by code that would HtmlEncode it (it will be nice to have AutoMapper do this for us):

<%= Html.Encode(Model.Title) %>

And there is a lot of formatting to do:

<abbr class="dtstart" title="<%= Model.EventDate.ToString("s") %>">
    <%= Model.EventDate.ToString("MMM dd, yyyy") %>
    <strong>@</strong>
    <%= Model.EventDate.ToShortTimeString() %>
</abbr>

Imagine a project with 300 screens and a team of analysts and you can imagine that specifying this formatting over and over again in requirements documents and planning would become tedious.  Not to mention coding it.  It’d be easier to just say: “Format this date in the standard way.” You can also imagine the security implications of forgetting to encode even one value.

In converting these screens to use a view model instead of the domain model I didn’t want to change existing functionality.  So I took this:

<%@ Page Language="C#" Inherits="System.Web.Mvc.ViewPage<NerdDinner.Models.Dinner>"

and changed it to this:

<%@ Page Language="C#" Inherits="System.Web.Mvc.ViewPage<DinnerDetailsViewModel>"

See what I did there?  I just changed the type of the Model property to a new DinnerDetailsViewModel type.

The view will receive a view model mapped from the domain model when I apply a special action filter to the controller action:

[AutoMap(typeof(Dinner), typeof(DinnerDetailsViewModel))]

The code’s in the sample, straight from Jimmy’s post.

I started out with DinnerDetailsViewModel being an empty class definition and used Resharper to generate each property as I encountered it.  I removed the formatting and the ubiquitous encoding from the parameters, turning this:

<div id="dinnerDiv" class="vevent">

    <h2 class="summary"><%= Html.Encode(Model.Title) %></h2>

    <p>
        <a href="http://feeds.technorati.com/events/<%= Url.AbsoluteAction("Details", new { id = Model.DinnerID }) %>">
            Add event to your calendar (iCal)
        </a>
    </p>

    <p>
        <strong>When:</strong>
<abbr class="dtstart" title="<%= Model.EventDate.ToString("s") %>">
<%= Model.EventDate.ToString("MMM dd, yyyy") %>
<strong>@</strong>
<%= Model.EventDate.ToShortTimeString() %>
</abbr>

into this:

<h2 class="summary"><%= Model.Title %></h2>

<p>
    <a href="http://feeds.technorati.com/events/<%= Url.AbsoluteAction("Details", new { id = Model.DinnerID }) %>">
        Add event to your calendar (iCal)
    </a>
</p>

<p>
    <strong>When:</strong>
    <%= Model.EventDate %>
</p>

I had to write a formatter to replace the custom formatting performed by the view.

public class AttendeeNameFormatter : BaseFormatter<string>
{
    protected override string FormatValueCore(string value)
    {
        return value.Replace("@", " at ");
    }
}

See how testable that is; small and reusable?

I also moved some methods that were previously being called from the view directly into the domain model which AutoMapper will evaluate at runtime.

Before:

<p id="whoscoming">
    <strong>Who's Coming:</strong>
    <%if (Model.RSVPs.Count == 0){%>
          No one has registered.
    <% } %>
</p>

After:

<p id="whoscoming">
    <strong>Who's Coming:</strong>
    <%if (Model.IsNobodyRegistered){%>
          No one has registered.
    <% } %>
</p>

The view model for this screen ends up looking like this:

public class DinnerDetailsViewModel
{
    public string Address { get; set; }
    public string Title { get; set; }
    public string DinnerID { get; set; }
    public string EventDate { get; set; }
    public string Country { get; set; }
    public string Latitude { get; set; }
    public string Longitude { get; set; }
    public string Description { get; set; }
    public string HostedBy { get; set; }
    public string ContactPhone { get; set; }
    public bool IsAnyoneRegistered { get; set; }
    public bool IsNobodyRegistered { get; set; }
    public bool IsCurrentUserRegistered { get; set; }
    public bool IsCurrentUserHosting { get; set; }

    public List<RsvpViewModel> RSVPs { get; set; }

    public class RsvpViewModel
    {
        public string AttendeeName { get; set; }
    }
}

The really key part is the AutoMapper configuration profile.  You can group configurations with profiles.  Maybe in one profile you format dates in one way, in another profile you format dates in another way.  I’m just using one profile here.

public class ViewModelProfile : Profile
{
    protected override string ProfileName
    {
        get { return "ViewModel"; }
    }

    protected override void Configure()
    {
        AddFormatter<HtmlEncoderFormatter>();
        ForSourceType<DateTime>().AddFormatter<StandardDateFormatter>();

        CreateMap<Dinner, DinnerDetailsViewModel>()
            .ForMember(x => x.IsCurrentUserRegistered, o => o.ResolveUsing<CurrentUserRegisteredResolver>())
            .ForMember(x => x.IsCurrentUserHosting, o => o.ResolveUsing<CurrentUserHostingResolver>())
            .ForMember(x => x.EventDate, o => o.SkipFormatter<HtmlEncoderFormatter>());

        CreateMap<RSVP, DinnerDetailsViewModel.RsvpViewModel>()
            .ForMember(x => x.AttendeeName, o => o.AddFormatter<AttendeeNameFormatter>());
    }
}

Most properties of the view model are mapped conventionally.  The property names match up so AutoMapper knows exactly what do do with them.  AutoMapper will do a lot more for you if you’d like it to.  This is actually a pretty hefty configuration.  In a different scenario it’d be likely that almost everything is mapped conventionally.

Note the first AddFormatter call.  That’s instructing AutoMapper to html encode everything.  I skip it for a property later.  The possibilities here are endless.  One cool thing we do in another project is wrap each property in a span that’s given a conventionally named CSS class.  In automated UI tests, we can use that class to find the proper element and ensure that the screen is displaying the right thing.

Let me know if you have any questions.

• Windows XP SP3 – Vista too much friction
• Use BlackViper‘s Safe config
• Turn off System Restore
• Pop a shortcut to Start Menu in my SendTo folder for easy/lazy Launchy indexing)
• Set up my folder views and apply to all folders:

• Windows XP continued
• Set up Windows Classic Theme and turn off any fancy UI stuff like animations

• Windows XP continued
• Setup toolbar to locked with just the Show Desktop shortcut

• Launchy – gotta have it
• Virtual CD ROM Control Panel – mount ISOs
• SQL Server 2005 Developer
• Visual Studio 2008 Pro
• .NET 3.5 SP1
• Windows Update including IE 7 and whatever Media Player they have
• Tortoise SVN (reboot here)
• ASP.NET MVC
• Firefox 3
• Adblock Plus
• Better Gmail 2
• Delicious Bookmarks
• Foxmarks
• Split Browser
• Tab Mix Plus dev build
• Firebug
• Reflector
• CCTray
• ClearType
• Proggy Clean – font
• Foxit
• Google Talk – the only IM client that delivers searchable logs in my Gmail – required.
• Notepad++
• VisualSVN
• Testdriven.NET – map run tests to Ctrl-T
• AIR / Twhirl – to waste time
• Paint.NET
• Resharper
• Windows Live Writer
• Paste from Visual Studio (WLW plugin)
• 7-Zip
• Terminals
• Console2
• FileZilla
• wget
• Fiddler
• grep
• µTorrent
• xvid codec

A: Multiple SSL sites on a single IIS server using host headers.  <- the answer. 

Basically, use SelfSSL or SSLDiag to create a cert with CN=*.example.com, then just point the second site to that cert in the Directory Security tab.  Also, configure secure server bindings using adsutil (found in c:\inetpub\adminscripts).

A: Use the SelfSSL utility that comes with the IIS Resource kit!

http://codeforeternity.com/blogs/technology/archive/2008/02/15/creating-self-signed-ssl-certificates-on-iis-6-0-and-windows-server-2003.aspx

Q: How do I install self-signed SSL certificates on two IIS 6 websites on the same server?

A: SelfSSL.exe is bugged.  Install SSLDiag and use its embedded SelfSSL tool.

The problem with two certs, two sites on the same server is strange.  You install a cert on website A and it works great.  You install another cert on B and B works great while A breaks.  And etc.

http://ewright.spaces.live.com/blog/cns!C0C3DF24CE16DC2F!169.entry

ssldiag /selfssl /V:365 /N:CN=www.point2.com /S:1834870997

Check out a copy of the CodeCampServer source (svn).  CodeCampServer is easy to work with because it has good tests on an already-working NHibernate implementation.

Check out a copy of NH Contrib (svn), open the NHibernate.Linq solution in Visual Studio and build. You may have to remove the compiler flag that indicates .NET 3.5 sp1 is available.

Open the CodeCampServer.sln and remove the NHibernate.dll reference from the DataAccess and IntegrationTests projects.  Add a reference to NHibernate.dll from the NHibernate.Linq bin directory.  Build and run tests.  I had to play with the DatabaseTesterBase.recreateDatabase() method because I think are are still some bugs in Export():

public static void recreateDatabase()
{
    var exporter = new SchemaExport(new HybridSessionBuilder().GetConfiguration());
    exporter.Drop(false, true);
    exporter.Create(false, true);
}

Now add a reference to NHibernate.Linq.dll in the DataAccess project. You can start writing queries and check your work with the integration tests that already exist. Here are a few simple queries for ConferenceRepository:

public Conference[] GetAllConferences()
{
    ISession session = getSession();
    var query = from conference in session.Linq<Conference>() select conference;
    return query.ToList().ToArray();
}

public Conference GetConferenceByKey(string key)
{
    ISession session = getSession();
    var query = from conference in session.Linq<Conference>()
                where conference.Key == key
                select conference;
    return query.Distinct().Single();
}

public Conference GetFirstConferenceAfterDate(DateTime date)
{
    ISession session = getSession();
    var query = from conference in session.Linq<Conference>()
                where conference.StartDate >= date
                orderby conference.StartDate
                select conference;
    return query.First();
}

public Conference GetMostRecentConference(DateTime date)
{
    ISession session = getSession();
    var query = from conference in session.Linq<Conference>()
            where conference.EndDate <= date
            select conference;
    query.OrderByDescending(conference => conference.EndDate);
    return query.First();
}

Minutes… slow, dreadful minutes.  

I thought it was Resharper’s fault or VisualSVN’s but nay.  It’s because I have a large recycle bin, which is fully scanned every time you delete a file.  After I emptied the recycle bin files deleted much faster.

Via Jeff Brown on the alt.net list.

Database trigger

• See Jon Galloway’s post on Auditing with SQL Server
• To generate an audit trigger in oracle you can do something similar.

NH Interceptor (per NH in action and the NH docs)

NH Listener (per the Hibernate docs)

Domain model

Because auditing is a simple application of interceptors there is a lot of guidance online about that approach, and using an interceptor was my first attempt at auditing.

But since the concept of an audit entry is important to the application (and the users!), it makes sense to promote this concept to a domain object.  Reporting is simple and the behavior is easier to manage.  Create a class called AuditEntry (with supporting mapping file) and hang collections of AuditEntry from the entity. Manage this collection in regular behavior:

public virtual void ChangeStatus(Employee employee, DateTime time, OrderStatus status)
{
    if(this.Status != status)
    {
        AuditEntry entry = new AuditEntry(employee, time, this.Status, status);
        _auditEntries.Add(entry);
    }
    Status = status;
}

After having gone down the database trigger path and the interceptor path and encountering friction I now recommend the domain model approach.

Instead of nothing:

You can now see:

By default, when I set the insertion point on line 12 and hit Enter, Visual Studio inserted spaces instead of tabs:

To turn this off, change the setting to Keep Tabs in Tools > Options > Text Editor > All Languages > Tabs:

You can also do Edit > Advanced > Tabify Selected Lines.

Now I won’t commit ugly spaces.  And a reminder to review Sara Ford’s blog more often.