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 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.Methods declared in class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Modifier and TypeMethodDescriptionprotected Object
clone()
Creates and returns a copy of this object.boolean
Indicates whether some other object is "equal to" this one.protected void
finalize()
Deprecated, for removal: This API element is subject to removal in a future version.Finalization is deprecated and subject to removal in a future release.final Class
<?> getClass()
Returns the runtime class of thisObject
.int
hashCode()
Returns a hash code value for this object.final void
notify()
Wakes up a single thread that is waiting on this object's monitor.final void
Wakes up all threads that are waiting on this object's monitor.toString()
Returns a string representation of the object.final void
wait()
Causes the current thread to wait until it is awakened, typically by being notified or interrupted.final void
wait
(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.final void
wait
(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
-
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
-
getFilters
-
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
-