org.elasticsearch.cluster.node

Class DiscoveryNodes

java.lang.Object

org.elasticsearch.cluster.AbstractDiffable<DiscoveryNodes>

org.elasticsearch.cluster.node.DiscoveryNodes

All Implemented Interfaces:

Iterable<DiscoveryNode>, Diffable<DiscoveryNodes>, StreamableReader<DiscoveryNodes>, Writeable<DiscoveryNodes>

public class DiscoveryNodes
extends AbstractDiffable<DiscoveryNodes>
implements Iterable<DiscoveryNode>

This class holds all DiscoveryNode in the cluster and provides convenience methods to access, modify merge / diff discovery nodes.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DiscoveryNodes.Builder
static class	DiscoveryNodes.Delta

Field Summary

Fields

Modifier and Type	Field and Description
static DiscoveryNodes	EMPTY_NODES
static DiscoveryNodes	PROTO

Method Summary

Methods

Modifier and Type	Method and Description
static DiscoveryNodes.Builder	builder()
static DiscoveryNodes.Builder	builder(DiscoveryNodes nodes)
ImmutableOpenMap<String,DiscoveryNode>	dataNodes() Get a Map of the discovered data nodes arranged by their ids
DiscoveryNodes.Delta	delta(DiscoveryNodes other) Returns the changes comparing this nodes to the provided nodes.
DiscoveryNodes.Delta	emptyDelta()
DiscoveryNode	findByAddress(TransportAddress address) Get a node by its address
DiscoveryNode	get(String nodeId) Get a node by its id
ImmutableOpenMap<String,DiscoveryNode>	getDataNodes() Get a Map of the discovered data nodes arranged by their ids
DiscoveryNode	getLocalNode() Get the local node
String	getLocalNodeId() Get the id of the local node
DiscoveryNode	getMasterNode() Get the master node
String	getMasterNodeId() Get the id of the master node
ImmutableOpenMap<String,DiscoveryNode>	getMasterNodes() Get a Map of the discovered master nodes arranged by their ids
ImmutableOpenMap<String,DiscoveryNode>	getNodes() Get a Map of the discovered nodes arranged by their ids
int	getSize() Get the number of known nodes
boolean	isAllNodes(String... nodesIds)
com.google.common.collect.UnmodifiableIterator<DiscoveryNode>	iterator()
DiscoveryNode	localNode() Get the local node
String	localNodeId() Get the id of the local node
boolean	localNodeMaster() Returns true if the local node is the master node.
ImmutableOpenMap<String,DiscoveryNode>	masterAndDataNodes() Get a Map of the discovered master and data nodes arranged by their ids
DiscoveryNode	masterNode() Get the master node
String	masterNodeId() Get the id of the master node
ImmutableOpenMap<String,DiscoveryNode>	masterNodes() Get a Map of the discovered master nodes arranged by their ids
DiscoveryNodes	newNode(DiscoveryNode node)
boolean	nodeExists(String nodeId) Determine if a given node exists
ImmutableOpenMap<String,DiscoveryNode>	nodes() Get a Map of the discovered nodes arranged by their ids
String	prettyPrint()
DiscoveryNodes	readFrom(StreamInput in) Reads a copy of an object with the same type form the stream input The caller object remains unchanged.
DiscoveryNodes	readFrom(StreamInput in, DiscoveryNode localNode)
DiscoveryNodes	removeDeadMembers(Set<String> newNodes, String masterNodeId)
DiscoveryNode	resolveNode(String node) Resolve a node with a given id
String[]	resolveNodesIds(String... nodesIds)
int	size() Get the number of known nodes
Version	smallestNonClientNodeVersion() Returns the version of the node with the oldest version in the cluster that is not a client node
Version	smallestVersion() Returns the version of the node with the oldest version in the cluster
String	toString()
boolean	valid() Is this a valid nodes that has the minimal information set.
void	writeTo(StreamOutput out) Writes the current object into the output stream out

Methods inherited from class org.elasticsearch.cluster.AbstractDiffable

diff, get, readDiffFrom, readDiffFrom

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_NODES

public static final DiscoveryNodes EMPTY_NODES

PROTO

public static final DiscoveryNodes PROTO

Method Detail

iterator

public com.google.common.collect.UnmodifiableIterator<DiscoveryNode> iterator()

Specified by:

iterator in interface Iterable<DiscoveryNode>

valid

public boolean valid()

Is this a valid nodes that has the minimal information set. The minimal set is defined by the localNodeId being set.

localNodeMaster

public boolean localNodeMaster()

Returns true if the local node is the master node.

size

public int size()

Get the number of known nodes

Returns:

number of nodes

getSize

public int getSize()

Get the number of known nodes

Returns:

number of nodes

nodes

public ImmutableOpenMap<String,DiscoveryNode> nodes()

Get a Map of the discovered nodes arranged by their ids

Returns:

Map of the discovered nodes arranged by their ids

getNodes

public ImmutableOpenMap<String,DiscoveryNode> getNodes()

Get a Map of the discovered nodes arranged by their ids

Returns:

Map of the discovered nodes arranged by their ids

dataNodes

public ImmutableOpenMap<String,DiscoveryNode> dataNodes()

Get a Map of the discovered data nodes arranged by their ids

Returns:

Map of the discovered data nodes arranged by their ids

getDataNodes

public ImmutableOpenMap<String,DiscoveryNode> getDataNodes()

Get a Map of the discovered data nodes arranged by their ids

Returns:

Map of the discovered data nodes arranged by their ids

masterNodes

public ImmutableOpenMap<String,DiscoveryNode> masterNodes()

Get a Map of the discovered master nodes arranged by their ids

Returns:

Map of the discovered master nodes arranged by their ids

getMasterNodes

public ImmutableOpenMap<String,DiscoveryNode> getMasterNodes()

Get a Map of the discovered master nodes arranged by their ids

Returns:

Map of the discovered master nodes arranged by their ids

masterAndDataNodes

public ImmutableOpenMap<String,DiscoveryNode> masterAndDataNodes()

Get a Map of the discovered master and data nodes arranged by their ids

Returns:

Map of the discovered master and data nodes arranged by their ids

get

public DiscoveryNode get(String nodeId)

Get a node by its id

Parameters:

nodeId - id of the wanted node

Returns:

wanted node if it exists. Otherwise null

nodeExists

public boolean nodeExists(String nodeId)

Determine if a given node exists

Parameters:

nodeId - id of the node which existence should be verified

Returns:

true if the node exists. Otherwise false

masterNodeId

public String masterNodeId()

Get the id of the master node

Returns:

id of the master

getMasterNodeId

public String getMasterNodeId()

Get the id of the master node

Returns:

id of the master

localNodeId

public String localNodeId()

Get the id of the local node

Returns:

id of the local node

getLocalNodeId

public String getLocalNodeId()

Get the id of the local node

Returns:

id of the local node

localNode

public DiscoveryNode localNode()

Get the local node

Returns:

local node

getLocalNode

public DiscoveryNode getLocalNode()

Get the local node

Returns:

local node

masterNode

public DiscoveryNode masterNode()

Get the master node

Returns:

master node

getMasterNode

public DiscoveryNode getMasterNode()

Get the master node

Returns:

master node

findByAddress

public DiscoveryNode findByAddress(TransportAddress address)

Get a node by its address

Parameters:

address - TransportAddress of the wanted node

Returns:

node identified by the given address or null if no such node exists

isAllNodes

public boolean isAllNodes(String... nodesIds)

smallestVersion

public Version smallestVersion()

Returns the version of the node with the oldest version in the cluster

Returns:

the oldest version in the cluster

smallestNonClientNodeVersion

public Version smallestNonClientNodeVersion()

Returns the version of the node with the oldest version in the cluster that is not a client node

Returns:

the oldest version in the cluster

resolveNode

public DiscoveryNode resolveNode(String node)

Resolve a node with a given id

Parameters:

node - id of the node to discover

Returns:

discovered node matching the given id

Throws:

IllegalArgumentException - if more than one node matches the request or no nodes have been resolved

resolveNodesIds

public String[] resolveNodesIds(String... nodesIds)

removeDeadMembers

public DiscoveryNodes removeDeadMembers(Set<String> newNodes,
                               String masterNodeId)

newNode

public DiscoveryNodes newNode(DiscoveryNode node)

delta

public DiscoveryNodes.Delta delta(DiscoveryNodes other)

Returns the changes comparing this nodes to the provided nodes.

toString

public String toString()

Overrides:

toString in class Object

prettyPrint

public String prettyPrint()

emptyDelta

public DiscoveryNodes.Delta emptyDelta()

writeTo

public void writeTo(StreamOutput out)
             throws IOException

Description copied from interface: Writeable

Writes the current object into the output stream out

Specified by:

writeTo in interface Writeable<DiscoveryNodes>

Throws:

IOException

readFrom

public DiscoveryNodes readFrom(StreamInput in,
                      DiscoveryNode localNode)
                        throws IOException

Throws:

IOException

readFrom

public DiscoveryNodes readFrom(StreamInput in)
                        throws IOException

Description copied from interface: StreamableReader

Reads a copy of an object with the same type form the stream input The caller object remains unchanged.

Specified by:

readFrom in interface StreamableReader<DiscoveryNodes>

Throws:

IOException

builder

public static DiscoveryNodes.Builder builder()

builder

public static DiscoveryNodes.Builder builder(DiscoveryNodes nodes)