模块  jdk.httpserver
软件包  com.sun.net.httpserver

Class HttpContext

  • public abstract class HttpContext
extends Object
    HttpContext表示应用程序的根URI路径与HttpHandler之间的映射，该路径被调用以处理发往相关HttpServer或HttpsServer上该路径的请求。

    HttpContext实例由HttpServer和HttpsServer中的create方法创建

    可以将一个Filter对象链添加到HttpContext中。 由上下文处理的所有交换可以由链中的每个过滤器预处理和后处理。

    从以下版本开始：
    1.6

    • 构造方法详细信息

      • HttpContext

        protected HttpContext()

    • 方法详细信息

      • getHandler

        public abstract HttpHandler getHandler()
        返回此上下文的处理程序
        结果
        这个上下文的HttpHandler

      • setHandler

        public abstract void setHandler​(HttpHandler h)
        设置此上下文的处理程序（如果尚未设置）。
        参数
        h - 为此上下文设置的处理程序
        异常
        IllegalArgumentException - 如果已设置此上下文的处理程序。
        NullPointerException - 如果handler是 null

      • getPath

        public abstract String getPath()
        返回创建此上下文的路径
        结果
        这个上下文的路径

      • getServer

        public abstract HttpServer getServer()
        返回创建此上下文的服务器
        结果
        这个上下文的服务器

      • getAttributes

        public abstract Map<String,​Object> getAttributes()
        返回一个可变Map，可用于将配置和其他数据传递给Filter模块和上下文的交换处理程序。

        存储在此Map中的每个属性对于此上下文处理的每个HttpExchange都是可见的

      • getFilters

        public abstract List<Filter> getFilters()
        返回此上下文的Filters列表。 这是服务器在分派请求时使用的实际列表，因此对此列表的修改会立即影响交换的处理。

      • setAuthenticator

        public abstract Authenticator setAuthenticator​(Authenticator auth)
        为此HttpContext设置Authenticator。 一旦在上下文上建立了身份验证器，就必须对所有客户端请求进行身份验证，并调用给定对象来验证每个请求。 每次调用此方法都会替换以前的任何值集。
        参数
        auth - 要设置的身份验证器。 如果null则删除任何先前设置的身份验证器，并且将不再需要客户端身份验证。
        结果
        如果有任何设置， null上一个Authenticator，否则为 null 。

      • getAuthenticator

        public abstract Authenticator getAuthenticator()
        返回当前为此上下文设置的Authenticator（如果存在）。
        结果
        这个HttpContext的Authenticator，如果没有设置， null 。