Tips & Tricks: CodeSmith Maps

2007-06-10T04:01:00Z

CodeSmith Maps allow developers to reduce the amount of plumbing code in their templates and increase the readability and re usability at the same time. Maps provide a named dictionary like semantic to template development.

While developing templates, a common scenario developers face is accessing a lookup list based on some sort of information. A common example is a mapping between CLR data types and SQL Server data types. Before CodeSmith maps, this functionality would have been accomplished by writing a method with a switch/Select Case statement.

Before CodeSmith Maps, your template code might contain methods like this:

public String GetFrameworkType(ColumnSchema column
)  
{ 
   switch(column.DataType)  
   { 
      case DbType.AnsiString:  
      case DbType.AnsiStringFixedLength: 
      case DbType.String: 
      case DbType.StringFixedLength:  
         return "String"; 
          
      case DbType.Binary: 
         return "Byte[]"; 
          
      case DbType.Boolean:  
         return "Boolean"; 
          
      case DbType.Byte:  
         return "Byte"; 
          
      case DbType.Currency: 
      case DbType.Decimal: 
      case DbType.VarNumeric:  
         return "Decimal";

CodeSmith Map files allow us to create named Maps using the new Map Editor like this:

Once we have saved this mapping file (using the .csmap extension), we can reference it in our template using the Map directive.

<%@ Map
    Name="SqlToClrTypes"
    src="Sql-System.csmap"
    Description="A Mapping of SQL Server data types to .NET Framework data types" %>

BigInt:<%=SqlToClrTypes["bigint"]%>
Binary:<%=SqlToClrTypes["binary"]%>
Bit:<%=SqlToClrTypes["bit"]%>

This code would result in the following output:
BigInt:System.Int64
Binary:System.Object
Bit:System.Boolean

Another scenario might involve mapping .NET Framework types to specific server control types. For example, on one project you might be required to use the standard ASP.NET server controls such as TextBox, DropDownList, or Menu, but another project might require ASP.NET Ajax controls. CodeSmith Maps allow you to write the code for your interface pages one time, but interchange mapping references to produce different results.

There are countless scenarios where CodeSmith Maps can drastically reduce the amount of effort needed during template development.

My new-new job

2007-03-26T01:31:00Z

I almost forgot...I start my new job tomorrow. It is at a little place you might have heard of... CodeSmith Tools ! Eric and I have been wanting to work together for awhile now, but the timing always seemed off. I am excited to be working there, not only do I get to sponge knowledge off Eric's greatness, but we are in the same offices as Telligent, so I should be working in the vicinity of some really smart people. I also am getting reunited with my boss from my last job, Shannon (still no blog...(read more)

Jeff Gonzalez

Tips & Tricks: CodeSmith Maps

My new-new job