com.gemstone.gemfire.cache.util

Interface BridgeServer

Deprecated.

as of 5.7 used CacheServer instead.

@Deprecated
public interface BridgeServer

A cache bridge server that serves the contents of a Cache to VMs in another distributed system via a socket. A bridge server is used in conjunction with a client Pool to connect two regions that reside in different distributed systems.

Since:

2.0.2

See Also:

Cache.addBridgeServer(), Cache.getBridgeServers()

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_BIND_ADDRESS Deprecated. The default ip address or host name that the server's socket will listen on for client connections.
static String[]	DEFAULT_GROUPS Deprecated. The default list of server groups a server belongs to.
static String	DEFAULT_HOSTNAME_FOR_CLIENTS Deprecated. The default ip address or host name that will be given to clients as the host this server is listening on.
static long	DEFAULT_LOAD_POLL_INTERVAL Deprecated. The default frequency at which to poll the load probe for the load on this server.
static ServerLoadProbe	DEFAULT_LOAD_PROBE Deprecated. The default load balancing probe.
static int	DEFAULT_MAX_CONNECTIONS Deprecated. The default number of sockets accepted by a BridgeServer.
static int	DEFAULT_MAX_THREADS Deprecated. The default limit to the maximum number of server threads that can be created to service client requests.
static int	DEFAULT_MAXIMUM_MESSAGE_COUNT Deprecated. The default maximum number of messages that can be enqueued in a client-queue.
static int	DEFAULT_MAXIMUM_TIME_BETWEEN_PINGS Deprecated. The default maximum amount of time between client pings.
static int	DEFAULT_MESSAGE_TIME_TO_LIVE Deprecated. The default time (in seconds ) after which a message in the client queue will expire.
static boolean	DEFAULT_NOTIFY_BY_SUBSCRIPTION Deprecated. The default notify-by-subscription value which tells the BridgeServer whether or not to notify clients based on key subscription.
static int	DEFAULT_PORT Deprecated. The default port on which a BridgeServer is configured to serve.
static int	DEFAULT_SOCKET_BUFFER_SIZE Deprecated. The default socket buffer size for socket buffers from the server to the client.

Method Summary

Methods

Modifier and Type	Method and Description
Set	getAllClientSessions() Deprecated. Returns a set of all ClientSessions
String	getBindAddress() Deprecated. Returns a string representing the ip address or host name that this server will listen on.
ClientSession	getClientSession(DistributedMember member) Deprecated. Returns the ClientSession associated with the DistributedMember
ClientSession	getClientSession(String durableClientId) Deprecated. Returns the ClientSession associated with the durable client id
ClientSubscriptionConfig	getClientSubscriptionConfig() Deprecated. Get the ClientSubscriptionConfig for this cache server.
String[]	getGroups() Deprecated. Returns the list of server groups that this cache server belongs to.
String	getHostnameForClients() Deprecated. Returns a string representing the ip address or host name that server locators will tell clients that this server is listening on.
long	getLoadPollInterval() Deprecated. Get the frequency in milliseconds to poll the load probe on this cache server.
ServerLoadProbe	getLoadProbe() Deprecated. Get the load probe for this cache server.
int	getMaxConnections() Deprecated. Returns the maximum allowed client connections
int	getMaximumMessageCount() Deprecated. Returns the maximum number of messages that can be enqueued in a client-queue.
int	getMaximumTimeBetweenPings() Deprecated. Returns the maximum amount of time between client pings.
int	getMaxThreads() Deprecated. Returns the maxium number of threads allowed in this server to service client requests.
int	getMessageTimeToLive() Deprecated. Returns the time (in seconds ) after which a message in the client queue will expire.
boolean	getNotifyBySubscription() Deprecated. as of 6.0.1. This method is no more in use, by default notifyBySubscription attribute is set to true.
int	getPort() Deprecated. Returns the port on which this server listens for clients.
int	getSocketBufferSize() Deprecated. Returns the configured buffer size of the socket connection for this BridgeServer.
boolean	isRunning() Deprecated. Returns whether or not this server is running
void	setBindAddress(String address) Deprecated. Sets the ip address or host name that this server is to listen on for client connections.
void	setGroups(String[] groups) Deprecated. Sets the list of server groups this cache server will belong to.
void	setHostnameForClients(String name) Deprecated. Sets the ip address or host name that this server is to listen on for client connections.
void	setLoadPollInterval(long loadPollInterval) Deprecated. Set the frequency in milliseconds to poll the load probe on this cache server
void	setLoadProbe(ServerLoadProbe loadProbe) Deprecated. Set the load probe for this cache server.
void	setMaxConnections(int maxCons) Deprecated. Sets the maxium number of client connections allowed.
void	setMaximumMessageCount(int maxMessageCount) Deprecated. Sets maximum number of messages that can be enqueued in a client-queue.
void	setMaximumTimeBetweenPings(int maximumTimeBetweenPings) Deprecated. Sets the maximum amount of time between client pings.
void	setMaxThreads(int maxThreads) Deprecated. Sets the maxium number of threads allowed in this server to service client requests.
void	setMessageTimeToLive(int messageTimeToLive) Deprecated. Sets the time (in seconds ) after which a message in the client queue will expire.Expiry settings are applicable for the secondary queues only This setting has no impact on the primary queue.
void	setNotifyBySubscription(boolean b) Deprecated. as of 6.0.1. This method is no more in use, by default notifyBySubscription attribute is set to true.
void	setPort(int port) Deprecated. Sets the port on which this server listens for clients.
void	setSocketBufferSize(int socketBufferSize) Deprecated. Sets the buffer size in bytes of the socket connection for this BridgeServer.
void	start() Deprecated. Starts this server.
void	stop() Deprecated. Stops this server.

Field Detail

DEFAULT_PORT

static final int DEFAULT_PORT

Deprecated.

The default port on which a BridgeServer is configured to serve.

See Also:

Constant Field Values

DEFAULT_MAX_CONNECTIONS

static final int DEFAULT_MAX_CONNECTIONS

Deprecated.

The default number of sockets accepted by a BridgeServer. When the maximum is reached the server will stop accepting new connections. Current value: 800

Since:

5.7

See Also:

Constant Field Values

DEFAULT_MAX_THREADS

static final int DEFAULT_MAX_THREADS

Deprecated.

The default limit to the maximum number of server threads that can be created to service client requests. Once this number of threads exist then connections must share the same thread to service their request. A selector is used to detect client connection requests and dispatch them to the thread pool. The default of 0 causes a thread to be bound to every connection and to be dedicated to detecting client requests on that connection. A selector is not used in this default mode. Current value: 0

Since:

5.7

See Also:

Constant Field Values

DEFAULT_NOTIFY_BY_SUBSCRIPTION

static final boolean DEFAULT_NOTIFY_BY_SUBSCRIPTION

Deprecated.

The default notify-by-subscription value which tells the BridgeServer whether or not to notify clients based on key subscription.

See Also:

Constant Field Values

DEFAULT_SOCKET_BUFFER_SIZE

static final int DEFAULT_SOCKET_BUFFER_SIZE

Deprecated.

The default socket buffer size for socket buffers from the server to the client.

See Also:

Constant Field Values

DEFAULT_MAXIMUM_TIME_BETWEEN_PINGS

static final int DEFAULT_MAXIMUM_TIME_BETWEEN_PINGS

Deprecated.

The default maximum amount of time between client pings. This value is used by the ClientHealthMonitor to determine the health of this BridgeServer's clients.

See Also:

Constant Field Values

DEFAULT_MAXIMUM_MESSAGE_COUNT

static final int DEFAULT_MAXIMUM_MESSAGE_COUNT

Deprecated.

The default maximum number of messages that can be enqueued in a client-queue.

See Also:

Constant Field Values

DEFAULT_MESSAGE_TIME_TO_LIVE

static final int DEFAULT_MESSAGE_TIME_TO_LIVE

Deprecated.

The default time (in seconds ) after which a message in the client queue will expire.

See Also:

Constant Field Values

DEFAULT_GROUPS

static final String[] DEFAULT_GROUPS

Deprecated.

The default list of server groups a server belongs to. The current default is an empty list.

Since:

5.7

DEFAULT_LOAD_PROBE

static final ServerLoadProbe DEFAULT_LOAD_PROBE

Deprecated.

The default load balancing probe. The default load balancing probe reports the connections counts of this server.

Since:

5.7

DEFAULT_LOAD_POLL_INTERVAL

static final long DEFAULT_LOAD_POLL_INTERVAL

Deprecated.

The default frequency at which to poll the load probe for the load on this server. Defaults to 5000 (5 seconds).

Since:

5.7

See Also:

Constant Field Values

DEFAULT_BIND_ADDRESS

static final String DEFAULT_BIND_ADDRESS

Deprecated.

The default ip address or host name that the server's socket will listen on for client connections. The current default is an empty string.

Since:

5.7

See Also:

