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 Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
abstract Map<String,Object>	getAttributes()	返回一个可变的Map，可用于将配置和其他数据传递给Filter模块和上下文的交换处理程序。
abstract Authenticator	getAuthenticator()	如果存在，返回此上下文的当前设置的Authenticator。
abstract List<Filter>	getFilters()	返回此上下文的List的过滤器。
abstract HttpHandler	getHandler()	返回此上下文的处理程序。
abstract String	getPath()	返回创建此上下文的路径。
abstract HttpServer	getServer()	返回创建此上下文的服务器。
abstract Authenticator	setAuthenticator(Authenticator auth)	为此HttpContext设置Authenticator。
abstract void	setHandler(HttpHandler handler)	如果尚未设置，为此上下文设置处理程序。

Methods declared in class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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