Module  java.xml.ws
软件包  javax.xml.ws.spi.http

Class HttpContext


  • public abstract class HttpContext
extends Object
    HttpContext表示Web服务的根URI路径与HttpHandler之间的映射，该对象被调用以处理发往关联容器上的该路径的请求。

    Container为此提供了实现，并将Web服务请求与相应的HttpContext对象相匹配。

    从以下版本开始：
    1.7，JAX-WS 2.2

    • 字段详细信息

      • handler

        protected HttpHandler handler
        为此上下文设置的处理程序。

    • 构造方法详细信息

      • HttpContext

        public HttpContext​()

    • 方法详细信息

      • setHandler

        public void setHandler​(HttpHandler handler)
        JAX-WS运行时在Endpoint.publish(HttpContext)中设置其处理程序来处理此上下文的HTTP请求。 容器或其扩展名使用此处理程序来处理请求。
        参数
        handler - 为此上下文设置的处理程序

      • getPath

        public abstract String getPath​()
        返回此上下文的路径。 此路径唯一标识应用程序内的端点，并且该路径是相对于应用程序的上下文路径。 容器应该根据如何将请求URI与此HttpContext对象相匹配来提供此路径。

        对于servlet容器，这通常是端点的url模式。

        该上下文的端点地址可以计算如下： 

          HttpExchange exch = ...;
  String endpointAddress =
      exch.getScheme() + "://"
      + exch.getLocalAddress().getHostName()
      + ":" + exch.getLocalAddress().getPort()
      + exch.getContextPath() + getPath();
        结果
        这个上下文的路径

      • getAttribute

        public abstract Object getAttribute​(String name)
        返回容器配置的属性值和jax-ws运行时可以使用的其他数据。
        参数
        name - 属性名称
        结果
        属性值

      • getAttributeNames

        public abstract Set<String> getAttributeNames​()
        返回容器配置的所有属性名称和jax-ws运行时可以使用的其他数据。
        结果
        所有属性名称的集合