asp.net webapi中action的选择与参数绑定

一、action的选择

• action的选择主要包含三个步骤
  • 第一步：Http Method
    • 首先根据请求方法，例如Get、Post等，从controller中所有有效的action方法中筛选出actionName是以请求方法开头的action，例如GetXXX
    • 或者action上由attribute显式标注了对哪种方式的请求进行响应，例如[HttpGet]
    • 如果actionName既没有以请求方法开头，action也没有attribute显式标注，则默认支持Post请求
  • 第二步：路由匹配值
    • 路由模板中显式定义了action，则直接按名称进行匹配
      • 例如，api/{controller}/{action}/{id}
  • 第三步：action的参数绑定
    • 如果action中定义的所有参数，都能绑定成功，则从所有能绑定成功的action中，查找出参数最多的action

二、参数绑定

• 对于action中的参数
  • 如果是简单类型，则绑定值主要来源于两类
    • URL路由匹配
    • QueryString
  • 如果是复杂类型，则绑定值主要来源于请求主体
  • 可以通过attribute显式指定绑定值的来源
    • [FromUri]
      • 主要用于复杂类型，标记绑定值从URL路由匹配或者QueryString中获取
    • [FromBody]
      • 主要用于简单类型，标记绑定值从请求主体中获取
      • 最多只能有一个参数从请求主体中读取
        • 请求主体可能保存在非缓冲的流中，只能读取一次