Module  jdk.httpserver
软件包  com.sun.net.httpserver

Class HttpContext


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

    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 - 如果处理程序是 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​()
        返回此上下文的过滤器列表。 这是服务器在发送请求时使用的实际列表，因此对此列表的修改会立即影响交换机的处理。

      • setAuthenticator

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

      • getAuthenticator

        public abstract Authenticator getAuthenticator​()
        返回当前设置的身份验证器（如果存在）。
        结果
        这个HttpContext的Authenticator，或者如果没有设置， null 。