org.jruby.runtime

Class ObjectSpace

java.lang.Object

org.jruby.runtime.ObjectSpace

public class ObjectSpace
extends java.lang.Object

FIXME: This version is faster than the previous, but both suffer from a crucial flaw: It is impossible to create an ObjectSpace with an iterator that doesn't either: a. hold on to objects that might otherwise be collected or b. have no way to guarantee that a call to hasNext() will be correct or that a subsequent call to next() will produce an object. For our purposes, for now, this may be acceptable.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	ObjectSpace.GroupSweeper
private static class	ObjectSpace.IdReference
private static class	ObjectSpace.ObjectGroup
private class	ObjectSpace.WeakReferenceListNode<T>

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.ThreadLocal<java.lang.ref.Reference<ObjectSpace.ObjectGroup>>	currentObjectGroup
private java.lang.ref.ReferenceQueue	deadIdentityReferences
private java.lang.ref.ReferenceQueue<java.lang.Object>	deadReferences
private java.lang.ref.Reference<ObjectSpace.GroupSweeper>	groupSweeperReference
private java.util.Map	identities
private java.util.Map	identitiesByObject
private static java.util.concurrent.atomic.AtomicLong	maxId
private java.lang.ref.ReferenceQueue<ObjectSpace.ObjectGroup>	objectGroupReferenceQueue
private ObjectSpace.WeakReferenceListNode	top

Constructor Summary

Constructors

Constructor and Description
ObjectSpace()

Method Summary

Modifier and Type	Method and Description
void	add(IRubyObject object)
void	addFinalizer(IRubyObject object, IRubyObject proc)
private void	addIndividualWeakReference(IRubyObject object)
private ObjectSpace.ObjectGroup	addObjectGroup()
static long	calculateObjectId(java.lang.Object object)
private void	cleanIdentities()
private void	cleanup(java.lang.ref.ReferenceQueue<?> referenceQueue)
long	createAndRegisterObjectId(IRubyObject rubyObject)
private long	createId(IRubyObject object)
private ObjectSpace.ObjectGroup	getObjectGroup()
IRubyObject	id2ref(long id)
long	idOf(IRubyObject rubyObject) Deprecated.
java.util.Iterator	iterator(RubyModule rubyClass)
private void	registerGroupSweeper()
void	registerObjectId(long id, IRubyObject object)
void	removeFinalizers(long id)
private void	splitObjectGroups()

Methods inherited from class java.lang.Object

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

Field Detail

deadReferences

private final java.lang.ref.ReferenceQueue<java.lang.Object> deadReferences

objectGroupReferenceQueue

private final java.lang.ref.ReferenceQueue<ObjectSpace.ObjectGroup> objectGroupReferenceQueue

top

private ObjectSpace.WeakReferenceListNode top

deadIdentityReferences

private java.lang.ref.ReferenceQueue deadIdentityReferences

identities

private final java.util.Map identities

identitiesByObject

private final java.util.Map identitiesByObject

maxId

private static final java.util.concurrent.atomic.AtomicLong maxId

currentObjectGroup

private final java.lang.ThreadLocal<java.lang.ref.Reference<ObjectSpace.ObjectGroup>> currentObjectGroup

groupSweeperReference

private java.lang.ref.Reference<ObjectSpace.GroupSweeper> groupSweeperReference

Constructor Detail

ObjectSpace

public ObjectSpace()

Method Detail

registerObjectId

public void registerObjectId(long id,
                             IRubyObject object)

calculateObjectId

public static long calculateObjectId(java.lang.Object object)

createAndRegisterObjectId

public long createAndRegisterObjectId(IRubyObject rubyObject)

createId

private long createId(IRubyObject object)

id2ref

public IRubyObject id2ref(long id)

cleanIdentities

private void cleanIdentities()

idOf

@Deprecated
public long idOf(IRubyObject rubyObject)

Deprecated.

addFinalizer

public void addFinalizer(IRubyObject object,
                         IRubyObject proc)

removeFinalizers

public void removeFinalizers(long id)

add

public void add(IRubyObject object)

addIndividualWeakReference

private void addIndividualWeakReference(IRubyObject object)

registerGroupSweeper

private void registerGroupSweeper()

splitObjectGroups

private void splitObjectGroups()

iterator

public java.util.Iterator iterator(RubyModule rubyClass)

cleanup

private void cleanup(java.lang.ref.ReferenceQueue<?> referenceQueue)

getObjectGroup

private ObjectSpace.ObjectGroup getObjectGroup()

addObjectGroup

private ObjectSpace.ObjectGroup addObjectGroup()