博客园_黃偉榮的學習筆記

Web Project的檔案共用小技巧

2011-01-29T18:39:00Z

有時Web Project會有一些檔案在不同專案間共同使用，如Javascript檔、圖檔、第三方套件等等，如果每一個專案都放置一份，很容易照成維護上的麻煩(如修改A專案的檔案，忘了複製到B專案)，這時可以調整一下檔案的結構與修改一下專案的設定來解決這問題(這是小弟最近建方案的心得，不一定是最好的)。

資料夾結構

可以在方案下建立一個方案內專案共用的資料夾，專門放置通用的檔案。

通用檔案的版本管理

通用檔案可以放在方案下，簽出簽入以方案內為主，但缺點是檔案的用共只能分享在方案中的專案間，其實可以將共用檔案存放在一個版本管理的特定路徑下，在用工具做同步，如:

SVN的 svn:externals
TFS的工具區設定多資料夾

等方式將方案所需的檔案放在方案資料夾中。

假設在TFS或SVN中以下列方式建立，shared(通用資料夾)是平行於方案的。

在SVN中在Checkout的方案資料夾上增加svn:externals屬性，讓工具簽出方案時一並簽出Shared資料夾，並修改後可簽入。

在TFS中工作區增加Shared的Map，讓工具簽出方案時一並簽出Shared資料夾，並修改後可簽入。

以Add As Link方式新增檔案

在各專案中以Add As Link的方式將檔案加入通用檔案(以Add As Link加入專案的檔案的圖示會多一個連結符號)，當修改時是修改同一份檔案，並可以簽入讓所有方案都使用最新的檔案。

如範例的二個專案中的JS是共用小弟寫多年的檔案，因為都是修改同一份，不會因為複製到不同專案中，因為修改而造成版本的混亂。

NOTE:

VSCommands 2010有提供，Copy Link與Paste Link的功能，可以減少一點點的操作。

修改專案檔

Web Project的MS Build預設設定是不複製Link Content到專案中，這樣就以Link加入專案就會出現問題，因為當按下F5執行時，是無法正常執行的，因為找不到檔案，所以要修改MS Build的設定，當發生編譯時，複製檔案到連結檔案的所在。

在*.csproj檔中增加下_CopyWebApplication Target

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

<Target Name="_CopyWebApplication" DependsOnTargets="$(_CopyWebApplicationDependsOn)">
<Copy SourceFiles="@(Content)" Condition=" '$(IsDesktopBuild)' != 'false' And '%(Content.Link)' != '' "
DestinationFiles="$(ProjectDir)%(Content.Link)" SkipUnchangedFiles="true" Retries="$(CopyRetryCount)" RetryDelayMilliseconds="$(CopyRetryDelayMilliseconds)" />
<CallTarget Condition=" '!$(Disable_CopyWebApplication)' And '$(OutDir)' != '$(OutputPath)' And '$(OnAfter_CopyWebApplication)' != ''"
Targets="$(OnAfter_CopyWebApplication)" RunEachTargetSeparately="true" />
</Target>
</Project>

NOTE:
此方法僅適用Web Project，不適用Web Site。

實行結果

這方式在小弟的專案實行一陣子了，用起來沒什麼問題，我們的開發環境是

Visual Studio 2010

Visual Studio TFS 2010

本機的Build、TFS的Build、Publish都還沒發現問題，有興趣的朋友可以試試看。

參考資料

svn:externals說明

HOW TO：加入現有項目至專案

MSBuild Target

本文链接

IoC的中繼器:CommonServiceLocator

2011-01-29T18:38:00Z

IoC(控制反轉)是時下很流行的設計模式，它可以大大的簡少程式之間的相依性，有點像工廠模式，在Class中操作的都是Interface，而Interface與Class的對應與建立實例都是由IoC Framework處理，光是在.Net Framework下的IoC Framework就有近10套，每套都有各自的優缺點，呼叫方式也略有不同，切換IoC Framework是非常麻煩的，或是開發組件(Assembly)，組件也是使用IoC，但是又不能限制使用端用特定款IoC Framework，這時候可以考慮使用IoC的中繼器:CommonServiceLocator來解決這個問題。

NOTE:

IoC的文章很多人寫，而且也寫的非常完整與詳細，小弟就不在這裡多述，各位可以參考以下文章:

In 91 : [Software Architecture]IoC and DI

黃忠成 : Inside ObjectBuilder Part1

什麼是CommonServiceLocator

官方網址:http://commonservicelocator.codeplex.com/

