代码生成器MyGeneration

MyGeneration是一个功能很强大的代码生成工具。通过编写包含各种类型脚本（C#,VB.Net,JScript,VBScript）的模板，通过数据库的表内容，生成你需要的各种代码。你可以用它来生成ORM的实体类，存储过程，SQL语句等等。我甚至用它来生成Asp.Net的页面（呵呵，我很懒）。

MyGeneration提供了强大的在线模版库，你可以通过访问其网站或者使用Template Browser中的在线模版功能按钮寻找你需要的模版。当然你也可以根据需要自己写模板。

我的NHibernate模板已经公布，并写了个随笔专门介绍它。详见“用我的MyGeneration模板生成NHibernate映射文件和关系(one-to-one,one-to-many,many-to-many) ”。

你可以从这里下载它的最新版本。

重要组件介绍

它由几个重要的外部组件组成，其中常用的有以下两个

MyMeta包含数据库中的信息。我们可以从这个库中获得想要的和数据库相关的信息。例如：数据库名，数据库里面的表，表里面的主键等等。

Zeus为MyGeneration提供了一个的框架，里面最常用的就是一组对WinFrom组件封装后的一套组件，通过这套组件我们可以动态的生成我们需要的界面（我们可以在这个界面中让模版使用者选择使用的参数），然后界面里面的信息可以为生成模版服务。

工作原理分析

MyGeneration的支持用多种脚本模式，其工作原理是一致的，只是通过不同的语言来表达。

我最常用的是C# Template。Template分为两个步骤运行，首先是通过脚本引擎执行Template Code和Interface Code中的脚本，生成Template Source和Interface Source的C#代码，然后执行Template Source，生成需要的代码。如下图

Template Code模版简介

C# Template Code的语法和Asp的语法十分的类似（注意Source是不能写代码的，那是根据你的Code生成的）。

<%=%>表示绑定某一个字段或属性。

<%%>表示脚本段，我们可以在这里写符合C#语法的任何语句。

其他的内容不进行解析。直接用output写到最后的结果里。

一般C#脚本会从DotNetScriptTemplate继承，DotNetScriptTemplate里面在Template Source里面可以看到他是从_DotNetScriptTemplate继承而来。Interface也类似。

public abstract class DotNetScriptTemplate : _DotNetScriptTemplate
{
    protected Zeus.UserInterface.GuiController ui;
    protected MyMeta.dbRoot MyMeta;
    protected Dnp.Utils.Utils DnpUtils;
    public DotNetScriptTemplate(IZeusContext context) : base(context)
{
        this.ui = context.Objects["ui"] as    Zeus.UserInterface.GuiController;
        this.MyMeta = context.Objects["MyMeta"] as MyMeta.dbRoot;
        this.DnpUtils = context.Objects["DnpUtils"] as Dnp.Utils.Utils;
}
}

DotNetScriptTemplate里面把模版需要使用到的数据库信息和界面信息也引用进来了，我们可以通过MyMeta来获得数据库里面的信息，而从ui里面获得和Template相关的参数设置信息。

代码写在模版Render方法里。页面代码写在Setup方法里。

使用配置文件

MyGeneration支持配置文件的使用，在Edit里面的Default Settings...我们可以看到。

Language Mapping定义了数据库和语言（C#，VB.Net等）的字段对应关系。

Database Target Mapping定义了数据库和ADO.Net里面的字段对应关系。

User Meta-Date允许用户设置自定义的配置文件。

在模版中我们可以通过类似input["__dbDriver"]的语法来访问其中的内容。

常见的有如下：

__defaultOutputPath
__dbDriver
__dbTarget
__language
__dbTargetMappingFileName
__dbLanguageMappingFileName
__userMetaDataFileName

你可以看看模版目录里面的Tutorials/C#里面的Charpt1里面的示例（Charpt2也是个不错的例子，但写得有些繁琐）。

快捷按钮详解

Template Browser可以看到所有的模版。

第一个按钮作用是刷新。

第二个按钮作用是切换显示模式。按照目录浏览和按照命名空间浏览。

第三个按钮作用是查看在线模版库。

第四个按钮作用是打开模版。

第五个按钮和第六个按钮配合使用，点第六个运行时，参数将记录到你指定的znip文件里（其实是XML格式）中，下次运行时点第五个按钮，然后选到你保存的znip文件，将自动加载你的配置。

第七个按钮是运行模版。

第一个按钮作用是打开一个文件。

第二个按钮作用是显示Template Browser窗口。

第三个按钮作用是显示MyMeta Browser窗口，查看数据库信息。

第四个按钮作用是新建一个项目。你可以使用多个模版完成你的任务（我一般不用）。

第五个按钮作用是打开默认的输出路径。

第六个按钮作用是新建JScript Template

第七个按钮作用是新建VBScript Template

第八个按钮作用是新建C# Template

