本文介绍WebApi2如何将action中的结果返回至Http输出中。
一个WebApi Controller可以返回以下任意一种类型：
1.void
2.HttpReponseMessage
3.IHttpActionResult
4.其他类型
依据不同返回类型，WebApi会选择不同的机制来创建Http Reponse
该接口定义了一个方法ExecuteAsync，用来创建HttpReponseMessage实例
public interface IHttpActionResult
{
Task<HttpResponseMessage> ExecuteAsync(CancellationToken cancellationToken);
}
所以，当Action返回一个IHttpActionResult接口的时候，WebApi会调用ExecuteAsync方法生成HttpReponseMessage实例，然后HttpReponseMessage实例会将信息写入到Http响应中返回给用户。
下面是一个简单的继承IHttpActionResult接口，返回给客户端一个文本信息的例子：
继承：
public class TextResult : IHttpActionResult
{
string _value;
HttpRequestMessage _request;
public TextResult(string value, HttpRequestMessage request)
{
_value = value;
_request = request;
}
public Task<HttpResponseMessage> ExecuteAsync(CancellationToken cancellationToken)
{
var response = new HttpResponseMessage()
{
Content = new StringContent(_value),
RequestMessage = _request
};
return Task.FromResult(response);
}
}
Controller：
public class ValuesController : ApiController
{
public IHttpActionResult Get()
{
return new TextResult(“hello”, Request);
}
}
Response:
HTTP/1.1 200 OK
Content-Length: 5
Content-Type: text/plain; charset=utf-8
Server: Microsoft-IIS/8.0
Date: Mon, 27 Jan 2014 08:53:35 GMT
hello
但是，通常情况下我们会使用System.Web.Http.Results命名空间中的IHttpActionResult实现类。并且ApiController的一些内建辅助类可以返回这些实现类。
在下面的例子中，如果没有找到对应的产品ID，则会调用ApiController.NotFound返回一个404的IHttpActionResult的实例。否则的话，调用ApiController.OK返回一个包含产品信息的200状态的结果。
public IHttpActionResult Get (int id)
{
Product product = _repository.Get (id);
if (product == null)
{
return NotFound(); // Returns a NotFoundResult
}
return Ok(product); // Returns an OkNegotiatedContentResult
}
4.Other Return Types其他返回类型
对于其他返回类型，WepApi会调用media formatter来序列化对象，还记得前面讲的吗，WebApi会根据请求中ACCEPT头来自动选择formatter（Content Negotiation）。然后将序列化结果写入到响应信息中。
public class ProductsController : ApiController
{
public IEnumerable<Product> Get()
{
return GetAllProductsFromDB();//将会序列化
}
}
注意：因为返回的是自定义类型，所以你不能直接指定返回错误代码404等，但是你可以通过抛出HttpResponseException 异常来指定错误代码，更多信息请看
Exception Handling in ASP.NET Web API.
请求信息：
GET http://localhost/api/products HTTP/1.1
User-Agent: Fiddler
Host: localhost:24127
Accept: application/json
相应信息：
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/8.0
Date: Mon, 27 Jan 2014 08:53:35 GMT
Content-Length: 56
[{“Id”:1,”Name”:”Yo-yo”,”Category”:”Toys”,”Price”:6.95}]