CommonServiceLocator是放在Codeplex中由Microsoft patterns & practices團隊所設計的小組件，它很輕所有的Code才一百多行，它主要的定義一些Interface，讓我們的程式是呼叫CommonServiceLocator，透過CommonServiceLocator去呼叫IoC Framework，如同中繼器一般，使我們的程式不會綁死於一同IoC Framework，而且有提供主流的IoC Framework用的Provider(就算未提供也可以自己寫)，支援非常的廣泛。

支援的IoC Framework如下:

Castle Windsor
Spring .NET
Unity
StructureMap
Autofac
MEF
LinFu

使用方式:

//泛型
//第一個Method,也是最常用的Method
ICreditCardService instance = ServiceLocator.Current.GetInstance<ICreditCardService>();

//第二個多載Method，因為一個Interface，所能有很多個Class實作，如果有設定Key，可以用Key指定要實例的Type
ICreditCardService instance = ServiceLocator.Current.GetInstance<ICreditCardService>("中國信託");

//非泛型的
ICreditCardService instance = (ICreditCardService)ServiceLocator.Current.GetInstance(typeof(ICreditCardService));

ICreditCardService instance = (ICreditCardService)ServiceLocator.Current.GetInstance(typeof(ICreditCardService), "中國信託");

//從System.IServiceProvider繼承來的，不過看了幾個Provider，GetService都只是呼叫GetInstance，所以沒什麼不同
ICreditCardService instance = (ICreditCardService)ServiceLocator.Current.GetService(typeof(ICreditCardService));

註冊Provider

//先註冊IoC的東西
ContainerBuilder builder = new ContainerBuilder();
builder.RegisterType<OrderService>().As<IOrderService>();
builder.RegisterType<中國信託CreditCardService>().Named<ICreditCardService>("中國信託");
builder.RegisterType<台北富邦CreditCardService>().Named<ICreditCardService>("台北富邦");

//最後在設定Provider
ServiceLocator.SetLocatorProvider(() => new MyServiceLocator(builder));

這裡介紹幾個常見的IoC設定方式，詳情請看官方網站的說明。

Autofac的設定

到Autofac網站下載AutofacContrib，加入參考AutofacContrib.CommonServiceLocator.dll

ContainerBuilder builder = new ContainerBuilder();
var container = builder.Build();
ServiceLocator.SetLocatorProvider(() => new AutofacServiceLocator(container));

Spring .NET的設定

下載:CommonServiceLocator.SpringAdapter.zip，加入參考CommonServiceLocator.SpringAdapter.dll

DefaultListableObjectFactory objectFactory = new DefaultListableObjectFactory(false);
objectFactory.RegisterSingleton(typeof(SimpleLogger).FullName, new SimpleLogger());
objectFactory.RegisterSingleton(typeof(AdvancedLogger).FullName, new AdvancedLogger());

ServiceLocator.SetLocatorProvider(() => new SpringServiceLocatorAdapter(objectFactory));

Unity的設定

下載:CommonServiceLocator.UnityAdapter.zip，加入參考Microsoft.Practices.Unity.ServiceLocatorAdapter.dll

IUnityContainer container = new UnityContainer()
.RegisterType<ILogger, AdvancedLogger>()
.RegisterType<ILogger, SimpleLogger>(typeof (SimpleLogger).FullName)
.RegisterType<ILogger, AdvancedLogger>(typeof (AdvancedLogger).FullName);

ServiceLocator.SetLocatorProvider(() => new UnityServiceLocator(container));
return new UnityServiceLocator(container);

StructureMap的設定

下載:CommonServiceLocator.StructureMapAdapter.zip，加入參考StructureMapAdapter.dll

Registry registry = new Registry();
registry.ForRequestedType<ILogger>().TheDefaultIsConcreteType<AdvancedLogger>();
registry.AddInstanceOf<ILogger>(new SimpleLogger()).WithName(typeof(SimpleLogger).FullName);
registry.AddInstanceOf<ILogger>(new AdvancedLogger()).WithName(typeof(AdvancedLogger).FullName);
IContainer container = new Container(registry);

ServiceLocator.SetLocatorProvider(() => new StructureMapServiceLocator(container));

本文链接

UTF8Encoding與BOM

2011-01-29T18:35:00Z

前陣子團隊中有用XmlSerializer將物件轉成XML存檔後，上傳給另一家公司，對方卻一直回報我們XML有問題，用文字編輯器看格式都很正確，但用XML的編輯器卻會出錯，發現原來是BOM害的。

用Visual Studio開啟，會出現未預期的XML宣告。XML宣告必須是文件中的第一個節點，前面不得有空白字元的錯誤訊息(如圖一)，可是怎麼看都沒有多餘的空白，後來用2進元編輯器開啟，發現檔案前多了一組BOM(Byte order mark)。

圖一用Visual Studio開啟檔案所發生的錯誤。

