Package org.jgroups.protocols
Class TCPGOSSIP
- java.lang.Object
-
- org.jgroups.stack.Protocol
-
- org.jgroups.protocols.Discovery
-
- org.jgroups.protocols.TCPGOSSIP
-
- All Implemented Interfaces:
RouterStub.MembersNotification
public class TCPGOSSIP extends Discovery implements RouterStub.MembersNotification
The TCPGOSSIP protocol layer retrieves the initial membership (used by GMS when started by sending event FIND_INITIAL_MBRS down the stack). We do this by contacting one or more GossipRouters, which must be running at well-known addresses:ports. The responses should allow us to determine the coordinator whom we have to contact, e.g. in case we want to join the group. When we are a server (after having received the BECOME_SERVER event), we'll respond to TCPGOSSIP requests with a TCPGOSSIP response.- Since:
- a long time ago
- Author:
- Bela Ban
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class org.jgroups.protocols.Discovery
Discovery.DiscoveryCacheDisseminationTask
-
-
Field Summary
Fields Modifier and Type Field Description protected long
reconnect_interval
protected int
sock_conn_timeout
protected RouterStubManager
stubManager
protected boolean
use_nio
-
Fields inherited from class org.jgroups.protocols.Discovery
async_discovery, async_discovery_use_separate_thread_per_request, break_on_coord_rsp, cluster_name, current_coord, discovery_req_futures, discovery_rsp_callback, discovery_rsp_expiry_time, is_coord, is_leaving, is_server, local_addr, max_members_in_discovery_request, max_rank_to_reply, num_discovery_requests, num_discovery_runs, ping_responses, return_entire_cache, send_cache_on_join, sends_can_block, stagger_timeout, timer, transport, transport_supports_multicasting, use_disk_cache, use_ip_addrs, view, WHITESPACE
-
Fields inherited from class org.jgroups.stack.Protocol
after_creation_hook, down_prot, ergonomics, id, log, stack, stats, up_prot
-
-
Constructor Summary
Constructors Constructor Description TCPGOSSIP()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
addInitialHost(java.lang.String hostname, int port)
void
destroy()
This method is called on aJChannel.close()
.void
findMembers(java.util.List<Address> members, boolean initial_discovery, Responses responses)
Fetches information (e.g.java.util.List<java.net.InetSocketAddress>
getInitialHosts()
RouterStubManager
getStubManager()
void
handleConnect()
void
handleDisconnect()
void
init()
Called after instance has been created (null constructor) and before protocol is started.boolean
isDynamic()
void
members(java.util.List<PingData> mbrs)
java.lang.String
print()
java.lang.String
printReconnectList()
java.lang.String
printStubs()
boolean
removeInitialHost(java.lang.String hostname, int port)
void
setInitialHosts(java.util.Collection<java.net.InetSocketAddress> hosts)
void
setInitialHosts(java.util.List<java.net.InetSocketAddress> hosts)
void
stop()
This method is called on aJChannel.disconnect()
.-
Methods inherited from class org.jgroups.protocols.Discovery
addDiscoveryResponseToCaches, addResponse, addResponse, addressAsString, addToCache, breakOnCoordResponse, breakOnCoordResponse, clearRequestFutures, deserialize, discoveryRequestReceived, discoveryRspExpiryTime, disseminateDiscoveryInformation, down, dumpCache, findInitialMembersAsString, findMembers, getClusterName, getCurrentCoord, getNumberOfDiscoveryRequestsSent, getView, getViewId, handleDiscoveryResponse, invokeFindMembers, isCoord, isMergeRunning, marshal, providedUpServices, read, readPingData, resetStats, returnEntireCache, returnEntireCache, sendCacheInformation, sendDiscoveryResponse, serializeWithoutView, setClusterName, staggerTimeout, staggerTimeout, start, startCacheDissemination, up, up, useDiskCache, useDiskCache, weedOutCompletedDiscoveryResponses, write
-
Methods inherited from class org.jgroups.stack.Protocol
accept, afterCreationHook, down, enableStats, getConfigurableObjects, getDownProtocol, getDownServices, getId, getIdsAbove, getLevel, getLog, getName, getProtocolStack, getSocketFactory, getThreadFactory, getTransport, getUpProtocol, getUpServices, getValue, isErgonomics, level, parse, providedDownServices, requiredDownServices, requiredUpServices, resetStatistics, setDownProtocol, setErgonomics, setId, setLevel, setProtocolStack, setSocketFactory, setUpProtocol, setValue, statsEnabled, up
-
-
-
-
Field Detail
-
sock_conn_timeout
protected int sock_conn_timeout
-
reconnect_interval
protected long reconnect_interval
-
use_nio
protected boolean use_nio
-
stubManager
protected volatile RouterStubManager stubManager
-
-
Method Detail
-
setInitialHosts
public void setInitialHosts(java.util.List<java.net.InetSocketAddress> hosts)
-
setInitialHosts
public void setInitialHosts(java.util.Collection<java.net.InetSocketAddress> hosts)
-
getInitialHosts
public java.util.List<java.net.InetSocketAddress> getInitialHosts()
-
getStubManager
public RouterStubManager getStubManager()
-
init
public void init() throws java.lang.Exception
Description copied from class:Protocol
Called after instance has been created (null constructor) and before protocol is started. Properties are already set. Other protocols are not yet connected and events cannot yet be sent.
-
stop
public void stop()
Description copied from class:Protocol
This method is called on aJChannel.disconnect()
. Stops work (e.g. by closing multicast socket). Will be called from top to bottom. This means that at the time of the method invocation the neighbor protocol below is still working. This method will replace the STOP, STOP_OK, CLEANUP and CLEANUP_OK events. The ProtocolStack guarantees that when this method is called all messages in the down queue will have been flushed
-
destroy
public void destroy()
Description copied from class:Protocol
This method is called on aJChannel.close()
. Does some cleanup; after the call the VM will terminate
-
handleConnect
public void handleConnect()
- Overrides:
handleConnect
in classDiscovery
-
print
public java.lang.String print()
-
printStubs
public java.lang.String printStubs()
-
printReconnectList
public java.lang.String printReconnectList()
-
handleDisconnect
public void handleDisconnect()
- Overrides:
handleDisconnect
in classDiscovery
-
findMembers
public void findMembers(java.util.List<Address> members, boolean initial_discovery, Responses responses)
Description copied from class:Discovery
Fetches information (e.g. physical address, logical name) for the given member addresses. Needs to add responses to theResponses
object. IfDiscovery.async_discovery
is true, this method will be called in a separate thread, otherwise the caller's thread will be used.- Specified by:
findMembers
in classDiscovery
- Parameters:
members
- A list of logical addresses (typicallyUUID
s). If null, then information for all members is fetchedinitial_discovery
- Set to true if this is for the initial membership discovery. Some protocols (e.g. file based ones) may return only the information for the coordinator(s).responses
- The list to which responses should be added
-
members
public void members(java.util.List<PingData> mbrs)
- Specified by:
members
in interfaceRouterStub.MembersNotification
-
addInitialHost
public void addInitialHost(java.lang.String hostname, int port)
-
removeInitialHost
public boolean removeInitialHost(java.lang.String hostname, int port)
-
-