io.ably.lib.transport

Class Hosts

java.lang.Object

io.ably.lib.transport.Hosts

public class Hosts
extends java.lang.Object

Object to encapsulate primary host name and shuffled fallback host names.

Constructor Summary

Constructors

Constructor and Description
Hosts(java.lang.String primaryHost, java.lang.String defaultHost, ClientOptions options) Create Hosts object

Method Summary

Modifier and Type	Method and Description
java.lang.String	getFallback(java.lang.String lastHost) Get next fallback host if any
java.lang.String	getHost() Get primary host name
void	setHost(java.lang.String primaryHost) set primary hostname This gets called when the Hosts object is being used by an Http that is the http connection for a ConnectionManager.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Hosts

public Hosts(java.lang.String primaryHost,
             java.lang.String defaultHost,
             ClientOptions options)
      throws AblyException

Create Hosts object

Parameters:

primaryHost - the primary hostname, null if not configured

defaultHost - the default hostname that the primary hostname must match for fallback to occur

options - ClientOptions to get environment and fallbackHosts from The fallback and environment processing here is used when the Hosts object is used by a ConnectionManager (for a realtime connection) or by an Http for a rest connection. The case where the Hosts object is used by an Http that is being used by a ConnectionManager goes through this code, but the results are ignored because ConnectionManager then calls setHost() and fallback is not used.

Throws:

AblyException

Method Detail

setHost

public void setHost(java.lang.String primaryHost)

set primary hostname This gets called when the Hosts object is being used by an Http that is the http connection for a ConnectionManager.

getHost

public java.lang.String getHost()

Get primary host name

getFallback

public java.lang.String getFallback(java.lang.String lastHost)

Get next fallback host if any

Parameters:

lastHost -

Returns:

Successor host that can be used as a fallback. null, if there is no successor fallback available.