圖二多出的BOM。

NOTE:什麼是BOM

位元組順序記號(byte-order mark，BOM)，是Unicode存放在檔案的最前面，用來記錄讀位元組的順序，如UTF-8是EF BB BF，詳情請看:

維基百科 - 位元組順記號

維基百科 - 位元組序

這是其中的程式碼片段

var ser = new XmlSerializer(sample.GetType());
using (var memoryStream = new MemoryStream())
{
//XmlSerializer不給Encoding，其XML宣告會是UTF-16
var xmlWriter = new XmlTextWriter(memoryStream, Encoding.UTF8);

//空命名空間
XmlSerializerNamespaces xsn = new XmlSerializerNamespaces();
xsn.Add(String.Empty, String.Empty);

ser.Serialize(xmlWriter, sample, xsn);
var result = Encoding.UTF8.GetString(memoryStream.ToArray());

//do something

//把檔案存起來
File.WriteAllText(filePath, result, Encoding.UTF8);
}

會照成輸入二次BOM的原因在於第5行與第17行，同時給了UTF8Encoding，但這不是最主要的原因，出錯的主因是二個地方都使用了有BOM的UTF8Encoding，查了MSDN，UTF8Encoding在建構式時，可以指定要不要輸出BOM，而System.Text.Encoding.UTF8是使用要輸出BOM的UTF8Encoding。

圖三 MSDN的UTF8Encoding的說明。

System.Text.Encoding.UTF8的原始碼

public static Encoding UTF8
{
get
{
if (utf8Encoding == null)
{
utf8Encoding = new UTF8Encoding(true);
}
return utf8Encoding;
}
}

而System.Text.Encoding下的幾個靜態屬性UTF7、UTF8、Unicode、UTF32都是使用BOM為true的建構式，所以想不要BOM的話，請改用 new UTF8Encoding(false)。

NOTE:
我同時也看了File.WriteAllText的原始碼，其實是我們雞婆，因為File.WriteAllText的多載，其中File.WriteAllText(string path, string contents)，所用的預設Encoding就是new UTF8Encoding(false)，所以我們不指定Encoding反而沒事。

參考資料

UTF8Encoding 類別

本文链接

Temporary Post Used For Theme Detection (d4b0aefa-c88e-4957-bba7-b367d1bfa042 - 3bfe001a-32de-4114-a6b4-4005b770f6d7)

2011-01-29T18:28:00Z

This is a temporary post that was not deleted. Please delete this manually. (3cc2719a-c1ed-43a1-9fce-d2eb7cfd0299 - 3bfe001a-32de-4114-a6b4-4005b770f6d7)

本文链接

寫CodedUI時如何尋找控制項的小技巧

2010-11-25T16:42:00Z

在用CodedUI寫自動化測試時，我不喜歡用工具產生的代碼(相關資訊可參考手工製Coded UI Test(Visual Studio 2010新的UI自動化測試))，寫久了有一些經驗，例如找到控制項的一些的小技巧。

工具

尋找控制項我也是用Visual Studio 2010內建的CodedUITestBuilder.exe，不過一般的情況下CodedUITestBuilder.exe必需搭配測試專案的UIMap.uitest使用，有點麻煩，不過還好它有提供獨立執行的方法。

圖1 CodedUITestBuilder.exe的執行畫面

在CMD中下

"C:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE\CodedUITestBuilder.exe" /standAlone

多一個參數/standAlone就可以單獨執行，也加入Visual Studio的External Tools中，方便日常的呼叫。

圖二 External Tools視窗

尋找控制項

使用CodedUITestBuilder的UIMap功能，使用的方式有二種。

按下 Windows key + U，會自動選取到游標所在的控制項，適用在不方便滑鼠拖曳的情況下
滑鼠拖曳下圖紅色框中的Icon，到控制項上方

圖三拖曳用的Icon

圖四選到控制項的晝面

選擇到控制項後，會出現控制項的說明視窗，裡面有控制項的各個屬性值與階層，可以用來做為寫CodedUI的搜尋條件。

圖五控制項的說明視窗

像Name=q，Code就可以這樣寫

//假設已經開啟了IE且網址在www.google.com上
BrowserWindow window = BrowserWindow.Locate("Google");

HtmlEdit input = new HtmlEdit(window);
input.SearchProperties[HtmlEdit.PropertyNames.Name] = "q";
input.Text = "黃偉榮";

圖六控制項視窗的屬性值，都可以做為搜尋條件

階層問題

之前有遇到問題，條件都下對，就是找不到控制項，後來發現可能是階層問題，可以試著一層一層的去找到控制項。

圖七控制項都可以將父視窗傳進去，然後可以只搜尋子控制項

