Package org.jruby.runtime

Class ObjectSpace

java.lang.Object

org.jruby.runtime.ObjectSpace

public class ObjectSpace
extends 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	Description
private final class	ObjectSpace.GroupSweeper
private static class	ObjectSpace.IdReference
private static final class	ObjectSpace.ObjectGroup
private class	ObjectSpace.WeakReferenceListNode<T>

Field Summary

Fields

Modifier and Type	Field	Description
private final ThreadLocal<Reference<ObjectSpace.ObjectGroup>>	currentObjectGroup
private final ReferenceQueue	deadIdentityReferences
private final ReferenceQueue<Object>	deadReferences
private Reference<ObjectSpace.GroupSweeper>	groupSweeperReference
private final Map<Long,ObjectSpace.IdReference>	identities
private final Map<IRubyObject,Long>	identitiesByObject
private static final AtomicLong	maxId
private final ReferenceQueue<ObjectSpace.ObjectGroup>	objectGroupReferenceQueue
private ObjectSpace.WeakReferenceListNode	top

Constructor Summary

Constructors

Constructor	Description
ObjectSpace()

Method Summary

Modifier and Type	Method	Description
void	add(IRubyObject object)
void	addFinalizer(IRubyObject object, IRubyObject proc)
private void	addIndividualWeakReference(IRubyObject object)
private ObjectSpace.ObjectGroup	addObjectGroup()
static long	calculateObjectId(Object object)
private void	cleanIdentities()
private void	cleanup(ReferenceQueue<?> referenceQueue)
long	createAndRegisterObjectId(IRubyObject rubyObject)
private long	createId(IRubyObject object)
private ObjectSpace.ObjectGroup	getObjectGroup()
IRubyObject	id2ref(long id)
long	idOf(IRubyObject rubyObject)	Deprecated.
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 Details

deadReferences

private final ReferenceQueue<Object> deadReferences

objectGroupReferenceQueue

private final ReferenceQueue<ObjectSpace.ObjectGroup> objectGroupReferenceQueue

top

private ObjectSpace.WeakReferenceListNode top

deadIdentityReferences

private final ReferenceQueue deadIdentityReferences

identities

private final Map<Long,ObjectSpace.IdReference> identities

identitiesByObject

private final Map<IRubyObject,Long> identitiesByObject

maxId

private static final AtomicLong maxId

currentObjectGroup

private final ThreadLocal<Reference<ObjectSpace.ObjectGroup>> currentObjectGroup

groupSweeperReference

private Reference<ObjectSpace.GroupSweeper> groupSweeperReference

Constructor Details

ObjectSpace

public ObjectSpace()

Method Details

registerObjectId

public void registerObjectId(long id,
 IRubyObject object)

calculateObjectId

public static long calculateObjectId(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 Iterator iterator(RubyModule rubyClass)

cleanup

private void cleanup(ReferenceQueue<?> referenceQueue)

getObjectGroup

private ObjectSpace.ObjectGroup getObjectGroup()

addObjectGroup

private ObjectSpace.ObjectGroup addObjectGroup()