程序博客网 > 调查数据网

Inside ObjectBuilder Part 2

来源：互联网 发布：调查数据网 编辑：程序博客网 时间：2024/05/17 02:30
2006年09月25日 20:39:00

Object Builder Application Block
文/黃忠成
2006/9/21

三、ObjectBuilder Application Block
ObjectBuilder一開始出現於Microsoft所提出的Composite UI Application Block，主司物件的建立及釋放工作，她實現了本文前面所提及的Dependency Injection概念，同時在架構上提供了高度的延展性。運用ObjectBuilder來建立物件，設計師可以透過程式或組態檔，對物件建立與釋放的流程進行細部的調整，例如改變物件建立時所呼叫的Constructor(建構子)，調整傳入的參數，於物件建立後呼叫特定函式等等。鑑於ObjectBuilder的功能逐漸完整，加上社群對於Dependency Injection實作體的強烈需求，Microsoft正式將ObjectBuilder納入Enterprise Library 2006中，並修改Caching、Logger、Security、Data Access等Application Block的底層，令其於ObjectBuilder整合，以此增加這些Application Block的延展性。就官方文件的說明，ObjectBuilder Application Block提供以下的功能。
表1
l 允許要求一個抽象物件或介面，ObjectBuilder會依據程式或組態檔的設定，傳回一個實體物件。
l 回傳一個既存物件，或是每次回傳一個新的物件(多半用於Dependency、Singleton情況，稍後會有詳細說明)。
l 透過特定的Factory建立一個物件，這個Factory可以依據組態檔的設定來建立物件(CustomFactory，隸屬於Enterprise Common Library)。
l 當物件擁有一個以上的建構子時，依據已有的參數，自動選取相容的建構子來建立要求的物件。(Consturctor Injection)
l 允許物件於建立後，透過程式或組態檔來賦值至屬性，或是呼叫特定的函式。(Setter Injection、Interface Injection)
l 提供一組Attribute，讓設計師可以指定需要Injection的屬性，亦或是於物件建立後需要呼叫的函式，也就是使用Reflection來自動完成Injection動作。
l 提供IBuilerAware介面，實作此介面的物件，ObjectBuilder會於建立該物件後，呼叫OnBuildUp或是OnTearDown函式。
l 提供TearDown機制，按建立物件的流程，反向釋放物件。
對於多數讀者來說，這些官方說明相當的隱誨，本文嘗試由架構角度切入，討論ObjectBuidler的主要核心概念，再透過實作讓讀者們了解，該如何使用ObjectBuidler。
3-1、The Architecture of Object Builder
圖2
圖2是ObjectBuilder中四個主要核心物件的示意圖，BuidlerContext是一個概念型的環境物件，在這個物件中，包含著一組Strategys物件，一組Polices物件，一個Locator物件， ObjectBuidler採用Strategys Pipeline(策略流)概念，設計師必須透過Strategy串列來建立物件，而Strategy會透過Polices來尋找『型別/id』對應的Policy物件，使用她來協助建立指定的物件。此處有一個必須特別提出來討論的概念，Strategy在架構上是與型別無關的，每個BuidlerContext會擁有一群Strategys物件，我們透過這個Strategys物件來建立任何型別的物件，不管建立的物件型別為何，都會通過這個Strategys Pipeline。這意味著，當我們希望於建立A型別物件後呼叫函式A1，於建立B型別物件後呼叫函式 B1時，負責呼叫函式的Strategy物件會需要一個機制來判別該呼叫那個函式，那就是Policy物件，BuilderContext中擁有一個Polices物件，其中存放著與『型別/id』對應的Policy物件，如圖3所示。
圖3
值得一提的是，Policy是以Type/id方式，也就是『型別/id』方式來存放，這種做法不只可以讓不同型別擁有各自的Policy，也允許同型別但不同id擁有各自的Policy。ObjectBuilder中的最後一個元素是Locator，Locator物件在ObjectBuidler中扮演著前述的Service Locator角色，設計師可以用Key/Value的方式，將物件推入Locator中，稍後再以Key值來取出使用。
3-2、Strategys
ObjectBuilder內建了許多Strategy，這些Strategy可以大略分成四種類型，如圖4。
圖4
Pre-Creation Strategy
Pre-Creation意指物件被建立前的初始動作，參與此階段的Strategy有：TypeMappingStrategy、PropertyReflectionStrategy、ConstructorReflectionStrategy、MethodReflectionStrategy及SingletonStrategy，稍後我們會一一檢視她們。
Creation Strategy
Creation類型的Strategy主要工作在於建立物件，她會利用Pre-Creation Strategys所準備的參數來建立物件，ObjectBuilder就是運用Pre-Creation的ConstructorReflectionStrategy及CreationStrategy來完成Constructor Injection動作。
Initialization Strategy
當物件建立後，會進入初始化階段，這就是Initialization Strategy階段，在此階段中，PropertySetterStrategy會與PropertyReflectionStrategy合作，完成Setter Injection。而MethodExecutionStrategy則會與MethodReflectionStrategy合作，在物件建立後，呼叫特定的函式，也就是Method Injection(視使用方式，Interface Injection是以此種方式完成的)。
Post-Initialization Strategy
在物件建立並完成初始化動作後，就進入了Post-Initialization Strategy階段，在此階段中，BuilderAwareStrategy會探詢已建立的物件是否實作了IBuilderAware介面，是的話就呼叫IBuilderAware.OnBuildUp函式。
關於物件釋放
先前曾經提過，ObjectBuidler在建立物件時，會一一呼叫所有Strategy來建立物件，同樣的！當釋放物件時，ObjectBuilder也會進行同樣的動作，不過方向是相反的，在內建的Strategy中，只有BuilderAwareStrategy會參與物件釋放的動作，在物件釋放時，BuilderAwareStrategy會探詢欲釋放的物件是否實作了IBuidlerAware介面，是的話就呼叫IBuidlerAware.OnTearDown函式。
3-3、A Simple Application
再怎麼詳細的說明，少了一個實例就很難讓人理解，本節以一個簡單的ObjectBuidler應用實例開始，一步步帶領讀者進入ObjectBuilder的世界。
程式10
using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.Practices.ObjectBuilder;
namespace SimpleApp
{
class Program
{
static void Main(string[] args)
{
Builder builder = new Builder();
TestObject obj = builder.BuildUp>TestObject<(new Locator(), null, null);
obj.SayHello();
Console.ReadLine();
}
}
public class TestObject
{
public void SayHello()
{
Console.WriteLine("TEST");
}
}
}
這是一個相當陽春的例子，在程式一開始時建立了一個Builder物件，她是ObjectBuilder所提供的Facade物件，其會預先建立一般常用的Strategy串列，並於BuilderUp函式被呼叫時，建立一個BuilderContext物件，並將Srategy串列及Polices串列指定給該BuilderContext，然後進行物件的建立工作。
How Object Creating
要了解前面的例子中，TestObject物件究竟是如何被建立起來的，首先必須深入Builder物件的建構動作。
private StrategyList>TStageEnum< strategies = new StrategyList>TStageEnum<();
public BuilderBase()
{
}
public PolicyList Policies
{
get { return policies; }
}
public StrategyList>TStageEnum< Strategies
{
get { return strategies; }
}
public Builder(IBuilderConfigurator>BuilderStage< configurator)
{
Strategies.AddNew>TypeMappingStrategy<(BuilderStage.PreCreation);
Strategies.AddNew>SingletonStrategy<(BuilderStage.PreCreation);
Strategies.AddNew>ConstructorReflectionStrategy<(BuilderStage.PreCreation);
Strategies.AddNew>PropertyReflectionStrategy<(BuilderStage.PreCreation);
Strategies.AddNew>MethodReflectionStrategy<(BuilderStage.PreCreation);
Strategies.AddNew>CreationStrategy<(BuilderStage.Creation);
Strategies.AddNew>PropertySetterStrategy<(BuilderStage.Initialization);
Strategies.AddNew>MethodExecutionStrategy<(BuilderStage.Initialization);
Strategies.AddNew>BuilderAwareStrategy<(BuilderStage.PostInitialization);
Policies.SetDefault>ICreationPolicy<(new DefaultCreationPolicy());
if (configurator != null)
configurator.ApplyConfiguration(this);
}
當Buidler物件被建立時，其建構子會將前面所提及的幾個Strategys加到Strategies這個StrategyList Collection物件中，待BuildUp函式被呼叫時指定給新建立的BuilderContext物件。
public TTypeToBuild BuildUp>TTypeToBuild<(IReadWriteLocator locator,
string idToBuild, object existing, params PolicyList[] transientPolicies)
{
return (TTypeToBuild)BuildUp(locator, typeof(TTypeToBuild), idToBuild, existing, transientPolicies);
}
public virtual object BuildUp(IReadWriteLocator locator, Type typeToBuild,
string idToBuild, object existing, params PolicyList[] transientPolicies)
{
....................
return DoBuildUp(locator, typeToBuild, idToBuild, existing, transientPolicies);
...................
}
private object DoBuildUp(IReadWriteLocator locator, Type typeToBuild, string idToBuild, object existing,
PolicyList[] transientPolicies)
{
IBuilderStrategyChain chain = strategies.MakeStrategyChain();
..............
IBuilderContext context = MakeContext(chain, locator, transientPolicies);
..........................
object result = chain.Head.BuildUp(context, typeToBuild, existing, idToBuild);
.......................
}
private IBuilderContext MakeContext(IBuilderStrategyChain chain,
IReadWriteLocator locator, params PolicyList[] transientPolicies)
{
.............
return new BuilderContext(chain, locator, policies);
}
當Builder的泛型函式BuildUp函式被呼叫後，其會呼叫非泛型的BuildUp函式，該函式會呼叫DoBuildUp函式，此處會透過strategies(先前於Builder建構子時初始化的StrategyList物件)來取得Strategys串列，並指定給稍後由MakeContext函式建立的BuilderContext，最後呼叫Strategy串列中第一個Strategy的BuildUp函式來進行物件的建立動作。在這一連串的動作中，我們可以釐清幾個容易令人混淆的設計，第一！我們是透過Strategy串列，也就是IBuidlerStrategyChain.Head.BuildUp來建立物件，這個Head屬性就是Strategy串列中的第一個Strategy。第二！BuilderContext的作用在於，於呼叫各個Strategy.BuildUp函式時，給予她們存取此次建立動作所使用的Strategys及Policies等物件的機會。
Policy物件的用途
現在，我們弄清楚了Strategy的用途，BuilderContext的真正涵意，但還有兩個元素尚未釐清，其中之一就是Policy物件，前面曾經稍微提過，Strategy是與型別無關的設計概念，因此為了針對不同型別做個別的處理，我們需要另一個與型別相關的設計，那就是Policy物件，要確認這點，必須重返Builder的建構子。
public Builder(IBuilderConfigurator>BuilderStage< configurator)
{
..................
Policies.SetDefault>ICreationPolicy<(new DefaultCreationPolicy());
.................
}
這裡呼叫了Policies的SetDefault函式，Policies是一個PolicyList物件，其提供了推入(Set、SetDefault)及取出(Get)函式，允許設計者針對所有『型別/id』及特定『型別/id』指定對應的IBuilderPolicy物件，那這有什麼用呢？這個問題可以由CreationStrategy類別中的以下這段程式碼來回答。
public override object BuildUp(IBuilderContext context, Type typeToBuild, object existing, string idToBuild)
{
if (existing != null)
BuildUpExistingObject(context, typeToBuild, existing, idToBuild);
else
existing = BuildUpNewObject(context, typeToBuild, existing, idToBuild);
return base.BuildUp(context, typeToBuild, existing, idToBuild);
}
[SecurityPermission(SecurityAction.Demand, Flags = SecurityPermissionFlag.SerializationFormatter)]
private object BuildUpNewObject(IBuilderContext context, Type typeToBuild,
object existing, string idToBuild)
{
ICreationPolicy policy = context.Policies.Get>ICreationPolicy<(typeToBuild, idToBuild);
.........................
InitializeObject(context, existing, idToBuild, policy);
return existing;
}
private void InitializeObject(IBuilderContext context, object existing, string id, ICreationPolicy policy)
{
................
ConstructorInfo constructor = policy.SelectConstructor(context, type, id);
...................
object[] parms = policy.GetParameters(context, type, id, constructor);
...............
method.Invoke(existing, parms);
}
如你所見，CreationStrategy於建立物件時，會由Policies中取出『型別/id』對應的ICreationPolicy物件，接著利用她來取得ConstructorInfo(建構子函式)，再以GetParameters函式來取得建構子所需的參數，最後呼叫此建構子。這段程式碼告訴我們Policy的真正用途，就是用來協助Strategy於不同『型別/id』物件建立時，採取不同的動作，這也就是說，Strategy與Policy通常是成對出現的。
Locator
最後一個尚未釐清的關鍵元素是Locator，我們於呼叫Builder的BuildUp函式時，建立了一個Locator物件並傳入該函式，這是用來做什麼的呢？在ObjectBuilder中，Locator扮演兩種角色，第一個角色是提供一個物件容器供Strategy使用，這點可以透過以下程式了解。
public class SingletonStrategy : BuilderStrategy
{
public override object BuildUp(IBuilderContext context, Type typeToBuild,
object existing, string idToBuild)
{
DependencyResolutionLocatorKey key = new DependencyResolutionLocatorKey(
typeToBuild, idToBuild);
if (context.Locator != null && context.Locator.Contains(key, SearchMode.Local))
{
TraceBuildUp(context, typeToBuild, idToBuild, "");
return context.Locator.Get(key);
}
return base.BuildUp(context, typeToBuild, existing, idToBuild);
}
}
SingletonStrategy是一個用來維持某一個物件只能有一份實體存在，當此Strategy被喚起時，其會先至Locator尋找目前要求的物件是否已被建立，是的話就取出該物件並傳回。Locator同時也可以作為一個Service Locator，這點可以由以下程式碼來驗證。
locator.Add("Test",new TestObject());
.............
TestObject obj = locator.Get>TestObject<("Test");
當然，這種手法有一個問題，那就是TestObject物件是預先建立後放在Locator中，這並不是一個好的設計，後面的章節我們會提出將Service Locator與Dependency Injection整合的手法。
PS:ObjectBuidler的Locator離完善的Service Locator還有段距離。
四、Dependency Injection With ObjectBuilder
ObjectBuilder支援Dependency Injection中定義的三種Injection模式，本章將一一介紹如何運用ObjectBuilder來實現。
4-1、Constructor Injection
Constructor Injection的精神在於使用建構子來進行注入動作，本節延用InputAccept的例子，程式11是改採ObjectBuilder進行Constructor Injection的例子。
程式11
using System;
using System.Collections.Generic;
using System.Text;
using System.Configuration;
using Microsoft.Practices.ObjectBuilder;
using Microsoft.Practices.EnterpriseLibrary.Common.Configuration.ObjectBuilder;
using Microsoft.Practices.EnterpriseLibrary.Common.Configuration;
namespace OB_ConstructorInjectionTest
{
class Program
{
static void UseValueParameter(MyBuilderContext context)
{
ConstructorPolicy creationPolicy = new ConstructorPolicy();
creationPolicy.AddParameter(new ValueParameter(typeof(IDataProcessor),
new PromptDataProcessor()));
context.Policies.Set>ICreationPolicy<(creationPolicy, typeof(InputAccept), null);
}
static void Main(string[] args)
{
MyBuilderContext context = new MyBuilderContext(new Locator());
context.InnerChain.Add(new CreationStrategy());
UseValueParameter(context);
InputAccept accept = (InputAccept)context.HeadOfChain.BuildUp(context,
typeof(InputAccept), null, null);
accept.Execute();
Console.Read();
}
}
internal class MyBuilderContext : BuilderContext
{
public IReadWriteLocator InnerLocator;
public BuilderStrategyChain InnerChain = new BuilderStrategyChain();
public PolicyList InnerPolicies = new PolicyList();
public LifetimeContainer lifetimeContainer = new LifetimeContainer();
public MyBuilderContext()
: this(new Locator())
{
}
public MyBuilderContext(IReadWriteLocator locator)
{
InnerLocator = locator;
SetLocator(InnerLocator);
StrategyChain = InnerChain;
SetPolicies(InnerPolicies);
if (!Locator.Contains(typeof(ILifetimeContainer)))
Locator.Add(typeof(ILifetimeContainer), lifetimeContainer);
}
}
public class InputAccept
{
private IDataProcessor _dataProcessor;
public void Execute()
{
Console.Write("Please Input some words:");
string input = Console.ReadLine();
input = _dataProcessor.ProcessData(input);
Console.WriteLine(input);
}
public InputAccept(IDataProcessor dataProcessor)
{
_dataProcessor = dataProcessor;
}
}
public interface IDataProcessor
{
string ProcessData(string input);
}
public class DummyDataProcessor : IDataProcessor
{
#region IDataProcessor Members
public string ProcessData(string input)
{
return input;
}
#endregion
}
public class PromptDataProcessor : IDataProcessor
{
#region IDataProcessor Members
public string ProcessData(string input)
{
return "your input is: " + input;
}
#endregion
}
}
程式於一開始時，建立了一個MyBuilderContext物件，會自行建立BuilderContext物件而不使用Builder物件的目的很單純，就是為了釐清個別Strategy究竟做了那些事，這點在使用Builder物件時，會因為內建的Strategy都已加入，而顯得有些模糊。在MyBuilderContext物件建立後，此處將一個CreationStrategy加到Strategy串列中，CreationStrategy這個Strategy被歸類為Creation階段，是真正建立物件的Strategy，緊接著UseValueParameter函式會被呼叫，這個函式中建立了一個ConstructorPolicy物件，並呼叫其AddParameter函式，加入一個ValueParameter物件，這個ValueParameter物件就對應著InputAccept的建構子所需的參數，CreationStrategy於物件建立後，會透過BuilderContext的Policies來取得『型別/id』對應的ICreationPolicy物件(本例就是ConstructorPolicy物件)，然後呼叫ICreationPolicy.SelectionConstructor函式，這個函式必須根據呼叫者已用ICreationPolicy.AddParameter所傳入的參數來選擇正確的建構子，然後再呼叫這個建構子並填入參數值來完成物件建立工作，圖5是這整個流程的示意圖。
圖5
圖中讀者可能會有所迷惑的是，FormatterServices.GetSafeUninitializedObject函式是何作用？這是.NET Framework中一個建立物件的途徑，與一般new或是Activator.CreateInstance方式不同，GetSafeUninitializedObject函式並不會觸發該物件的建構子，只是單純的將物件建立起來而已，因此CreationStrategy才必須於最後呼叫對應的建構子。
Understanding Parameter
程式11中使用了一個ValueParameter物件，要知道這個物件的作用，我們得先了解Parameter在ObjectBuilder中所代表的意義，在三種注入模式中，有一個共通的規則，就是需要有參數來注入，Constructor Injection是透過建構子參數注入，而Interface Injection則是透過函數參數注入，Setter Injection則是透過屬性注入，因此參數是這三種注入模式都會用到的觀念，所以ObjectBuilder定義了IParameter介面，並提供一組實作此介面的參數物件，於注入時期由這些參數物件來取得參數值，如圖6。
圖6
ValueParameter
這是一個最簡單的Paramter物件，建構子如下所示：
public ValueParameter(Type valueType, object value)
她的GetValue函式僅是將建構子傳入的value物件傳回而已。
DependencyParamter
DependencyParameter是一個功能強大的Parameter物件，程式12是以DependencyParameter來取代ValueParameter完成Constructor Injection的例子。
程式12
static void UseDependencyParameter(MyBuilderContext context)
{
ConstructorPolicy creationPolicy = new ConstructorPolicy();
creationPolicy.AddParameter(new DependencyParameter(typeof(IDataProcessor),null,
typeof(PromptDataProcessor),NotPresentBehavior.CreateNew,SearchMode.Local));
context.Policies.Set>ICreationPolicy<(creationPolicy, typeof(InputAccept), null);
ConstructorPolicy creationPolicy2 = new ConstructorPolicy();
context.Policies.Set>ICreationPolicy<(creationPolicy2, typeof(PromptDataProcessor),null);
}
讀者可以發現，DependencyParameter並未要求建構者傳入任何物件實體，而是要求建構者傳入注入時對應的參數型別、參數名稱、實體型別、NotPersentBehavoir及SearchMode等參數，下面的程式列表是DependencyParameter的建構子：
public DependencyParameter(Type parameterType, string name,
Type createType, NotPresentBehavior notPresentBehavior, SearchMode searchMode)
第一個參數是參數的型別，第二個參數是參數的名稱，當ConstructorPolicy於SelectConstructor函式時，會依據這兩個參數來選取適合的建構子，第三個參數是實體物件的型別，以本例來說，就是以PromptDataProcessor這個型別建立物件來傳入需要IDataProcessor型別的建構子、函式或屬性，第四個參數則影響了DependencyParameter的取值動作，預設情況下，DependencyParameter會先至Locator中取值，這個動作會受到第五個參數：SearchMode的影響(稍後會介紹這一部份)，如果找不到的話，就會依據此參數值來做動作，NotPersentBehavior這個列舉的定義如下：
public enum NotPresentBehavior
{
CreateNew,
ReturnNull,
Throw,
}
CreateNew代表著當DependencyParameter於Locator找不到需要的值時，呼叫BuilderContext.HeadOfChain.BuildUp函式來建立該物件，以此例來說即是如此，所建立物件的型別就是PromptDataProcessor。ReturnNull則是回傳一個Null值，Throw則是直接拋出一個例外。好了，了解了整體流程後，現在讓我們一一釐清這個流程中剩下的部份，第一！於Locator找尋需要的值是什麼意思，試想一種情況，當我們在做Dependency Injection時，是否有某些欲注入物件是可重用的，也就是該物件可以只建立一個，注入多個不同的物件，讓這些物件共用這個注入物件，這就是DependencyParameter會先至Locator中找尋已推入的注入物件的原因，請參考程式13的例子。
程式13
static void UseDependencyParameter(MyBuilderContext context)
{
context.InnerLocator.Add(new DependencyResolutionLocatorKey(typeof(IDataProcessor), null),
new PromptDataProcessor());
ConstructorPolicy creationPolicy = new ConstructorPolicy();
creationPolicy.AddParameter(new DependencyParameter(typeof(IDataProcessor),
null,typeof(PromptDataProcessor),NotPresentBehavior.CreateNew,SearchMode.Local));
context.Policies.Set>ICreationPolicy<(creationPolicy, typeof(InputAccept), null);
ConstructorPolicy creationPolicy2 = new ConstructorPolicy();
context.Policies.Set>ICreationPolicy<(creationPolicy2, typeof(PromptDataProcessor),null);
}
這個例子預先建立了一個PromptDataProcessor物件，並以DependencyResolutionLocatorKey封裝後推入Locator中，這樣一來，當DependencyParameter取值時，就會依據參數的『型別/id』至Locator找尋需要的值，此時就會得到我們所推入的PromptDataProcessor物件，而不是建立一個新的，另外！只要於AddParameter所傳入的DependencyParameter是以IDataProcessor為參數型別，並以null為id(名稱)的話，那麼永遠都會傳回我們所推入Locator的PromptDataProcessor物件。第二個要釐清的是SearchMode的涵意，在ObjectBuilder的架構上，Locator是可以有Parent/Child關係的，當DependencyParameter要找尋需要的物件時，如果SearchMode是Local的話，那麼這個搜尋動作只會搜尋該Locator自身，如果是Up的話，那麼在該Locator自身搜尋不到時，就會往Parent Locator搜尋。第三個要釐清的是第二個ConstructorPolicy的建立動作，還記得嗎？我們提過Policy是『型別/id』相關的，當DependencyParameter無法於Locator找到需要的物件而透過BuildUp來建立物件時，該『型別/id』同樣需要一個ICreationPolicy來對應，否則將會引發Missing Policy的例外，注意！DependencyParameter所使用的name參數必須與設定Set>ICreationPolicy<時所傳入的第三個參數相同。最後一個問題是，如果每個『型別/id』都要設定對應的ICreationPolicy，豈不累人，ObjectBuilder當然沒有這麼不人性化，我們可以呼叫Policies.SetDefault來為所有『型別/id』預設一個ICreationPolicy，如程式14所示。
程式14
static void UseDependencyParameter(MyBuilderContext context)
{
ConstructorPolicy creationPolicy = new ConstructorPolicy();
creationPolicy.AddParameter(new DependencyParameter(typeof(IDataProcessor),
null,typeof(PromptDataProcessor),NotPresentBehavior.CreateNew,SearchMode.Local));
context.Policies.Set>ICreationPolicy<(creationPolicy, typeof(InputAccept), null);
context.Policies.SetDefault>ICreationPolicy<(new ConstructorPolicy());
}
CreationParameter
與DependencyParameter相同，CreationParameter也會透過BuildUp來建立物件，不同的是其不會先搜尋Locator，也無法作參數型別與實體型別對應，因此無法適用於InputAccept這種以介面為介質的注入方式，必須與TypeMappingStrategy(後述)合用才能解決，如程式15所示。
程式15
static void UseCreationParameter(MyBuilderContext context)
{
ConstructorPolicy creationPolicy = new ConstructorPolicy();
creationPolicy.AddParameter(new CreationParameter(typeof(IDataProcessor)));
context.Policies.Set>ICreationPolicy<(creationPolicy, typeof(InputAccept), null);
TypeMappingPolicy mappingPolicy = new TypeMappingPolicy(typeof(PromptDataProcessor), null);
context.Policies.Set>ITypeMappingPolicy<(mappingPolicy, typeof(IDataProcessor), null);
context.Policies.SetDefault>ICreationPolicy<(new ConstructorPolicy());
}
static void Main(string[] args)
{
MyBuilderContext context = new MyBuilderContext(new Locator());
context.InnerChain.Add(new TypeMappingStrategy());
context.InnerChain.Add(new CreationStrategy());
UseCreationParameter(context);
InputAccept accept = (InputAccept)context.HeadOfChain.BuildUp(context,
typeof(InputAccept), null, null);
accept.Execute();
Console.Read();
}
CloneParameter
CloneParameter的建構子接受一個IParameter參數，當其GetValue函式被呼叫時，會透過從建構子指定的Parameter物件來取值，如果取得的值是實作了ICloneable介面的物件時，其將呼叫Clone函式來拷貝該值，否則傳回原值，下面的程式片斷是CloneParametr的建構子宣告。
public CloneParameter(IParameter param)
LookupParameter
LookupParameter的建構子接受一個object型別的參數，當GetValue函式被呼叫時，會經由Locator.Get函式，以建構子所傳入的參數為鍵值，取得位於Locator中的值，下面的程式片斷為LookupParameter的建構子宣告。
public LookupParameter(object key)
程式16則是將InputAccept範例改為使用LookupParameter的版本。
程式16
static void UseLookupParameter(MyBuilderContext context)
{
context.InnerLocator.Add("dataProcessor", new PromptDataProcessor());
ConstructorPolicy creationPolicy = new ConstructorPolicy();
creationPolicy.AddParameter(new LookupParameter("dataProcessor"));
context.Policies.Set>ICreationPolicy<(creationPolicy, typeof(InputAccept), null);
context.Policies.SetDefault>ICreationPolicy<(new ConstructorPolicy());
}
InjectionConstructor Attribute
使用Paramerer物件來進行Consturctor Injection時，設計者必須在建立物件前，預先準備這些Parameter物件，雖然動作不算繁鎖，但若全部物件的建立都要這麼做，未免有些沒有效率，為此！ObjectBuilder提供了另一種較為簡單的方法，就是利用InjectionConstructor這個Attribute，再搭配上ConstructorReflectionStrategy物件，自動的為設計者準備這些Parmeter物件，程式17是修改為InjectionConstructor模式的版本。
程式17
static void UseInjectionConstructorAttribute(MyBuilderContext context)
{
context.InnerChain.Add(new ConstructorReflectionStrategy());
context.InnerChain.Add(new CreationStrategy());
}
..........
public class InputAccept
{
private IDataProcessor _dataProcessor;
public void Execute()
{
Console.Write("Please Input some words:");
string input = Console.ReadLine();
input = _dataProcessor.ProcessData(input);
Console.WriteLine(input);
}
[InjectionConstructor]
public InputAccept([Dependency(Name="dataProcessor",
CreateType=typeof(PromptDataProcessor))]IDataProcessor dataProcessor)
{
_dataProcessor = dataProcessor;
}
}
要使用InjectionConstructor Attribute，我們必須在CreationStrategy這個Strategy前加入一個ConstructorReflectionStrategy物件，她會於建立物件動作時，探詢欲建立物件型別所提供的所有建構子，選取已標上InjectionConstrucor Attribute的那個為指定建構子，接著ConstructorReflectionStrategy會探詢該建構子的所有參數，查看是否標上Dependency Attribute，是的話就以其設定建立DependencyParameter，否則建立一個新的DependencyParameter，她會單以型別參數來建立DependencyParameter，最後ConstructorReflectionStrategy會以這些資訊來建立對應的ConstructorPolicy物件，完成整個物件建立動作。
Understanding Dependency Attribute
ConstructorReflectionStrategy依賴兩個關鍵的Attribute，一個是用來標示指定建構子的InjectionConstructor Attribute，另一個則是用來標示參數該如何取得的Dependency Attribute，此Attribute有四個屬性，分別對應到DependencyParameter的四個屬性，如表2。
表2
DependencyAttribute
DependencyParameter
說明
Name
Name
id(名稱)
CreateType
CreateType
欲建立物件的實體型別
NotPersentBehavior
NotPersentBehavior
當欲建立物件無法由Locator取得時的行為模式。
SearchMode
SearchMode
對Locator的搜尋法則。
使用Dependency Attribute與ConsturctorReflectionStrategy模式的優點是設計者不需花費時間一一建立Parameter物件，而缺點就是CreateType參數，由於ConstructorReflectionStrategy依賴著Dependency Attribute的CreateType參數來決定實際建立物件的型別，這使得設計者必須在標示Dependency Attribute時，一併指定這個參數，否則ConstructorReflectionStrategy將會以參數型別做為建立實際物件時的型別，而在本例中，我們無法建立一個IDataProcessor物件，這點降低了程式的可訂制性。那這要如何解決呢？簡單的方法是撰寫一個新的Dependency Attribute、或是使用TypeMappingStrategy，複雜的則是撰寫一個新的ConstructorReflectionStrategy，後面的章節我們會再重訪這個問題。
Injection with DependencyResolutionLocator
前面談到DependencyParameter時曾經提過，她會先至Locator中搜尋需要的參數值，那麼這也意味著，在使用ConstructorReflectionStrategy時，我們可以將參數值先行推入Locator中，這樣就可以避開指定CreateType了，如程式18所示。
程式18
static void UseDependencyResolution(MyBuilderContext context)
{
context.InnerChain.Add(new ConstructorReflectionStrategy());
context.InnerChain.Add(new CreationStrategy());
context.InnerLocator.Add(new DependencyResolutionLocatorKey(typeof(IDataProcessor),
"dataProcessor"),new PromptDataProcessor());
}
[InjectionConstructor]
public InputAccept([Dependency(Name="dataProcessor")]IDataProcessor dataProcessor)
當然，這仍然會有一個問題，那就是必須預先建立PromptDataProcessor物件，而非於InputAccept物件建立時期建立，這是在不撰寫自定Dependency Attribute或Strategy，亦或是使用TypeMappingStrategy情況下的簡易解法。
DefaultCreationPolicy and ConstructorPolicy
ObjectBuilder內建了兩個ICreationPolicy的實作體，一是前面所使用的ConsturoctPolicy，二是DefaultCreationPolicy，與ConstructorPolicy不同，DefaultCationPolicy永遠使用預設的建構子，如下所示。
public ConstructorInfo SelectConstructor(IBuilderContext context, Type type, string id)
{
if (constructor != null)
return constructor;
List>Type< types = new List>Type<();
foreach (IParameter parm in parameters)
types.Add(parm.GetParameterType(context));
return type.GetConstructor(types.ToArray());
}
而呼叫該建構子時所需的參數，則直接以BuildUp函式，依據參數的『型別/id』來建立，沒有與Parameter的互動。
public object[] GetParameters(IBuilderContext context, Type type, string id, ConstructorInfo constructor)
{
ParameterInfo[] parms = constructor.GetParameters();
object[] parmsValueArray = new object[parms.Length];
for (int i = 0; i > parms.Length; ++i)
parmsValueArray[i] = context.HeadOfChain.BuildUp(context, parms[i].ParameterType, null, id);
return parmsValueArray;
}
由此可見，DefaultCreationPolicy有兩個特色，一是其會選擇頂端的建構子，二是其一律以BuidUp函式依據參數型別來建立參數物件，不需要設計者介入。那在何種情況下選擇DefaultCreationPolicy呢？一般來說，使用ConstructorPolicy時，因為其會依據設計者所加入的Parameter物件來選擇建構子，如果設計者未準備這些，那麼ConstructorPolicy將因無法取得適合的建構子而引發例外，雖然這點可以經由搭配ConstructorReflectionStrategy來解決，但使用ConstructorReflectionStrategy時必須搭配Dependency Attribtue及InjectionConstructor Attribute，所以也是個負擔。使用DefaultCreationPolicy就沒有這些問題了，缺點則是無法指定實際建立的參數物件型別，所以DefautlCreationPolicy通常被設定成預設的ICreationPolicy，主要作用在於當我們所建立的物件是簡單的，只有一個建構子，且不需要特別指定參數實際型別時，就交由她來處理，而需要特別處理的，就運用『型別/id』對應的ConstructorPolicy或是Dependency Attribute、Injection Constructor Attrbute搭配ConstructorReflectionStrategy來處理。
4-2、Interface Injection
Interface Injection在ObjectBuidler中可以經由Method Injection來完成，指的是在物件建立後，呼叫所指定的函式來完成初始化動作，而負責這個工作的就是MethodExecutionStrategy，本節持續延應InputAccept來示範如何於ObjectBuidler中實現Interface Injection。
MethodExecutionStrategy
要實現Interface Injection，除了必須使用CreationStrategy來建立物件外，還要使用另一個Strategy：MethodExecutionStrategy，她會在物件建立完成後，執行指定的函式，程式19是使用MethodExecutionStrategy來實現Interface Injection的例子。
程式19
static void UseMethodInfo(MyBuilderContext context)
{
context.InnerChain.Add(new CreationStrategy());
context.InnerChain.Add(new MethodExecutionStrategy());
IMethodCallInfocallInfo = new MethodCallInfo("SetDataProcessor",
new ValueParameter(typeof(IDataProcessor), new PromptDataProcessor()));
IMethodPolicy policy = new MethodPolicy();
policy.Methods.Add("SetDataProcessor", callInfo);
context.Policies.Set>IMethodPolicy<(policy, typeof(InputAccept), null);
}
static void Main(string[] args)
{
MyBuilderContext context = new MyBuilderContext(new Locator());
UseDependencyAttribute(context);
context.Policies.SetDefault>ICreationPolicy<(new DefaultCreationPolicy());
InputAccept accept = (InputAccept)context.HeadOfChain.BuildUp(context, typeof(InputAccept),
null, null);
accept.Execute();
Console.Read();
}
public class InputAccept
{
private IDataProcessor _dataProcessor;
public void SetDataProcessor(IDataProcessor dataProcessor)
{
_dataProcessor = dataProcessor;
}
public void Execute()
{
Console.Write("Please Input some words:");
string input = Console.ReadLine();
input = _dataProcessor.ProcessData(input);
Console.WriteLine(input);
}
}
此處使用ValueParameter來進行呼叫指定函式時的參數注入動作，在使用MethodExecutionStrategy時，設計者必須先行建立呼叫函式時所需的MethodCallInfo物件，這是一個實作IMethodInfo介面的物件，設計者必須於此物件中指定欲呼叫的函式、及傳入的Parameter物件，下面是MethodInfo的建構子宣告。
public MethodCallInfo(string methodName)
public MethodCallInfo(string methodName, params object[] parameters)
public MethodCallInfo(string methodName, params IParameter[] parameters)
public MethodCallInfo(string methodName, IEnumerable>IParameter< parameters)
public MethodCallInfo(MethodInfo method)
public MethodCallInfo(MethodInfo method, params IParameter[] parameters)
public MethodCallInfo(MethodInfo method, IEnumerable>IParameter< parameters)
MethodInfo擁有許多重載的建構子，大概分成兩大類：函式名稱及MethodInfo物件，每類會分成四個，分別是無參數、使用params傳入參數值、使用params傳入IParamete物件、傳入IEnumerable>IParameter<物件。在MethodInfo物件建立後，接著就要將這些物件傳入IMethodPolicy物件，並指定給context.Policies物件，這樣就完成了Interface Injection的準備動作，之後建立InputAccept物件後，SetDataProcess函式就會被呼叫，同時會傳入指定的PromptDataProcessor物件。
How MethodExecutionStrategy Working？
當MethodExecutionStrategy的BuildUp函式被呼叫時，會透過context.Policies來取得型別對應的IMethodPolicy物件，如下所示。
IMethodPolicy policy = context.Policies.Get>IMethodPolicy<(type, id);
然後會透過IMethodPolicy物件來取得所有需要處理的IMethodCallInfo物件，並一一呼叫其SelectMethod函式來取得欲呼叫函式，如下所示。
MethodInfo methodInfo = methodCallInfo.SelectMethod(context, type, id);
SelectMethod函式會依據當初建立此IMethodCallInfo物件時所指定的函式名稱、參數數量及型別來取得對應函式的MethodInfo物件。於取得MethodInfo物件後，緊接著就是透過IMethodCallInfo.GetParameters函式來取得呼叫此函式時需傳入的參數值，如下所示。
object[] parameters = methodCallInfo.GetParameters(context, type, id, methodInfo);
最後呼叫MethodInfo.Invoke函式來呼叫該函式就完成整個動作了。
methodInfo.Invoke(obj, parameters);
好了，這就是MethodExecutionStrategy的整個流程，現在我們要釐清幾個可能會令人困惑的問題，第一！當欲呼叫的函式是重載，有多個同名函式時，SelectMethod依據什麼來決定要呼叫那一個？答案是參數數量及型別。第二！當使用Parameter物件傳入MethodCallInfo物件的建構子時，GetParameters函式會透過Parameter.GetValue來取值，那麼當直接以object[]方式傳入MethodCallInfo的建構子時呢？答案是該建構子會逐個為傳入的object建立ValueParameter物件，如下所示。
public MethodCallInfo(string methodName, params object[] parameters)
:this(methodName, null, ObjectsToIParameters(parameters))
{
}
private static IEnumerable>IParameter< ObjectsToIParameters(object[] parameters)
{
List>IParameter< results = new List>IParameter<();
if (parameters != null)
foreach (object parameter in parameters)
results.Add(new ValueParameter(parameter.GetType(), parameter));
return results.ToArray();
}
最後一個問題是，可以進行一個以上的函式呼叫嗎？答案是可以，建立對應的MethodCallInfo物件，並加到IMethodPolicy後即可，呼叫的順序則是依照MethodCallInfo加入IMethodPolicy的順序。。
Use DependencyParameter
與Constructor Injection相同，你也可以使用DependencyParameter來進行Interface Injection動作，如程式20。
程式20
static void UseDependencyParameter(MyBuilderContext context)
{
context.InnerChain.Add(new CreationStrategy());
context.InnerChain.Add(new MethodExecutionStrategy());
MethodCallInfo callInfo = new MethodCallInfo("SetDataProcessor",
new DependencyParameter(typeof(IDataProcessor), "dataProcessor", typeof(PromptDataProcessor), NotPresentBehavior.CreateNew, SearchMode.Local));
IMethodPolicy policy = new MethodPolicy();
policy.Methods.Add("SetDataProcessor", callInfo);
context.Policies.Set>IMethodPolicy<(policy, typeof(InputAccept), null);
}
use MethodReflectionStrategy
如同ConstructorReflectionStrategy的作用一樣，ObjectBuilder也提供了供Method Injection使用的MethodReflectionStrategy物件，要使用她，我們必須為欲進行Method Injection的函式標上InjectionMethod Attribute，如程式21所示。
程式21
static void UseDependencyResolverLocator(MyBuilderContext context)
{
context.InnerChain.Add(new CreationStrategy());
context.InnerChain.Add(new MethodReflectionStrategy());
context.InnerChain.Add(new MethodExecutionStrategy());
context.InnerLocator.Add(new DependencyResolutionLocatorKey(typeof(IDataProcessor),
"dataProcessor"), new PromptDataProcessor());
}
public class InputAccept
{
private IDataProcessor _dataProcessor;
[InjectionMethod]
public void SetDataProcessor(
[Dependency(Name="dataProcessor"))]IDataProcessor dataProcessor)
{
_dataProcessor = dataProcessor;
}
...........
}
本例使用DependencyResolutionLocatorKey模式進行注入動作，有了Constructor Injection部份的解說，相信讀者對這種模式已經了然於胸了。
Injection with Dependency Attribute and CreateType
同樣的，我們也可以在Dependency Attribute中指定CreateType來達到同樣的效果，如程式22所示。
程式22
static void UseDependencyAttribute(MyBuilderContext context)
{
context.InnerChain.Add(new CreationStrategy());
context.InnerChain.Add(new MethodReflectionStrategy());
context.InnerChain.Add(new MethodExecutionStrategy());
}
public class InputAccept
{
private IDataProcessor _dataProcessor;
[InjectionMethod]
public void SetDataProcessor(
[Dependency(Name="dataProcessor",
CreateType=typeof(PromptDataProcessor))]IDataProcessor dataProcessor)
{
_dataProcessor = dataProcessor;
}
.............
}
4-3、Setter Injection
ObjectBuilder使用PropertySetterStrategy來進行Setter Injection，用法與前述的Interface Injection模式大致相同，如程式23所示。
程式23
static void UsePropertySetter(MyBuilderContext context)
{
context.InnerChain.Add(new CreationStrategy());
context.InnerChain.Add(new PropertySetterStrategy());
PropertySetterPolicy policy = new PropertySetterPolicy();
policy.Properties.Add("DataProcessor", new PropertySetterInfo("DataProcessor",
new ValueParameter(typeof(IDataProcessor), new PromptDataProcessor())));
context.Policies.Set>IPropertySetterPolicy<(policy, typeof(InputAccept), null);
}
static void Main(string[] args)
{
MyBuilderContext context = new MyBuilderContext(new Locator());
UsePropertySetter(context);
context.Policies.SetDefault>ICreationPolicy<(new DefaultCreationPolicy());
InputAccept accept = (InputAccept)context.HeadOfChain.BuildUp(context,
typeof(InputAccept), null, null);
accept.Execute();
Console.Read();
}
public class InputAccept
{
private IDataProcessor _dataProcessor;
public IDataProcessor DataProcessor
{
get
{
return _dataProcessor;
}
set
{
_dataProcessor = value;
}
}
public void Execute()
{
Console.Write("Please Input some words:");
string input = Console.ReadLine();
input = _dataProcessor.ProcessData(input);
Console.WriteLine(input);
}
}
設計者必須預先建立PropertySetterInfo物件，並為其指定欲設定的屬性名稱及參數，PropertySetterInfo是一個實作了IPropertySetterInfo介面的物件，其建構子宣告如下。
public PropertySetterInfo(string name, IParameter value)
public PropertySetterInfo(PropertyInfo propInfo, IParameter value)
有了MethodCallInfo的經驗，讀者們對這些建構子應該不會有任何疑惑，應該會抱怨其不像MethodCallInfo般提供那麼多的選擇吧(笑)。在ProeprtySetterInfo建立後，接著只要將其加到IPropertySetterPolicy物件中，並依『型別/id』指定給context.Policies即可完成Setter Injection。
How PropertySetterStrategy Work？
當PropertySetterStrategy的BuildUp函式被呼叫時，會透過context.Policies來取得型別對應的IPropertySetterPolicy物件，如下所示。
IPropertySetterPolicy policy = context.Policies.Get>IPropertySetterPolicy<(type, id);
然後會透過IMethodPoliIPropertySetterPolicyy物件來取得所有需要處理的IPropertySetterInfo物件，並一一呼叫其SelectProperty函式來取得欲設定的屬性，如下所示。
PropertyInfo propInfo = propSetterInfo.SelectProperty(context, type, id);
SelectProperty函式會依據當初建立此IPropertySetterInfo物件時所指定的屬性名稱、參數來取得對應屬性的PropertyInfo物件。於取得PropertyInfo物件後，緊接著就是透過IPropertySetterInfo.GetValue函式來取得設定此屬性時需傳入的值，如下所示。
object value = propSetterInfo.GetValue(context, type, id, propInfo);
最後呼叫PropertyInfo.SetValue函式來設定屬性值就完成整個動作了。
propInfo.SetValue(obj, value, null);
這就是整個Setter Injection的流程，這裡只有一個問題，我們可以設定一個以上的屬性嗎？答案是肯定的，只要建立對應數量的PropertySetterInfo物件即可。
use DependencyParameter
同樣的，使用DependencyParameter也可以達到同樣的效果，如程式24。
程式24
static void UseDependencyParameter(MyBuilderContext context)
{
context.InnerChain.Add(new CreationStrategy());
context.InnerChain.Add(new PropertySetterStrategy());
PropertySetterPolicy policy = new PropertySetterPolicy();
policy.Properties.Add("DataProcessor", new PropertySetterInfo("DataProcessor",
new DependencyParameter(typeof(IDataProcessor),"DataProcessor",
typeof(PromptDataProcessor),NotPresentBehavior.CreateNew,SearchMode.Local)));
context.Policies.Set>IPropertySetterPolicy<(policy, typeof(InputAccept), null);
}
use PropertyReflectionStrategy
相對於ConsturctorReflectionStrategy及MethodReflectionStrategy，ObjectBuilder也提供了一個同類型的PropertyReflectionStrategy，我們可以搭配Dependency Attribute及DependencyResolutionLocatorKey物件來達到同樣效果，如程式25。
程式25
static void UseDependencyResolutionLocator(MyBuilderContext context)
{
context.InnerChain.Add(new CreationStrategy());
context.InnerChain.Add(new PropertyReflectionStrategy());
context.InnerChain.Add(new PropertySetterStrategy());
context.Locator.Add(new DependencyResolutionLocatorKey(typeof(IDataProcessor),
"DataProcessor"), new PromptDataProcessor());
}
public class InputAccept
{
private IDataProcessor _dataProcessor;
[Dependency(Name="DataProcessor")]
public IDataProcessor DataProcessor
{
get
{
return _dataProcessor;
}
set
{
_dataProcessor = value;
}
}
.........
}
Injection with Dependency Attribute and CreateType
我們也可以使用Dependency Attribute及CreateType參數來進行Setter Injection，如程式26。
程式26
static void UseDependencyAttribute(MyBuilderContext context)
{
context.InnerChain.Add(new CreationStrategy());
context.InnerChain.Add(new PropertyReflectionStrategy());
context.InnerChain.Add(new PropertySetterStrategy());
}
public class InputAccept
{
private IDataProcessor _dataProcessor;
[Dependency(Name="DataProcessor",CreateType=typeof(PromptDataProcessor))]
public IDataProcessor DataProcessor
{
get
{
return _dataProcessor;
}
set
{
_dataProcessor = value;
}
}
...............
}
v

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=1282150


调查数据网 调查数据网
原创粉丝点击
热门IT博客
手机word文档软件手机word文档软件
股票数据库股票数据库
新瓷杯子怎么洗 知乎
知乎武林外传细思极恐
杭州小知科技 知乎
开淘宝卖美甲在哪进货
苹果平板电脑淘宝卖家
俄亥俄州立大学知乎
java发送邮件的代码
网络电视盒
皇汉 知乎
em算法实现
java入门教程txt下载
foxmail mac导入旧邮件
知乎 后端必看的书
网络投资平台排名
p2p网络终结者官网
明解c语言
php 洗衣管理软件
宜家的厨房怎么样 知乎
热门问题 老师的惩罚 人脸识别 我在镇武司摸鱼那些年 重生之率土为王 我在大康的咸鱼生活 盘龙之生命进化 天生仙种 凡人之先天五行 春回大明朝 姑娘不必设防，我是瞎子 梦见火烧房子 卖房子的女人 房子抵押给个人流程 房子过户需要什么手续 房子贷款利息计算公式 装修房子入住 60万房子过户费多少钱 房子贷款利息计算器 一百平方的房子装修要多少钱 上海青浦房子 在农村盖房子需要多少钱 100平方的房子 浦东新区房子 房子怎么过户 房子的方位怎么看 附近的房子两室一厅 装修好的房子 房子装修照片 农村房子设计平面图 北京房山房子 重庆房子均价 房子装修效果图大全 装修一套房子要多久 沈阳房子哪里好 90平房子装修价格 装修房子图片 退房子定金的好理由 120平方的房子装修需要多少钱 杭州 租房 楼房 有房产 房屋网站 购买房屋 营口房产信息网 上海市房地产信息网 马鞍山房产网 的楼盘 中山房产信息网 盐城房产信息网 现在楼房价格 新房的

程序博客网，程序员的互联网技术博客家园。csdn论坛精品 msdn技术资料都在这里