第九个按钮作用是新建VB.Net Template

第十个按钮作用是查看MyMeta Property（不知道怎么用，会使用的还请指教下我）

第十一个按钮作用是查看Language Mapping。

第十二个按钮作用是查看DbTarget Mapping。

第十三个按钮作用是查看User Meta Data。

第十四个按钮作用是查看Global User Meta Data。

第一个按钮作用是保存

第二个按钮作用是另存

第三个按钮作用是查看模版信息

第四个按钮作用是显示控制台

第五个按钮作用是运行模版

试着写第一个模版

在主菜单中选择File-->New-->C# Template。MyGeneration将会给你生成以下的模版代码。这是Template Code里面的内容。

<%
public class GeneratedTemplate : DotNetScriptTemplate
{
    public GeneratedTemplate(ZeusContext context) : base(context) {}

    //---------------------------------------------------
    // Render() is where you want to write your logic    
    //---------------------------------------------------
    public override void Render()
    {
        %>
        You can toggle in out of script like this
        <%
        output.writeln("Hello world.");
    }

}
%>

 我们运行此模版可以看到输出。%><%里面的内容直接输出到结果，output.writeln的内容也输出到结果了。output是Interface里面自带的属性。有很多的功能。请参见Zeus的帮助文件。

 You can toggle in out of script like this
  Hello world.

我们找到Interface Code,发现里面注释了些代码。我们把注释去掉后代码如下

public class GeneratedGui : DotNetScriptGui
{
    public GeneratedGui(ZeusContext context) : base(context) {}

    //-----------------------------------------
    // The User Interface Entry Point
    //-----------------------------------------
    public override void Setup()
    {
        // ** UNCOMMENT CODE BELOW TO SEE UI **
        ui.Width  = 100;
        ui.Height = 100;
        GuiLabel lblDemo = ui.AddLabel("lblDemo", "Demo", "Demo Tooltip");
        ui.ShowGui = true;
    }

}

运行模板。将会看到一个有Demo字体标签和Ok按纽的窗体。其中Demo字体标签是我们在代码中添加的。Ok按纽是模板自动设置，用来表示确定。

我们来写一个模板来实现一个简单功能。界面上用一个下拉列表绑定数据库名称列表，选择数据库后生成数据库中的表的列表。代码如下

public class GeneratedGui : DotNetScriptGui
{
    public GeneratedGui(ZeusContext context) : base(context) {}

    //-----------------------------------------
    // The User Interface Entry Point
    //-----------------------------------------
    public override void Setup()
    {
        // ** UNCOMMENT CODE BELOW TO SEE UI **
        ui.Width  = 180;
        ui.Height = 120;
        ui.Title="First Template";//窗体的标题
        GuiLabel lblDatabase = ui.AddLabel("lblDatabase", "选择数据库", "选择数据库");
        GuiComboBox chooseDatabase = ui.AddComboBox( "chooseDatabase", "选择数据库" );
        chooseDatabase.Width=150;
        setupDatabaseDropdown(chooseDatabase);
        
        ui.ShowGui = true;
    }

    //绑定数据库
    public void setupDatabaseDropdown( GuiComboBox checkbox )
    {
        if( MyMeta.IsConnected )//如果MyMeta连接成功
        {
            checkbox.BindData( MyMeta.Databases );
        }
    }
}

 

<%
public class GeneratedTemplate : DotNetScriptTemplate
{
    public GeneratedTemplate(ZeusContext context) : base(context) {}

    //---------------------------------------------------
    // Render() is where you want to write your logic    
    //---------------------------------------------------
    public override void Render()
    {
        string _dbName = input["chooseDatabase"].ToString();
        
        
        
        foreach(ITable table in MyMeta.Databases[_dbName].Tables)
        {
            output.writeln(table.Alias);
        }
        
        output.writeln("**************************");
        
        foreach(ITable table in MyMeta.Databases[_dbName].Tables)
        {
%><%=table.Alias%>
<%
        }
    }

}
%>

两个foreach可以作用是相同的,我这里写两个是为了展示<%=%>的绑定功能。你可能会问绑定的两行为什么顶行了，因为其中的空格会显示在结果中，你可以自己试试效果。
其他代码很简单，我想大家都看得懂。

运行它看看结果

sysdiagrams
T_Child
T_Employee
T_Employee1
T_Parent
T_Person
T_Person1
T_Role
T_User
T_User_Role
**************************
sysdiagrams
T_Child
T_Employee
T_Employee1
T_Parent
T_Person
T_Person1
T_Role
T_User
T_User_Role

呵呵，成功了。

这只是个简单的示例。MyGeneration功能十分强大可以生成ORM的实体类，存储过程，SQL语句等等。
如果你也想自己写模板，你可以多看看Zeus和MyMeta的帮助文件，多看别人写得模板。相信你很快也能写出功能强大的模版。