org.jgroups.util

Class TopologyUUID

java.lang.Object

org.jgroups.util.UUID

org.jgroups.util.TopologyUUID

All Implemented Interfaces:

Externalizable, Serializable, Comparable<Address>, Address, Streamable

public class TopologyUUID
extends UUID

Subclass of UUID which adds 3 strings (siteId, rackId and machineId)as payload. An instance of this can be fed to JChannel.setAddressGenerator(org.jgroups.stack.AddressGenerator), with the address generator creating TopologyUUIDs.

Mainly used by TopologyAwareConsistentHash in Infinispan (www.infinispan.org).

Author:

Bela Ban

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected String	machine_id
protected String	rack_id
protected String	site_id

Fields inherited from class org.jgroups.util.UUID

cache, leastSigBits, mostSigBits, numberGenerator, print_function, print_uuids, SIZE

Fields inherited from interface org.jgroups.Address

IP_ADDR, NULL, UUID_ADDR

Constructor Summary

Constructors

Modifier	Constructor and Description
	TopologyUUID()
protected	TopologyUUID(byte[] data, String site_id, String rack_id, String machine_id)

Method Summary

Methods

Modifier and Type	Method and Description
protected static byte[]	generateRandomBytes()
String	getMachineId()
String	getRackId()
String	getSiteId()
boolean	isSameMachine(TopologyUUID addr)
boolean	isSameRack(TopologyUUID addr)
boolean	isSameSite(TopologyUUID addr)
protected String	printDetails()
static TopologyUUID	randomUUID(String site_id, String rack_id, String machine_id)
static TopologyUUID	randomUUID(String logical_name, String site_id, String rack_id, String machine_id)
void	readExternal(ObjectInput in)
void	readFrom(DataInput in) Read the state of the current object (including superclasses) from instream Note that the input stream must not be closed
void	setMachineId(String machine_id)
void	setRackId(String rack_id)
void	setSiteId(String site_id)
int	size() Returns serialized size of this address
String	toString()
String	toStringDetailed()
void	writeExternal(ObjectOutput out)
void	writeTo(DataOutput out) Write the entire state of the current object (including superclasses) to outstream.

Methods inherited from class org.jgroups.util.UUID

add, add, compareTo, copy, digits, equals, get, getContents, getLeastSignificantBits, getMostSignificantBits, hashCode, printCache, randomUUID, remove, removeAll, retainAll, toStringLong

Methods inherited from class java.lang.Object

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

Field Detail

site_id

protected String site_id

rack_id

protected String rack_id

machine_id

protected String machine_id

Constructor Detail

TopologyUUID

public TopologyUUID()

TopologyUUID

protected TopologyUUID(byte[] data,
            String site_id,
            String rack_id,
            String machine_id)

Method Detail

randomUUID

public static TopologyUUID randomUUID(String site_id,
                      String rack_id,
                      String machine_id)

randomUUID

public static TopologyUUID randomUUID(String logical_name,
                      String site_id,
                      String rack_id,
                      String machine_id)

getSiteId

public String getSiteId()

setSiteId

public void setSiteId(String site_id)

getRackId

public String getRackId()

setRackId

public void setRackId(String rack_id)

getMachineId

public String getMachineId()

setMachineId

public void setMachineId(String machine_id)

isSameSite

public boolean isSameSite(TopologyUUID addr)

isSameRack

public boolean isSameRack(TopologyUUID addr)

isSameMachine

public boolean isSameMachine(TopologyUUID addr)

size

public int size()

Description copied from interface: Address

Returns serialized size of this address

Specified by:

size in interface Address

Overrides:

size in class UUID

writeTo

public void writeTo(DataOutput out)
             throws Exception

Description copied from interface: Streamable

Write the entire state of the current object (including superclasses) to outstream. Note that the output stream must not be closed

Specified by:

writeTo in interface Streamable

Overrides:

writeTo in class UUID

Throws:

Exception

readFrom

public void readFrom(DataInput in)
              throws Exception

Description copied from interface: Streamable

Read the state of the current object (including superclasses) from instream Note that the input stream must not be closed

Specified by:

readFrom in interface Streamable

Overrides:

readFrom in class UUID

Throws:

Exception

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException

Specified by:

readExternal in interface Externalizable

Overrides:

readExternal in class UUID

Throws:

IOException

ClassNotFoundException

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Overrides:

writeExternal in class UUID

Throws:

IOException

toString

public String toString()

Overrides:

toString in class UUID

toStringDetailed

public String toStringDetailed()

generateRandomBytes

protected static byte[] generateRandomBytes()

printDetails

protected String printDetails()