Dispatch 方法


Dispatch 方法

可以使用 AsyncContext 中下面的方法来转发请求:

dispatch(path)

这个 dispatch 方法的 String 参数描述了一个在 ServletContext 作用域中的路径。这个路径必须是相对于 ServletContext 的根路径并以’/’开头。

dispatch(servletContext, path)

这个 dispatch 方法的 String 参数描述了一个在 ServletContext 指定作用域中的路径。这个路径必须是相对于 ServletContext 的根路径并以’/’开头。

dispatch()

这个方法没有参数,它使用原来的URI路径。如果 AsyncContext 已经通过 startAsync(ServletRequest, ServletResponse) 初始化,且传递过来的请求是 HttpServletRequest 的实例,那么这个请求分发到HttpServletRequest.getRequestURI() 返回的 URI。否则转发到容器最后一次转发的URI。

AsyncContext 接口中的 dispatch 方法可被等待异步事件发生的应用程序调用。如果 AsyncContext 已经调用了 complete() 方法,必须抛出IllegalStateException 异常。所有不同的 dispatch 方法会立即返回并且不会提交响应。

请求对象暴露给目标 servlet 的路径元素(path elements)必须反映AsyncContext.dispatch 中指定的路径

查询字符串

请求调度机制是在调度请求时负责聚焦(aggregating)查询字符串。

调度请求参数

使用 AsyncContext 的 dispatch 方法调用过的 servlet 能够访问原始请求的路径。 下面的request属性必须设置:

javax.servlet.async.request_uri
javax.servlet.async.context_path
javax.servlet.async.servlet_path
javax.servlet.async.path_info
javax.servlet.async.query_string

这些属性的值必须分别与 HttpServletRequest 的 getRequestURI、getContextPath、 getServletPath、getPathInfo、getQueryString 方法的返回值相等,这些方法在从客户端接收到的请求对象上调用,值传递给调用链中的第一个 servlet 对象。

这些属性都可以从分发的 servlet 通过请求对象的 getAttribute 方法获得。注意,这些属性必须反映原始请求中的信息,甚至是多个分发的情况。