Module jdk.httpserver
Package com.sun.net.httpserver

Class HttpContext

java.lang.Object
com.sun.net.httpserver.HttpContext
public abstract class HttpContext extends Object
HttpContext表示应用程序的根URI路径与在关联的HttpServer或HttpsServer上处理该路径的请求的HttpHandler之间的映射。

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

可以向HttpContext添加一系列Filter对象。上下文中处理的所有交换都可以由链中的每个Filter进行预处理和后处理。

自版本:
1.6

  • Constructor Details

    • HttpContext

      protected HttpContext()
      子类调用的构造函数。

  • Method Details

    • getHandler

      public abstract HttpHandler getHandler()
      返回此上下文的处理程序。
      返回:
      此上下文的HttpHandler

    • setHandler

      public abstract void setHandler(HttpHandler handler)
      如果尚未设置，为此上下文设置处理程序。
      参数:
      handler - 要为此上下文设置的处理程序
      抛出:
      IllegalArgumentException - 如果已设置此处理程序的上下文。
      NullPointerException - 如果处理程序为null

    • getPath

      public abstract String getPath()
      返回创建此上下文的路径。
      返回:
      此路径的上下文

    • getServer

      public abstract HttpServer getServer()
      返回创建此上下文的服务器。
      返回:
      此服务器的上下文

    • getAttributes

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

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

      返回:
      包含此上下文属性的Map

    • getFilters

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

    • setAuthenticator

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

    • getAuthenticator

      public abstract Authenticator getAuthenticator()
      如果存在，返回此上下文的当前设置的Authenticator。
      返回:
      此HttpContext的Authenticator，如果未设置则为null