Class HttpsParameters
java.lang.Object
com.sun.net.httpserver.HttpsParameters
Represents the set of parameters for each https connection negotiated with
clients. One of these is created and passed to
HttpsConfigurator.configure(HttpsParameters)
for every incoming https
connection, in order to determine the parameters to use.
The underlying SSL parameters may be established either via the set/get
methods of this class, or else via a SSLParameters
object. SSLParameters
is the preferred method, because in the future,
additional configuration capabilities may be added to that class, and it is
easier to determine the set of supported parameters and their default values
with SSLParameters. Also, if an SSLParameters
object is provided via
setSSLParameters(SSLParameters)
then those parameter settings are
used, and any settings made in this object are ignored.
- Since:
- 1.6
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionString[]
Deprecated.abstract InetSocketAddress
Returns the address of the remote client initiating the connection.abstract HttpsConfigurator
Returns theHttpsConfigurator
for thisHttpsParameters
.boolean
Deprecated.It is recommended that the SSL parameters be configured and read through the use ofSSLParameters
.String[]
Deprecated.It is recommended that the SSL parameters be configured and read through the use ofSSLParameters
.boolean
Deprecated.It is recommended that the SSL parameters be configured and read through the use ofSSLParameters
.void
setCipherSuites
(String[] cipherSuites) Deprecated.It is recommended that the SSL parameters be configured and read through the use ofSSLParameters
.void
setNeedClientAuth
(boolean needClientAuth) Deprecated.It is recommended that the SSL parameters be configured and read through the use ofSSLParameters
.void
setProtocols
(String[] protocols) Deprecated.It is recommended that the SSL parameters be configured and read through the use ofSSLParameters
.abstract void
setSSLParameters
(SSLParameters params) Sets theSSLParameters
to use for thisHttpsParameters
.void
setWantClientAuth
(boolean wantClientAuth) Deprecated.It is recommended that the SSL parameters be configured and read through the use ofSSLParameters
.
-
Constructor Details
-
HttpsParameters
protected HttpsParameters()Constructor for subclasses to call.
-
-
Method Details
-
getHttpsConfigurator
Returns theHttpsConfigurator
for thisHttpsParameters
.- Returns:
HttpsConfigurator
for this instance ofHttpsParameters
-
getClientAddress
Returns the address of the remote client initiating the connection.- Returns:
- address of the remote client initiating the connection
-
setSSLParameters
Sets theSSLParameters
to use for thisHttpsParameters
. The parameters must be supported by theSSLContext
contained by theHttpsConfigurator
associated with thisHttpsParameters
. If no parameters are set, then the default behavior is to use the default parameters from the associatedSSLContext
.- Parameters:
params
- theSSLParameters
to set. Ifnull
then the existing parameters (if any) remain unchanged- Throws:
IllegalArgumentException
- if any of the parameters are invalid or unsupported
-
getCipherSuites
Deprecated.It is recommended that the SSL parameters be configured and read through the use ofSSLParameters
.Returns a copy of the array of ciphersuites ornull
if none have been set.- Returns:
- a copy of the array of ciphersuites or
null
if none have been set
-
setCipherSuites
Deprecated.It is recommended that the SSL parameters be configured and read through the use ofSSLParameters
. UseSSLParameters.setCipherSuites(String[])
instead.Sets the array of ciphersuites.- Parameters:
cipherSuites
- the array of ciphersuites (ornull
)
-
getProtocols
Deprecated.It is recommended that the SSL parameters be configured and read through the use ofSSLParameters
.Returns a copy of the array of protocols ornull
if none have been set.- Returns:
- a copy of the array of protocols or
null
if none have been set
-
setProtocols
Deprecated.It is recommended that the SSL parameters be configured and read through the use ofSSLParameters
. UseSSLParameters.setProtocols(String[])
instead.Sets the array of protocols.- Parameters:
protocols
- the array of protocols (ornull
)
-
getWantClientAuth
Deprecated.It is recommended that the SSL parameters be configured and read through the use ofSSLParameters
.Returns whether client authentication should be requested.- Returns:
- whether client authentication should be requested
-
setWantClientAuth
Deprecated.It is recommended that the SSL parameters be configured and read through the use ofSSLParameters
. UseSSLParameters.setWantClientAuth(boolean)
instead.Sets whether client authentication should be requested. Calling this method clears theneedClientAuth
flag.- Parameters:
wantClientAuth
- whether client authentication should be requested
-
getNeedClientAuth
Deprecated.It is recommended that the SSL parameters be configured and read through the use ofSSLParameters
.Returns whether client authentication should be required.- Returns:
- whether client authentication should be required
-
setNeedClientAuth
Deprecated.It is recommended that the SSL parameters be configured and read through the use ofSSLParameters
. UseSSLParameters.setNeedClientAuth(boolean)
instead.Sets whether client authentication should be required. Calling this method clears thewantClientAuth
flag.- Parameters:
needClientAuth
- whether client authentication should be required
-
SSLParameters
.