java.lang.Object
com.sun.net.httpserver.HttpContext
HttpContext
represents a mapping between the root URI
path of an application to a HttpHandler
which is invoked to handle
requests destined for that path on the associated HttpServer
or
HttpsServer
.
HttpContext
instances are created by the create methods in
HttpServer
and HttpsServer
.
A chain of Filter
objects can be added to a HttpContext
.
All exchanges processed by the context can be pre- and post-processed by each
Filter
in the chain.
- Since:
- 1.6
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionabstract Authenticator
Returns the currently setAuthenticator
for this context if one exists.abstract HttpHandler
Returns the handler for this context.abstract String
getPath()
Returns the path this context was created with.abstract HttpServer
Returns the server this context was created with.abstract Authenticator
Sets theAuthenticator
for thisHttpContext
.abstract void
setHandler
(HttpHandler handler) Sets the handler for this context, if not already set.
-
Constructor Details
-
HttpContext
protected HttpContext()Constructor for subclasses to call.
-
-
Method Details
-
getHandler
Returns the handler for this context.- Returns:
- the
HttpHandler
for this context
-
setHandler
Sets the handler for this context, if not already set.- Parameters:
handler
- the handler to set for this context- Throws:
IllegalArgumentException
- if the context for this handler is already set.NullPointerException
- if handler isnull
-
getPath
Returns the path this context was created with.- Returns:
- the context of this path
-
getServer
Returns the server this context was created with.- Returns:
- the context of this server
-
getAttributes
Returns a mutableMap
, which can be used to pass configuration and other data toFilter
modules and to the context's exchange handler.Every attribute stored in this
Map
will be visible to everyHttpExchange
processed by this context.- Returns:
- a
Map
containing the attributes of this context
-
getFilters
Returns this context'sList
of filters. This is the actual list used by the server when dispatching requests so modifications to this list immediately affect the handling of exchanges.- Returns:
- a
List
containing the filters of this context
-
setAuthenticator
Sets theAuthenticator
for thisHttpContext
. Once an authenticator is established on a context, all client requests must be authenticated, and the given object will be invoked to validate each request. Each call to this method replaces any previous value set.- Parameters:
auth
- theAuthenticator
to set. Ifnull
then any previously setAuthenticator
is removed, and client authentication will no longer be required.- Returns:
- the previous
Authenticator
, if any set, ornull
otherwise.
-
getAuthenticator
Returns the currently setAuthenticator
for this context if one exists.- Returns:
- this HttpContext's
Authenticator
, ornull
if none is set
-