NOTE:
如果嘗試幾次都失敗，可以叫出產生器，去看產生的CodedUI是如何去找到控制項。

本文链接

Visual Studio 2010 Feature Packs 2之Silverlight自動化測試

2010-11-25T16:38:00Z

在Visual Studio 2010上市沒多久後，很高興它推出了Coded UI的自動化測試，那時我的專案是跑Silverlight，要錄制時出現不支援的錯誤，只好又乖乖的自己當人工測試機，不過前幾天看到微軟推出Visual Studio 2010 Feature Packs 2套件，其中有一項功能是Create coded UI tests for Silverlight 4 applications，就興高彩烈安裝玩一翻。

NOTE:

在2010/11/23日，截筆前Visual Studio 2010 Feature Packs 2必需要MSDN Subscribers才能下載，什麼沒有MSDN Subscribers，這我也辦法，只能期待微軟把這功能加到Visual Studio 2010 SP1中，或看沒有沒人分享吧。

Visual Studio 2010 Feature Packs 2的新功能(僅介紹測試)

Coded UI與Test Manager的動作錄制與執行支援Silverlight。
Coded UI與Test Manager的動作錄制與執行支援Firefox 3.5、3.6。
Coded UI編輯器。

Silverlight自動化測試

要Silverlight可以自動化測試還有點麻煩，有三個條件。

Host只支援IE。
必需要Silverlight 4.0以上。
必需要加入參考Microsoft.VisualStudio.TestTools.UITest.Extension.SilverlightUIAutomationHelper.dll組件。

Microsoft.VisualStudio.TestTools.UITest.Extension.SilverlightUIAutomationHelper.dll

安裝好Visual Studio 2010 Feature Packs 2後組件的位址預設在:

C:\Program Files (x86)\Common Files\microsoft shared\VSTT\10.0\UITestExtensionPackages\SilverlightUIAutomationHelper\Microsoft.VisualStudio.TestTools.UITest.Extension.SilverlightUIAutomationHelper.dll

但專案不可以一直都掛載組件，組件的下載的流量與或安全性問題，每次要上線前都要刪除組件，或每次要測試時都加入這個組件，會很煩吧，所以可以從MSBuild下手，打開Project檔如*.csproj，打開後找到

加上Condition=" '$(Configuration)' == 'Debug' "，讓組件只有在Debug的模式下才被參考，Release時不會，加入後的結果如下。

NOTE:
其實有點不懂為什麼MSDN中的文件How to: Set Up Your Silverlight Application for Testing，MSBuild要寫的那麼麻煩，要自訂Property，每一次切換還要打開專案檔，切換Property。

範例

下載

<Grid x:Name="LayoutRoot">
<RadioButton Content="紅色" Height="16" Margin="12,14,22,270" Name="RBRed" Background="Red" Click="OnColorButtomClick" />
<RadioButton Content="綠色" Height="16" Margin="12,51,22,233" Name="RBGreen" Background="Green" Click="OnColorButtomClick" />
<RadioButton Content="藍色" Height="16" Margin="12,32,22,252" Name="RBBlue" Background="Blue" Click="OnColorButtomClick" />
</Grid>public partial class MainPage : UserControl
{
public MainPage()
{
InitializeComponent();
}

private void OnColorButtomClick(object sender, RoutedEventArgs e)
{
this.LayoutRoot.Background = (sender as Control).Background;
}
}

範例很簡單只是三個RadioButton，被Click時切換背景色，錄制RadioButton的切換，選擇Silverlight中綠色的RadioButton，驗證Selected是否為真，工具的可驗證的屬性有點少，不過事實上是工具尚未支援，用Code寫幾乎所有的屬性都可以取得，可參考手工製Coded UI Test(Visual Studio 2010新的UI自動化測試)。

圖一選取Silverlight的Control並加入Assertion

如果沒有加入組件會出現圖二的錯誤訊息，所以改用Release模式Build，組件是沒加入的。

圖二沒有加入組件的錯誤訊息

終於有編輯器了，以前錄好了想改不是改XML(誰會改阿)，就是重錄，現在小變動下，可以用編輯器微調。

圖三 Coded UI Editor

參考

Visual Studio 2010 Feature Packs 2

本文链接

Moles - Isolation framework for .NET(假.Net)介紹

2010-11-25T16:37:00Z

Moles是前陣子91大推薦我用的Mock的Framework，它跟Moq與Rhino.Mocks這類的套件不同，Moq與Rhino.Mocks這類的Mock是對Interface或Abstract Class做Mock，而Moles是Mock整個CLR(Common Language Runtime)，破除Moq等Mock套件的限制，非Interface或Abstract Class也可以Mock，而且還可以對Static Method來Mock，如DateTime.Now或File.Open等等Static Method，使原本在開發時不用為了方便測試而過度設計(如小弟之前為了方便測試，把DateTime又加了一層DateTimeProvider，當我看到這Framework後，就覺得我之前的作法非常的無聊，可參考Unit Test小技巧 : DateTime的Stub)。

