de.intarsys.tools.ipc

Interface IIPCScope

All Known Implementing Classes:

StandardIPCScope

public interface IIPCScope

All exported/imported objects for the IPC mechanism are held and looked up in the IIPCScope.

An IIPCScope can be looked up via the IPCScope singleton.

An IIPCScope is provided (and removed) in the IPCScope singleton for example by the service container framework. This way the IIPCScope is confidentially contained within the session.

Method Summary

Methods

Modifier and Type	Method and Description
IPCHandle	exportObject(Object object) Make a VM local POJO addressable in the IIPCScope.
IPCHandle	importHandle(String id) Make an id retrieved from some marshaling layer available as a handle to the remote system in the local VM.
int	size() The number of objects in the scope.

Method Detail

exportObject

IPCHandle exportObject(Object object)

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.

Parameters:

object -

Returns:

importHandle

IPCHandle importHandle(String id)

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.

Parameters:

id -

Returns:

size

int size()

The number of objects in the scope.

Returns:

The number of objects in the scope.