org.cojen.dirmi

Annotation Type Disposer

@Documented
 @Retention(value=RUNTIME)
 @Target(value=METHOD)
public @interface Disposer

Identify a method as being a disposer of the enclosing remote object. With such a method, a remote object can be freed before the local garbage collector determines that it is unreachable.

When a disposer method is called, it immediately prevents all new remote method inovcations on the same object from functioning. Any attempt causes a NoSuchObjectException to be thrown. The actual disposer call is allowed to complete normally, but any other methods running concurrently might fail. Exported remote objects on the server side are not actually unreferenced until the disposer implementation completes. Use the Ordered annotation to ensure that the disposer doesn't run too soon.

 @Disposer
 @Asynchronous
 void close() throws RemoteException;
 

Author:

Brian S O'Neill