•什麼是Mock

Mock簡單來說就是作一個假的東西，通常用在單元測試，因為寫單元測試時，難免沒辦法抽的很乾淨，多少會呼叫到別的Method，如寫訂單的處理，其中有呼叫到信用卡API，在寫單元測試不需要也盡可能不要呼叫到信用卡API，所以用Mock把信用卡API變成假的信用卡API，讓訂單的測試可以獨立，Mock的用法與概念當然不只這樣，詳情可以參考:

Will保哥的ASP.NET MVC 單元測試系列
In 91的測試系列

NOTE:

Mock與Stub都是用來作假物件，只是二個有實作上的差異，簡單來說，Mock是用動態產生的(如用Moq產生)，Stub是已經寫好的(如為了測試實作一個Interface)，本文統一都叫作Mock，雖然Moles感覺比較像Stub。

•Moq與Moles比較

Moq的Mock原理是動態產生Class，所以它才只能對Interface或Abstract Class，這類可繼承的型別，如對Interface就是動態產生一個實作Interface所有成員的Class，在用Setup來指定成員的內容或回傳值，多半會搭配IoC，讓程式在呼叫其他類別時，改為呼叫Mock的程式。

NOTE:

大部分Mock的Framework如Moq與Rhino Mocks的底層都是使用Castle DynamicProxy，來動態產生Class。

Moles的Mock原理是，在CLR上在建立一個自己的Runtime，測試時是在MoleRuntime上執行，所以原本是直接呼叫如DateTime.Now，改為呼叫Mock的程式。

圖一 MoleRuntime的假想圖

Moq與Moles都有適合的使用時機與限制，可參考圖二。

圖二使用Mole與一般Mock的差異來源:Microsoft Moles Reference Manual

•安裝Moles

Moles

Visual Studio 2010 Moles - Isolation Framework for .NET(x86)

Visual Studio 2010 Moles - Isolation Framework for .NET(x64)

Pex And Moles

Pex - Automated Whitebox Testing for .NET(x86)

x64版目前只在MSDN Suscribers中下載

NOTE:

Pex是一個Code的分析工具，可以產生相關的單元測試，都是同一個團隊開發，他們把二套Framework綁在一起，個人試用的結果，很有趣，但實用性不高。

•實作DateTime.Now的Mock

1.新增測試專案

2.在測試專案中的參考上按右鍵，選Add Moles Assembly for mscorlib，產生mscorlib.moles檔

圖三新增mscorlib.moles檔

當專案中有.moles檔時，編譯會產生其對應的組件

圖四 mscorlib.moles檔與其對應的組件

NOTE:

在舊版的Moles中，mscorlib.moles檔的新增是在新增項目時自行輸入組件名稱，新版直接在參考中右鍵新增*.moles，方便很多。

圖五新增.moles已取消從新增項目中新增的方式，因為找不到圖了借用程湘大的圖片一用。

mscorlib是.Net Framework是最基本的函式庫，俗稱Base Class Library(BCL)，也就是把專案中的所有參考都刪除，剩下可以用的型別就是在mscorlib.dll中的型別，DateTime也是其一，而所有不同類型專案的mscorlib.dll一定都相同，如WebApplication與Silverlight的mscorlib.dll是一致的(這小弟我沒記錯是這樣，如果說錯了請見諒)。

如果想要Mock其他組件在其他組件上按右鍵新增該組件的.moles檔。

圖六新增其他Moles組件

3.於TestMethod中撰寫DateTime的測試，且Mock DateTime並驗證。

[TestMethod]
[HostType("Moles")]
public void TestMethod1()
{
System.Moles.MDateTime.NowGet = () => { return new DateTime(2010, 1, 1); };

Assert.AreEqual(new DateTime(2010, 1, 1), DateTime.Now);
}

在TestMethod上增加[HostType("Moles")]，讓Visual Studio知道這一個TestMethod，是要用MoleRuntime執行，Mock的方式是用Delegate，如圖四Moles會建立mscorlib的Mock用組件，其邏輯如下:

Namespace:最後加上Moles
Type:在前加上M
Property:後方加上Get或Set
Method:後方加上參數的型別
Instance:在AllInstances下操作

所以System.DateTime.Now的Mock在System.Moles.MDateTime.NowGet，範例中DateTime.Now就改為Mock的值，而不是現在時間。

4.增加MoledType宣告。

