功能強(qiáng)大的T4文本模版
希望您至少能意識(shí)到即使有代碼自動(dòng)生成器,但數(shù)據(jù)庫(kù)結(jié)構(gòu)變更等因素也會(huì)給我們帶來(lái)不少的麻煩。這種直接放到項(xiàng)目里.tt文件的好處自然不用多說了。有特別的業(yè)務(wù)需求,在.用partial類來(lái)實(shí)現(xiàn),免得模板文件自動(dòng)更新代碼時(shí)將手寫的代碼覆蓋掉。(北京網(wǎng)站制作)
T4文本模版到底有什么用?什么時(shí)候用?
看一下下面這個(gè)示例你應(yīng)該就會(huì)明白了:
新建一個(gè)控制臺(tái)應(yīng)用程序,刪除里面的所有文件,新建一個(gè)Program.tt的文件,并輸入如下內(nèi)容:
- <#@ template language="C#"debug="true"#>
- <#@ output extension=".cs"encoding="utf-8"#>
- <#
- stringClassName = "Program";
- #>stringClassName = "Program";
- #>
- namespaceHelloAngel
- {
- usingSystem;
- class<#=ClassName #>
- {
- staticvoidMain(string[] args)
- {
- Console.WriteLine("Hello Angel");
- }
- }
- }
保存后我們會(huì)看到解決方案資源管理器中是這個(gè)樣式的:
此時(shí)的Program.cs文件正是我們的Program.tt文件生成的,其內(nèi)容如下:
- namespaceHelloAngel
- {
- usingSystem;
- classProgram
- {
- staticvoidMain(string[] args)
- {
- Console.WriteLine("Hello Angel");
- }
- }
- }
看看下面兩個(gè)指令:
- <#@ template language="C#"debug="true"#>
- <#@ output extension=".cs"encoding="utf-8"#>
<#@ template #>指令中l(wèi)anguage指定了我們模板運(yùn)行使用的語(yǔ)言,可以是VB,或C#,debug聲明了是否使用調(diào)試,如果用不到調(diào)試,可以設(shè)置為false.
<#@ output #>指令中extension指定了輸出文件的擴(kuò)展名,encoding指定輸出文件的編碼方案。
也就是說,我們可以使用C#語(yǔ)言來(lái)寫此模板文件中的邏輯,模板將會(huì)輸出一個(gè)與模板文件名相同,擴(kuò)展名為.cs編碼為utf-8的文件。
這里稍作了解下,接下來(lái)看看指令的語(yǔ)法吧:
指令的語(yǔ)法如下所示:
- <#@ DirectiveName [AttributeName = "AttributeValue"] ... #>
必須將所有特性值放在雙引號(hào)內(nèi)。如果值本身包含引號(hào),則必須使用 字符對(duì)這些引號(hào)進(jìn)行轉(zhuǎn)義。
指令通常是模板文件或包含的文件中的第一個(gè)元素。不應(yīng)將它們放置在代碼塊 <#...#> 內(nèi),也不應(yīng)放置在類功能塊 <#+...#> 之后。
T4 模板指令
<#@ template [language="VB"] [hostspecific="true"] [debug="true"] [inherits="templateBaseClass"] [culture="code"] [compilerOptions="options"] #>
T4 參數(shù)指令
<#@ parameter type="Full.TypeName"name="ParameterName"#>
T4 輸出指令
<#@ output extension=".fileNameExtension"[encoding="encoding"] #>
T4 程序集指令
<#@ assembly name="[assembly strong name|assembly file name]"#>
T4 導(dǎo)入指令
<#@ import namespace="namespace"#>
T4 包含指令
<#@ include file="filePath"#>
看了上面的指令后,就試著寫個(gè)模板文件生成一些類來(lái)練習(xí)一下吧:
- <#@ template language="C#"debug="true"#>
- <#@ output extension=".cs"encoding="utf-8"#>
- <#@ import namespace="System.Collections.Generic"#>
- <#
- List<List<string>classNames =
- new List<string>()
- {
- "Hello",
- "Test"
- };
- List<string>callMethods = new List<string>();
- #>
- namespace HelloAngel
- {
- using System;
- <#
- foreach (string className in classNames)
- {
- callMethods.Add(string.Format("{0}.Show();", className));
- #>foreach (string className in classNames)
- {
- callMethods.Add(string.Format("{0}.Show();", className));
- #>
- class <#=className #>
- {
- /// <summary>
- /// <#=className #>的注釋
- /// </summary>
- public static void Show()
- {
- Console.WriteLine("ClassName:<#=className #>");
- }
- }
- <#
- #>}
- #>
- class Program
- {
- /// <summary>
- /// 入口方法的注釋
- /// </summary>
- static void Main(string[] args)
- {
- <#
- foreach (string callMethod in callMethods)
- {
- #>foreach (string callMethod in callMethods)
- {
- #>
- // <#=callMethod #>調(diào)用
- <#=callMethod #>
- <#
- }
- #>}
- #>
- }
- }
- }
我們一般的項(xiàng)目多是分了簡(jiǎn)單三層,有了上面的一些經(jīng)驗(yàn),你應(yīng)該會(huì)想。要是只寫三個(gè)類.tt文件,就能自動(dòng)給我們把整個(gè)三層維護(hù)好那多令人興奮??!確實(shí),我就是這樣做了一個(gè)項(xiàng)目給大家分享一下:
看看現(xiàn)在整個(gè)項(xiàng)目成什么樣子了:
這里不止三個(gè)項(xiàng)目了。我加了個(gè)UnitTest的項(xiàng)目,一個(gè)Adapters的項(xiàng)目,看項(xiàng)目名稱不難看出來(lái),UnitTest項(xiàng)目就是一個(gè)測(cè)試項(xiàng)目。而Adapters項(xiàng)目呢,是實(shí)體適配器項(xiàng)目。先不管它們了。
就這么點(diǎn)東西,已經(jīng)完成三層的架設(shè)了,只是還是Paramter方式的。沒有對(duì)存儲(chǔ)過程的支持。十一如果沒有人陪我過的話,我會(huì)將對(duì)存儲(chǔ)過程的支持添加上去。
建項(xiàng)目的時(shí)候建的是.net 4的,這里我把它改為.net2.0的了。不過本人只裝有visual stuido 2010,如果您使用的是Visual studio 2008請(qǐng)您自行將項(xiàng)目文件中的版本號(hào)更正,此方法網(wǎng)上有許多。我就不多啰嗦了。
標(biāo)簽:北京網(wǎng)站制作 高端網(wǎng)站建設(shè)