public Class HttpServerImpl

Implements abstract com.sun.net.httpserver.HttpServer.bind.

Doc from com.sun.net.httpserver.HttpServer.bind.

Binds a currently unbound HttpServer to the given address and port number. A maximum backlog can also be specified. This is the maximum number of queued incoming connections to allow on the listening socket. Queued TCP connections exceeding this limit may be rejected by the TCP implementation.

Implements abstract com.sun.net.httpserver.HttpServer.createContext.

Doc from com.sun.net.httpserver.HttpServer.createContext.

Creates a HttpContext. A HttpContext represents a mapping from a URI path to a exchange handler on this HttpServer. Once created, all requests received by the server for the path will be handled by calling the given handler object. The context is identified by the path, and can later be removed from the server using this with the removeContext(String) method.

The path specifies the root URI path for this context. The first character of path must be '/'.

The class overview describes how incoming request URIs are mapped to HttpContext instances.

Implements abstract com.sun.net.httpserver.HttpServer.createContext.

Doc from com.sun.net.httpserver.HttpServer.createContext.

Creates a HttpContext without initially specifying a handler. The handler must later be specified using HttpContext#setHandler(HttpHandler). A HttpContext represents a mapping from a URI path to an exchange handler on this HttpServer. Once created, and when the handler has been set, all requests received by the server for the path will be handled by calling the handler object. The context is identified by the path, and can later be removed from the server using this with the removeContext(String) method.

The path specifies the root URI path for this context. The first character of path must be '/'.

The class overview describes how incoming request URIs are mapped to HttpContext instances.

Implements abstract com.sun.net.httpserver.HttpServer.getAddress.

Doc from com.sun.net.httpserver.HttpServer.getAddress.

Returns the address this server is listening on

Implements abstract com.sun.net.httpserver.HttpServer.getExecutor.

Doc from com.sun.net.httpserver.HttpServer.getExecutor.

Returns this server's Executor object if one was specified with setExecutor(Executor), or null if none was specified.

Implements abstract com.sun.net.httpserver.HttpServer.removeContext.

Doc from com.sun.net.httpserver.HttpServer.removeContext.

Removes the context identified by the given path from the server. Removing a context does not affect exchanges currently being processed but prevents new ones from being accepted.

Exceptions

IllegalArgumentException:

if no handler corresponding to this path exists.

Implements abstract com.sun.net.httpserver.HttpServer.removeContext.

Doc from com.sun.net.httpserver.HttpServer.removeContext.

Removes the given context from the server. Removing a context does not affect exchanges currently being processed but prevents new ones from being accepted.

Implements abstract com.sun.net.httpserver.HttpServer.setExecutor.

Doc from com.sun.net.httpserver.HttpServer.setExecutor.

Sets this server's java.util.concurrent.Executor object. An Executor must be established before start() is called. All HTTP requests are handled in tasks given to the executor. If this method is not called (before start()) or if it is called with a null Executor, then a default implementation is used, which uses the thread which was created by the start() method.

Implements abstract com.sun.net.httpserver.HttpServer.start.

Doc from com.sun.net.httpserver.HttpServer.start.

Starts this server in a new background thread. The background thread inherits the priority, thread group and context class loader of the caller.

Implements abstract com.sun.net.httpserver.HttpServer.stop.

Doc from com.sun.net.httpserver.HttpServer.stop.

Stops this server by closing the listening socket and disallowing any new exchanges from being processed. The method will then block until all current exchange handlers have completed or else when approximately delay seconds have elapsed (whichever happens sooner). Then, all open TCP connections are closed, the background thread created by start() exits, and the method returns. Once stopped, a HttpServer cannot be re-used.