ValueProviderFactory
在ASP.NET Model綁定系統中,用於提供數據值的ValueProvider對象通過ValueProviderFactory來創建。在ASP.NET MVC應用編程接口中,ValueProviderFactory繼承自ValueProviderFactory類。本篇文章只要介紹基於ValueProviderFactory的ValueProvider的提供機制,以及如何通過自定義ValueProviderFactory實現我們需要的數據值的綁定方式。
一、ValueProviderFactory
如下面的代碼片斷所示,ValueProviderFactory是一個抽象類,唯一的抽象方法GetValueProvider用於實現基於指定Controller上下文的ValueProvider創建。
1: public abstract class ValueProviderFactory
2: {
3: public abstract IValueProvider GetValueProvider(ControllerContext controllerContext);
4: }
下面的列表列出了定義在Model綁定系統中的6個原生的ValueProviderFactory:
ChildActionValueProviderFactory:根據給定的Controller上下文創建一個ChildActionValueProvider對象。
FormValueProviderFactory:根據給定的Controller上下文創建一個FormValueProvider對象。
JsonValueProviderFactory:將以JSON形式表示的請求數據轉換成一個Dictionary<string, object>對象,並最終創建一個DictionaryValueProvider<object>對象。
RouteDataValueProviderFactory:根據給定的Controller上下文創建一個RouteDataValueProvider對象。
QueryStringValueProviderFactory:根據給定的Controller上下文創建一個QueryStringValueProvider對象。
HttpFileCollectionValueProviderFactory:根據給定的Controller上下文創建一個HttpFileCollectionValueProvider對象。
二、ValueProviderFactory的注冊
ValueProviderFactory在ASP.NET MVC應用中的注冊通過靜態類型ValueProviderFactories實現。如下面的代碼片斷所示,ValueProviderFactories具有一個靜態只讀屬性Factories返回一個表示ValueProviderFactory集合的ValueProviderFactoryCollection類型。
1: public static class ValueProviderFactories
2: {
3: public static ValueProviderFactoryCollection Factories { get; }
4: }
5:
6: public class ValueProviderFactoryCollection : Collection<ValueProviderFactory>
7: {
8: public ValueProviderFactoryCollection();
9: public ValueProviderFactoryCollection(IList<ValueProviderFactory> list);
10: public IValueProvider GetValueProvider(ControllerContext controllerContext);
11: }
ValueProviderFactoryCollection的GetValueProvider方法返回的是一個ValueProviderCollection對象,集合中的每個ValueProvider通過對應的ValueProviderFactory來創建。ValueProviderFactory在ValueProviderFactoryCollection集合中的先後次序決定了創建的ValueProvider在ValueProviderCollection中的次序,而次序決定了使用優先級。
在默認的情況下ValueProviderFactories的Factories屬性表示的ValueProviderFactoryCollection包含了上面我們介紹的6種ValueProviderFactory,次序(優先級)為:ChildActionValueProviderFactory、FormValueProviderFactory、JsonValueProviderFactory、RouteDataValueProviderFactory、QueryStringValueProviderFactory和。如果具有相同的名稱的請求書去同時存在於請求表單和查詢字符串中,前者會被選用。
以ValueProvider為核心的值提供系統中涉及到了三類組件/類型,即用於具體實現數據值提供的ValueProvider,ValueProvider通過ValueProviderFactotry,而ValueProviderFactotry通過ValueProviderFactotries進行注冊。圖5-4所示的UML體現了三者之間的關系。