org.apache.river.concurrent

Class ReferenceFactory<T>

java.lang.Object

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

class ReferenceFactory<T>
extends Object

ReferenceFactory creates References, representing the various subclasses of Reference, such as WEAK, SOFT and STRONG for use in collections. These subtypes override equals and hashcode, so that References may be used in Collections, Maps, Sets and Lists to represent their referent.

Author:

Peter Firmstone.

See Also:

Reference, Ref

Constructor Summary

Constructors

Modifier	Constructor and Description
private	ReferenceFactory()

Method Summary

Modifier and Type	Method and Description
(package private) static <T> Referrer<T>	create(T t, RefQueue<? super T> queue, Ref type)
(package private) static <T> Referrer<T>	singleUseForLookup(T t, Ref type) This doesn't create a genuine reference, only a simple wrapper object that will be used once then discarded.

Methods inherited from class java.lang.Object

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

Constructor Detail

ReferenceFactory

private ReferenceFactory()

Method Detail

create

static <T> Referrer<T> create(T t,
                              RefQueue<? super T> queue,
                              Ref type)

singleUseForLookup

static <T> Referrer<T> singleUseForLookup(T t,
                                          Ref type)

This doesn't create a genuine reference, only a simple wrapper object that will be used once then discarded. The Referrer will be allocated to the stack by the jvm and not the heap. There is no queue, no reference, this is simply a wrapper class that provides the correct equals, hashcode and comparator semantics. This object must not be added to any collection classes, it is not serialisable, it's sole intended purpose is to improve read performance by being allocated to the stack, not the heap space and avoiding a cache miss. To achieve this goal, it must not be shared with other Threads either.

Type Parameters:

T -

Parameters:

t -

type -

Returns: