Package org.apache.catalina.tribes
Interface Member
- All Superinterfaces:
- Serializable
- All Known Implementing Classes:
- MemberImpl,- StaticMember
The Member interface, defines a member in the group. Each member can carry a set of properties, defined by the actual
 implementation.
 
A member is identified by the host/ip/uniqueId.
- The host is what interface the member is listening to, to receive data
- The port is what port the member is listening to, to receive data
- The uniqueId defines the session id for the member. This is an important feature since a member that has crashed and the starts up again on the same port/host is not guaranteed to be the same member, so no state transfers will ever be confused.
- 
Field SummaryFieldsModifier and TypeFieldDescriptionstatic final byte[]When a member leaves the cluster, the payload of the memberDisappeared member will be the following bytes.
- 
Method SummaryModifier and TypeMethodDescriptionbyte[]byte[]getData(boolean getalive) Highly optimized version of serializing a member into a byte array Returns a cached byte[] reference, do not modify this databyte[]getData(boolean getalive, boolean reset) Highly optimized version of serializing a member into a byte array Returns a cached byte[] reference, do not modify this dataintLength of a message obtained bygetData(boolean)orgetData(boolean, boolean).byte[]byte[]getHost()Returns the listen host for the ChannelReceiver implementationlongContains information on how long this member has been online.getName()byte[]intgetPort()Returns the listen port for the ChannelReceiver implementationintReturns the secure listen port for the ChannelReceiver implementation.intReturns the UDP port that this member is listening to for UDP messages.byte[]returns a UUID unique for this member over all sessions.booleanbooleanisLocal()booleanisReady()The current state of the member.booleanThe current state of the member.voidsetCommand(byte[] command) Set the command associated with this member.voidsetLocal(boolean local) Set if the member is local.voidsetMemberAliveTime(long memberAliveTime) Set the alive time in ms.voidsetPayload(byte[] payload) Set the payload associated with this member.
- 
Field Details- 
SHUTDOWN_PAYLOADstatic final byte[] SHUTDOWN_PAYLOADWhen a member leaves the cluster, the payload of the memberDisappeared member will be the following bytes. This indicates a soft shutdown, and not a crash
 
- 
- 
Method Details- 
getNameString getName()- Returns:
- the name of this node, should be unique within the group.
 
- 
getHostbyte[] getHost()Returns the listen host for the ChannelReceiver implementation- Returns:
- IPv4 or IPv6 representation of the host address this member listens to incoming data
- See Also:
 
- 
getPortint getPort()Returns the listen port for the ChannelReceiver implementation- Returns:
- the listen port for this member, -1 if its not listening on an insecure port
- See Also:
 
- 
getSecurePortint getSecurePort()Returns the secure listen port for the ChannelReceiver implementation. Returns -1 if its not listening to a secure port.- Returns:
- the listen port for this member, -1 if its not listening on a secure port
- See Also:
 
- 
getUdpPortint getUdpPort()Returns the UDP port that this member is listening to for UDP messages.- Returns:
- the listen UDP port for this member, -1 if its not listening on a UDP port
 
- 
getMemberAliveTimelong getMemberAliveTime()Contains information on how long this member has been online. The result is the number of milli seconds this member has been broadcasting its membership to the group.- Returns:
- nr of milliseconds since this member started.
 
- 
setMemberAliveTimevoid setMemberAliveTime(long memberAliveTime) Set the alive time in ms.- Parameters:
- memberAliveTime- the value to set
 
- 
isReadyboolean isReady()The current state of the member.- Returns:
- trueif the member is functioning correctly
 
- 
isSuspectboolean isSuspect()The current state of the member.- Returns:
- trueif the member is suspect, but the crash has not been confirmed
 
- 
isFailingboolean isFailing()- Returns:
- trueif the member has been confirmed to malfunction
 
- 
getUniqueIdbyte[] getUniqueId()returns a UUID unique for this member over all sessions. If the member crashes and restarts, the uniqueId will be different.- Returns:
- byte[]
 
- 
getPayloadbyte[] getPayload()- Returns:
- the payload associated with this member
 
- 
setPayloadvoid setPayload(byte[] payload) Set the payload associated with this member.- Parameters:
- payload- the payload
 
- 
getCommandbyte[] getCommand()- Returns:
- the command associated with this member
 
- 
setCommandvoid setCommand(byte[] command) Set the command associated with this member.- Parameters:
- command- the command
 
- 
getDomainbyte[] getDomain()- Returns:
- the domain for this cluster
 
- 
getDatabyte[] getData(boolean getalive) Highly optimized version of serializing a member into a byte array Returns a cached byte[] reference, do not modify this data- Parameters:
- getalive- calculate memberAlive time
- Returns:
- the data as a byte array
 
- 
getDatabyte[] getData(boolean getalive, boolean reset) Highly optimized version of serializing a member into a byte array Returns a cached byte[] reference, do not modify this data- Parameters:
- getalive- calculate memberAlive time
- reset- reset the cached data package, and create a new one
- Returns:
- the data as a byte array
 
- 
getDataLengthint getDataLength()Length of a message obtained bygetData(boolean)orgetData(boolean, boolean).- Returns:
- the data length
 
- 
isLocalboolean isLocal()- Returns:
- trueif the member is local member
 
- 
setLocalvoid setLocal(boolean local) Set if the member is local.- Parameters:
- local- set to- trueif this is the local member
 
 
-