- java.lang.Object
-
- com.sun.net.httpserver.HttpServer
-
- com.sun.net.httpserver.HttpsServer
-
public abstract class HttpsServer extends HttpServer
This class is an extension ofHttpServer
which provides support for HTTPS.A HttpsServer must have an associated
HttpsConfigurator
object which is used to establish the SSL configuration for the SSL connections.All other configuration is the same as for HttpServer.
- Since:
- 1.6
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
HttpsServer()
-
Method Summary
All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description static HttpsServer
create()
creates a HttpsServer instance which is initially not bound to any local address/port.static HttpsServer
create(InetSocketAddress addr, int backlog)
Create aHttpsServer
instance which will bind to the specifiedInetSocketAddress
(IP address and port number) A maximum backlog can also be specified.abstract HttpsConfigurator
getHttpsConfigurator()
Gets this server'sHttpsConfigurator
object, if it has been set.abstract void
setHttpsConfigurator(HttpsConfigurator config)
Sets this server'sHttpsConfigurator
object.-
Methods declared in class com.sun.net.httpserver.HttpServer
bind, createContext, createContext, getAddress, getExecutor, removeContext, removeContext, setExecutor, start, stop
-
-
-
-
Method Detail
create
public static HttpsServer create() throws IOException
creates a HttpsServer instance which is initially not bound to any local address/port. The HttpsServer is acquired from the currently installedHttpServerProvider
The server must be bound usingHttpServer.bind(InetSocketAddress,int)
before it can be used. The server must also have a HttpsConfigurator established withsetHttpsConfigurator(HttpsConfigurator)
- Throws:
IOException
create
public static HttpsServer create(InetSocketAddress addr, int backlog) throws IOException
Create aHttpsServer
instance which will bind to the specifiedInetSocketAddress
(IP 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. The HttpsServer is acquired from the currently installedHttpServerProvider
The server must have a HttpsConfigurator established withsetHttpsConfigurator(HttpsConfigurator)
- Parameters:
addr
- the address to listen on, ifnull
then bind() must be called to set the addressbacklog
- the socket backlog. If this value is less than or equal to zero, then a system default value is used.- Throws:
BindException
- if the server cannot bind to the requested address, or if the server is already bound.IOException
setHttpsConfigurator
public abstract void setHttpsConfigurator(HttpsConfigurator config)
Sets this server'sHttpsConfigurator
object.- Parameters:
config
- the HttpsConfigurator to set- Throws:
NullPointerException
- if config is null.
getHttpsConfigurator
public abstract HttpsConfigurator getHttpsConfigurator()
Gets this server'sHttpsConfigurator
object, if it has been set.- Returns:
-
the HttpsConfigurator for this server, or
null
if not set.
-