Maps Java objects to their proxies. Combines elements of WeakHashMap and ConcurrentHashMap to permit unsynchronized reads. May be configured to use either Weak (the default) or Soft references.

Note that both Java objects and their proxies are held by weak/soft references; because proxies (currently) keep strong references to their Java objects, if we kept strong references to them the Java objects would never be gc'ed. This presents a problem in the case where a user passes a Rubified Java object out to Java but keeps no reference in Ruby to the proxy; if the object is returned to Ruby after its proxy has been gc'ed, a new (and possibly very wrong, in the case of JRuby-defined subclasses) proxy will be created. Use of soft references may help reduce the likelihood of this occurring; users may be advised to keep Ruby-side references to prevent it occurring altogether.

Nested and Inner Type Summary

Modifier and Type	Class and Description
pack-priv static class	ObjectProxyCache.Entry<T>
private static interface	ObjectProxyCache.EntryRef<T>
public static enum	ObjectProxyCache.ReferenceType
pack-priv static class	ObjectProxyCache.Segment<T, A>
private static class	ObjectProxyCache.SoftEntryRef<T>
private static class	ObjectProxyCache.WeakEntryRef<T>

Field Summary

Modifier and Type	Field and Description
private static int	_nextId
private static final float	DEFAULT_LOAD_FACTOR
private static final int	DEFAULT_SEGMENT_SIZE
private static final int	DEFAULT_SEGMENTS
private final int	id
private static final Logger	LOG
private static final int	MAX_CAPACITY
private static final int	MAX_SEGMENTS
private final ObjectProxyCache.ReferenceType	referenceType
private final int	segmentMask
private final ObjectProxyCache.Segment<T, A>[]	segments
private final int	segmentShift
private static final int	VULTURE_RUN_FREQ_SECONDS

Access	Constructor and Description
public	ObjectProxyCache()
public	ObjectProxyCache(ObjectProxyCache.ReferenceType refType)
public	ObjectProxyCache(int numSegments, int initialSegCapacity, ObjectProxyCache.ReferenceType refType)

Method Summary

Modifier and Type	Method and Description
public abstract T	allocateProxy(Object javaObject, A allocator)
public T	get(Object javaObject)
public T	getOrCreate(Object javaObject, A allocator)
private static int	hash(Object javaObject)
private static synchronized int	nextId()
public void	put(Object javaObject, T proxy)
private ObjectProxyCache.Segment<T, A>	segmentFor(int hash)
public int	size() Returns the approximate size (elements in use) of the cache.
public String	stats()

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

_nextId	back to summary
private static int _nextId

DEFAULT_LOAD_FACTOR	back to summary
private static final float DEFAULT_LOAD_FACTOR

DEFAULT_SEGMENT_SIZE	back to summary
private static final int DEFAULT_SEGMENT_SIZE

DEFAULT_SEGMENTS	back to summary
private static final int DEFAULT_SEGMENTS

id	back to summary
private final int id

LOG	back to summary
private static final Logger LOG

MAX_CAPACITY	back to summary
private static final int MAX_CAPACITY

MAX_SEGMENTS	back to summary
private static final int MAX_SEGMENTS

referenceType	back to summary
private final ObjectProxyCache.ReferenceType referenceType

segmentMask	back to summary
private final int segmentMask

segments	back to summary
private final ObjectProxyCache.Segment<T, A>[] segments

segmentShift	back to summary
private final int segmentShift

VULTURE_RUN_FREQ_SECONDS	back to summary
private static final int VULTURE_RUN_FREQ_SECONDS

ObjectProxyCache	back to summary
public ObjectProxyCache()

ObjectProxyCache	back to summary
public ObjectProxyCache(ObjectProxyCache.ReferenceType refType)

ObjectProxyCache	back to summary
public ObjectProxyCache(int numSegments, int initialSegCapacity, ObjectProxyCache.ReferenceType refType)

Method Detail

allocateProxy	back to summary
public abstract T allocateProxy(Object javaObject, A allocator)

get	back to summary
public T get(Object javaObject)

getOrCreate	back to summary
public T getOrCreate(Object javaObject, A allocator)

hash	back to summary
private static int hash(Object javaObject)

nextId	back to summary
private static synchronized int nextId()

put	back to summary
public void put(Object javaObject, T proxy)

segmentFor	back to summary
private ObjectProxyCache.Segment<T, A> segmentFor(int hash)

size	back to summary
public int size() Returns the approximate size (elements in use) of the cache. The sizes of the segments are summed. No effort is made to synchronize across segments, so the value returned may differ from the actual size at any point in time.

