de.intarsys.tools.ipc

Class StandardIPCScope

java.lang.Object

de.intarsys.tools.ipc.StandardIPCScope

All Implemented Interfaces:

IDisposable, IIPCScope

public class StandardIPCScope
extends Object
implements IIPCScope, IDisposable

The heap of available IPCHandle instances.

Constructor Summary

Constructors

Constructor and Description
StandardIPCScope()

Method Summary

Methods

Modifier and Type	Method and Description
void	dispose() Dispose all of the objects resources.
IPCHandle	exportObject(Object object) Make a VM local POJO addressable in the IIPCScope.
int	getId()
IPCHandle	importHandle(String id) Make an id retrieved from some marshaling layer available as a handle to the remote system in the local VM.
boolean	isDisposed() true if this object is already disposed.
int	size() The number of objects in the scope.

Methods inherited from class java.lang.Object

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

Constructor Detail

StandardIPCScope

public StandardIPCScope()

Method Detail

dispose

public void dispose()

Description copied from interface: IDisposable

Dispose all of the objects resources. This method should be safe to be called in any object state, especially when the object is in an invalid/error state and when the object is already disposed.

Specified by:

dispose in interface IDisposable

exportObject

public IPCHandle exportObject(Object object)

Description copied from interface: IIPCScope

Make a VM local POJO addressable in the IIPCScope. The handle returned is the unique representation for the object and may be used for interprocess communication. A marshaling layer may send the handle id and later on retrieve the object using the handle id.

Specified by:

exportObject in interface IIPCScope

Returns:

getId

public int getId()

importHandle

public IPCHandle importHandle(String id)

Description copied from interface: IIPCScope

Make an id retrieved from some marshaling layer available as a handle to the remote system in the local VM.

Immediately after import, "getObject" will return null for the IPCHandle returned. A higher level marshaling may replace this with a more full blown local representation, thereby allowing object identity for the remote.

Specified by:

importHandle in interface IIPCScope

Returns:

isDisposed

public boolean isDisposed()

Description copied from interface: IDisposable

true if this object is already disposed.

Specified by:

isDisposed in interface IDisposable

Returns:

size

public int size()

Description copied from interface: IIPCScope

The number of objects in the scope.

Specified by:

size in interface IIPCScope

Returns:

The number of objects in the scope.