OpenJDK 27 · com.sun.net.httpserver.spi.HttpServerProvider

Modifier and Type	Field and Description
private static final Object	lock
private static HttpServerProvider	provider

Access	Constructor and Description
protected	HttpServerProvider() Initializes a new instance of this class.

Method Summary

Modifier and Type	Method and Description
public abstract HttpServer	Returns: An instance of HttpServer createHttpServer(InetSocketAddress the address to bind to. May be `null` addr, int the socket backlog. A value of `zero` means the systems default backlog) creates a HttpServer from this provider
public abstract HttpsServer	Returns: An instance of HttpServer createHttpsServer(InetSocketAddress the address to bind to. May be `null` addr, int the socket backlog. A value of `zero` means the systems default backlog) creates a HttpsServer from this provider
private static boolean	loadProviderAsService()
private static boolean	loadProviderFromProperty()
public static HttpServerProvider	Returns: The system-wide default HttpServerProvider provider() Returns the system wide default HttpServerProvider for this invocation of the Java virtual machine.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

lock	back to summary
private static final Object lock

provider	back to summary
private static HttpServerProvider provider

HttpServerProvider	back to summary
protected HttpServerProvider() Initializes a new instance of this class.

createHttpServer back to summary

createHttpServer	back to summary
public abstract HttpServer createHttpServer(InetSocketAddress addr, int backlog) throws IOException creates a HttpServer from this provider Parameters addr:InetSocketAddress the address to bind to. May be `null` backlog:int the socket backlog. A value of `zero` means the systems default Returns:HttpServer An instance of HttpServer Exceptions IOException: if an I/O error occurs

public abstract HttpServer createHttpServer(InetSocketAddress addr, int backlog) throws IOException

creates a HttpServer from this provider

Parameters

addr:InetSocketAddress: the address to bind to. May be null
backlog:int: the socket backlog. A value of zero means the systems default

An instance of HttpServer

Exceptions

createHttpsServer back to summary

createHttpsServer	back to summary
public abstract HttpsServer createHttpsServer(InetSocketAddress addr, int backlog) throws IOException creates a HttpsServer from this provider Parameters addr:InetSocketAddress the address to bind to. May be `null` backlog:int the socket backlog. A value of `zero` means the systems default Returns:HttpsServer An instance of HttpServer Exceptions IOException: if an I/O error occurs

public abstract HttpsServer createHttpsServer(InetSocketAddress addr, int backlog) throws IOException

creates a HttpsServer from this provider

Parameters

addr:InetSocketAddress: the address to bind to. May be null
backlog:int: the socket backlog. A value of zero means the systems default

An instance of HttpServer

Exceptions

loadProviderAsService	back to summary
private static boolean loadProviderAsService()

loadProviderFromProperty	back to summary
private static boolean loadProviderFromProperty()

provider back to summary

provider	back to summary
public static HttpServerProvider 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 directory `META-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:HttpServerProvider The system-wide default HttpServerProvider

public static HttpServerProvider 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 directory META-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.