TLSClientParameters (Apache CXF JavaDoc 3.0.4.redhat-621177 API)

org.apache.cxf.configuration.jsse

## Class TLSClientParameters

- java.lang.Object
- - org.apache.cxf.configuration.jsse.TLSParameterBase
  - - org.apache.cxf.configuration.jsse.TLSClientParameters

-     public class TLSClientParameters
      extends TLSParameterBase

  This class extends `TLSParameterBase` with client-specific SSL/TLS parameters.

- - ### Field Summary

    - ### Fields inherited from class org.apache.cxf.configuration.jsse.TLSParameterBase

      `certAlias, certConstraints, cipherSuiteFilters, ciphersuites, keyManagers, protocol, provider, secureRandom, trustManagers`

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `TLSClientParameters()`

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `boolean` | `equals(Object o)`
    `HostnameVerifier` | `getHostnameVerifier()` Get custom HostnameVerifier
    `int` | `getSslCacheTimeout()` Returns the SSL cache timeout in seconds if it has been configured or the default value
    `SSLSocketFactory` | `getSSLSocketFactory()` Returns the SSLSocketFactory to be used, or null if none has been set.
    `int` | `hashCode()`
    `boolean` | `isDisableCNCheck()` Returns whether or not JSSE omits checking if the host name specified in the URL matches that of the Common Name (CN) on the server's certificate.
    `boolean` | `isUseHttpsURLConnectionDefaultHostnameVerifier()` Returns whether or not `HttpsURLConnection.getDefaultHostnameVerifier()` should be used to create https connections.
    `boolean` | `isUseHttpsURLConnectionDefaultSslSocketFactory()` Returns whether or not `HttpsURLConnection.getDefaultSSLSocketFactory()` should be used to create https connections.
    `void` | `setDisableCNCheck(boolean disableCNCheck)` Set whether or not JSEE should omit checking if the host name specified in the URL matches that of the Common Name (CN) on the server's certificate.
    `void` | `setHostnameVerifier(HostnameVerifier verifier)` Set custom HostnameVerifier
    `void` | `setSslCacheTimeout(int sslCacheTimeout)` This sets the SSL Session Cache timeout value in seconds for client sessions handled by CXF
    `void` | `setSSLSocketFactory(SSLSocketFactory factory)` This sets the SSLSocketFactory to use, causing all other properties of this bean (and its superclass) to get ignored (this takes precendence).
    `void` | `setUseHttpsURLConnectionDefaultHostnameVerifier(boolean useHttpsURLConnectionDefaultHostnameVerifier)` Sets whether or not `HttpsURLConnection.getDefaultHostnameVerifier()` should be used to create https connections.
    `void` | `setUseHttpsURLConnectionDefaultSslSocketFactory(boolean useHttpsURLConnectionDefaultSslSocketFactory)` Sets whether or not `HttpsURLConnection.getDefaultSSLSocketFactory()` should be used to create https connections.

    - ### Methods inherited from class org.apache.cxf.configuration.jsse.TLSParameterBase

      `getCertAlias, getCertConstraints, getCipherSuites, getCipherSuitesFilter, getJsseProvider, getKeyManagers, getSecureRandom, getSecureSocketProtocol, getTrustManagers, setCertAlias, setCertConstraints, setCipherSuites, setCipherSuitesFilter, setJsseProvider, setKeyManagers, setSecureRandom, setSecureSocketProtocol, setTrustManagers`

    - ### Methods inherited from class java.lang.Object

      `clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait`

- - ### Constructor Detail

    - #### TLSClientParameters

          public TLSClientParameters()

  - ### Method Detail

    - #### setHostnameVerifier

          public void setHostnameVerifier(HostnameVerifier verifier)

      Set custom HostnameVerifier
      Parameters:
        `verifier` - hostname verifier

    - #### getHostnameVerifier

          public HostnameVerifier getHostnameVerifier()

      Get custom HostnameVerifier
      Returns:
        hostname verifier

    - #### setDisableCNCheck

          public void setDisableCNCheck(boolean disableCNCheck)

      Set whether or not JSEE should omit checking if the host name specified in the URL matches that of the Common Name (CN) on the server's certificate. Default is false; this attribute should not be set to true during production use.

    - #### isDisableCNCheck

          public boolean isDisableCNCheck()

      Returns whether or not JSSE omits checking if the host name specified in the URL matches that of the Common Name (CN) on the server's certificate.

    - #### setSSLSocketFactory

          public final void setSSLSocketFactory(SSLSocketFactory factory)

      This sets the SSLSocketFactory to use, causing all other properties of this bean (and its superclass) to get ignored (this takes precendence).

    - #### getSSLSocketFactory

          public final SSLSocketFactory getSSLSocketFactory()

      Returns the SSLSocketFactory to be used, or null if none has been set.

    - #### getSslCacheTimeout

          public int getSslCacheTimeout()

      Returns the SSL cache timeout in seconds if it has been configured or the default value

    - #### setSslCacheTimeout

          public void setSslCacheTimeout(int sslCacheTimeout)

      This sets the SSL Session Cache timeout value in seconds for client sessions handled by CXF

    - #### isUseHttpsURLConnectionDefaultSslSocketFactory

          public boolean isUseHttpsURLConnectionDefaultSslSocketFactory()

      Returns whether or not `HttpsURLConnection.getDefaultSSLSocketFactory()` should be used to create https connections. If `true` , `TLSParameterBase.getJsseProvider()` , `TLSParameterBase.getSecureSocketProtocol()`, `TLSParameterBase.getTrustManagers()`, `TLSParameterBase.getKeyManagers()`, `TLSParameterBase.getSecureRandom()`, `TLSParameterBase.getCipherSuites()` and `TLSParameterBase.getCipherSuitesFilter()` are ignored.

    - #### setUseHttpsURLConnectionDefaultSslSocketFactory

          public void setUseHttpsURLConnectionDefaultSslSocketFactory(boolean useHttpsURLConnectionDefaultSslSocketFactory)

      Sets whether or not `HttpsURLConnection.getDefaultSSLSocketFactory()` should be used to create https connections.
      See Also:
        `isUseHttpsURLConnectionDefaultSslSocketFactory()`

    - #### isUseHttpsURLConnectionDefaultHostnameVerifier

          public boolean isUseHttpsURLConnectionDefaultHostnameVerifier()

      Returns whether or not `HttpsURLConnection.getDefaultHostnameVerifier()` should be used to create https connections. If `true`, `isDisableCNCheck()` is ignored.

    - #### setUseHttpsURLConnectionDefaultHostnameVerifier

          public void setUseHttpsURLConnectionDefaultHostnameVerifier(boolean useHttpsURLConnectionDefaultHostnameVerifier)

      Sets whether or not `HttpsURLConnection.getDefaultHostnameVerifier()` should be used to create https connections.
      See Also:
        `isUseHttpsURLConnectionDefaultHostnameVerifier()`

    - #### hashCode

          public int hashCode()

      Overrides:
        `hashCode` in class `Object`

    - #### equals

          public boolean equals(Object o)

      Overrides:
        `equals` in class `Object`

Apache CXF