【ASP.NET Core】MVC控制器的各种自定义：修改参数的名称

在上一篇中，老周演示了通过实现约定接口的方式自定义控制器的名称。

至于说自定义操作方法的名称，就很简单了，因为有内置的特性类可以用。看看下面的例子。

    [Route("[controller]/[action]")]

    public class StockController : Controller

    {

        [ActionName("OutGoing"), HttpGet("{q?}")]

        public string Sendout(int q) => $"今天发出{q}笔订单";

    }

上述代码中，本来操作方法的名称是“Sendout”，但应用了 ActionName 特性后，就变成“OutGoing”了。访问 /stock/outgoing/12 试试看。

如何？简单吧。可是有大伙伴会说，那我用实现约定接口的方式能实现吗？能，扩展的是 IActionModelConvention 接口，修改 ActionModel 实例的 ActionName 属性就可以了。请参考下面代码：

[AttributeUsage(AttributeTargets.Method, AllowMultiple = false, Inherited = true)]

public class MyActionNameAttribute : Attribute, IActionModelConvention

{

    private readonly string _actionName;

    public MyActionNameAttribute(string Name)

    {

       _actionName = Name;

    }

    public void Apply(ActionModel action)

    {

        action.ActionName = _actionName;

    }

}

然后，咱们用自己定义的这个特性类替换 ActionName 特性。

    [Route("[controller]/[action]")]

    public class StockController : Controller

    {

        [MyActionName("OutGoing"), HttpGet("{q?}")]

        public string Sendout(int q) => $"今天发出{q}笔订单";

    }

效果是一样的哟。

------------------------------------------------------------------ 银河分隔线 ----------------------------------------------------------------

控制器和操作方法的自定义名称好弄，但，方法参数的名称就不好弄了。有大伙伴就不乐意了，我直接按思路套代码不就行了吗？扩展下 IParameterModelConvention 接口，然后设置 ParameterModel.ParameterName 属性不就完事了吗？

是的，梦境总是那么美好，咱们不妨试试。

    [AttributeUsage(AttributeTargets.Parameter, AllowMultiple = false, Inherited = true)]

    public class MyParameterAttribute : Attribute, IParameterModelConvention

    {

        private readonly string _name;

        public MyParameterAttribute(string name)

        {

            _name = name;

        }

        public void Apply(ParameterModel parameter)

        {

            parameter.ParameterName = _name;

        }

    }

接着，套在控制器的操作方法上。

public class TestController : Controller

{

    [HttpGet("test/get")]

    public int GetNumber([MyParameter("num")]int xx) => xx * 5;

}

试试看，访问 /test/get?num=5。结果……

WTF，这是咋回事呢？不知道伙伴们有没有看过老周曾写过模型绑定的水文。其实这里我们不需要对模型绑定有多深的了解，但我们得知道，对于操作方法的参数来说，是存在模型绑定这一过程的。这就导致不能修改一下参数名就完事了，ModelBinder 认的是参数的数据类型，而不是 ApplicationModel 中的信息。这里头牵涉的东西太多了，你无法任性地扩展一两个接口就能完事的。但也不是没有办法，不用写扩展，有个现成的特性类也能给参数设置别名。

   [HttpGet("test/get")]

   public int GetNumber([ModelBinder(Name = "num")]int xx) => xx * 5;

使用 ModelBinder特性，然后改一下 Name 属性就好了。咱们再试试。

怎么样，有效果吧。

可你又说了，我要是坚持要通过约定接口来扩展，那有法子乎？有，原理一样，改 ModelBinder 的名字。

    [AttributeUsage(AttributeTargets.Parameter, AllowMultiple = false, Inherited = true)]

    public class MyParameterAttribute : Attribute, IParameterModelConvention

    {

        private readonly string _name;

        public MyParameterAttribute(string name)

        {

            _name = name;

        }

        public void Apply(ParameterModel parameter)

        {

            // 注意，BindingInfo 属性可能会为null

            parameter.BindingInfo ??= new BindingInfo();

            // 修改模型名称

            parameter.BindingInfo.BinderModelName = _name;

        }

    }

原理就是设置 BindingInfo 类的 BinderModelName 属性。

再试试看。

[HttpGet("test/get")]

public int GetNumber([MyParameter("num")]int xx) => xx * 5;

总算有满意的结果了。

巴特西

【ASP.NET Core】MVC控制器的各种自定义：修改参数的名称

最新文章

热门文章