摘要：異步處理是指給這些阻塞操作分配一個新線程，并把關聯請求處理的線程返回給容器。異步處理支持和的異步處理。在一個上啟用異步處理，設置注解的參數為，如下類提供在方法中執行異步處理所需的功能。

應用服務器的web容器通常會為每個請求分配一個服務線程。在重負載的場景下，容器需要大量的線程去服務所有客戶端請求。服務可擴展性的限制包括內存不足或者耗盡容器線程。創建可擴展web程序，你必須確保沒有關聯請求的線程是空閑的，所以容器可以使用他們處理新請求。
這里有兩個關聯請求的線程空閑的兩個場景：

線程需要在構建響應之前等待一個資源可用或者處理數據。例如，一個應用程序需要在構建響應前查詢數據庫或者通過遠程web服務訪問數據。

線程需要在構建響應之前等待一個事件。例如，線程在構建響應之前需要等待一個JMS消息，另一個客戶端的新信息，或者隊列里面的新數據可用。

這些場景代表限制web程序可擴展性的阻塞操作。異步處理是指給這些阻塞操作分配一個新線程，并把關聯請求處理的線程返回給web容器。

java ee支持servlet和filter的異步處理。如果一個servlet或一個filter處理請求時可能到達一個阻塞操作，它可以把操作分配給一個異步處理上下文并且在不生成響應的情況下將關聯請求處理的線程回送給web容器。阻塞操作在不同線程的異步上下文中執行完成，它可以生成響應或者轉發請求到另一個servlet。
在一個servlet上啟用異步處理，設置@WebServlet注解的asyncSupported參數為true，如下：

@WebServlet(urlPatterns={"/asyncservlet"}, asyncSupported=true)
public class AsyncServlet extends HttpServlet { ... }

javax.servlet.AsyncContext類提供在Service方法中執行異步處理所需的功能。獲得一個AsyncContext實例，在service方法中調用request對象的startAsync()方法；例如：

public void doGet(HttpServletRequest req, HttpServletResponse resp) {
   ...
   AsyncContext acontext = req.startAsync();
   ...
}

這個調用將請求進入異步模式并且確保響應在退出service方法時每月被提交。你必須在異步上下文完成阻塞操作時生成響應或者轉發到其他servlet中。
AsyncContext類提供的基礎功能描述：
方法簽名：void start(Runnable run)
描述：容器提供的能提供阻塞操作處理的不同線程
方法簽名：ServletRequest getRequest()
描述：返回用來初始化異步上下文的請求。在上面的例子中，request與service方法中的相同。你可以通過這個方法在異步上下文中從請求中獲取參數。
方法簽名：ServletResponse getResponse()
描述：返回初始化異步上下文的響應。在上面的例子中，response與service方法中的相同。你可以在異步上下文中，使用這個方法寫入阻塞操作的結果到響應中。
方法簽名：void complete()
描述：完成異步操作，并關閉與此異步上下文關聯的響應。你可以在異步上下文完成寫入響應后調用這個操作。
方法簽名：void dispatch(String path)
描述：轉發請求和響應到給定的路徑。在阻塞操作完成后，使用這個方法調用另一個servlet寫出響應。

這個章節示范了怎么使用AsyncContext上下文提供的功能，有如下用例：

servlet從一個GET請求中獲取參數

servlet使用一個資源，比如一個數據庫或者一個web service，基于這個參數獲取信息。這個資源可能比較緩慢，所以這可能是一個阻塞操作。

servlet使用資源的結果生成響應。

下面的例子是一個不使用異步處理的常見servlet：

@WebServlet(urlPatterns={"/syncservlet"})
public class SyncServlet extends HttpServlet {
   private MyRemoteResource resource;
   @Override
   public void init(ServletConfig config) {
      resource = MyRemoteResource.create("config1=x,config2=y");
   }

   @Override
   public void doGet(HttpServletRequest request, 
                     HttpServletResponse response) {
      response.setContentType("text/html;charset=UTF-8");
      String param = request.getParameter("param");
      String result = resource.process(param);
      /* ... print to the response ... */
   }
}

下面的示例是同一個servlet，但使用了異步處理：

@WebServlet(urlPatterns={"/asyncservlet"}, asyncSupported=true)
public class AsyncServlet extends HttpServlet {
   /* ... Same variables and init method as in SyncServlet ... */

   @Override
   public void doGet(HttpServletRequest request, 
                     HttpServletResponse response) {
      response.setContentType("text/html;charset=UTF-8");
      final AsyncContext acontext = request.startAsync();
      acontext.start(new Runnable() {
         public void run() {
            String param = acontext.getRequest().getParameter("param");
            String result = resource.process(param);
            HttpServletResponse response = acontext.getResponse();
            /* ... print to the response ... */
            acontext.complete();
   }
}

AsyncServlet在@WebServlet注解屬性中添加asyncSupported=true。其余的差異在service方法中：

request.startAsync() 引發request被異步執行；response不會在service方法結束時發送到客戶端；

acontext.start(new Runnable() {...})從容器中得到一個新的線程。

內部類中的run() 中的代碼在一個新線程中執行。內部類需要從異步上下文中讀取請求參數和寫入響應。調用異步上下文的complete()方法來提交并發送響應到客戶端。

AsyncServlet的service方法立即返回，同時請求在異步上下文中處理。