c# - WebApi POST 可以在没有 [FromBody] 的情况下工作吗？

Question

我有这个 Controller Action :

 [HttpPost]
 [ActionName("aaa")]
 public HttpResponseMessage aaa(Z z) //notice  - no [FromBody]
 {
    return Request.CreateResponse(HttpStatusCode.OK, 1);  
 }

Z 是:

public class Z
 {
   public string a { get; set; }
 }

但是当我通过 fiddler 发帖时:

POST http://localhost:11485/api/profiles/aaa HTTP/1.1
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
Host: localhost:11485
Content-Length: 3
Accept-Encoding: gzip, deflate
Accept-Language: en-US,en;q=0.8,he;q=0.6
Cache-Control: no-cache
Connection: keep-alive

a=1

我实际上可以看到它正在工作:

问题:

如果是这样，它在没有 [FromBody] 属性的情况下如何工作？我还需要/不写这个属性吗？

另外，不写这个属性的场景是什么 - 会导致问题？

Answer 1

绑定(bind)对于 MVC 和 Web API 是不同的。默认情况下，ASP.NET Web API 绑定(bind)来自请求消息正文的复杂类型和来自 URI、查询字符串等的简单类型。由于您指定了 Z，它是一个类(复杂类型)，它会填充body 中的操作方法参数，而无需指定 [FromBody]。另一方面，如果您的请求是没有正文的 http://localhost:11485/api/profiles/aaa?z=1，它不会自动绑定(bind)到您的复杂参数。在这种情况下，您需要像这样指定 [FromUri]:public HttpResponseMessage aaa([FromUri]Z z)。

另一方面，假设您的操作方法是 public HttpResponseMessage aaa(string a)。我们现在有了 string，这是一个简单的类型。在这种情况下，没有消息正文的 http://localhost:11485/api/profiles/aaa?a=1 将让 Web API 正确绑定(bind)参数，而无需指定 [FromUri ]。现在，如果你想在这种情况下从 body 绑定(bind)，你将需要指定 public HttpResponseMessage aaa([FromBody]string a)。当然对于这个body必须是=1，对于application/x-www-form-urlencoded，没有a的键名。

底线 - 您的参数(简单类型或复杂类型)决定了 Web API 的绑定(bind)方式。要使其与默认行为不同，您需要通过 FromUri 或 FromBody 进行告知。

附言。我上面提到的任何内容都完全适用于良好的旧 ASP.NET Web API(包括 2)。在 ASP.NET 5.0 a.k.a ASP.NET vNext 或 ASP.NET MVC 6.0 中，MVC 和 Web API 已统一。为了让它从 body 绑定(bind)复杂类型，您必须指定 [FromBody]。