mvc实用架构设计(三)ef-code first(3)：使用t4模板生成相似代码

MVC实用架构设计（三）——EF-Code First（3）：使用T4

模板生成相似代码

〇、目录一、前言二、工具准备三、T4代码生成预热(一) 单文件生成：HelloWorld.cs (二) 多文件生成四、生成数据层实体相关相似代码(一) 生成准备(二)

生成实体相关相似代码生成实体映射配置类生成实体仓储

接口生成实体仓储实现五、源码获取系列导航一、前言

经过前面EF的《第一篇》与《第二篇》，我们的数据层功能已经较为完善了，但有不少代码相似度较高，比如负责实体映射的EntityConfiguration，负责仓储操作的IEntityRepository与EntityRepository。而且每添加一个实体类型，就要手动去添加一套相应的代码，也是比较累的工作。如果能有一个根据实体类型自动生成这些相似度较高的代

码的解决方案，那将会减少大量的无聊的工作。VS提供的“文本模板”（俗称T4）功能，就是一个较好的解决方案。要添加一个实体类型，只要把实体类型定义好，然后运行一下定义好的T4模板，就可以自动生成相应的类文件。二、工具准备为了更好的使用T4模板功能，我们需要给VS安装如下两个插件：Devart T4 Editor：为VS提供智能提示功能。T4 Toolbox：在生成多文件时很有用。三、T4

代码生成预热(一) 单文件生成：HelloWorld.cs 下面，

我们先来体验一个最简单的T4代码生成功能，输出一个最简单的类文件。首先，在GMF.Demo.Core.Data中添加一个名为T4 的文件夹，用于存放生成本工程内的代码的T4模板文件。并在其中添加一个名为HelloWorld.tt的“文本模板”的项。HelloWorld.tt定义如下：1 <#@ template debug="false" hostspecific="false" language="C#" #>

2 <#@ assembly name="System.Core" #>

3 <#@ import namespace="System.Linq" #>

4 <#@ import namespace="System.Text" #>

5 <#@ import

namespace="System.Collections.Generic" #>

6 <#@ output extension=".cs" #>

7 using System;

8

9 namespace GMF.Demo.Core.Data.T4

10 {

11 public class HelloWorld

12 {

13 private string _word;

14

15 public HelloWorld(string word)

16 {

17 _word = word;

18 }

19 }

20 } 直接保存文件（T4的生成将会在保存模板，模板失去焦点等情况下自动触发生成。），将会在模板的当前位置生成一个同名的类文件：HelloWorld.cs的内容如下：1 using System;

2

3 namespace GMF.Demo.Core.Data.T4

4 {

5 public class HelloWorld

6 {

7 private string _word;

8

9 public HelloWorld(string word)

10 {

11 _word = word;

12 }

13 }

14 } 这样，我们的HelloWorld之旅就结束了，非常简单。(二) 多文件生成当前位置方案的方案只能生成如下所示的代码：生成的文件会与T4模板在同一目录中，

这里就不详述了，可以参考蒋金楠一个简易版的T4代码

生成"框架" 。本项目的多文件需要生成到指定文件夹中，但又想对T4模板进行统一的管理，T4文件夹里放置T4模

板文件，但生成的映射文件EntityConfiguration将放置到文件夹Configurations中，仓储操作的文件IEntityRepository

与EntityRepository将放置到Repositories文件夹中。且生成的代码文件应能自动的添加到解决方案中，而不是只是在文件夹中存在。要实现此需求，一个简单的办法就是通过T4 Toolbox 来进行生成。想了解T4 Toolbox 的细节，可以自己使用ILSpy 来对T4Toolbox.dll 文件进行反编译

来查看源代码，如果是通过T4 Toolbox 是通过VS的插件来安装的，将在

“C:\Users\Administrator\AppData\Local\Microsoft\VisualSt udio\11.0\Extensions\dca4f0lt.jdx”文件夹中（我的机器上）。下面，我们直接进行多文件生成的演示。首先，添加一个名为HelloWorldTemplate.tt 的T4 Toolbox 的代码模板。此模板将继承于T4 Toolbox 的CSharpTemplate 类：1 <#+

2 // <copyright file="HelloWorldTemplate.tt" company="

郭明锋@中国">

3 // Copyright ? 郭明锋@中国. All Rights Reserved.

