com.gemstone.org.jgroups.protocols.TransportedVectorTime Maven / Gradle / Ivy
Show all versions of gemfire-jgroups Show documentation
/** Notice of modification as required by the LGPL
* This file was modified by Gemstone Systems Inc. on
* $Date$
**/
// $Id: TransportedVectorTime.java,v 1.5 2005/08/08 12:45:45 belaban Exp $
package com.gemstone.org.jgroups.protocols;
import com.gemstone.org.jgroups.Message;
import java.io.Serializable;
/**
* Lighweight representation of the VectorTime clock suitable for network transport
*
* @author Vladimir Blagojevic [email protected]
* @version $Revision: 1.5 $
*/
public class TransportedVectorTime implements Serializable
{
/**
* index of the sender
*/
int senderPosition;
/**
* values represented as an array
*/
int[] values;
/**
* Message associated with this vector clock
*/
private transient Message m;
private static final long serialVersionUID = 5857647322589533545L;
/**
*
*/
public TransportedVectorTime()
{
}
/**
* Constructs TransportedVectorTime with sender index and vector values
*
* @param senderIndex index of the sender of the message
* @param values vector values
*/
public TransportedVectorTime(int senderIndex, int[] values)
{
this.values = values;
this.senderPosition = senderIndex;
}
/**
* Returns sender index
* @return sender index position
*/
public int getSenderIndex()
{
return senderPosition;
}
/**
* Returns vector values
* @return an array of vector values
*/
public int[] getValues()
{
return values;
}
/**
* Returns size of this vector timestamp i.e number of process group members
* @return vector timestamp size
*/
public int size()
{
return values.length;
}
/**
* Sets a message associated with this vector timestamp
* @param owner Message that is associated with this vector timestamp
*/
public void setAssociatedMessage(Message owner)
{
m = owner;
}
/**
* Returns a message associated with this vector timestamp.
* @return Message associated with this vector timestamp
*/
public Message getAssociatedMessage()
{
return m;
}
/**
*
*Checks if this TransportedVectorTime is less than or equal to the the specified TransportedVectorTime.
*The check is done as follows:
*
*
* VT1<=VT2 iff for every i:1..k VT1[i]<=VT2[i]
*
* @param other TransportedVectorTimebeing compared with this.
* @return true if this TransportedVectorTimeis less than or equal from
* other, false othwerwise
*/
public boolean lessThanOrEqual(TransportedVectorTime other)
{
int[] b = other.getValues();
int[] a = values;
for (int k = 0; k < a.length; k++)
{
if (a[k] <= b[k])
return true;
else
return false;
}
return true;
}
/**
*
* Checks if this TransportedVectorTimeis equal to the specified TransportedVectorTime.
* The check is done as follows:
*
*
* VT1==VT2 iff for every i:1..k VT1[i]==VT2[i]
* @param other TransportedVectorTimebeing compared with this.
* @return true if the equation given above is true, false otherwise
*/
@Override // GemStoneAddition
public boolean equals(Object other)
{
if (other == null || !(other instanceof TransportedVectorTime)) return false; // GemStoneAddition
int a [] = getValues();
int b [] = ((TransportedVectorTime)other).getValues();
for (int i = 0; i < a.length; i++)
if (a[i] != b[i]) return false;
return true;
}
/*
* (non-Javadoc)
* @see java.lang.Object#hashCode()
*
* Note that we just need to make sure that equal objects return equal
* hashcodes; nothing really elaborate is done here.
*/
@Override // GemStoneAddition
public int hashCode() { // GemStoneAddition
return 0; // TODO more efficient implementation :-)
}
/**
* Returns String representation of this vector timestamp
* @return String representing this vetor timestamp
*/
@Override // GemStoneAddition
public String toString()
{
String classType = "TransportedVectorTime[";
int bufferLength = classType.length() + values.length * 2 + 1;
StringBuffer buf = new StringBuffer(bufferLength);
buf.append(classType);
for (int i = 0; i < values.length - 1; i++)
{
buf.append(values[i]).append(',');
}
buf.append(values[values.length - 1]);
buf.append(']');
return buf.toString();
}
}