WebApi 2 return 种类型

Question

我正在查看 WebAPI 2 的文档，我对构建操作结果的方式感到非常失望。我真的希望有更好的方法。

所以文档说我可以 return 这些：

**void**    Return empty 204 (No Content)

**HttpResponseMessage** Convert directly to an HTTP response message.

**IHttpActionResult**   Call ExecuteAsync to create an HttpResponseMessage, then convert to an HTTP response message.

**Other type**  Write the serialized return value into the response body; return 200 (OK).

我没有找到一种干净的方法来 return 具有自定义 HTTP 状态代码、自定义 headers 和自动协商内容的项目数组。

我想看到的是

public HttpResult<Item> Post()
{
   var item = new Item();
   var result = new HttpResult<Item>(item, HttpStatusCode.Created);
   result.Headers.Add("header", "header value");

   return result;
}

这样我可以浏览一个方法并立即看到正在 return 编辑的内容，并修改状态代码和 headers.

我找到的最接近的是 NegotiatedContentResult<T>，带有奇怪的签名（为什么它需要一个控制器实例？），但是没有办法设置自定义 headers?

有没有更好的方法？

Answer 1

下面的代码应该给你你想要的一切：

[ResponseType(typeof(Item))]
public IHttpActionResult Post()
{
    var item = new Item();
    HttpContext.Current.Response.AddHeader("Header-Name", "Header Value");
    return Content(HttpStatusCode.Created, item);
}

...如果你真的需要return一组项目...

[ResponseType(typeof(List<Item>))]
public IHttpActionResult Post()
{
    var items = new List<Item>();
    // Do something to fill items here...
    HttpContext.Current.Response.AddHeader("Item-Count", items.Count.ToString());
    return Content(HttpStatusCode.Created, items);
}

Answer 2

我不认为 web-api 的设计者打算使用控制器方法来摆弄 headers。设计模式似乎是使用 DelegatingHandler, ActionFilterAttribute 和 ApiController 的 ExecuteAsync 可覆盖方法来处理身份验证和响应格式。

那么也许您的消息内容协商逻辑应该在那里处理？

但是，如果您确实需要从您的控制器方法中控制 headers，您可以稍微 set-up 使其工作。为此，您可以创建自己的 DelegationHandler，转发从您的 "Inner" 响应中选择的 headers headers:

public class MessageHandlerBranding : DelegatingHandler {
    protected async override Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
    {
        var response = await base.SendAsync(request, cancellationToken);
        //If we want to forward headers from inner content we can do this:
        if (response.Content != null && response.Content.Headers.Any())
        {
            foreach (var hdr in response.Content.Headers)
            {
                var keyUpr = hdr.Key.ToUpper(); //Response will not tolerate setting of some header values
                if ( keyUpr != "CONTENT-TYPE" && keyUpr != "CONTENT-LENGTH")
                {
                    string val = hdr.Value.Any() ? hdr.Value.FirstOrDefault() : "";
                    response.Headers.Add(hdr.Key, val);                       
                }
            }
        }
        //Add our branding header to each response
        response.Headers.Add("X-Powered-By", "My product");
        return response;
    }  
}

然后在 web-api 配置中注册此处理程序，这通常在 GlobalConfig.cs 文件中。

config.MessageHandlers.Add(new MessageHandlerBranding());

您也可以像这样为响应 object 编写自己的自定义 class：

public class ApiQueryResult<T> : IHttpActionResult where T : class
{
    public ApiQueryResult(HttpRequestMessage request)
    {
        this.StatusCode = HttpStatusCode.OK; ;
        this.HeadersToAdd = new List<MyStringPair>();
        this.Request = request;
    }

    public HttpStatusCode StatusCode { get; set; }
    private List<MyStringPair> HeadersToAdd { get; set; }
    public T Content { get; set; }
    private HttpRequestMessage Request { get; set; }

    public void AddHeaders(string headerKey, string headerValue)
    {
        this.HeadersToAdd.Add(new MyStringPair(headerKey, headerValue));
    }

    public Task<HttpResponseMessage> ExecuteAsync(CancellationToken cancellationToken)
    {
        var response = this.Request.CreateResponse<T>(this.StatusCode, this.Content);
        foreach (var hdr in this.HeadersToAdd)
        {
            response.Content.Headers.Add(hdr.key, hdr.value); 
        }
        return Task.FromResult(response);
    }


    private class MyStringPair
    {
        public MyStringPair(string key, string value)
        {
            this.key = key;
            this.value = value;
        }
        public string key;
        public string value;
    }
}

并在你的控制器中像这样使用它：

 [HttpGet]
    public ApiQueryResult<CustomersView> CustomersViewsRow(int id)
    {
        var ret = new ApiQueryResult<CustomersView>(this.Request);
        ret.Content = this.BLL.GetOneCustomer(id);
        ret.AddHeaders("myCustomHkey","myCustomValue");
        return ret;
    }

WebApi 2 return 种类型

WebApi 2 return types

c#

asp.net-web-api

asp.net-web-api2