解讀ASP.NET 5 & MVC6系列教程(15):MvcOptions配置
程序模型處理 IApplicationModelConvention
在MvcOptions的實(shí)例對象上,有一個(gè)ApplicationModelConventions屬性(類型是:List<IApplicationModelConvention>),該屬性IApplicationModelConvention類型的接口集合,用于處理應(yīng)用模型ApplicationModel,該集合是在MVC程序啟動的時(shí)候進(jìn)行調(diào)用,所以在調(diào)用之前,我們可以對其進(jìn)行修改或更新,比如,我們可以針對所有的Controller和Action在數(shù)據(jù)庫中進(jìn)行授權(quán)定義,在程序啟動的時(shí)候讀取數(shù)據(jù)授權(quán)信息,然后對應(yīng)用模型ApplicationModel進(jìn)行處理。 示例如下:
public class PermissionCheckApplicationModelConvention : IApplicationModelConvention
{
public void Apply(ApplicationModel application)
{
foreach (var controllerModel in application.Controllers)
{
var controllerType = controllerModel.ControllerType;
var controllerName = controllerModel.ControllerName;
controllerModel.Actions.ToList().ForEach(actionModel =>
{
var actionName = actionModel.ActionName;
var parameters = actionModel.Parameters;
// 根據(jù)判斷條件,操作修改actionModel
});
// 根據(jù)判斷條件,操作修改ControllerModel
}
}
}
視圖引擎的管理ViewEngines
在MvcOptions的實(shí)例對象中,有一個(gè)ViewEngines屬性用于保存系統(tǒng)的視圖引擎集合,以便可以讓我們實(shí)現(xiàn)自己的自定義視圖引擎,比如在《自定義View視圖文件查找邏輯》章節(jié)中,我們就利用了該特性,來實(shí)現(xiàn)了自己的自定義視圖引擎,示例如下:
services.AddMvc().Configure<MvcOptions>(options =>
{
options.ViewEngines.Clear();
options.ViewEngines.Add(typeof(ThemeViewEngine));
});
Web API中的輸入(InputFormater)/輸出(OutputFormater)
輸入
Web API和目前的MVC的輸入?yún)?shù)的處理,目前支持JSON和XML格式,具體的處理類分別如下:
JsonInputFormatter XmlDataContractSerializerInputFormatter
輸出
在Web API中,默認(rèn)的輸出格式化器有如下四種:
HttpNoContentOutputFormatter StringOutputFormatter JsonOutputFormatter XmlDataContractSerializerOutputFormatter
上述四種在系統(tǒng)中,是根據(jù)不同的情形自動進(jìn)行判斷輸出的,具體判斷規(guī)則如下:
如果是如下類似的Action,則使用HttpNoContentOutputFormatter返回204,即NoContent。
public Task DoSomethingAsync()
{
// 返回Task
}
public void DoSomething()
{
// Void方法
}
public string GetString()
{
return null; // 返回null
}
public List<Data> GetData()
{
return null; // 返回null
}
如果是如下方法,同樣是返回字符串,只有返回類型是string的Action,才使用StringOutputFormatter返回字符串;返回類型是object的Action,則使用JsonOutputFormatter返回JSON類型的字符串?dāng)?shù)據(jù)。
public object GetData()
{
return"The Data"; // 返回JSON
}
public string GetString()
{
return"The Data"; // 返回字符串
}
如果上述兩種類型的Action都不是,則默認(rèn)使用JsonOutputFormatter返回JSON數(shù)據(jù),如果JsonOutputFormatter格式化器通過如下語句被刪除了,那就會使用XmlDataContractSerializerOutputFormatter返回XML數(shù)據(jù)。
services.Configure<MvcOptions>(options => options.OutputFormatters.RemoveAll(formatter => formatter.Instance is JsonOutputFormatter) );
當(dāng)然,你也可以使用ProducesAttribute顯示聲明使用JsonOutputFormatter格式化器,示例如下。
public class Product2Controller : Controller
{
[Produces("application/json")]
//[Produces("application/xml")]
public Product Detail(int id)
{
return new Product() { ProductId = id, ProductName = "商品名稱" };
}
}
或者,可以在基類Controller上,也可以使用ProducesAttribute,示例如下:
[Produces("application/json")]
public class JsonController : Controller { }
public class HomeController : JsonController
{
public List<Data> GetMeData()
{
return GetDataFromSource();
}
}
當(dāng)然,也可以在全局范圍內(nèi)聲明該ProducesAttribute,示例如下:
services.Configure<MvcOptions>(options =>
options.Filters.Add(newProducesAttribute("application/json"))
);
Output Cache 與 Profile
在MVC6中,OutputCache的特性由ResponseCacheAttribute類來支持,示例如下:
[ResponseCache(Duration = 100)]
public IActionResult Index()
{
return Content(DateTime.Now.ToString());
}
上述示例表示,將該頁面的內(nèi)容在客戶端緩存100秒,換句話說,就是在Response響應(yīng)頭header里添加一個(gè)Cache-Control頭,并設(shè)置max-age=100。 該特性支持的屬性列表如下:
| 屬性名稱 | 描述 |
|---|---|
| Duration | 緩存時(shí)間,單位:秒,示例:Cache-Control:max-age=100 |
| NoStore | true則設(shè)置Cache-Control:no-store |
| VaryByHeader | 設(shè)置Vary header頭 |
| Location | 緩存位置,如將Cache-Control設(shè)置為public, private或no-cache。 |
另外,ResponseCacheAttribute還支持一個(gè)CacheProfileName屬性,以便可以讀取全局設(shè)置的profile信息配置,進(jìn)行緩存,示例如下:
[ResponseCache(CacheProfileName = "MyProfile")]
public IActionResult Index()
{
return Content(DateTime.Now.ToString());
}
public void ConfigureServices(IServiceCollection services)
{
services.Configure<MvcOptions>(options =>
{
options.CacheProfiles.Add("MyProfile",
new CacheProfile
{
Duration = 100
});
});
}
通過向MvcOptions的CacheProfiles屬性值添加一個(gè)名為MyProfile的個(gè)性設(shè)置,可以在所有的Action上都使用該配置信息。
其它我們已經(jīng)很熟悉的內(nèi)容
以下內(nèi)容我們可能都已經(jīng)非常熟悉了,因?yàn)樵谥暗腗VC版本中都已經(jīng)使用過了,這些內(nèi)容均作為MvcOptions的屬性而存在,具體功能列表如下(就不一一敘述了):
FiltersModelBindersModelValidatorProvidersValidationExcludeFiltersValueProviderFactories
另外兩個(gè):
MaxModelValidationErrors
置模型驗(yàn)證是顯示的最大錯(cuò)誤數(shù)量。
RespectBrowserAcceptHeader
在使用Web API的內(nèi)容協(xié)定功能時(shí),是否遵守Accept Header的定義,默認(rèn)情況下當(dāng)media type默認(rèn)是*/*的時(shí)候是忽略Accept header的。如果設(shè)置為true,則不忽略。
相關(guān)文章
ASP.NET MVC4入門教程(八):給數(shù)據(jù)模型添加校驗(yàn)器
本文介紹給模型添加校驗(yàn)器,以前我們做表單驗(yàn)證都要前臺驗(yàn)證一遍,后臺再驗(yàn)證一遍,MVC4中這種方式,只需在模型上加驗(yàn)證規(guī)則,前后臺就都驗(yàn)證了。2016-04-04
在ASP.NET 2.0中操作數(shù)據(jù)之六十:創(chuàng)建一個(gè)自定義的Database-Driven Site Map Provid
ASP.NET 2.0的site map是建立在provider模式的基礎(chǔ)上的,因此我們可以創(chuàng)建一個(gè)自定義的site map provider,從數(shù)據(jù)庫或某個(gè)層來獲取數(shù)據(jù)。本文就詳解介紹如何自定義的site map provider動態(tài)的獲取數(shù)據(jù),替代先前通過"硬編碼"的方式添加到Web.sitemap文件的方法。2016-05-05
解讀ASP.NET 5 & MVC6系列教程(16):自定義View視圖文件查找邏輯
這篇文章主要介紹了ASP.NET 5 MVC6中自定義View視圖文件查找邏輯,需要的朋友可以參考下2016-06-06
在ASP.NET 2.0中操作數(shù)據(jù)之四十五:DataList和Repeater里的自定義Button
本文主要介紹在DataList和Repeater添加諸如Button,LinkButton和ImageButton等控件的方法,并根據(jù)相關(guān)控件CommandName屬性觸發(fā)相應(yīng)的事件,執(zhí)行相應(yīng)的操作。2016-05-05
在ASP.NET 2.0中操作數(shù)據(jù)之十三:在DetailsView控件中使用TemplateField
就像在GridView中那樣,DetailsView控件也可以同樣的使用TemplateField。本文用兩個(gè)TemplateField來演示在它的使用方法。2016-05-05
在ASP.NET 2.0中操作數(shù)據(jù)之六十八:為DataTable添加額外的列
本文介紹并使用TableAdapter向DataTable添加新的一列的方法和步驟,任何時(shí)候只要重新運(yùn)行TableAdapter設(shè)置向?qū)?,用戶所做的所有定制都要被覆蓋,為避免出現(xiàn)這種情況,我們建議直接修改存儲過程。2016-05-05
ASP.NET MVC4入門教程(四):添加一個(gè)模型
本文主要介紹在MVC4中如何添加一個(gè)模型(Model),這個(gè)類負(fù)責(zé)和數(shù)據(jù)庫交互,主要處理一些增刪改查的操作。2016-04-04
.NET應(yīng)用程序集DLL與EXE工作機(jī)制及原理介紹
這篇文章介紹了.NET應(yīng)用程序集DLL與EXE工作機(jī)制及原理,對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2022-02-02