4 // </copyright>

5

6 public class HelloWorldTemplate : CSharpTemplate

7 {

8 private string _className;

9

10 public HelloWorldTemplate(string className)

11 {

12 _className = className;

13 }

14

15 public override string TransformText()

16 {

17 #>

18 using System;

19

20 namespace GMF.Demo.Core.Data.T4

21 {

22 public class <#=_className #>

23 {

24 private string _word;

25

26 public <#=_className #>(string word)

27 {

28 _word = word;

29 }

30 }

31 }

32 <#+

33 return this.GenerationEnvironment.ToString();

34 }

35 }

36 #> 模板类中定义了一个className 参数，用于接收一个表示要生成的类名的值。所有生成类的代码都以字符串的形式写在重写的TransformText 方法中。再定义一个T4模板文件HelloWorldMulti.tt，用于调用上面定义的代码模板进行代码文件的生成。1 <#@ template debug="false" hostspecific="false" language="C#" #>

2 <#@ assembly name="System.Core" #>

3 <#@ import namespace="System.IO" #>

4 <#@ import namespace="System.Linq" #>

5 <#@ import namespace="System.Text" #>

6 <#@ import

namespace="System.Collections.Generic" #>

7 <#@ include file="T4Toolbox.tt" #>

8 <#@ include file="HelloWorldTemplate.tt" #>

9 <#

10 string curPath =

Path.GetDirectoryName(Host.TemplateFile);

11 string destPath = https://www.360docs.net/doc/2916418990.html,bine(curPath, "outPath");

12 if(!Directory.Exists(destPath))

13 {

14 Directory.CreateDirectory(destPath);

15 }

16 string[] classNames = new[]{"HelloWorld1", "HelloWorld2", "HelloWorld3"};

17 foreach(string className in classNames)

18 {

19 HelloWorldTemplate template = new HelloWorldTemplate(className);

20 string fileName = string.Format(@"{0}\{1}.cs", destPath, className);

21 template.Output.Encoding = Encoding.UTF8;

22 template.RenderToFile(fileName);

23 }

24 #> 以上是整个T4模板的执行方，在执行方中，

要引用所有需要用到的类库文件，命名空间，包含的模板文件等。最后，文件的生成是调用T4 Toolbox 的Template基类中定义的RenderToFile(string filename)方

法来生成各个文件的，输入的参数为生成文件的文件全名。在这里，生成将如下所示：outPPath文件夹中生成了HelloWorld1.cs、HelloWorld2.cs、HelloWorld3.cs 文件，而HelloWorldMulti.tt 所在文件夹中也会生成一个空的HelloWorldMulti.cs 类文件。四、生成数据层实体相关相似代码(一) 生成准备我们的生成代码是完全依赖于业务

实体的，所以，需要有一个类来对业务实体的信息进行提取封装。1 namespace https://www.360docs.net/doc/2916418990.html,ponent.Tools.T4

2 {

3 /// <summary>

4 /// T4实体模型信息类

5 /// </summary>

6 public class T4ModelInfo

7 {

8 /// <summary>

9 /// 获取模型所在模块名称

10 /// </summary>

11 public string ModuleName { get; private set; }

12

13 /// <summary>

14 /// 获取模型名称

15 /// </summary>

16 public string Name { get; private set; }

17

18 /// <summary>

19 /// 获取模型描述

20 /// </summary>

21 public string Description { get; private set; }

22

23 public IEnumerable<PropertyInfo> Properties { get; private set; }

24

25 public T4ModelInfo(Type modelType)

26 {

27 var @namespace =

https://www.360docs.net/doc/2916418990.html,space;

28 if (@namespace == null)

29 {

30 return;

31 }

32 var index = @https://www.360docs.net/doc/2916418990.html,stIndexOf('.')

+ 1;

33 ModuleName =

@namespace.Substring(index, @namespace.Length - index);

34 Name = https://www.360docs.net/doc/2916418990.html,;

35 var descAttributes =

modelType.GetCustomAttributes(typeof(DescriptionAttribu te), true);

36 Description = descAttributes.Length == 1 ? ((DescriptionAttribute)descAttributes[0]).Description : Name;

37 Properties = modelType.GetProperties();

38 }

39 }

40 } 另外，通过模板生成的代码，与我们手写的代码有如下几个区别：手写代码可以自由定义，生成代码是根据模板生成的，必然遵守模板定义的规范。手写代码的修改可以永久保存，生成代码的修改将会在下次生成后丢失，即生成代码不应该进行修改。基于以上几个区别，我提出如下解决方案，来解决生成代码的修改问题通过模板生成的类应尽量定义为分部类（partial class），在需要进行修改及扩展的时候可以定义另外的同名分部类来进行修改。对于需要外