[assembly: Microsoft.Moles.Framework.MoledType(typeof(DateTime))]

在檔案的最上方或AssemblyInfo.cs中加上MoledType的宣告，每一個要Mock的Type都要增加。

5.執行測試，並通過測試。

•已知問題

我在使用Moles版本0.94.51023.0時，有遇到一個問題，就是MoleRuntime無法正確取得測試專案的app.config，我也有在MSDN中詢問別人，得知的訊息是Bug，可參考Can't get data via ConfigurationManager.AppSettings on HostType("Moles")，但山不轉路轉，聰明的方法沒有，笨死人的解決方法到有，MoleRuntime只會抓自己的app.config，所以只要將資料寫在MoleRuntime的app.config中測試時就可以正常讀取資料，只是設定就沒辦法很方便的xCopy，且會所有專案共用一個app.config，最後我只想到切換專案時，手動更換檔案。

圖七各測試專案需要的app.config

Moles的執行檔案路徑在
C:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE\PrivateAssemblies\Microsoft.Moles.VsHost.x86.exe

•其他範例

//測試時只用一組固定的Guid
System.Moles.MGuid.NewGuid = () =>
{
return new Guid("FFEB1621-5016-4F28-94AE-5DB72FC8A23B");
};

//測試時不需要真的讀實體檔案
System.IO.Moles.MFile.ReadAllTextString = (filePath) =>
{
return "測試內容";
};

System.Net.Mail.Moles.MSmtpClient.AllInstances.SendMailMessage = (smtp, message) =>
{
//測試時不真的寄Email
};

•參考資料

Moles - Isolation framework for .NET

程湘之間 - 單元測試(7): 使用 Moles 增加可測試性

Moq

Rhino.Mocks

本文链接

[小技巧]Entity Framework強型別Include

2010-10-20T14:00:00Z

在Entity Framework中如果不設定為Lazy Loading Enable=true，勢必要自己處理關聯資料的載入，如:用Load或Include的，但因為Include的參數是用string，個人很討厭沒有IntelliSense，且用String改了TableName後，工具不易找到錯誤，所以小弟我寫一個Extension Method來擴展。

//原弱型別的寫法
AdventureWorksLT2008R2Entities context = new AdventureWorksLT2008R2Entities();
var customer = context.Customer.Include("SalesOrderHeader").ToList();

//擴展的強型別寫法
AdventureWorksLT2008R2Entities context = new AdventureWorksLT2008R2Entities();
var customer = context.Customer.Include(x => x.SalesOrderHeader).ToList();

NOTE:
這個方法暫時不適用Collection後又在關聯，如上一個例子SalesOrderHeader是Collection，無法這樣下x.SalesOrderHeader.SalesOrderDetail，為什麼是暫時，因為小弟還沒想出好的寫法，用x.SalesOrderHeader[0].SalesOrderDetail或x.SalesOrderHeader.First().SalesOrderDetail嗎，感覺挺醜的。

Source Code

public static IQueryable<T> Include<T>(this ObjectSet<T> source, Expression<Func<T, object>> path) where T : class
{
//偷吃步的作法，如:Expression為x=>x.Customer.CustomerAddress,ToString後直接從第一個.分割，取後面的Customer.CustomerAddress
string spath = path.Body.ToString();
spath = spath.Substring(spath.IndexOf('.') + 1);
return source.Include(spath);
}

上面的Code比較偷懶，應該要分析一下Expression比較正統

public static IQueryable<T> Include<T>(this ObjectSet<T> source, Expression<Func<T, object>> path) where T : class
{
StringBuilder pathBuilder = new StringBuilder();

MemberExpression pro = path.Body as MemberExpression;
while (pro != null)
{
//Exprssion有點像鏈結串列，從Statemant的後方往前連結，如: x=> x.Customer.CustomerAddress
//path.Body是CustomerAddress
//CustomerAddress的Expression是Customer
//Customer的Expression是x
pathBuilder.Insert(0, "." + pro.Member.Name);
pro = pro.Expression as MemberExpression;
}

return source.Include(pathBuilder.ToString(1, pathBuilder.Length-1));
}

NOTE:
我沒有做錯誤檢查，想說有錯Entity Framework也會丟Exception，自己就不多事了。

圖1 Model關聯圖

本文链接

C#仿Oracle Decode，將ValueType對應成String

2010-10-20T13:59:00Z

在寫Page，有時會有int、bool等等要轉成文字輸出，如: <%: item.Enable ? "啟用" : "停用" %>，用? : 處理雖然方便，但如果要轉換的String加上二個以上，就非常難處理，可是Page的這三個<%: %>、<%= %>、<%# %>語法，不能用if或switch，因為有用過Oracle，很喜歡它的Decode函式，所以我就自己寫一組Extension Method來處理。

