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
Constructors -
Method Summary
Modifier and TypeMethodDescriptionString[]Returns a copy of the array of ciphersuites ornullif none have been set.abstract InetSocketAddressReturns the address of the remote client initiating the connection.abstract HttpsConfiguratorReturns theHttpsConfiguratorfor thisHttpsParameters.booleanReturns whether client authentication should be required.String[]Returns a copy of the array of protocols ornullif none have been set.booleanReturns whether client authentication should be requested.voidsetCipherSuites(String[] cipherSuites) Sets the array of ciphersuites.voidsetNeedClientAuth(boolean needClientAuth) Sets whether client authentication should be required.voidsetProtocols(String[] protocols) Sets the array of protocols.abstract voidsetSSLParameters(SSLParameters params) Sets theSSLParametersto use for thisHttpsParameters.voidsetWantClientAuth(boolean wantClientAuth) Sets whether client authentication should be requested.
-
Constructor Details
-
HttpsParameters
protected HttpsParameters()Constructor for subclasses to call.
-
-
Method Details
-
getHttpsConfigurator
Returns theHttpsConfiguratorfor thisHttpsParameters.- Returns:
HttpsConfiguratorfor 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 theSSLParametersto use for thisHttpsParameters. The parameters must be supported by theSSLContextcontained by theHttpsConfiguratorassociated with thisHttpsParameters. If no parameters are set, then the default behavior is to use the default parameters from the associatedSSLContext.- Parameters:
params- theSSLParametersto set. Ifnullthen the existing parameters (if any) remain unchanged- Throws:
IllegalArgumentException- if any of the parameters are invalid or unsupported
-
getCipherSuites
Returns a copy of the array of ciphersuites ornullif none have been set.- Returns:
- a copy of the array of ciphersuites or
nullif none have been set
-
setCipherSuites
Sets the array of ciphersuites.- Parameters:
cipherSuites- the array of ciphersuites (ornull)
-
getProtocols
Returns a copy of the array of protocols ornullif none have been set.- Returns:
- a copy of the array of protocols or
nullif none have been set
-
setProtocols
Sets the array of protocols.- Parameters:
protocols- the array of protocols (ornull)
-
getWantClientAuth
public boolean getWantClientAuth()Returns whether client authentication should be requested.- Returns:
- whether client authentication should be requested
-
setWantClientAuth
public void setWantClientAuth(boolean wantClientAuth) Sets whether client authentication should be requested. Calling this method clears theneedClientAuthflag.- Parameters:
wantClientAuth- whether client authentication should be requested
-
getNeedClientAuth
public boolean getNeedClientAuth()Returns whether client authentication should be required.- Returns:
- whether client authentication should be required
-
setNeedClientAuth
public void setNeedClientAuth(boolean needClientAuth) Sets whether client authentication should be required. Calling this method clears thewantClientAuthflag.- Parameters:
needClientAuth- whether client authentication should be required
-