HttpServer
and associated classes. Applications do not normally use
this class. See provider()
for how providers are found and loaded.-
Constructor Summary
ModifierConstructorDescriptionprotected
Initializes a new instance of this class. -
Method Summary
Modifier and TypeMethodDescriptionabstract HttpServer
createHttpServer
(InetSocketAddress addr, int backlog) creates a HttpServer from this providerabstract HttpsServer
createHttpsServer
(InetSocketAddress addr, int backlog) creates a HttpsServer from this providerstatic HttpServerProvider
provider()
Returns the system wide default HttpServerProvider for this invocation of the Java virtual machine.
-
Constructor Details
-
HttpServerProvider
protected HttpServerProvider()Initializes a new instance of this class.- Throws:
SecurityException
- If a security manager has been installed and it deniesRuntimePermission
("httpServerProvider")
-
-
Method Details
-
createHttpServer
creates a HttpServer from this provider- Parameters:
addr
- the address to bind to. May benull
backlog
- the socket backlog. A value ofzero
means the systems default- Returns:
- An instance of HttpServer
- Throws:
IOException
- if an I/O error occurs
-
createHttpsServer
public abstract HttpsServer createHttpsServer(InetSocketAddress addr, int backlog) throws IOException creates a HttpsServer from this provider- Parameters:
addr
- the address to bind to. May benull
backlog
- the socket backlog. A value ofzero
means the systems default- Returns:
- An instance of HttpServer
- Throws:
IOException
- if an I/O error occurs
-
provider
Returns the system wide default HttpServerProvider for this invocation of the Java virtual machine.The first invocation of this method locates the default provider object as follows:
If the system property
com.sun.net.httpserver.HttpServerProvider
is defined then it is taken to be the fully-qualified name of a concrete provider class. The class is loaded and instantiated; if this process fails then an unspecified unchecked error or exception is thrown.If a provider class has been installed in a jar file that is visible to the system class loader, and that jar file contains a provider-configuration file named
com.sun.net.httpserver.HttpServerProvider
in the resource directoryMETA-INF/services
, then the first class name specified in that file is taken. The class is loaded and instantiated; if this process fails then an unspecified unchecked error or exception is thrown.Finally, if no provider has been specified by any of the above means then the system-default provider class is instantiated and the result is returned.
Subsequent invocations of this method return the provider that was returned by the first invocation.
- Returns:
- The system-wide default HttpServerProvider
-