com.hazelcast.config

Class MulticastConfig

java.lang.Object

com.hazelcast.config.MulticastConfig

All Implemented Interfaces:

TrustedInterfacesConfigurable<MulticastConfig>

public class MulticastConfig
extends Object
implements TrustedInterfacesConfigurable<MulticastConfig>

Contains the configuration for the multicast discovery mechanism.

With the multicast discovery mechanism Hazelcast allows Hazelcast members to find each other using multicast. So Hazelcast members do not need to know concrete addresses of members, they just multicast to everyone listening.

It depends on your environment if multicast is possible or allowed; you need to have a look at the TCP/IP cluster: TcpIpConfig.

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEFAULT_ENABLED Whether the multicast discovery mechanism has been enabled
static String	DEFAULT_MULTICAST_GROUP Default group of multicast.
static int	DEFAULT_MULTICAST_PORT Default value of port.
static int	DEFAULT_MULTICAST_TIMEOUT_SECONDS Default timeout of multicast in seconds.
static int	DEFAULT_MULTICAST_TTL Default value of time to live of multicast.

Constructor Summary

Constructors

Constructor and Description
MulticastConfig()

Method Summary

Modifier and Type	Method and Description
MulticastConfig	addTrustedInterface(String ip) Adds a trusted interface.
boolean	equals(Object o)
Boolean	getLoopbackModeEnabled() Returns if explicit loopback mode configuration was requested (by setLoopbackModeEnabled(Boolean)).
String	getMulticastGroup() Gets the multicast group.
int	getMulticastPort() Gets the multicast port.
int	getMulticastTimeoutSeconds() Gets the multicast timeout in seconds.
int	getMulticastTimeToLive() Gets the time to live for the multicast package.
Set<String>	getTrustedInterfaces() Gets the trusted interfaces.
int	hashCode()
boolean	isEnabled() Check if the multicast discovery mechanism has been enabled.
boolean	isLoopbackModeEnabled() Deprecated. Use the getLoopbackModeEnabled().
MulticastConfig	setEnabled(boolean enabled) Enables or disables the multicast discovery mechanism
MulticastConfig	setLoopbackModeEnabled(Boolean enabled) Explicitly enables or disables the loopback mode in the multicast discovery mechanism.
MulticastConfig	setMulticastGroup(String multicastGroup) Sets the multicast group.
MulticastConfig	setMulticastPort(int multicastPort) Sets the multicast port.
MulticastConfig	setMulticastTimeoutSeconds(int multicastTimeoutSeconds) Specifies the time in seconds that a node should wait for a valid multicast response from another node running in the network before declaring itself as master node and creating its own cluster.
MulticastConfig	setMulticastTimeToLive(int multicastTimeToLive) Sets the time to live for the multicast package; a value between 0..255.
MulticastConfig	setTrustedInterfaces(Set<String> interfaces) Sets the trusted interfaces.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

DEFAULT_ENABLED

public static final boolean DEFAULT_ENABLED

Whether the multicast discovery mechanism has been enabled

See Also:

Constant Field Values

DEFAULT_MULTICAST_GROUP

public static final String DEFAULT_MULTICAST_GROUP

Default group of multicast.

See Also:

Constant Field Values

DEFAULT_MULTICAST_PORT

public static final int DEFAULT_MULTICAST_PORT

Default value of port.

See Also:

Constant Field Values

DEFAULT_MULTICAST_TIMEOUT_SECONDS

public static final int DEFAULT_MULTICAST_TIMEOUT_SECONDS

Default timeout of multicast in seconds.

See Also:

Constant Field Values

DEFAULT_MULTICAST_TTL

public static final int DEFAULT_MULTICAST_TTL

Default value of time to live of multicast.

See Also:

Constant Field Values

Constructor Detail

MulticastConfig

public MulticastConfig()

Method Detail

isEnabled

public boolean isEnabled()

Check if the multicast discovery mechanism has been enabled.

Returns:

true if the multicast discovery mechanism has been enabled

setEnabled

public MulticastConfig setEnabled(boolean enabled)

Enables or disables the multicast discovery mechanism

Parameters:

enabled - true to enable, false to disable

Returns:

the updated MulticastConfig

getMulticastGroup

public String getMulticastGroup()

Gets the multicast group.

Returns:

the multicastGroup

setMulticastGroup

public MulticastConfig setMulticastGroup(String multicastGroup)

Sets the multicast group.

Parameters:

multicastGroup - the multicastGroup to set

Returns:

the updated MulticastConfig

Throws:

IllegalArgumentException - if multicastGroup is null or empty

See Also:

getMulticastGroup(), setMulticastPort(int)

getMulticastPort

public int getMulticastPort()

Gets the multicast port.

Returns:

the multicastPort

See Also:

setMulticastPort(int)

setMulticastPort

public MulticastConfig setMulticastPort(int multicastPort)

Sets the multicast port.

Parameters:

multicastPort - the multicastPort to set

Returns:

the updated MulticastConfig

Throws:

IllegalArgumentException - if multicastPort is smaller than 0

See Also:

getMulticastPort(), setMulticastGroup(String)

getMulticastTimeoutSeconds

public int getMulticastTimeoutSeconds()

Gets the multicast timeout in seconds.

Returns:

the multicastTimeoutSeconds

See Also:

setMulticastTimeoutSeconds(int)

setMulticastTimeoutSeconds

public MulticastConfig setMulticastTimeoutSeconds(int multicastTimeoutSeconds)

Specifies the time in seconds that a node should wait for a valid multicast response from another node running in the network before declaring itself as master node and creating its own cluster. This applies only to the startup of nodes where no master has been assigned yet. If you specify a high value, e.g. 60 seconds, it means until a master is selected, each node is going to wait 60 seconds before continuing, so be careful with providing a high value. If the value is set too low, nodes might give up too early and create their own cluster.

Parameters:

multicastTimeoutSeconds - the multicastTimeoutSeconds to set

Returns:

the updated MulticastConfig

See Also:

getMulticastTimeoutSeconds()

getTrustedInterfaces

public Set<String> getTrustedInterfaces()

Gets the trusted interfaces.

Specified by:

getTrustedInterfaces in interface TrustedInterfacesConfigurable<MulticastConfig>

Returns:

the trusted interfaces

See Also:

setTrustedInterfaces(java.util.Set)

setTrustedInterfaces

public MulticastConfig setTrustedInterfaces(Set<String> interfaces)

Sets the trusted interfaces.

By default, when the set of trusted interfaces is empty, a Hazelcast member will accept join-requests from every member. With a trusted interface, you can control the members you want to receive join requests from.

The interface is an IP address where the last octet can be a wildcard '*' or a range '10-20'.

Specified by:

setTrustedInterfaces in interface TrustedInterfacesConfigurable<MulticastConfig>

Parameters:

interfaces - the new trusted interfaces

Returns:

the updated MulticastConfig

See Also:

if interfaces is {@code null}

addTrustedInterface

public MulticastConfig addTrustedInterface(String ip)

Adds a trusted interface.

Specified by:

addTrustedInterface in interface TrustedInterfacesConfigurable<MulticastConfig>

Parameters:

ip - the IP of the trusted interface

Returns:

the updated MulticastConfig

Throws:

IllegalArgumentException - if IP is null

See Also:

setTrustedInterfaces(java.util.Set)

getMulticastTimeToLive

public int getMulticastTimeToLive()

Gets the time to live for the multicast package.

Returns:

the time to live for the multicast package

See Also:

MulticastSocket.setTimeToLive(int), setMulticastTimeToLive(int)

setMulticastTimeToLive

public MulticastConfig setMulticastTimeToLive(int multicastTimeToLive)

Sets the time to live for the multicast package; a value between 0..255.

See this link for more information.

Parameters:

multicastTimeToLive - the time to live for the multicast package

Returns:

the updated MulticastConfig

Throws:

IllegalArgumentException - if time to live is smaller than 0 or larger than 255

See Also:

getMulticastTimeToLive(), MulticastSocket.setTimeToLive(int)

isLoopbackModeEnabled

@Deprecated
public boolean isLoopbackModeEnabled()

Deprecated. Use the getLoopbackModeEnabled().

Check if the loopback mode is enabled in the multicast discovery mechanism.

Returns:

true if the the loopback mode is enabled, false otherwise

getLoopbackModeEnabled

public Boolean getLoopbackModeEnabled()

Returns if explicit loopback mode configuration was requested (by setLoopbackModeEnabled(Boolean)).

Returns:

TRUE if the loopback mode should be enabled, FALSE disabled, null when it's left up to platform to decide.

setLoopbackModeEnabled

public MulticastConfig setLoopbackModeEnabled(Boolean enabled)

Explicitly enables or disables the loopback mode in the multicast discovery mechanism.

Parameters:

enabled - true to enable the loopback mode, false to disable

Returns:

the updated MulticastConfig

equals

public final boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public final int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object