部实现的功能，定义分部方法来对外提供扩展。生成代码的类文件命名把扩展名由“.cs”更改为“generated.cs”，以区分生成代码与手写代码文件。(二) 生成实体相关相似代码 1. 生成实体映射配置类实体映射配置类模板EntityConfigurationTemplate.tt 定义：1 <#+

2 // <copyright file="EntityConfigurationTemplate.tt" company="郭明锋@中国">

3 // Copyright ? 郭明锋@中国. All Rights Reserved.

4 // </copyright>

5

6 public class EntityConfigurationTemplate : CSharpTemplate

7 {

8 private T4ModelInfo _model;

9

10 public EntityConfigurationTemplate(T4ModelInfo model)

11 {

12 _model = model;

13 }

14

15 /// <summary>

16 /// 获取生成的文件名，根据模型名定义

17 /// </summary>

18 public string FileName

19 {

20 get

21 {

22 return

string.Format("{0}Configuration.generated.cs",

_https://www.360docs.net/doc/2916418990.html,);

23 }

24 }

25

26 public override string TransformText()

27 {

28 #>

29

//------------------------------------------------------------------------------

30 // <auto-generated>

31 // 此代码由工具生成。

32 // 对此文件的更改可能会导致不正确的行为，并且如果

33 // 重新生成代码，这些更改将会丢失。

34 // 如存在本生成代码外的新需求，请在相同命名空间下创建同名分部类实现<#= _https://www.360docs.net/doc/2916418990.html,

#>ConfigurationAppend 分部方法。

35 // </auto-generated>

36 //

37 // <copyright file="<#= _https://www.360docs.net/doc/2916418990.html,

#>Configuration.generated.cs">

38 // Copyright(c)2013 GMFCN.All rights reserved.

39 // CLR版本：4.0.30319.239

40 // 开发组织：郭明锋@中国

41 // 公司网站：https://www.360docs.net/doc/2916418990.html,

42 // 所属工程：GMF.Demo.Core.Data

43 // 生成时间：<#=

DateTime.Now.ToString("yyyy-MM-dd HH:mm") #>

44 // </copyright>

45

//------------------------------------------------------------------------------

46

47 using System;

48 using System.Data.Entity.ModelConfiguration;

49 using

System.Data.Entity.ModelConfiguration.Configuration;

50

51 using https://www.360docs.net/doc/2916418990.html,ponent.Data;

52 using GMF.Demo.Core.Models;

53

54

55 namespace GMF.Demo.Core.Data.Configurations

56 {

57 /// <summary>

58 /// 实体类-数据表映射——<#=

_model.Description #>

59 /// </summary>

60 internal partial class <#= _https://www.360docs.net/doc/2916418990.html,

#>Configuration : EntityTypeConfiguration<<#= _https://www.360docs.net/doc/2916418990.html, #>>, IEntityMapper

61 {

62 /// <summary>

63 /// 实体类-数据表映射构造函数——<#= _model.Description #>

64 /// </summary>

65 public <#= _https://www.360docs.net/doc/2916418990.html,

#>Configuration()

66 {

67 <#= _https://www.360docs.net/doc/2916418990.html,

#>ConfigurationAppend();

68 }

69

70 /// <summary>

71 /// 额外的数据映射

72 /// </summary>

73 partial void <#= _https://www.360docs.net/doc/2916418990.html,

#>ConfigurationAppend();

74

75 /// <summary>

76 /// 将当前实体映射对象注册到当前数据访问上下文实体映射配置注册器中

77 /// </summary>

78 /// <param name="configurations">实体映射配置注册器</param>

79 public void RegistTo(ConfigurationRegistrar configurations)

80 {

81 configurations.Add(this);

82 }

83 }

84 }

85 <#+

86 return this.GenerationEnvironment.ToString();

87 }

88 }

89 #> 生成模板调用方EntityCodeScript.tt 定义1 <#@ template language="C#" debug="True" #>

2 <#@ output extension="cs" #>

3 <#@ Assembly Name="System.Core" #>

4 <#@ Assembly

Name="$(SolutionDir)\https://www.360docs.net/doc/2916418990.html,ponent.Tools\bin\Debug\ https://www.360docs.net/doc/2916418990.html,ponent.Tools.dll" #>

5 <#@ import namespace="System.IO" #>

6 <#@ Import Namespace="System.Linq" #>

7 <#@ Import Namespace="System.Text" #>

8 <#@ import namespace="System.Reflection" #>

9 <#@ Import

Namespace="System.Collections.Generic" #>

10 <#@ Import Namespace="https://www.360docs.net/doc/2916418990.html,ponent.Tools"

#>

11 <#@ Import

Namespace="https://www.360docs.net/doc/2916418990.html,ponent.Tools.T4" #>

12 <#@ include file="T4Toolbox.tt" #>

13 <#@ include

file="Include\EntityConfigurationTemplate.tt" #>

14 <#

15 string currentPath =

Path.GetDirectoryName(Host.TemplateFile);

16 string projectPath =currentPath.Substring(0, currentPath.IndexOf(@"\T4"));

17 string solutionPath = currentPath.Substring(0, currentPath.IndexOf(@"\GMF.Demo.Core.Data"));

18

19 string modelFile= https://www.360docs.net/doc/2916418990.html,bine(solutionPath, @"GMF.Demo.Core.Models\bin\Debug\GMF.Demo.Core. Models.dll");

20 byte[] fileData= File.ReadAllBytes(modelFile);

21 Assembly assembly = Assembly.Load(fileData);

22 IEnumerable<Type> modelTypes = assembly.GetTypes().Where(m =>

typeof(Entity).IsAssignableFrom(m)

&& !m.IsAbstract);

23 foreach(Type modelType in modelTypes)

24 {

25 T4ModelInfo model = new

T4ModelInfo(modelType);

26 //实体映射类

27 EntityConfigurationTemplate config = new EntityConfigurationTemplate(model);

28 string path =

string.Format(@"{0}\Configurations", projectPath);

29 config.Output.Encoding = Encoding.UTF8;

30 config.RenderToFile(https://www.360docs.net/doc/2916418990.html,bine(path, config.FileName));

31 }

32 #> 调用方通过反射从业务实体程序集

GMF.Demo.Core.Models.dll 中获取所有基类为Entity 的并且不是抽象类的实体类型信息，再调用模板逐个生成实体配置类文件。例如，生成的登录记录信息（LoginLog）的映射文件LoginLogConfiguration.generated.cs 如下：1 //------------------------------------------------------------------------------

2 // <auto-generated>

3 // 此代码由工具生成。

4 // 对此文件的更改可能会导致不正确的行为，并且如果

5 // 重新生成代码，这些更改将会丢失。

6 // 如存在本生成代码外的新需求，请在相同命名空间下创建同名分部类实现LoginLogConfigurationAppend 分部方法。

7 // </auto-generated>

8 //

9 // <copyright

file="LoginLogConfiguration.generated.cs">

10 // Copyright(c)2013 GMFCN.All rights reserved.

11 // CLR版本：4.0.30319.239

12 // 开发组织：郭明锋@中国

13 // 公司网站：https://www.360docs.net/doc/2916418990.html,

14 // 所属工程：GMF.Demo.Core.Data

15 // 生成时间：2013-06-16 17:45

16 // </copyright>

17

//------------------------------------------------------------------------------

18

19 using System;

20 using System.Data.Entity.ModelConfiguration;

21 using

System.Data.Entity.ModelConfiguration.Configuration;

22

23 using https://www.360docs.net/doc/2916418990.html,ponent.Data;

24 using GMF.Demo.Core.Models;

25

26

27 namespace GMF.Demo.Core.Data.Configurations

28 {

29 /// <summary>

30 /// 实体类-数据表映射——登录记录信息

31 /// </summary>

32 internal partial class LoginLogConfiguration : EntityTypeConfiguration<LoginLog>, IEntityMapper

33 {

34 /// <summary>

35 /// 实体类-数据表映射构造函数——登录记录信息

36 /// </summary>