Constant Field Values

DEFAULT_HOSTNAME_FOR_CLIENTS

static final String DEFAULT_HOSTNAME_FOR_CLIENTS

Deprecated.

The default ip address or host name that will be given to clients as the host this server is listening on. The current default is an empty string.

Since:

5.7

See Also:

Constant Field Values

Method Detail

getPort

int getPort()

Deprecated.

Returns the port on which this server listens for clients.

setPort

void setPort(int port)

Deprecated.

Sets the port on which this server listens for clients.

Throws:

IllegalStateException - If this server is running

getBindAddress

String getBindAddress()

Deprecated.

Returns a string representing the ip address or host name that this server will listen on.

Returns:

the ip address or host name that this server is to listen on

Since:

5.7

See Also:

DEFAULT_BIND_ADDRESS

setBindAddress

void setBindAddress(String address)

Deprecated.

Sets the ip address or host name that this server is to listen on for client connections.

Setting a specific bind address will cause the server to always use this address and ignore any address specified by "server-bind-address" or "bind-address" in the gemfire.properties file (see DistributedSystem for a description of these properties).

The value "" does not override the gemfire.properties. It will cause the local machine's default address to be listened on if the properties file does not specify and address. If you wish to override the properties and want to have your server bind to all local addresses then use this bind address "0.0.0.0".

A null value will be treated the same as the default "".

Parameters:

address - the ip address or host name that this server is to listen on

Since:

5.7

See Also:

DEFAULT_BIND_ADDRESS

getHostnameForClients

String getHostnameForClients()

Deprecated.

Returns a string representing the ip address or host name that server locators will tell clients that this server is listening on.

Returns:

the ip address or host name to give to clients so they can connect to this server

Since:

5.7

See Also:

DEFAULT_HOSTNAME_FOR_CLIENTS

setHostnameForClients

void setHostnameForClients(String name)

Deprecated.

Sets the ip address or host name that this server is to listen on for client connections.

Setting a specific hostname-for-clients will cause server locators to use this value when telling clients how to connect to this server. This is useful in the case where the server may refer to itself with one hostname, but the clients need to use a different hostname to find the server.

The value "" causes the bind-address to be given to clients.

A null value will be treated the same as the default "".

Parameters:

name - the ip address or host name that will be given to clients so they can connect to this server

Since:

5.7

See Also:

DEFAULT_HOSTNAME_FOR_CLIENTS

setNotifyBySubscription

@Deprecated
void setNotifyBySubscription(boolean b)

Deprecated. as of 6.0.1. This method is no more in use, by default notifyBySubscription attribute is set to true.

Sets whether or not this server should notify clients based on key subscription. If false, then an update to any key on the server causes an update to be sent to all clients. This update does not push the actual data to the clients. Instead, it causes the client to locally invalidate or destroy the corresponding entry. The next time the client requests the key, it goes to the server for the value. If true, then an update to any key on the server causes an update to be sent to only those clients who have registered interest in that key. Other clients are not notified of the change. In addition, the actual value is pushed to the client. The client does not need to request the new value from the server.

Since:

4.2

getNotifyBySubscription

@Deprecated
boolean getNotifyBySubscription()

Deprecated. as of 6.0.1. This method is no more in use, by default notifyBySubscription attribute is set to true.

Answers whether or not this server should notify clients based on key subscription.

Since:

4.2

setSocketBufferSize

void setSocketBufferSize(int socketBufferSize)

Deprecated.

Sets the buffer size in bytes of the socket connection for this BridgeServer. The default is 32768 bytes.

Parameters:

socketBufferSize - The size in bytes of the socket buffer

Since:

4.2.1

getSocketBufferSize

int getSocketBufferSize()

Deprecated.

Returns the configured buffer size of the socket connection for this BridgeServer. The default is 32768 bytes.

Returns:

the configured buffer size of the socket connection for this BridgeServer

Since:

4.2.1

setMaximumTimeBetweenPings

void setMaximumTimeBetweenPings(int maximumTimeBetweenPings)

Deprecated.

Sets the maximum amount of time between client pings. This value is used by the ClientHealthMonitor to determine the health of this BridgeServer's clients. The default is 60000 ms.

Parameters:

maximumTimeBetweenPings - The maximum amount of time between client pings

Since:

4.2.3

getMaximumTimeBetweenPings

int getMaximumTimeBetweenPings()

Deprecated.

Returns the maximum amount of time between client pings. This value is used by the ClientHealthMonitor to determine the health of this BridgeServer's clients. The default is 60000 ms.

