com.streambase.liveview.client

Enum ConnectionMode

java.lang.Object

java.lang.Enum<ConnectionMode>

com.streambase.liveview.client.ConnectionMode

All Implemented Interfaces:

Serializable, Comparable<ConnectionMode>

public enum ConnectionMode
extends Enum<ConnectionMode>

Used when creating a MultiConnectionConfig to define how it will connect to the servers.

Since:

2.0

Enum Constant Summary

Enum Constants

Enum Constant and Description
SIMULTANEOUS_CONNECT_MULTIPLE_ACTIVE On startup, attempt to connect to all servers, all that connect will be considered active.
SIMULTANEOUS_CONNECT_SINGLE_ACTIVE On startup, attempt to connect to all servers, first one to connect becomes 'current' and all others remain warm.
SIMULTANEOUS_CONNECT_SINGLE_ACTIVE_RETURN_TO_PREFERRED On startup, attempt to connect to all servers, first one to connect becomes 'current' and all others remain warm.
SINGLE_CONNECT_RETURN_TO_PREFERRED Only one server will be connected at a time, and will be considered 'current' If it fails, the next will be tried.
SINGLE_CONNECTION_ROUND_ROBIN Only one server will be connected at a time, and will be considered 'current' If it fails, the next will be tried.

Method Summary

Modifier and Type	Method and Description
static ConnectionMode	valueOf(String name) Returns the enum constant of this type with the specified name.
static ConnectionMode[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

SINGLE_CONNECTION_ROUND_ROBIN

public static final ConnectionMode SINGLE_CONNECTION_ROUND_ROBIN

Only one server will be connected at a time, and will be considered 'current' If it fails, the next will be tried. then the next, etc. If 'current' goes down, it will cause a roughFailover notification.

SINGLE_CONNECT_RETURN_TO_PREFERRED

public static final ConnectionMode SINGLE_CONNECT_RETURN_TO_PREFERRED

Only one server will be connected at a time, and will be considered 'current' If it fails, the next will be tried. When any server other than the preferred server (the first in the list) is 'current', a background thread will attempt to reconnect to the preferred server, and 'current' will switch back to that one if it becomes available (causing a smoothFailover notification). If 'current' goes down, it will cause a roughFailover notification.

SIMULTANEOUS_CONNECT_SINGLE_ACTIVE

public static final ConnectionMode SIMULTANEOUS_CONNECT_SINGLE_ACTIVE

On startup, attempt to connect to all servers, first one to connect becomes 'current' and all others remain warm. Only a single connection will be active (the 'current' server), which means all queries will go to it. Constant attempts will be made to reconnect to any server that is not currently connected (unless they are specifically set to inactive through the API). If 'current' goes down and any others are connected, then one of the others will become 'current' and a smoothFailover notification will be given. If 'current' goes down and not others are connected, then a roughFailover notification will be given This is the default value if the ConnectionMode is not specified.

SIMULTANEOUS_CONNECT_SINGLE_ACTIVE_RETURN_TO_PREFERRED

public static final ConnectionMode SIMULTANEOUS_CONNECT_SINGLE_ACTIVE_RETURN_TO_PREFERRED

On startup, attempt to connect to all servers, first one to connect becomes 'current' and all others remain warm. Only a single connection will be active (the 'current' server), which means all queries will go to it. Constant attempts will be made to reconnect to any server that is not currently connected (unless they are specifically set to inactive through the API). If 'current' goes down and any others are connected, then one of the others will become 'current' and a smoothFailover notification will be given. If 'current' goes down and not others are connected, then a roughFailover notification will be given If preferred server connects, it is always made 'current' and a smoothFailover to it occurs

SIMULTANEOUS_CONNECT_MULTIPLE_ACTIVE

public static final ConnectionMode SIMULTANEOUS_CONNECT_MULTIPLE_ACTIVE

On startup, attempt to connect to all servers, all that connect will be considered active. Queries will be assigned to all active connections in a round robin. Constant attempts will be made to reconnect to any server that is not currently connected (unless they are specifically set to inactive through the API). If any server goes down, its queries will be reassigned to other active servers (assuming at least one other is active). This will cause a smoothFailover notification. If the last active server goes down, it will cause a roughFailover notification.

Method Detail

values

public static ConnectionMode[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (ConnectionMode c : ConnectionMode.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static ConnectionMode valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null