MembershipService (Apache Tomcat 7.0.109 API Documentation)

All Known Implementing Classes:

McastService
```
public interface MembershipService
```
MembershipService Interface
The MembershipService interface is the membership component at the bottom layer, the IO layer (for layers see the javadoc for the Channel interface).

Author:

Filip Hanik

Field Summary

Fields
Modifier and Type Field and Description

static int MBR_RX

static int MBR_TX

Fields
Modifier and Type	Field and Description
`static int`	`MBR_RX`
`static int`	`MBR_TX`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`broadcast(ChannelMessage message)` Broadcasts a message to all members
`Member`	`findMemberByName(String name)` Return the member by name
`Member`	`getLocalMember(boolean incAliveTime)` Returns the member object that defines this member
`Member`	`getMember(Member mbr)`
`Member[]`	`getMembers()` Returns a list of all the members in the cluster.
`String[]`	`getMembersByName()` Return all members by name
`Properties`	`getProperties()` Returns the properties for the configuration used.
`boolean`	`hasMembers()`
`void`	`removeMembershipListener()` removes the membership listener.
`void`	`setDomain(byte[] domain)`
`void`	`setLocalMemberProperties(String listenHost, int listenPort, int securePort, int udpPort)` Sets the local member properties for broadcasting
`void`	`setMembershipListener(MembershipListener listener)` Sets the membership listener, only one listener can be added.
`void`	`setPayload(byte[] payload)` Set a payload to be broadcasted with each membership broadcast.
`void`	`setProperties(Properties properties)` Sets the properties for the membership service.
`void`	`start()` Starts the membership service.
`void`	`start(int level)` Starts the membership service.
`void`	`stop(int level)` Starts the membership service.

- Field Detail
  - MBR_RX
```
static final int MBR_RX
```
    See Also:
    Constant Field Values
  - MBR_TX
```
static final int MBR_TX
```
    See Also:
    Constant Field Values
- Method Detail
  - setProperties
```
void setProperties(Properties properties)
```
    Sets the properties for the membership service. This must be called before the start() method is called. The properties are implementation specific.
    
    Parameters:
    properties - - to be used to configure the membership service.
  - getProperties
```
Properties getProperties()
```
    Returns the properties for the configuration used.
  - start
```
void start()
           throws Exception
```
    Starts the membership service. If a membership listeners is added the listener will start to receive membership events. Performs a start level 1 and 2
    
    Throws:
    
    Exception - if the service fails to start.
  - start
```
void start(int level)
           throws Exception
```
    Starts the membership service. If a membership listeners is added the listener will start to receive membership events.
    
    Parameters:
    level - - level MBR_RX starts listening for members, level MBR_TX starts broad casting the server
    
    Throws:
    
    Exception - if the service fails to start.
    
    IllegalArgumentException - if the level is incorrect.
  - stop
```
void stop(int level)
```
    Starts the membership service. If a membership listeners is added the listener will start to receive membership events.
    
    Parameters:
    level - - level MBR_RX stops listening for members, level MBR_TX stops broad casting the server
    
    Throws:
    
    IllegalArgumentException - if the level is incorrect.
  - hasMembers
```
boolean hasMembers()
```
    Returns:
    true if the the group contains members
  - getMember
```
Member getMember(Member mbr)
```
    Parameters:
    mbr - Member
    
    Returns:
    Member
  - getMembers
```
Member[] getMembers()
```
    Returns a list of all the members in the cluster.
  - getLocalMember
```
Member getLocalMember(boolean incAliveTime)
```
    Returns the member object that defines this member
  - getMembersByName
```
String[] getMembersByName()
```
    Return all members by name
  - findMemberByName
```
Member findMemberByName(String name)
```
    Return the member by name
  - setLocalMemberProperties
```
void setLocalMemberProperties(String listenHost,
                            int listenPort,
                            int securePort,
                            int udpPort)
```
    Sets the local member properties for broadcasting
  - setMembershipListener
```
void setMembershipListener(MembershipListener listener)
```
    Sets the membership listener, only one listener can be added. If you call this method twice, the last listener will be used.
    
    Parameters:
    listener - The listener
  - removeMembershipListener
```
void removeMembershipListener()
```
    removes the membership listener.
  - setPayload
```
void setPayload(byte[] payload)
```
    Set a payload to be broadcasted with each membership broadcast.
    
    Parameters:
    payload - byte[]
  - setDomain
```
void setDomain(byte[] domain)
```
  - broadcast
```
void broadcast(ChannelMessage message)
               throws ChannelException
```
    Broadcasts a message to all members
    
    Parameters:
    message -
    
    Throws:
    
    ChannelException

Interface MembershipService

Field Summary

Method Summary

Field Detail

MBR_RX

MBR_TX

Method Detail

setProperties

getProperties

start

start

stop

hasMembers

getMember

getMembers

getLocalMember

getMembersByName

findMemberByName

setLocalMemberProperties

setMembershipListener

removeMembershipListener

setPayload

setDomain

broadcast