【ASP.NET Web API教程】5.4 ASP.NET Web API批处理器Batching Handler for ASP.NET Web API 5.4 ASP.NET Web API批处理器

本文引自：http://bradwilson.typepad.com/blog/2012/06/batching-handler-for-web-api.html

Brad Wilson ｜ June 20, 2012

作者：Brad Wilson ｜ 日期：2012-6-20

While there is no batching standard built into the HTTP protocol, there is a standard for MIME encoding HTTP request and response messages ("application/http" with "msgtype=request" and "msgtype=response", respectively). ASP.NET Web API has built-in support for both MIME multipart as well as encoded request and response messages, so we have all the building blocks we need to make a simple batch request handler.

当批处理标准尚未进入HTTP协议时，就已经有了对HTTP请求和响应消息进行编码的MIME标准（分别采用“msgtype=request”和“msgtype=response”的“application/http”）。ASP.NET Web API对MIME的multipart（多部分内容类型）、以及经过编码请求和响应消息都有内建的支持，因此，我们拥有了制作简单的请求批处理器的全部构建块。

All we need to make this work is an endpoint which can accept a multipart batch (an invention of our own), which then parses the requests, runs them sequentially, and returns the responses back in a multipart batch response.

我们所要做的全部工作只是一个端点（endpoint），它可以接收一个multipart batch（多部批，一个我们自己发明的内容类型），然后用它对请求进行解析，按顺序执行请求，并以一个multipart batch响应的形式返回一个响应。

Starting with a Web API project (built against the latest nightly build), I updated the Web API config to look like this:

从一个Web API项目（根据最新版建立的项目）开始，我修改了Web API的config，它看上去像这样：

I've inserted the handler for "api/batch" as our endpoint for batching requests, using the new "route-specific endpoint handler" feature in Web API. Note that since its URL is "api/batch", I made sure to add it before the default API route.

我已经为“api/batch”插入了处理器，以此作为对请求进行批处理的端点，这种做法利用了Web API中的“路由专用的端点处理器”特性。注，由于它的URL是“api/batch”，必须把它添加在默认的API路由之前。

Using async & await in .NET 4.5 makes the implementation of BatchHandler fairly straight-forward. All we need is an in-memory HttpServer which uses our existing configuration, so that the batched requests hit the exact same endpoints as requests from the Internet:

利用.NET 4.5中的async和await可以很直接地构造BatchHandler实现。我们所需要的只是一个放在内存中的HttpServer，它使用当前配置，以便当请求来自Internet时，需要分批的请求会找到完全相同的端点：

Now we have an endpoint that we can send multipart/batch requests to, which are assumed to be HTTP request objects (anything which isn't is going to yield a 400).

现在，我们拥有了一个端点，我们能够把multipart/batch请求发送给它，假设这些请求都是HTTP请求对象（任何不是HTTP请求的对象都会产生一个400状态码）。

On the client side, we make a multipart request and push requests into the multipart batch, one at a time:

在客户端，我们形成了一个multipart请求，并把请求推入multipart batch，每次压入一个请求：

In a console application, we can log both the request and response with code like this:

在一个控制台应用程序中，我们可以用以下代码对请求和响应时行日志：

When I run this console application, I see output similar to this:

当运行这个控制台应用程序时，会看到输出类似于这样：

As you can see, our batch was successfully run, and the results show what we'd expected (the two real API calls returned back 200 with their data, and the bogus request we threw in the middle returns back a 404).

正如我们所看到的，批处理成功地运行了，并且显示了我们所期望的结果（两个真正的API调用返回了带有其数据的200状态码，而在中间压入的伪造请求返回了404状态码）。