Method Detail

• hostname

  public final T hostname(String hostname)

  Sets the hostname.

  Parameters:

  hostname - The hostname.

  Returns:

  The builder.

• port

  public final T port(int port)

  Sets the port.

  Parameters:

  port - The port.

  Returns:

  The builder.

• proxy

  public final T proxy(Proxy proxy)

  Sets the proxy, e.g. if you are behind a HTTP proxy and use a BOSH connection.

  Parameters:

  proxy - The proxy.

  Returns:

  The builder.

• secure

  public final T secure(boolean secure)

  Sets whether the connection is secured via SSL.

  Parameters:

  secure - If the connection is secured via SSL.

  Returns:

  The builder.

• sslContext

  public final T sslContext(SSLContext sslContext)

  Sets a custom SSL context, used to secure the connection.

  Parameters:

  sslContext - The SSL context.

  Returns:

  The builder.

• hostnameVerifier

  public final T hostnameVerifier(HostnameVerifier hostnameVerifier)

  Sets an optional hostname verifier, used to verify the hostname in the certificate presented by the server. If no verifier is set, the hostname is verified nonetheless using the default.

  Parameters:

  hostnameVerifier - The hostname verifier.

  Returns:

  The builder.

• connectTimeout

  public final T connectTimeout(int connectTimeout)

  Sets a timeout for the connection establishment.

  Connecting to a XMPP server involves multiple steps:

  • DNS lookup
  • Connection establishment of the underlying transport (e.g. TCP or HTTP)
  • XMPP stream negotiation

  This timeout is only used for DNS lookup (which is not used in all cases) and for connection establishment of the underlying transport (e.g. for a socket connection), but not for stream negotiation. Therefore it does not reflect how long the whole connection process may take, but should be understood as hint for establishing the underlying XMPP transport.

  XMPP stream negotiation is configured via XmppSessionConfiguration.Builder.defaultResponseTimeout(int)

  Parameters:

  connectTimeout - The timeout in milliseconds.

  Returns:

  The builder.

  See Also:

  XmppSession.connect()

• compressionMethods

  public final T compressionMethods(CompressionMethod... compressionMethods)

  Sets the compression method.

  Parameters:

  compressionMethods - The compression methods.

  Returns:

  The builder.

  See Also:

  CompressionManager.ZLIB, CompressionManager.GZIP, CompressionManager.DEFLATE

• build

  public abstract ConnectionConfiguration build()

  Builds the connection configuration.

  Returns:

  The concrete connection configuration.