从编程的角度来看,一个MVC应用是由一系列Controller类型构建而成的,所以对于一个代表应用模型的ApplicationModel对象来说,它的核心就是Controllers属性返回的一组ControllerModel对象,每个ControllerModel对象是应用模型针对Controller类型的描述。
一、ControllerModel
二、 实例演示:Controller模型的构建
三、实例演示:定制Controller模型
一、ControllerModel
描述Controller类型的ControllerModel具有如下定义。该类型的Application属性返回作为当前应用模型的ApplicationModel对象。它的Actions属性返回的ActionModel是对所有定义在当前Controller类型中的Action方法的描述。描述Controller类型属性的PropertyModel对象则存放在ControllerProperties属性中,由于PropertyModel和描述Action方法参数的ParameterModel对象承载的都是服务于模型绑定的元数据,所以我们会将这两个类型的介绍放在一起。ControllerModel类型的Selectors属性返回的一组SelectorModel对象是对应用在Controller级别上的Action选择器的描述,我们会在后续内容中对SelectorModel对象进行单独介绍。
public class ControllerModel : ICommonModel, IFilterModel, IApiExplorerModel { public ApplicationModel Application { get; set; } public IList Actions { get; } public IList ControllerProperties { get; } public IList Selectors { get; } public IDictionaryobject, object> Properties { get; } public IList Filters { get; } public ApiExplorerModel ApiExplorer { get; set; } public TypeInfo ControllerType { get; } public IReadOnlyListobject> Attributes { get; } public string ControllerName { get; set; } public string DisplayName { get; } public IDictionarystring, string> RouteValues { get; } MemberInfo ICommonModel.MemberInfo { get; } string ICommonModel.Name { get; } }
ControllerModel类型同时实现了ICommonModel、IFilterModel和IApiExplorerModel接口。默认注册的DefaultApplicationModelProvider会对ControllerModel对象做如下的设置:ControllerType和MemberInfo属性会设置为当前Controller的类型,该类型名称去除“Controller”后缀的字符串会作为Name和ControllerName的属性值。通过标注的特性注册到Controller类型上的过滤器会被提取出来,对应的元数据会添加到Filters属性中。ApiExplorer属性返回的ApiExplorerModel对象由标注在Controller类型上实现了IApiDescriptionGroupNameProvider和IApiDescriptionVisibilityProvider接口的特性构建而成。
DefaultApplicationModelProvider还会将标注到Controller类型上的所有特性提取出来,并将它们添加到Attributes属性中。如果特性类型实现了IRouteTemplateProvider接口,它们将专门用来构建特性路由信息或者路由约束,所以它们会从此列表中移除。DisplayName属性返回的显示名称通过对类型名称作相应格式化生成。DefaultApplicationModelProvider还会提取标注在Controller类型上实现了IRouteValueProvider接口的特性,并利用对应的设置来填充RouteValues属性返回的路由参数。目前唯一实现了该接口的是如下这个用来设置Area名称的AreaAttribute特性,设置的路由参数名称为“area”。
public interface IRouteValueProvider { string RouteKey { get; } string RouteValue { get; } } [AttributeUsage(AttributeTargets.Method | AttributeTargets.Class, AllowMultiple=true, Inherited=true)] public abstract class RouteValueAttribute : Attribute, IRouteValueProvider { public string RouteKey { get; } public string RouteValue { get; } protected RouteValueAttribute(string routeKey, string routeValue); } [AttributeUsage(AttributeTargets.Method | AttributeTargets.Class, AllowMultiple=false, Inherited=true)] public class AreaAttribute : RouteValueAttribute { public AreaAttribute(string areaName) : base("area", areaName) {} }
二、 实例演示:Controller模型的构建
我们照例通过一个简单的实例来演示应用模型中用以描述Controller的元数据采用的默认构建规则。我们在前面演示程序中定义如下这个测试Controller类型FoobarController。如代码片段所示,FoobarController类型上标注了三个特性,分别是用来指定Area的AreaAttribute、过滤器特性FoobarAttribute和设置ApiExplorer的ApiExplorerSettingsAttribute。FoobarController类型中定义了两个属性(A和B)和两个Action方法(Foo和Bar)。
[Area("test")] [Foobar] [ApiExplorerSettings(GroupName = "test")] public class FoobarController { public string A { get; set; } public string B { get; set; } [HttpGet("foo")] public void Foo() => throw new NotImplementedException(); [HttpGet("bar")] public void Bar() => throw new NotImplementedException(); }
为了在页面上呈现描述FoobarController类型的ControllerModel对象的相关信息,我们对定义在HomeControllere中的Action方法Index作了相应的修改。如下面的代码片段所示,我们利用在方法中注入的ApplicationModelProducer对象根据FoobarController类型创建一个ApplicationModel对象,并将包含在该对象中用来描述FoobarController的ControllerModel作为Model呈现成默认的View中。
public class HomeController: Controller { [HttpGet("/")] public IActionResult Index([FromServices]ApplicationModelProducer producer) { var applicationModel = producer.Create(typeof(FoobarController服务器托管网)); return View(applicationModel.Controllers.Single()); } }
我们最后对Action方法Index对应的View文件作相应的修改。如下面的代码片段所示,这是一个Model类型为ControllerModel的强类型View,,它将ControllerModel承载的元数据呈现在一个表格中。
@using Microsoft.AspNetCore.Mvc.ApplicationModels;
@model ControllerModel
@{
var commonModel = (ICommonModel)Model;
var actions = Model.Actions;
var filters = Model.Filters;
var properties = Model.ControllerProperties;
var attributes = Model.Attributes;
var routeValues = Model.RouteValues.ToArray();
}
html>
head>
title>Controllertitle>
head>
body>
table border="1" cellpadding="0" cellspacing="0">
tr>td>ControllerType td>td>@Model.ControllerType.Nametd>tr>
tr>td>ControllerName td>td>@Model.ControllerNametd>tr>
tr>td>Name td>td>@commonModel.Nametd>tr>
tr>td>DisplayName td>td>@Model.DisplayNametd>tr>
tr>td rowspan="@actions.Count">Actionstd>td>@actions[0].ActionNametd>tr>
@for (int index = 1; index actions.Count; index++)
{
tr>td>@actions[index].ActionNametd>tr>
}
tr>
td rowspan="@filters.Count">Filterstd>td>@filters[0].GetType().Nametd>
tr>
@for (int index = 1; index filters.Count; index++)
{
tr>td>@filters[index].GetType().Nametd>tr>
}
tr>
td rowspan="@properties.Count">ControllerPropertiestd>
td>@properties[0].PropertyNametd>
tr>
@for (int index = 1; index properties.Count; index++)
{
tr>td>@properties[index].PropertyNametd>tr>
}
tr>
td rowspan="@attributes.Count">Attributestd>
td>@attributes[0].GetType().Nametd>
tr>
@for (int index = 1; index attributes.Count; index++)
{
tr>td>@attributes[index].GetType().Nametd>tr>
}
tr>
td rowspan="@routeValues.Length">RouteVluestd>
td>@routeValues[0].Key = @routeValues[0].Valuetd>
tr>
@for (int index = 1; index routeValues.Length; index++)
{
tr>td>@routeValues[index].Key = @routeValues[index].Valuetd>tr>
}
tr>
td rowspan="2">ApiExplorertd>
td>IsVisible = @Model.ApiExplorer.IsVisible td>
tr>
tr>td>GroupName = @Model.ApiExplorer.GroupName td>tr>
table>
body>
html>
改动后的演示程序启动后,我们利用浏览器访问应用的主页,可以得到如图1所示的输出结果。正如上面我们所说的,去除“Controller”字符后缀的类型名称成为了ControllerModel对象的Name和ControllerName的属性值(“Foobar”)。两个属性(A和B)和Action方法(Foo和Bar)转换成相应的PropertyModel和ActionModel对象并分别添加到ControllerModel对象的ControllerProperties和Actions属性中。通过标注特性注册的过滤器(FoobarAttribute)被添加到ControllerModel对象的Filters属性中。通过标注的AreaAttribute设置的Area名称最终转移到ControllerModel对象对象RouteValues属性中。ControllerModel对象的ApiExplorer属性返回的ApiExplorerModel对象很明显是通过标注在类型上的ApiExplorerSettingsAttribute特性创建的,而它的Attributes属性中包含了我们标注的三个特性。
图1Controller模型默认的构建规则
三、实例演示:定制Controller模型
通过前面介绍的针对应用模型的总体设计,我们知道针对Controller模型的定制可以通过自定义的IControllerModelConvention实现类型来实现,我们接下来利用这种方式来改变Controller默认的命名规则。我们在上面演示的程序中定义了如下这个ControllerNameAttribute特性,该特性类型实现了IControllerModelConvention接口,在实现的Apply方法中,我们将构造函数中设置的Controller名称应用到提供的ControllerModel对象上。我们将该特性标注到Foo服务器托管网barController类型上并将名称设置为“Baz”。
[AttributeUsage(AttributeTargets.Class)] public class ControllerNameAttribute : Attribute, IControllerModelConvention { public string ControllerName { get; } public ControllerNameAttribute(string name) => ControllerName = name; public void Apply(ControllerModel controller) => controller.ControllerName = ControllerName; } [Area("test")] [Foobar] [ApiExplorerSettings(GroupName = "test")] [ControllerName("Baz")] public class FoobarController { … }
改动后的演示程序启动后,我们利用浏览器访问应用的主页,可以得到如图2所示的输出结果。我们从图中可以看出,对于最终生成的用来描述FoobarController类型的ControllerModel对象来说,它的ControllerName属性被设置成我们指定的名称“Baz”,它的Name属性(ControllerModel类型针对ICommonModel接口的实现)返回的就是ControllerName属性值。
图2 自定义IControllerModelConvention实现类型定制Controller模型
ASP.NET Core MVC应用模型的构建[1]: 应用的蓝图
ASP.NET Core MVC应用模型的构建[2]: 应用模型
ASP.NET Core MVC应用模型的构建[3]: Controller模型
ASP.NET Core MVC应用模型的构建[4]: Action模型
服务器托管,北京服务器托管,服务器租用 http://www.fwqtg.net
机房租用,北京机房租用,IDC机房托管, http://www.fwqtg.net