HttpServer 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 SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionstatic HttpsServercreate()Creates aHttpsServerinstance which is initially not bound to any local address/port.static HttpsServercreate(InetSocketAddress addr, int backlog) Create aHttpsServerinstance which will bind to the specifiedInetSocketAddress(IP address and port number).static HttpsServercreate(InetSocketAddress addr, int backlog, String path, HttpHandler handler, Filter... filters) Creates anHttpsServerinstance with an initial context.abstract HttpsConfiguratorGets this server'sHttpsConfiguratorobject, if it has been set.abstract voidSets this server'sHttpsConfiguratorobject.Methods declared in class com.sun.net.httpserver.HttpServerbind, createContext, createContext, getAddress, getExecutor, removeContext, removeContext, setExecutor, start, stop
- 
Constructor Details- 
HttpsServerprotected HttpsServer()Constructor for subclasses to call.
 
- 
- 
Method Details- 
createCreates aHttpsServerinstance which is initially not bound to any local address/port. TheHttpsServeris acquired from the currently installedHttpServerProvider. The server must be bound usingHttpServer.bind(InetSocketAddress,int)before it can be used. The server must also have aHttpsConfiguratorestablished withsetHttpsConfigurator(HttpsConfigurator).- Returns:
- an instance of HttpsServer
- Throws:
- IOException- if an I/O error occurs
 
- 
createCreate aHttpsServerinstance 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. TheHttpsServeris acquired from the currently installedHttpServerProvider. The server must have aHttpsConfiguratorestablished withsetHttpsConfigurator(HttpsConfigurator).- Parameters:
- addr- the address to listen on, if- nullthen- HttpServer.bind(InetSocketAddress,int)must be called to set the address
- backlog- the socket backlog. If this value is less than or equal to zero, then a system default value is used.
- Returns:
- an instance of HttpsServer
- Throws:
- BindException- if the server cannot bind to the requested address, or if the server is already bound
- IOException- if an I/O error occurs
 
- 
createpublic static HttpsServer create(InetSocketAddress addr, int backlog, String path, HttpHandler handler, Filter... filters) throws IOException Creates anHttpsServerinstance with an initial context.The server is created with an initial context that maps the URI pathto the exchangehandler. The initial context is created as if by an invocation ofcreateContext(path). Thefilters, if any, are added to the initial context, in the order they are given. The returned server is not started so can be configured further if required.The server instance will bind to the given InetSocketAddress.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 installed HttpServerProvider.The server must have an HttpsConfigurator established with setHttpsConfigurator(HttpsConfigurator).- Parameters:
- addr- the address to listen on, if- nullthen- bindmust be called to set the address
- backlog- the socket backlog. If this value is less than or equal to zero, then a system default value is used
- path- the root URI path of the context, must be absolute
- handler- the HttpHandler for the context
- filters- the Filters for the context, optional
- Returns:
- the HttpsServer
- Throws:
- BindException- if the server cannot bind to the address
- IOException- if an I/O error occurs
- IllegalArgumentException- if path is invalid
- NullPointerException- if any of:- path,- handler,- filters, or any element of- filters, are- null
- Since:
- 18
 
- 
setHttpsConfiguratorSets this server'sHttpsConfiguratorobject.- Parameters:
- config- the- HttpsConfiguratorto set
- Throws:
- NullPointerException- if config is- null
 
- 
getHttpsConfiguratorGets this server'sHttpsConfiguratorobject, if it has been set.- Returns:
- the HttpsConfiguratorfor this server, ornullif not set
 
 
-