使用Web Api CreateResponse <content>()和CreateResponse()之间有什么区别吗?</content>

时间:2013-10-23 08:12:20

标签: c# asp.net-mvc caching asp.net-web-api http-headers

鉴于以下内容:

    [HttpGet]
    [ActionName("GetContent")]
    public HttpResponseMessage GetContent(int id)
    {
        Content content = _uow.Contents.GetById(id);
        if (content == null)
        {
            var message = string.Format("Content with id = {0} not found", id);
            return Request.CreateErrorResponse(HttpStatusCode.NotFound, message);
        }
        else
        {
            return Request.CreateResponse(HttpStatusCode.OK, content);
        }
    }

    [HttpGet]
    [ActionName("GetContent")]
    public HttpResponseMessage GetContent(int id)
    {
        try
        {
            Content content = _uow.Contents.GetById(id);
            if (content == null)
            {
                throw new HttpResponseException(Request.CreateResponse(HttpStatusCode.NotFound));
            }
            return Request.CreateResponse<Content>(HttpStatusCode.OK, content);
        }
        catch (Exception ex)
        {
            return Request.CreateErrorResponse(HttpStatusCode.BadRequest, ex);
        } 

    }

我见过两种编码风格。一个使用例外,另一个不使用。一个使用CreateResponse&lt;&gt;和另一个CreateResponse()。有人能说出使用这些有什么优点/缺点吗?据我所知,第二种方法似乎看起来更完整但是真的需要使用try / catch来做这么简单的事情吗?

1 个答案:

答案 0 :(得分:10)

投掷HttpResponseException的主要好处是当您的操作方法返回模型类型而不是HttpResponseMessage时。例如:

public Product Get(int id) 
{
    Product p = _GetProduct(id);
    if (p == null)
    {
        throw new HttpResponseException(HttpStatusCode.NotFound);
    }
    return p;
}

这相当于以下内容:

public HttpResponseMessage Get(int id) 
{
    Product p = _GetProduct(id);
    if (p == null)
    {
        return Request.CreateResponse(HttpStatusCode.NotFound);
    }
    return Request.CreateResponse(HttpStatusCode.OK, p);
}

选择任何一种风格都可以。

您不应该捕获HttpResponseException,因为重点是Web API管道捕获它们并将它们转换为HTTP响应。在您的第二个代码示例中,当您确实希望客户端接收Not Found(404)时,Not Found错误会被捕获并变为Bad Request错误。

更长的答案:

CreateResponse vs CreateResponse<T>与使用HttpResponseException无关。

CreateResponse返回没有邮件正文的HTTP响应:

public HttpResponseMessage Get()
{
    return Request.CreateResponse(HttpStatusCode.NotFound);
}

CreateResponse<T>获取类型为T的对象,并将该对象写入HTTP响应的主体:

public HttpResponseMessage Get()
{
    Product product = new Product();
    // Serialize product in the response body
    return Request.CreateResponse<Product>(HttpStatusCode.OK, product);  
}

下一个示例完全相同,但使用类型推断来省略泛型类型参数:

public HttpResponseMessage Get()
{
    Product product = new Product();
    // Serialize product in the response body
    return Request.CreateResponse(HttpStatusCode.OK, product);  
}

CreateErrorResponse方法创建一个HTTP响应,其响应主体是HttpError对象。这里的想法是使用通用消息格式进行错误响应。调用CreateErrorResponse基本上与此相同:

HttpError err = new HttpError( ... )
// Serialize err in the response.
return Request.CreateResponse(HttpStatusCode.BadRequest, err);