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 longreconnect_intervalprotected intsock_conn_timeoutprotected RouterStubManagerstubManagerprotected booleanuse_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 voidaddInitialHost(java.lang.String hostname, int port)voiddestroy()This method is called on aJChannel.close().voidfindMembers(java.util.List<Address> members, boolean initial_discovery, Responses responses)Fetches information (e.g.java.util.List<java.net.InetSocketAddress>getInitialHosts()RouterStubManagergetStubManager()voidhandleConnect()voidhandleDisconnect()voidinit()Called after instance has been created (null constructor) and before protocol is started.booleanisDynamic()voidmembers(java.util.List<PingData> mbrs)java.lang.Stringprint()java.lang.StringprintReconnectList()java.lang.StringprintStubs()booleanremoveInitialHost(java.lang.String hostname, int port)voidsetInitialHosts(java.util.Collection<java.net.InetSocketAddress> hosts)voidsetInitialHosts(java.util.List<java.net.InetSocketAddress> hosts)voidstop()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.ExceptionDescription copied from class:ProtocolCalled 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:ProtocolThis 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:ProtocolThis method is called on aJChannel.close(). Does some cleanup; after the call the VM will terminate
-
handleConnect
public void handleConnect()
- Overrides:
handleConnectin classDiscovery
-
print
public java.lang.String print()
-
printStubs
public java.lang.String printStubs()
-
printReconnectList
public java.lang.String printReconnectList()
-
handleDisconnect
public void handleDisconnect()
- Overrides:
handleDisconnectin classDiscovery
-
findMembers
public void findMembers(java.util.List<Address> members, boolean initial_discovery, Responses responses)
Description copied from class:DiscoveryFetches information (e.g. physical address, logical name) for the given member addresses. Needs to add responses to theResponsesobject. IfDiscovery.async_discoveryis true, this method will be called in a separate thread, otherwise the caller's thread will be used.- Specified by:
findMembersin classDiscovery- Parameters:
members- A list of logical addresses (typicallyUUIDs). 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:
membersin interfaceRouterStub.MembersNotification
-
addInitialHost
public void addInitialHost(java.lang.String hostname, int port)
-
removeInitialHost
public boolean removeInitialHost(java.lang.String hostname, int port)
-
-