hydra

Class GatewaySenderHelper

java.lang.Object

hydra.GatewaySenderHelper

public class GatewaySenderHelper
extends Object

Provides support for gateway senders running in hydra-managed client VMs.

Constructor Summary

Constructors

Constructor and Description
GatewaySenderHelper()

Method Summary

Modifier and Type	Method and Description
static Set<com.gemstone.gemfire.cache.wan.GatewaySender>	createAndStartGatewaySenders(String gatewaySenderConfig) Creates and starts gateway senders in the current cache using the given gateway sender configuration.
static void	createGatewaySenderIds(String gatewaySenderConfig) Creates gateway sender ids for each remote distributed system for the specified logical gateway sender configuration.
static Set<com.gemstone.gemfire.cache.wan.GatewaySender>	createGatewaySenders(String gatewaySenderConfig) Creates gateway senders in the current cache.
static String	gatewaySenderToString(com.gemstone.gemfire.cache.wan.GatewaySender gs) Returns the given gatewaySender as a string.
static int	getDistributedSystemId()
static String	getDistributedSystemName()
static com.gemstone.gemfire.cache.wan.GatewaySender	getGatewaySender(String senderID) Returns the gateway sender for the current cache matching the given gateway sender id, or null if no matching gateway sender id exists.
static String	getGatewaySenderConfigName(String id) Returns the gateway sender configuration from the given gateway sender id.
static GatewaySenderDescription	getGatewaySenderDescription(String gatewaySenderConfig) Returns the GatewaySenderDescription with the given configuration name from GatewaySenderPrms.names.
static Set<String>	getGatewaySenderIds(String gatewaySenderConfig) Returns all gateway sender ids for the specified logical gateway sender configuration that have been created using (String) or createGatewaySenders(String), a possibly empty set.
static Set<com.gemstone.gemfire.cache.wan.GatewaySender>	getGatewaySenders() Returns the gateway senders for the current cache, or null if no gateway senders or cache exists.
static Set<com.gemstone.gemfire.cache.wan.GatewaySender>	getGatewaySenders(String gatewaySenderConfig) Returns the gateway senders for the current cache matching the given gateway sender configuration from GatewaySenderPrms.names, or null if no gateway senders or cache exist.
static SortedSet<String>	getHubAndSpokeDistributedSystems() Returns remote distributed system names from #distributedSystem that satisfy a hub and spoke topology, a possibly empty set.
static Set<String>	getParallelGatewaySenderIds(String gatewaySenderConfig) Returns the parallel gateway sender ids for the specified logical gateway sender configuration that have been created using createGatewaySenderIds(String) or createGatewaySenders(String), a possibly empty set.
static SortedSet<String>	getRemoteDistributedSystems() Returns all remote distributed system names from #distributedSystem, a possibly empty set.
static SortedSet<String>	getRingDistributedSystems() Returns the next distributed system name alphabetically after this one, wrapping around as needed, from GemFirePrms.distributedSystem, a possibly empty set.
static Set<String>	getSerialGatewaySenderIds(String gatewaySenderConfig) Returns the serial gateway sender ids for the specified logical gateway sender configuration that have been created using {@link #createGatewaySenderIds(String)} or {@link #createGatewaySenders (String)}, a possibly empty set.
protected static void	saveGatewaySenderId(String gatewaySenderConfig, boolean parallel, String id) Stores the gateway sender id in the global GatewaySenderIds, mapped by logical gateway sender configuration name.
static void	startGatewaySenders() Starts the existing gateway senders in the current cache, if they have not already been started.
static void	startGatewaySenders(String gatewaySenderConfig) Starts the gateway senders for the current cache matching the given gateway sender configuration from GatewaySenderPrms.names, if they have not already been started.
static void	stopGatewaySenders() Stops the gateway senders in the current cache, if any.
static void	stopGatewaySenders(String gatewaySenderConfig) Stops the gateway senders in the current cache matching the given gateway sender configuration from GatewaySenderPrms.names, if any.

Methods inherited from class java.lang.Object

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

Constructor Detail

GatewaySenderHelper

public GatewaySenderHelper()

Method Detail

createAndStartGatewaySenders

public static Set<com.gemstone.gemfire.cache.wan.GatewaySender> createAndStartGatewaySenders(String gatewaySenderConfig)

Creates and starts gateway senders in the current cache using the given gateway sender configuration. If GatewaySenderPrms.manualStart is false (default), each sender is started as soon as it is created.

See Also:

createGatewaySenders(String), startGatewaySenders(String)

createGatewaySenders

public static Set<com.gemstone.gemfire.cache.wan.GatewaySender> createGatewaySenders(String gatewaySenderConfig)

Creates gateway senders in the current cache. If #manualStart is false (default), each sender is started as soon as it is created. The senders are configured using the GatewaySenderDescription corresponding to the given configuration from GatewaySenderPrms.names.

One sender is created for each distributed system returned by GatewaySenderPrms.remoteDistributedSystemsAlgorithm. The id for each sender is formed from its name as given in GatewaySenderPrms.names plus the local and remote distributed systems. For example, a sender named "fred" from local distributed system "ds_3" to remote distributed system "ds_1" would have id set to "fred_ds_3_to_ds_1".

This method is thread-safe. The gateway senders for a given logical gateway sender configuration will only be created once.

Throws:

HydraRuntimeException - if an attempt is made to reconfigure an existing gateway sender.

startGatewaySenders

public static void startGatewaySenders()

Starts the existing gateway senders in the current cache, if they have not already been started.

Throws:

HydraRuntimeException - if no gateway senders have been created.

startGatewaySenders

public static void startGatewaySenders(String gatewaySenderConfig)

Starts the gateway senders for the current cache matching the given gateway sender configuration from GatewaySenderPrms.names, if they have not already been started.

Throws:

HydraRuntimeException - if no gateway senders have been created.

getGatewaySenders

public static Set<com.gemstone.gemfire.cache.wan.GatewaySender> getGatewaySenders()

Returns the gateway senders for the current cache, or null if no gateway senders or cache exists.

getGatewaySender

public static com.gemstone.gemfire.cache.wan.GatewaySender getGatewaySender(String senderID)

Returns the gateway sender for the current cache matching the given gateway sender id, or null if no matching gateway sender id exists.

getGatewaySenders

public static Set<com.gemstone.gemfire.cache.wan.GatewaySender> getGatewaySenders(String gatewaySenderConfig)

Returns the gateway senders for the current cache matching the given gateway sender configuration from GatewaySenderPrms.names, or null if no gateway senders or cache exist.

stopGatewaySenders

public static void stopGatewaySenders()

Stops the gateway senders in the current cache, if any.

stopGatewaySenders

public static void stopGatewaySenders(String gatewaySenderConfig)

Stops the gateway senders in the current cache matching the given gateway sender configuration from GatewaySenderPrms.names, if any.

gatewaySenderToString

public static String gatewaySenderToString(com.gemstone.gemfire.cache.wan.GatewaySender gs)

Returns the given gatewaySender as a string.

getGatewaySenderDescription

public static GatewaySenderDescription getGatewaySenderDescription(String gatewaySenderConfig)

Returns the GatewaySenderDescription with the given configuration name from GatewaySenderPrms.names.

getRemoteDistributedSystems

public static SortedSet<String> getRemoteDistributedSystems()

Returns all remote distributed system names from #distributedSystem, a possibly empty set.

getRingDistributedSystems

public static SortedSet<String> getRingDistributedSystems()

Returns the next distributed system name alphabetically after this one, wrapping around as needed, from GemFirePrms.distributedSystem, a possibly empty set.

getHubAndSpokeDistributedSystems

public static SortedSet<String> getHubAndSpokeDistributedSystems()

Returns remote distributed system names from #distributedSystem that satisfy a hub and spoke topology, a possibly empty set. One distributed system, the first alphabetically, is chosen as the hub, for which all remote distributed systems are returned, while for non-hubs, only the hub is returned.

getDistributedSystemId

public static int getDistributedSystemId()

getDistributedSystemName

public static String getDistributedSystemName()

createGatewaySenderIds

public static void createGatewaySenderIds(String gatewaySenderConfig)

Creates gateway sender ids for each remote distributed system for the specified logical gateway sender configuration.

getGatewaySenderIds

public static Set<String> getGatewaySenderIds(String gatewaySenderConfig)

Returns all gateway sender ids for the specified logical gateway sender configuration that have been created using (String) or createGatewaySenders(String), a possibly empty set.

getSerialGatewaySenderIds

public static Set<String> getSerialGatewaySenderIds(String gatewaySenderConfig)

Returns the serial gateway sender ids for the specified logical gateway sender configuration that have been created using #createGatewaySenderIds(String)} or {@link #createGatewaySenders (String)}, a possibly empty set. #createGatewaySenders(String), a possibly empty list.

getParallelGatewaySenderIds

public static Set<String> getParallelGatewaySenderIds(String gatewaySenderConfig)

Returns the parallel gateway sender ids for the specified logical gateway sender configuration that have been created using createGatewaySenderIds(String) or createGatewaySenders(String), a possibly empty set.

saveGatewaySenderId

protected static void saveGatewaySenderId(String gatewaySenderConfig,
                                          boolean parallel,
                                          String id)

Stores the gateway sender id in the global GatewaySenderIds, mapped by logical gateway sender configuration name. Keep parallel and serial gateway sender ids separate so they can be looked up separately.

getGatewaySenderConfigName

public static String getGatewaySenderConfigName(String id)

Returns the gateway sender configuration from the given gateway sender id.