Class HttpContext
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
Constructors -
Method Summary
Modifier and TypeMethodDescriptionabstract AuthenticatorReturns the currently setAuthenticatorfor this context if one exists.abstract HttpHandlerReturns the handler for this context.abstract StringgetPath()Returns the path this context was created with.abstract HttpServerReturns the server this context was created with.abstract AuthenticatorSets theAuthenticatorfor thisHttpContext.abstract voidsetHandler(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
HttpHandlerfor 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
-
getFilters
-
setAuthenticator
Sets theAuthenticatorfor 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- theAuthenticatorto set. Ifnullthen any previously setAuthenticatoris removed, and client authentication will no longer be required.- Returns:
- the previous
Authenticator, if any set, ornullotherwise.
-
getAuthenticator
Returns the currently setAuthenticatorfor this context if one exists.- Returns:
- this HttpContext's
Authenticator, ornullif none is set
-