stats	back to summary
public String stats()

org.jruby.javasupport.util back to summary

pack-priv Class ObjectProxyCache.Entry<T>

Class Inheritance

extends Object

java.lang.Object
org.jruby.javasupport.util.ObjectProxyCache.Entry

Field Summary

Modifier and Type	Field and Description
pack-priv final int	hash
pack-priv final ObjectProxyCache.Entry<T>	next
pack-priv final ObjectProxyCache.EntryRef<Object>	objectRef
pack-priv final ObjectProxyCache.EntryRef<T>	proxyRef

Constructor Summary

Access	Constructor and Description
pack-priv	Entry(Object object, int hash, T proxy, ObjectProxyCache.ReferenceType type, ObjectProxyCache.Entry<T> next, ReferenceQueue<Object> queue)
pack-priv	Entry(ObjectProxyCache.EntryRef<Object> objectRef, int hash, ObjectProxyCache.EntryRef<T> proxyRef, ObjectProxyCache.Entry<T> next)

Method Summary

Modifier and Type	Method and Description
pack-priv static final <T> ObjectProxyCache.Entry<T>[]	newArray(int size)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

hash	back to summary
pack-priv final int hash

next	back to summary
pack-priv final ObjectProxyCache.Entry<T> next

objectRef	back to summary
pack-priv final ObjectProxyCache.EntryRef<Object> objectRef

proxyRef	back to summary
pack-priv final ObjectProxyCache.EntryRef<T> proxyRef

Constructor Detail

Entry	back to summary
pack-priv Entry(Object object, int hash, T proxy, ObjectProxyCache.ReferenceType type, ObjectProxyCache.Entry<T> next, ReferenceQueue<Object> queue)

Entry	back to summary
pack-priv Entry(ObjectProxyCache.EntryRef<Object> objectRef, int hash, ObjectProxyCache.EntryRef<T> proxyRef, ObjectProxyCache.Entry<T> next)

Method Detail

newArray	back to summary
pack-priv static final <T> ObjectProxyCache.Entry<T>[] newArray(int size) Annotations @SuppressWarnings:unchecked

org.jruby.javasupport.util back to summary

private Interface ObjectProxyCache.EntryRef<T>

Known Direct Implementers: org.jruby.javasupport.util.ObjectProxyCache.WeakEntryRef, org.jruby.javasupport.util.ObjectProxyCache.SoftEntryRef

Method Summary

Modifier and Type	Method and Description
public T	get()
public int	hash()

Method Detail

get	back to summary
public T get()

hash	back to summary
public int hash()

org.jruby.javasupport.util back to summary

public final Enum ObjectProxyCache.ReferenceType

Class Inheritance

extends Enum<ObjectProxyCache.ReferenceType>

java.lang.Object
java.lang.Enum
org.jruby.javasupport.util.ObjectProxyCache.ReferenceType

Field Summary

Modifier and Type	Field and Description
public static final ObjectProxyCache.ReferenceType	SOFT
public static final ObjectProxyCache.ReferenceType	WEAK

Constructor Summary

Access	Constructor and Description
private	ReferenceType()

Method Summary

Modifier and Type	Method and Description
public static ObjectProxyCache.ReferenceType	valueOf(String name)
public static ObjectProxyCache.ReferenceType[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

SOFT	back to summary
public static final ObjectProxyCache.ReferenceType SOFT

WEAK	back to summary
public static final ObjectProxyCache.ReferenceType WEAK

Constructor Detail

ReferenceType	back to summary
private ReferenceType()

Method Detail

valueOf	back to summary
public static ObjectProxyCache.ReferenceType valueOf(String name)

values	back to summary
public static ObjectProxyCache.ReferenceType[] values()

org.jruby.javasupport.util back to summary

pack-priv Class ObjectProxyCache.Segment<T, A>

Class Inheritance

extends ReentrantLock

java.lang.Object
java.util.concurrent.locks.ReentrantLock
org.jruby.javasupport.util.ObjectProxyCache.Segment

Field Summary

Modifier and Type	Field and Description
pack-priv final ObjectProxyCache<T, A>	cache
pack-priv volatile ObjectProxyCache.Entry<T>[]	entryTable
pack-priv final ReferenceQueue<Object>	referenceQueue
pack-priv int	tableSize
pack-priv int	threshold

Constructor Summary

Access	Constructor and Description
pack-priv	Segment(int capacity, ObjectProxyCache<T, A> cache)

Method Summary

Modifier and Type	Method and Description
private int	count()
private void	expunge()
pack-priv T	get(Object object, int hash)
pack-priv T	getOrCreate(Object object, int hash, A allocator)
pack-priv static final <T, A> ObjectProxyCache.Segment<T, A>[]	newArray(int size)
pack-priv void	put(Object object, int hash, T proxy)
private ObjectProxyCache.Entry<T>[]	rehash()
private void	remove(ObjectProxyCache.Entry<T>[] table, int hash, ObjectProxyCache.Entry<T> e)

Field Detail

cache	back to summary
pack-priv final ObjectProxyCache<T, A> cache

entryTable	back to summary
pack-priv volatile ObjectProxyCache.Entry<T>[] entryTable

referenceQueue	back to summary
pack-priv final ReferenceQueue<Object> referenceQueue

tableSize	back to summary
pack-priv int tableSize

threshold	back to summary
pack-priv int threshold

Constructor Detail

Segment	back to summary
pack-priv Segment(int capacity, ObjectProxyCache<T, A> cache)

Method Detail

count	back to summary
private int count()

expunge	back to summary
private void expunge()

get	back to summary
pack-priv T get(Object object, int hash)

getOrCreate	back to summary
pack-priv T getOrCreate(Object object, int hash, A allocator)

newArray	back to summary
pack-priv static final <T, A> ObjectProxyCache.Segment<T, A>[] newArray(int size) Annotations @SuppressWarnings:unchecked

put	back to summary
pack-priv void put(Object object, int hash, T proxy)

rehash	back to summary
private ObjectProxyCache.Entry<T>[] rehash()

remove	back to summary
private void remove(ObjectProxyCache.Entry<T>[] table, int hash, ObjectProxyCache.Entry<T> e)

org.jruby.javasupport.util back to summary

private final Class ObjectProxyCache.SoftEntryRef<T>

Class Inheritance

extends SoftReference<T>
implements ObjectProxyCache.EntryRef<T>

java.lang.Object
java.lang.ref.Reference
java.lang.ref.SoftReference
org.jruby.javasupport.util.ObjectProxyCache.SoftEntryRef

All Implemented Interfaces

org.jruby.javasupport.util.ObjectProxyCache.EntryRef

Field Summary

Modifier and Type	Field and Description
pack-priv final int	hash

Constructor Summary

Access	Constructor and Description
pack-priv	SoftEntryRef(int hash, T rawObject, ReferenceQueue<Object> queue)

Method Summary

Modifier and Type	Method and Description
public int	hash() Implements org.jruby.javasupport.util.ObjectProxyCache.EntryRef.hash.

Inherited from java.lang.ref.SoftReference:: get

Field Detail

hash	back to summary
pack-priv final int hash

Constructor Detail

SoftEntryRef	back to summary
pack-priv SoftEntryRef(int hash, T rawObject, ReferenceQueue<Object> queue)

Method Detail

hash	back to summary
public int hash() Implements org.jruby.javasupport.util.ObjectProxyCache.EntryRef.hash.

org.jruby.javasupport.util back to summary

private final Class ObjectProxyCache.WeakEntryRef<T>

Class Inheritance

extends WeakReference<T>
implements ObjectProxyCache.EntryRef<T>

java.lang.Object
java.lang.ref.Reference
java.lang.ref.WeakReference
org.jruby.javasupport.util.ObjectProxyCache.WeakEntryRef

All Implemented Interfaces

org.jruby.javasupport.util.ObjectProxyCache.EntryRef

Field Summary

Modifier and Type	Field and Description
pack-priv final int	hash

Constructor Summary

Access	Constructor and Description
pack-priv	WeakEntryRef(int hash, T rawObject, ReferenceQueue<Object> queue)

Method Summary

Modifier and Type	Method and Description
public int	hash() Implements org.jruby.javasupport.util.ObjectProxyCache.EntryRef.hash.

Field Detail

hash	back to summary
pack-priv final int hash

Constructor Detail

WeakEntryRef	back to summary
pack-priv WeakEntryRef(int hash, T rawObject, ReferenceQueue<Object> queue)

Method Detail

hash	back to summary
public int hash() Implements org.jruby.javasupport.util.ObjectProxyCache.EntryRef.hash.

public abstract Class ObjectProxyCache<T, A>

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv Class ObjectProxyCache.Entry<T>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Interface ObjectProxyCache.EntryRef<T>

Method Summary

Method Detail

public final Enum ObjectProxyCache.ReferenceType

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv Class ObjectProxyCache.Segment<T, A>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Class ObjectProxyCache.SoftEntryRef<T>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Class ObjectProxyCache.WeakEntryRef<T>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail