com.hazelcast.spi.discovery

Class DiscoveryNode

java.lang.Object

com.hazelcast.spi.discovery.DiscoveryNode

Direct Known Subclasses:

SimpleDiscoveryNode

public abstract class DiscoveryNode
extends Object

A DiscoveryNode describes a nodes addresses (private and if necessary a public one) as well as attributes assigned to this node. Private address defines the typical internal communication port, all cluster communication and also client communication inside the same network happens on this address. However in cloud environments clients might run in other sub-networks and therefore cannot access the private address. In those situations DiscoveryStrategy vendors can retrieve and assign an additional external (or public) IP address of the node for clients to connect against.

Public addresses, if not necessary, can either be returned as null or may return the same address instance as the private one and will be handled internally the same way.

The properties will be used to store any kind of tags or other metadata available for the node inside of the cloud environment. If a NodeFilter is configured, these properties might be used for further refinement of the discovered nodes based on whatever the filter decides.

This class is implemented as an abstract class to offer easy extensibility in later versions of the SPI. Since Java only offers forward evolution of interfaces starting with Java 8, this is the best option.

Since:

3.6

Constructor Summary

Constructors

Constructor and Description
DiscoveryNode()

Method Summary

Modifier and Type	Method and Description
abstract Address	getPrivateAddress() Returns the private address of the discovered node.
abstract Map<String,Object>	getProperties() Returns a set of unmodifiable properties that are assigned to the discovered node.
abstract Address	getPublicAddress() Returns the public address of the discovered node if available.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DiscoveryNode

public DiscoveryNode()

Method Detail

getPrivateAddress

public abstract Address getPrivateAddress()

Returns the private address of the discovered node. The private address must not be null.

Returns:

the private address of the discovered node

getPublicAddress

public abstract Address getPublicAddress()

Returns the public address of the discovered node if available. Public addresses are optional and this method may return null or the same address as getPrivateAddress().

Returns:

the public address of the discovered node if available otherwise null or getPrivateAddress()

getProperties

public abstract Map<String,Object> getProperties()

Returns a set of unmodifiable properties that are assigned to the discovered node. These properties can be used for additional filtering based on the NodeFilter API.

Returns:

assigned properties of that node