com.tangosol.net.partition
Class Ownership

java.lang.Object
  com.tangosol.util.Base
      com.tangosol.util.BitHelper
          com.tangosol.util.ExternalizableHelper
              com.tangosol.net.partition.Ownership

All Implemented Interfaces:

ExternalizableLite, PortableObject, java.io.Serializable, java.lang.Cloneable

public class Ownership
extends ExternalizableHelper
implements ExternalizableLite, PortableObject, java.lang.Cloneable

Ownership is a light-weight data structure that contains a partition ownership information.

Since:

Coherence 3.4

Author:

gg 2008.06.29

Field Summary

protected int[]

m_aiOwner An array of member ids representing the parition ownership.

Constructor Summary

Ownership()
Default constructor (necessary for the ExternalizableLite interface).

Ownership(int cBackups)
Construct an empty Ownership object with a given backup count.

Method Summary

java.lang.Object	clone() Create a clone of this Ownership.
boolean	equals(java.lang.Object o) Indicates whether some other object is "equal to" this one.
int	getOwner(int iStore) Return the owner id for the specified storage for this partition.
int	getPrimaryOwner() Return the primary owner id for this partition.
void	readExternal(java.io.DataInput in) Restore the contents of this object by loading the object's state from the passed DataInput object.
void	readExternal(PofReader in) Restore the contents of a user type instance by reading its state using the specified PofReader object.
void	setOwner(int iStore, int iOwner) Specify a new owner id for the specified storage for this partition.
void	setPrimaryOwner(int iOwner) Specify a new primary owner id for this partition.
java.lang.String	toString() Returns a string representation of this Ownership.
void	writeExternal(java.io.DataOutput out) Save the contents of this object by storing the object's state into the passed DataOutput object.
void	writeExternal(PofWriter out) Save the contents of a POF user type instance by writing its state using the specified PofWriter object.

Methods inherited from class com.tangosol.util.BitHelper

countBits, countBits, countBits, indexOfLSB, indexOfLSB, indexOfLSB, indexOfMSB, indexOfMSB, indexOfMSB, rotateLeft, rotateLeft, rotateLeft, rotateRight, rotateRight, rotateRight, toBitString, toBitString, toBitString

Field Detail

m_aiOwner

protected int[] m_aiOwner

An array of member ids representing the parition ownership.

Constructor Detail

Ownership

public Ownership()

Default constructor (necessary for the ExternalizableLite interface).

Ownership

public Ownership(int cBackups)

Construct an empty Ownership object with a given backup count.

Parameters:

cBackups - the partition count

Method Detail

getPrimaryOwner

public int getPrimaryOwner()

Return the primary owner id for this partition.

Returns:

the primary owner id for this partition

setPrimaryOwner

public void setPrimaryOwner(int iOwner)

Specify a new primary owner id for this partition.

Parameters:

iOwner - the new primary owner id for this partition

getOwner

public int getOwner(int iStore)

Return the owner id for the specified storage for this partition.

Parameters:

iStore - the storage index (zero for primary)

Returns:

the owner id or zero if there is no owner

setOwner

public void setOwner(int iStore,
                     int iOwner)

Specify a new owner id for the specified storage for this partition.

Parameters:

iStore - the storage index (zero for primary)

iOwner - the new primary owner id or zero if there is no owner

readExternal

public void readExternal(java.io.DataInput in)
                  throws java.io.IOException

Restore the contents of this object by loading the object's state from the passed DataInput object.

Specified by:

readExternal in interface ExternalizableLite

Parameters:

in - the DataInput stream to read data from in order to restore the state of this object

Throws:

java.io.IOException - if an I/O exception occurs

java.io.NotActiveException - if the object is not in its initial state, and therefore cannot be deserialized into

writeExternal

public void writeExternal(java.io.DataOutput out)
                   throws java.io.IOException

Save the contents of this object by storing the object's state into the passed DataOutput object.

Specified by:

writeExternal in interface ExternalizableLite

Parameters:

out - the DataOutput stream to write the state of this object to

Throws:

java.io.IOException - if an I/O exception occurs

readExternal

public void readExternal(PofReader in)
                  throws java.io.IOException

Restore the contents of a user type instance by reading its state using the specified PofReader object.

Specified by:

readExternal in interface PortableObject

Parameters:

in - the PofReader from which to read the object's state

Throws:

java.io.IOException - if an I/O error occurs

writeExternal

public void writeExternal(PofWriter out)
                   throws java.io.IOException

Save the contents of a POF user type instance by writing its state using the specified PofWriter object.

Specified by:

writeExternal in interface PortableObject

Parameters:

out - the PofWriter to which to write the object's state

Throws:

java.io.IOException - if an I/O error occurs

clone

public java.lang.Object clone()

Create a clone of this Ownership.

Returns:

a clone of the Ownership object

equals

public boolean equals(java.lang.Object o)

Indicates whether some other object is "equal to" this one.

Parameters:

o - the object to test for equality

Returns:

true if this object is the same as the given one; false otherwise.

toString

public java.lang.String toString()

Returns a string representation of this Ownership.

Returns:

a string representation of this Ownership