Modifier and Type	Class and Description
private static class	ObjectTable.Reaper The Reaper thread waits for notifications that weak references in the object table have been cleared.

Field Summary

Modifier and Type	Field and Description
private static final long	gcInterval maximum interval between complete garbage collections of local heap
private static GC.LatencyRequest	gcLatencyRequest handle for GC latency request (for future cancellation)
private static final Map<WeakRef, Target>	implTable
private static int	keepAliveCount count of non-permanent objects in table or still processing calls
private static final Object	keepAliveLock lock guarding keepAliveCount, reaper, and gcLatencyRequest.
private static final Map<ObjectEndpoint, Target>	objTable tables mapping to Target, keyed from ObjectEndpoint and impl object
private static Thread	reaper thread to collect unreferenced objects from table
pack-priv static final ReferenceQueue<Object>	reapQueue queue notified when weak refs in the table are cleared
private static final Object	tableLock lock guarding objTable and implTable.

Constructor Summary

Access	Constructor and Description
private	ObjectTable()

Method Summary

Modifier and Type	Method and Description
pack-priv static void	decrementKeepAliveCount() Decrements the "keep-alive count".
public static Remote	Returns: the stub for the remote object, obj. getStub(Remote impl) Returns the stub for the remote object obj passed as a parameter.
pack-priv static Target	getTarget(ObjectEndpoint oe) Returns the target associated with the object id.
public static Target	getTarget(Remote impl) Returns the target associated with the remote object
pack-priv static void	incrementKeepAliveCount() Increments the "keep-alive count".
pack-priv static void	putTarget(Target target) Add target to object table.
pack-priv static void	referenced(ObjID id, long sequenceNum, VMID vmid) Process client VM signalling reference for given ObjID: forward to corresponding Target entry.
private static void	removeTarget(Target target) Remove target from object table.
public static boolean	Returns: true if operation is successful, false otherwise unexportObject(Remote the remote object to be unexported obj, boolean if true, unexports the object even if there are pending or in-progress calls; if false, only unexports the object if there are no pending or in-progress calls force) Remove the remote object, obj, from the RMI runtime.
pack-priv static void	unreferenced(ObjID id, long sequenceNum, VMID vmid, boolean strong) Process client VM dropping reference for given ObjID: forward to corresponding Target entry.

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

Field Detail

gcInterval	back to summary
private static final long gcInterval maximum interval between complete garbage collections of local heap

gcLatencyRequest	back to summary
private static GC.LatencyRequest gcLatencyRequest handle for GC latency request (for future cancellation)

implTable	back to summary
private static final Map<WeakRef, Target> implTable

keepAliveCount	back to summary
private static int keepAliveCount count of non-permanent objects in table or still processing calls

keepAliveLock	back to summary
private static final Object keepAliveLock lock guarding keepAliveCount, reaper, and gcLatencyRequest. Holders may NOT acquire a Target instance's lock or tableLock.

objTable	back to summary
private static final Map<ObjectEndpoint, Target> objTable tables mapping to Target, keyed from ObjectEndpoint and impl object

reaper	back to summary
private static Thread reaper thread to collect unreferenced objects from table

reapQueue	back to summary
pack-priv static final ReferenceQueue<Object> reapQueue queue notified when weak refs in the table are cleared

tableLock	back to summary
private static final Object tableLock lock guarding objTable and implTable. Holders MAY acquire a Target instance's lock or keepAliveLock.

Constructor Detail

ObjectTable	back to summary
private ObjectTable()

Method Detail

decrementKeepAliveCount	back to summary
pack-priv static void decrementKeepAliveCount() Decrements the "keep-alive count". The "keep-alive count" is the number of non-permanent remote objects that are either in the object table or still have calls in progress. Therefore, this method should be invoked exactly once for every previously-exported non-permanent remote object that both has been removed from the object table and has no calls still in progress. If the keep-alive count is decremented to zero, then the current reaper thread is terminated to cease keeping the VM alive (and because there are no more non-permanent remote objects to reap).

decrementKeepAliveCount

back to summary

pack-priv static void decrementKeepAliveCount()

Decrements the "keep-alive count". The "keep-alive count" is the number of non-permanent remote objects that are either in the object table or still have calls in progress. Therefore, this method should be invoked exactly once for every previously-exported non-permanent remote object that both has been removed from the object table and has no calls still in progress. If the keep-alive count is decremented to zero, then the current reaper thread is terminated to cease keeping the VM alive (and because there are no more non-permanent remote objects to reap).

getStub	back to summary
public static Remote getStub(Remote impl) throws NoSuchObjectException Returns the stub for the remote object obj passed as a parameter. This operation is only valid after the object has been exported. Returns:Remote the stub for the remote object, obj. Exceptions NoSuchObjectException: if the stub for the remote object could not be found.

getStub

back to summary

public static Remote getStub(Remote impl) throws NoSuchObjectException

Returns the stub for the remote object obj passed as a parameter. This operation is only valid after the object has been exported.

Returns:Remote

the stub for the remote object, obj.

Exceptions

