MyGeneration是一个功能很强大的代码生成工具。通过编写包含各种类型脚本(C#,VB.Net,JScript,VBScript)的模板,通过数据库的表内容,生成你需要的各种代码。你可以用它来生成ORM的实体类,存储过程,SQL语句等等。
MyGeneration提供了强大的在线模版库,你可以通过访问其网站或者使用Template Browser中的在线模版功能按钮寻找你需要的模版。当然你也可以根据需要自己写模板。
它由几个重要的外部组件组成,其中常用的有以下两个
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