从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

时间:2023-03-08 17:32:24

  对于T4模板很多朋友都不太熟悉,它在项目开发中,会帮我们减轻很大的工作量,提升我们的开发效率,减少出错概率。所以学好T4模板的应用,对于开发人员来说是非常重要的。

  园子里对于T4模板的介绍与资料已经太多了,所以在这里我就不再详细讲述基础知识了,只是说说T4模板在本框架中的具体应用与实践。

  一、创建逻辑层项目

  从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

  从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

  二、添加引用

  从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

  将之前添加的三个项目添加到引用

  从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

  三、创建T4模板放置的文件夹,并命名为SubSonic

  从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

  四、将Solution.DataAccess项目中SubSonic文件夹下的MultipleOutputHelper.ttinclude、Settings.ttinclude、SQLServer.ttinclude以及项目根目录下的App.config四个文件复制到逻辑层对应的位置里,详见下图

  从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

  五、SubSonic文件夹里创建Test.tt模板文件,用来练习T4模板的实践

  从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

  从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

  从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

  六、编写T4模板实例,练习模板的使用

  1、练习一

  我们先添加几行代码  

 <#@ template language="C#" debug="false" hostspecific="True" #>
<#@ output extension=".cs" encoding="utf-8" #>
<#@ include file="SQLServer.ttinclude" #> using System; namespace <#=Namespace#> { }

  <#@ template language="C#" debug="false" hostspecific="True" #>是T4模板指令,说明使用的语言是C#,不开启debug模式,并将名为 Host 的属性添加到由文本模板生成的类中

  <#@ output extension=".cs" encoding="utf-8" #>是T4模板的输出指令,限制当前模板生成的文件扩展名为.cs,存储格式为utf-8

  <#@ include file="SQLServer.ttinclude" #>这是模板的工具类文件,使用 Include 指令在其他文本模板中包含此文件,本行代码主要功能是将SQL操作的工具类(函数)包含到代码

  using System; 这是输出在cs文件中显示的文本信息,具体功能大家一看就明白了,不再解释

  namespace <#=Namespace#>  创建命名空间名称,因为SQLServer.ttinclude文件里使用了<#@ include file="Settings.ttinclude" #>,将SubSonic3.0模板的配置信息也同时读取了进来,所以可以直接使用Settings.ttinclude中设置的变量,用它来作为命名空间名称,详见下图

  从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)  

从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

  也就是说,如果你想在模板中使用一些你想要的变量的话,可以在这些工具类或配置文件中进行定义

  点击保存后生成Test.cs文件内容:

  从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

  2、练习二

  通过练习一,我们明白了T4模板生成代码的简单原理,那么我们增加些实用的内容来看看模板运行的效果

  先上代码

 <#@ template debug="false" hostspecific="True" language="C#" #>
<#@ output extension=".cs" encoding="utf-8" #>
<#@ include file="SQLServer.ttinclude" #> using System; namespace <#=Namespace#> {
<#
var tables = LoadTables();
//遍历所有表
foreach(var tbl in tables){
#> public class <#=tbl.CleanName#>Table {
/// <summary>
/// 表名
/// </summary>
public static string TableName {
get{
return "<#=tbl.CleanName#>";
}
}
}
<#
}
#>
}

  var tables = LoadTables();  LoadTables()是SQLServer.ttinclude工具类中的函数,功能是获取数据库中所有表和字段(已修改了该文件的代码,可以获取到所有表与视图)

  foreach(var tbl in tables)  遍历所有表

  <#=tbl.CleanName#>  读取表名称

  public class <#=tbl.CleanName#>Table  用表名称+Table 做为类名

  点击保存后生成Test.cs文件内容:

  从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

  3、练习三

  通过上面练习,我们可以看到使用很简单的几行代码,就可以非常方便的生成我们想要的代码,减少我们复制粘贴的操作,当然上面生成的东西太简单了,我们想通过本模板生成的类来减少强编码,那么就需要获取所有字段名称出来

  

 <#@ template debug="false" hostspecific="True" language="C#" #>
<#@ output extension=".cs" encoding="utf-8" #>
<#@ include file="SQLServer.ttinclude" #> using System; namespace <#=Namespace#> {
<#
var tables = LoadTables();
//遍历所有表
foreach(var tbl in tables){
#> public class <#=tbl.CleanName#>Table {
/// <summary>
/// 表名
/// </summary>
public static string TableName {
get{
return "<#=tbl.CleanName#>";
}
} //新增代码,循环遍历表中的所有字段,创建相应的函数
<#
foreach(var col in tbl.Columns){
#>
/// <summary>
/// <#=Replace(col.Description) #>
/// </summary>
public static string <#= col.Name #>{
get{
  return "<#= col.Name #>";
}
} <#
}
#> }
<#
}
#>
}

  foreach(var col in tbl.Columns)  遍历表中所有字段,获取字段结构

  <#=Replace(col.Description) #>  本代码中通过col.Description来获取字估注释,Replace函数是将字段注释(说明)里的换行符替换成对应格式

  <#= col.Name #>  获取字段名称

  点击保存后生成Test.cs文件内容:

  从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

  从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

  4、练习四

  用完上面的练习是不是感觉很简单呢。对于数据表比较少的情况下,这种生成是完全没有问题的,但表多了以后都放在一个文件里,在DEBUG调试时就会出问题了,主要原因是代码行数过大,所以我们有另外一种解决办法,就是分文件生成

  先上代码(为了让大家更好的理解,会将前面例子中的一些内容删除掉)

 

 <#@ template debug="false" hostspecific="True" language="C#" #>
<#@ output extension=".cs" encoding="utf-8" #>
<#@ include file="SQLServer.ttinclude" #>
<#@ include file="MultipleOutputHelper.ttinclude"#> <#
//获取所有表与视图
var tables = LoadTables();
//创建多文件生成实体
var manager = Manager.Create(Host, GenerationEnvironment); //遍历所有表
foreach(var tbl in tables){
//判断当前表名是否是禁用名称(禁用的名称可以在Settings.ttinclude文件的ExcludeTables字符串数据中进行添加)
if(!ExcludeTables.Contains(tbl.Name))
{
// 设置输出的文件名
manager.StartNewFile(tbl.ClassName+".cs");
#>
using System; namespace <#=Namespace#> { } <#
// 输出文件结束
manager.EndBlock();
} //if(!ExcludeTables.Contains(tbl.Name)) 判断结束 }// end foreach // 执行编译,生成文件
manager.Process(true);
#>

  <#@ include file="MultipleOutputHelper.ttinclude"#>  生成多文件工具类

  var manager = Manager.Create(Host, GenerationEnvironment);   创建多文件生成实体

  foreach(var tbl in tables)  遍历所有表,这个放在using的前面,是因为每个单独文件生成后都需要有using

  其他新增内容在代码中都有详细注释了,所以这里不再说明

  点击保存后生成Test.cs文件内容:

  从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

  从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

  再来个完整的模板代码

  

 <#@ template debug="false" hostspecific="True" language="C#" #>
<#@ output extension=".cs" encoding="utf-8" #>
<#@ include file="SQLServer.ttinclude" #>
<#@ include file="MultipleOutputHelper.ttinclude"#> <#
//获取所有表与视图
var tables = LoadTables();
//创建多文件生成实体
var manager = Manager.Create(Host, GenerationEnvironment); //遍历所有表
foreach(var tbl in tables){
//判断当前表名是否是禁用名称(禁用的名称可以在Settings.ttinclude文件的ExcludeTables字符串数据中进行添加)
if(!ExcludeTables.Contains(tbl.Name))
{
// 设置输出的文件名
manager.StartNewFile(tbl.ClassName+".cs");
#>
using System; namespace <#=Namespace#> { public class <#=tbl.CleanName#>Table {
/// <summary>
/// 表名
/// </summary>
public static string TableName {
get{
return "<#=tbl.CleanName#>";
}
} <#
foreach(var col in tbl.Columns){
#>
/// <summary>
/// <#=Replace(col.Description) #>
/// </summary>
public static string <#= col.Name #>{
get{
return "<#= col.Name #>";
}
} <#
}
#>
} } <#
// 输出文件结束
manager.EndBlock();
} //if(!ExcludeTables.Contains(tbl.Name)) 判断结束 }// end foreach // 执行编译,生成文件
manager.Process(true);
#>

  点击保存后生成Test.cs文件内容:

  从零开始编写自己的C#框架(12)——T4模板在逻辑层中的应用(一)(附源码)

 下载地址:

T4模板在逻辑层中的应用(一).rar

 版权声明:

  本文由AllEmpty原创并发布于博客园,欢迎转载,未经本人同意必须保留此段声明,且在文章页面明显位置给出原文链接,否则保留追究法律责任的权利。如有问题,可以通过1654937@qq.com 联系我,非常感谢。

  发表本编内容,只要主为了和大家共同学习共同进步,有兴趣的朋友可以加加Q群:327360708 ,大家一起探讨。

  更多内容,敬请观注博客:http://www.cnblogs.com/EmptyFS/