NoSuchObjectException:: if the stub for the remote object could not be found.

getTarget	back to summary
pack-priv static Target getTarget(ObjectEndpoint oe) Returns the target associated with the object id.

getTarget	back to summary
public static Target getTarget(Remote impl) Returns the target associated with the remote object

incrementKeepAliveCount	back to summary
pack-priv static void incrementKeepAliveCount() Increments the "keep-alive count". The "keep-alive count" is the number of non-permanent remote objects that are either in the object table or still have calls in progress. Therefore, this method should be invoked exactly once for every non-permanent remote object exported (a remote object must be exported before it can have any calls in progress). The VM is "kept alive" while the keep-alive count is greater than zero; this is accomplished by keeping a non-daemon thread running. Because non-permanent objects are those that can be garbage collected while exported, and thus those for which the "reaper" thread operates, the reaper thread also serves as the non-daemon VM keep-alive thread; a new reaper thread is created if necessary.

incrementKeepAliveCount

back to summary

pack-priv static void incrementKeepAliveCount()

Increments the "keep-alive count". The "keep-alive count" is the number of non-permanent remote objects that are either in the object table or still have calls in progress. Therefore, this method should be invoked exactly once for every non-permanent remote object exported (a remote object must be exported before it can have any calls in progress). The VM is "kept alive" while the keep-alive count is greater than zero; this is accomplished by keeping a non-daemon thread running. Because non-permanent objects are those that can be garbage collected while exported, and thus those for which the "reaper" thread operates, the reaper thread also serves as the non-daemon VM keep-alive thread; a new reaper thread is created if necessary.

putTarget	back to summary
pack-priv static void putTarget(Target target) throws ExportException Add target to object table. If it is not a permanent entry, then make sure that reaper thread is running to remove collected entries and keep VM alive.

referenced	back to summary
pack-priv static void referenced(ObjID id, long sequenceNum, VMID vmid) Process client VM signalling reference for given ObjID: forward to corresponding Target entry. If ObjID is not found in table, no action is taken.

removeTarget	back to summary
private static void removeTarget(Target target) Remove target from object table. Note This method must only be invoked while synchronized on the "tableLock" object, because it does not do so itself.

unexportObject	back to summary
public static boolean unexportObject(Remote obj, boolean force) throws NoSuchObjectException Remove the remote object, obj, from the RMI runtime. If successful, the object can no longer accept incoming RMI calls. If the force parameter is true, the object is forcibly unexported even if there are pending calls to the remote object or the remote object still has calls in progress. If the force parameter is false, the object is only unexported if there are no pending or in progress calls to the object. Parameters obj:Remote the remote object to be unexported force:boolean if true, unexports the object even if there are pending or in-progress calls; if false, only unexports the object if there are no pending or in-progress calls Returns:boolean true if operation is successful, false otherwise Exceptions NoSuchObjectException: if the remote object is not currently exported

unexportObject

back to summary

public static boolean unexportObject(Remote obj, boolean force) throws NoSuchObjectException

Remove the remote object, obj, from the RMI runtime. If successful, the object can no longer accept incoming RMI calls. If the force parameter is true, the object is forcibly unexported even if there are pending calls to the remote object or the remote object still has calls in progress. If the force parameter is false, the object is only unexported if there are no pending or in progress calls to the object.

Parameters

obj:Remote: the remote object to be unexported
force:boolean: if true, unexports the object even if there are pending or in-progress calls; if false, only unexports the object if there are no pending or in-progress calls

Returns:boolean

true if operation is successful, false otherwise

Exceptions

NoSuchObjectException:: if the remote object is not currently exported

unreferenced	back to summary
pack-priv static void unreferenced(ObjID id, long sequenceNum, VMID vmid, boolean strong) Process client VM dropping reference for given ObjID: forward to corresponding Target entry. If ObjID is not found in table, no action is taken.

sun.rmi.transport back to summary

private Class ObjectTable.Reaper

Class Inheritance

extends Object
implements Runnable

java.lang.Object
sun.rmi.transport.ObjectTable.Reaper

All Implemented Interfaces

java.lang.Runnable

The Reaper thread waits for notifications that weak references in the object table have been cleared. When it receives a notification, it removes the corresponding entry from the table. Since the Reaper is created as a non-daemon thread, it also serves to keep the VM from exiting while there are objects in the table (other than permanent entries that should neither be reaped nor keep the VM alive).

Constructor Summary

Access	Constructor and Description
private	Reaper()

Method Summary

Modifier and Type	Method and Description
public void	run() Implements java.lang.Runnable.run. Runs this operation.

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

Constructor Detail

Reaper	back to summary
private Reaper()

Method Detail

run	back to summary
public void run() Implements java.lang.Runnable.run. Doc from java.lang.Runnable.run. Runs this operation.

run

back to summary

public void run()

Implements java.lang.Runnable.run.

Doc from java.lang.Runnable.run.

Runs this operation.

public final Class ObjectTable

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class ObjectTable.Reaper

Constructor Summary

Method Summary

Constructor Detail

Method Detail