檢查非同步 Servlet 的行為變更

在 Servlet 3.0 規格中，如果要求隨附查詢字串，則會使此字串可供已分派的資源使用。在 Servlet 3.1 規格中，如果為分派資源提供查詢字串，則會使此查詢字串（而非來自原始要求的查詢字串）可供已分派的資源使用。

下列範例將示範此行為差異：

Request for /FirstResource?param=One First Resource: getParameter("param"); // returns "One" Forward request to /SecondResource?param=Two SecondResource: getParameter("param"); // returns "Two" AsyncContext ac = getAsyncContext(); ac.start(); ac.dispatch(); // dispatches to /FirstResource First Resource: Servlet-3.0 feature : getParameter("param") returns "One" Servlet-3.1 feature : getParameter("param") returns "Two"

不允許在呼叫 AsyncContext.dispatch() 或 AsyncContext.complete() 方法之後取得要求或回應物件，並且會導致下列異常狀況：

java.lang.IllegalStateException: SRVE9015E: Cannot obtain the request or response object after an AsyncContext.dispatch() or AsyncContext.complete().

此規則會標示下列項目：

• 具有 asyncSupported=true 屬性的 javax.servlet.annotation.WebServlet 註釋
• <servlet> 元素中具有 <async-supported>true</async-supported> 元素的 web.xml 及 web-fragment.xml 檔

如需 Servlet 3.1 行為變更的相關資訊，請參閱下列資源： Servlet 3.1 行為變更。