org.apache.river.concurrent

Class ReferenceSerializedForm<T>

java.lang.Object

org.apache.river.concurrent.ReferenceSerializedForm<T>

All Implemented Interfaces:

Serializable, Referrer<T>

class ReferenceSerializedForm<T>
extends Object
implements Referrer<T>, Serializable

A temporary but functional replacement for ReferenceKey's. No attempt is made to use readResolve to replace the original, that responsibility is left up to the collection implementation during de-serialisation.

Author:

peter

Field Summary

Fields

Modifier and Type	Field and Description
private int	hash
private T	obj
private static long	serialVersionUID

Constructor Summary

Constructors

Constructor and Description
ReferenceSerializedForm()
ReferenceSerializedForm(T t)

Method Summary

Modifier and Type	Method and Description
void	clear()
boolean	enqueue()
boolean	equals(Object o) Equals is calculated on IDENTITY or EQUALITY.
T	get()
int	hashCode() Standard hashCode calculation for IDENTITY based references, where k is the referent.
boolean	isEnqueued()
private void	readObject(ObjectInputStream in)
private void	writeObject(ObjectOutputStream out)

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

obj

private T obj

hash

private transient int hash

Constructor Detail

ReferenceSerializedForm

ReferenceSerializedForm()

ReferenceSerializedForm

ReferenceSerializedForm(T t)

Method Detail

get

public T get()

Specified by:

get in interface Referrer<T>

See Also:

Reference.get()

clear

public void clear()

Specified by:

clear in interface Referrer<T>

See Also:

Reference.clear()

isEnqueued

public boolean isEnqueued()

Specified by:

isEnqueued in interface Referrer<T>

Returns:

true if enqueued.

See Also:

Reference.isEnqueued()

enqueue

public boolean enqueue()

Specified by:

enqueue in interface Referrer<T>

Returns:

true if successfully enqueued.

See Also:

Reference.enqueue()

equals

public boolean equals(Object o)

Description copied from interface: Referrer

Equals is calculated on IDENTITY or EQUALITY.

IDENTITY calculation:

if (this == o) return true;
if (!(o instanceof Referrer)) return false;
Object k1 = get();
Object k2 = ((Referrer) o).get();
if ( k1 != null && k1 == k2 ) return true;
return ( k1 == null && k2 == null && hashCode() == o.hashCode());

EQUALITY calculation:

if (this == o) return true; // Same reference.
if (!(o instanceof Referrer)) return false;
Object k1 = get();
Object k2 = ((Referrer) o).get();
if ( k1 != null && k1.equals(k2)) return true;
return ( k1 == null && k2 == null && hashCode() == o.hashCode());



Specified by:

equals in interface Referrer<T>

Overrides:

equals in class Object

Returns:

true if equal

See Also:

Ref

hashCode

public int hashCode()

Description copied from interface: Referrer

Standard hashCode calculation for IDENTITY based references, where k is the referent. This may be stored in a final field:

int hash = 7;
hash = 29 * hash + System.identityHashCode(k);
hash = 29 * hash + k.getClass().hashCode();


Standard hashCode calculation for EQUALITY based references, where k is the referent:

int hash = 7;
hash = 29 * hash + k.hashCode();
hash = 29 * hash + k.getClass().hashCode();


The hash must be calculated during construction and if the reference is cleared, the recorded hashCode returned. While the referent remains reachable the hashCode must be calculated each time.

Specified by:

hashCode in interface Referrer<T>

Overrides:

hashCode in class Object

Returns:

hash

readObject

private void readObject(ObjectInputStream in)
                 throws IOException,
                        ClassNotFoundException

Throws:

IOException

ClassNotFoundException

writeObject

private void writeObject(ObjectOutputStream out)
                  throws IOException

Throws:

IOException