使用範例

<%--item.State的Type是int--%>
<%: item.State.Decode("未知","無法使用","等待執行","就緒","執行中") %>

<%--item.Enable的Type是bool?--%>
<%: item.Enable.Decode("停用","啟用","未設定") %>

<%--item.Enable的Type是int,但值不連續--%>
<%: item.State.Decode(new Dictionary<int, string> {{100,"處理中"}, {200,"成功"}, {300,"失敗"} })%>

程式說明

我的Extension Method對像是用ValueType，為什麼用ValueType呢?，因為ValueType是bool、int、long、float甚至enum的基類(也就是C#中的struct)，這樣就有多型的效果，程式也可以少寫一點，然後我也有寫Nullable的對應，當是null時會對應到預設Meaage，又因為值可能是不連續的，如:100、200、300，不是0、1、2，所以總共有四個多載。

如果值是連續的可以使用這二個Method

public static string Decode(this ValueType value, params string[] messages)
{
//大部分的ValueType都可以轉成int
int key = Convert.ToInt32(value);

//不在Array範圍中的用最後一個Message
if (key >= messages.Length || key < 0)
{
return messages.LastOrDefault();
}

return messages[key];
}

public static string Decode<T>(this Nullable<T> value, params string[] messages) where T : struct
{
if (value.HasValue)
{
return Decode(value.Value, messages);
}
else
{
//沒有值就用最後一個Message
return messages.LastOrDefault();
}
}

如果值不是連續的可以使用這二個Method

public static string Decode(this ValueType value, IDictionary<int, string> messages, string defaultMessage = null)
{
//大部分的ValueType都可以轉成int
int key = Convert.ToInt32(value);

//判斷有沒有Key
if (messages.ContainsKey(key))
{
return messages[key];
}
else
{
//有預設message用預設message，沒預設message用最後一個message
if (defaultMessage == null)
{
return messages.Values.LastOrDefault();
}
else
{
return defaultMessage;
}
}
}

public static string Decode<T>(this Nullable<T> value, IDictionary<int, string> messages, string defaultMessage = null) where T : struct
{
if (value.HasValue)
{
return Decode(value.Value, messages);
}
else
{
//沒有值就用最後一個Message
if (defaultMessage == null)
{
return messages.Values.LastOrDefault();
}
else
{
return defaultMessage;
}
}
}

NOTE:
我有想過把不連續的Method，this的Type改成object，讓所有object都可以使用，不過我剛好都沒有像A、B、C要對應成其他文字的需求，如果你有需要在自行修改吧。

測試案例

enum TestEnum
{
AA,
BB,
CC,
DD
}

[TestMethod, Owner("Wade")]
public void U__DecodeExtension_Decode()
{
var defaultMessage = "Test";
var message1 = new string[] { "A", "B", "C", "D" };
var message2 = new Dictionary<int, string> { { 10, "A" }, { 20, "B" }, { 30, "C" }, { 40, "D" } };

Assert.AreEqual("B", true.Decode(message1));
Assert.AreEqual("A", false.Decode(message1));
Assert.AreEqual("A", 0.Decode(message1));
Assert.AreEqual("B", 1.Decode(message1));
Assert.AreEqual("D", 4.Decode(message1));
Assert.AreEqual("D", (-1).Decode(message1));
Assert.AreEqual("B", ((byte)1).Decode(message1));
Assert.AreEqual("D", 10.Decode(message1));
Assert.AreEqual("D", (10f).Decode(message1));
Assert.AreEqual("B", (1L).Decode(message1));
Assert.AreEqual("A", (0L).Decode(message1));
Assert.AreEqual("A", TestEnum.AA.Decode(message1));
Assert.AreEqual("B", TestEnum.BB.Decode(message1));

Assert.AreEqual("D", true.Decode(message2));
Assert.AreEqual("D", false.Decode(message2));
Assert.AreEqual("A", 10.Decode(message2));
Assert.AreEqual("B", 20.Decode(message2));
Assert.AreEqual("D", 40.Decode(message2));
Assert.AreEqual("D", (-1).Decode(message2));
Assert.AreEqual("A", (10f).Decode(message2));

Assert.AreEqual("Test", true.Decode(message2, defaultMessage));
Assert.AreEqual("Test", false.Decode(message2, defaultMessage));
Assert.AreEqual("A", 10.Decode(message2, defaultMessage));
Assert.AreEqual("B", 20.Decode(message2, defaultMessage));
Assert.AreEqual("D", 40.Decode(message2, defaultMessage));
Assert.AreEqual("Test", (-1).Decode(message2, defaultMessage));
Assert.AreEqual("A", ((byte)10).Decode(message2, defaultMessage));
Assert.AreEqual("A", (10f).Decode(message2, defaultMessage));

Assert.AreEqual("D", (new Nullable<int>()).Decode(message1));
Assert.AreEqual("A", (new Nullable<int>(0)).Decode(message1));
Assert.AreEqual("D", (new Nullable<bool>()).Decode(message1));
Assert.AreEqual("B", (new Nullable<bool>(true)).Decode(message1));

Assert.AreEqual("D", (new Nullable<int>()).Decode(message2));
Assert.AreEqual("A", (new Nullable<int>(10)).Decode(message2));
Assert.AreEqual("D", (new Nullable<int>(40)).Decode(message2));

}

原始碼下載

參考資料

Value Types (C# Reference)

本文链接

Visual Studio 單元測試的3種Initialize與Cleanup

2010-10-20T13:58:00Z

Visual Stuido的單元測試有3種Initialize與Cleanup，讓開發測試時，可以在TestMethod執行前做一些初始化，結束後做一些清除，而這3種Initialize與Cleanup各針對了不同時期，如:我猜鮮少人知道的Assembly的Initialize與Cleanup，是在一個測試專案的所有TestMethod執行前呼叫Initialize，與一個測試專案所有TestMethod結束後呼叫Cleanup。

AssemblyInitialize與AssemblyCleanup

在一個測試專案的所有TestMethod執行前呼叫Initialize，與一個測試專案的所有測TestMethod結束後呼叫Cleanup，而一個測試專案中，只能有一個AssemblyInitialize與AssemblyCleanup，且只執行一次，通常用在整個專案都要使用情況，如:資料庫的掛載與卸除。

//包AssemblyInitialize與AssemblyCleanup的Class，一定要有TestClass，而是不是static無所謂
[TestClass]
public /*static*/ class TestHelper
{
//Method名稱可以隨便打，但一定要是static，且有一個參數context
[AssemblyInitialize]
public static void AssemblyInitialize(TestContext context)
{
//一個測試專案的最初始化
}

//Method名稱可以隨便打，但一定要是static
[AssemblyCleanup]
public static void AssemblyCleanup()
{
//一個測試專案的結束
}
}

NOTE:
如果有二個測試專案
TestProjectA有
----AssemblyInitializeA
----AssemblyCleanupA
----Test1
----Test3
TestProjectB有
----AssemblyInitializeB
----AssemblyCleanupB
----Test2

因為執行測試的順序可以依名稱排序，所以照Test1、Test2、Test3執行，呼叫執行的順序為
----AssemblyInitializeA
----Test1
----AssemblyInitializeB
----Test2
----Test3
----AssemblyCleanupA
----AssemblyCleanupB
同時間如果有多個測試專案，要注意可能會交叉執行Initialize。

ClassInitialize與ClassCleanup

在執行一個TestClass下的所有TestMethod執行前與執行後呼叫，而每一個TestClass只能有一個ClassInitialize與ClassCleanup，每一個TestClass只呼叫一次，已在Visual Studio在單元測試檔案的範本中，只要拿掉註解就可以使用。

[TestClass]
public class ProgramTest
{
..........

//在Test1與Test2執行前呼叫，Method名稱可以隨便打，但一定要是static，且有一個參數context
[ClassInitialize]
public static void ClassInitialize(TestContext testContext)
{
..........
}

//在Test1與Test2執行後呼叫，Method名稱可以隨便打，但一定要是static
[ClassCleanup]
public static void ClassCleanup()
{
..........
}

..........

[TestMethod]
public void Test1()
{
..........
}

[TestMethod]
public void Test2()
{
..........
}
}

NOTE:
也有交叉執行Initialize問題。

TestInitialize與TestCleanup

在一個TestClass下的TestMethod，每一次執行前與呼叫後呼叫，而每一個TestClass只能有一個TestInitialize與TestCleanup，每一個TestMethod只呼叫一次，已在Visual Studio在單元測試檔案的範本中，只要拿掉註解就可以使用，可以將每一個TestMethod通用的初始化與清除，寫在這裡。

[TestClass]
public class ProgramTest
{
..........

//在Test1或Test2執行前呼叫，Method名稱可以隨便打，但一定要是static
[TestInitialize]
public static void TestInitialize()
{
..........
}

//在Test1或Test2執行後呼叫，Method名稱可以隨便打，但一定要是static
[ClassCleanup]
public static void TestCleanup()
{
..........
}

..........

[TestMethod]
public void Test1()
{
..........
}

[TestMethod]
public void Test2()
{
..........
}
}

參考資料

[MSDN]單元測試架構

本文链接