Returns:

the maximum amount of time between client pings.

Since:

4.2.3

start

void start()
           throws IOException

Deprecated.

Starts this server. Once the server is running, its configuration cannot be changed.

Throws:

IOException - If an error occurs while starting the server

isRunning

boolean isRunning()

Deprecated.

Returns whether or not this server is running

stop

void stop()

Deprecated.

Stops this server. Note that the BridgeServer can be reconfigured and restarted if desired.

getMaxConnections

int getMaxConnections()

Deprecated.

Returns the maximum allowed client connections

setMaxConnections

void setMaxConnections(int maxCons)

Deprecated.

Sets the maxium number of client connections allowed. When the maximum is reached the server will stop accepting connections.

See Also:

DEFAULT_MAX_CONNECTIONS

getMaxThreads

int getMaxThreads()

Deprecated.

Returns the maxium number of threads allowed in this server to service client requests. The default of 0 causes the server to dedicate a thread for every client connection.

Since:

5.1

setMaxThreads

void setMaxThreads(int maxThreads)

Deprecated.

Sets the maxium number of threads allowed in this server to service client requests. The default of 0 causes the server to dedicate a thread for every client connection.

Since:

5.1

See Also:

DEFAULT_MAX_THREADS

getMaximumMessageCount

int getMaximumMessageCount()

Deprecated.

Returns the maximum number of messages that can be enqueued in a client-queue.

setMaximumMessageCount

void setMaximumMessageCount(int maxMessageCount)

Deprecated.

Sets maximum number of messages that can be enqueued in a client-queue.

See Also:

DEFAULT_MAXIMUM_MESSAGE_COUNT

getMessageTimeToLive

int getMessageTimeToLive()

Deprecated.

Returns the time (in seconds ) after which a message in the client queue will expire.

setMessageTimeToLive

void setMessageTimeToLive(int messageTimeToLive)

Deprecated.

Sets the time (in seconds ) after which a message in the client queue will expire.Expiry settings are applicable for the secondary queues only This setting has no impact on the primary queue.

See Also:

DEFAULT_MESSAGE_TIME_TO_LIVE

getClientSession

ClientSession getClientSession(DistributedMember member)

Deprecated.

Returns the ClientSession associated with the DistributedMember

Returns:

the ClientSession associated with the DistributedMember

Since:

5.6

getClientSession

ClientSession getClientSession(String durableClientId)

Deprecated.

Returns the ClientSession associated with the durable client id

Returns:

the ClientSession associated with the durable

Since:

5.6

getAllClientSessions

Set getAllClientSessions()

Deprecated.

Returns a set of all ClientSessions

Returns:

a set of all ClientSessions

setGroups

void setGroups(String[] groups)

Deprecated.

Sets the list of server groups this cache server will belong to. By default cache servers belong to the default global server group which all cache servers always belong to.

Parameters:

groups - possibly empty array of String where each string is a server groups that this cache server will be a member of.

Since:

5.7

See Also:

DEFAULT_GROUPS

getGroups

String[] getGroups()

Deprecated.

Returns the list of server groups that this cache server belongs to.

Returns:

a possibly empty array of Strings where each string is a server group. Modifying this array will not change the server groups that this cache server belongs to.

Since:

5.7

getLoadProbe

ServerLoadProbe getLoadProbe()

Deprecated.

Get the load probe for this cache server. See ServerLoadProbe for details on the load probe.

Returns:

the load probe used by this cache server.

Since:

5.7

setLoadProbe

void setLoadProbe(ServerLoadProbe loadProbe)

Deprecated.

Set the load probe for this cache server. See ServerLoadProbe for details on how to implement a load probe.

Parameters:

loadProbe - the load probe to use for this cache server.

Since:

5.7

getLoadPollInterval

long getLoadPollInterval()

Deprecated.

Get the frequency in milliseconds to poll the load probe on this cache server.

Returns:

the frequency in milliseconds that we will poll the load probe.

setLoadPollInterval

void setLoadPollInterval(long loadPollInterval)

Deprecated.

Set the frequency in milliseconds to poll the load probe on this cache server

Parameters:

loadPollInterval - the frequency in milliseconds to poll the load probe. Must be greater than 0.

getClientSubscriptionConfig

ClientSubscriptionConfig getClientSubscriptionConfig()

Deprecated.

Get the ClientSubscriptionConfig for this cache server. See ClientSubscriptionConfig for details on the client subscription configuration.

Returns:

ClientSubscriptionConfig

Since:

5.7