org.jpos.space
Interface RemoteSpace

All Superinterfaces:

Remote

All Known Implementing Classes:

SpaceProxy

public interface RemoteSpace
extends Remote

RMI based Space proxy

Since:

2.0

Version:

$Revision$ $Date$

Author:

Alejandro Revilla

See Also:

Space

Method Summary

Serializable	in(Serializable key) Take an entry from the space, waiting forever until one exists.
Serializable	in(Serializable key, long timeout) Take an entry from the space, waiting a limited amount of time until one exists.
Serializable	inp(Serializable key) In probe takes an entry from the space if one exists, return null otherwise.
void	out(Serializable key, Serializable value) Write a new entry into the Space
void	out(Serializable key, Serializable value, long timeout) Write a new leased entry into the Space.
Serializable	rd(Serializable key) Read an entry from the space, waiting forever until one exists.
Serializable	rd(Serializable key, long timeout) Read an entry from the space, waiting a limited amount of time until one exists.
Serializable	rdp(Serializable key) Read probe reads an entry from the space if one exists, return null otherwise.

Method Detail

out

void out(Serializable key,
         Serializable value)
         throws RemoteException

Write a new entry into the Space

Parameters:

key - Entry's key

value - Object value

Throws:

RemoteException

out

void out(Serializable key,
         Serializable value,
         long timeout)
         throws RemoteException

Write a new leased entry into the Space. Entry will remain valid for a limited amount of time.

Parameters:

key - Entry's key

value - Object value

timeout - entry valid time

Throws:

RemoteException

See Also:

LeasedReference

in

Serializable in(Serializable key)
                throws RemoteException

Take an entry from the space, waiting forever until one exists.

Parameters:

key - Entry's key

Returns:

value

Throws:

RemoteException

rd

Serializable rd(Serializable key)
                throws RemoteException

Read an entry from the space, waiting forever until one exists.

Parameters:

key - Entry's key

Returns:

value

Throws:

RemoteException

in

Serializable in(Serializable key,
                long timeout)
                throws RemoteException

Take an entry from the space, waiting a limited amount of time until one exists.

Parameters:

key - Entry's key

timeout - millis to wait

Returns:

value or null

Throws:

RemoteException

rd

Serializable rd(Serializable key,
                long timeout)
                throws RemoteException

Read an entry from the space, waiting a limited amount of time until one exists.

Parameters:

key - Entry's key

timeout - millis to wait

Returns:

value or null

Throws:

RemoteException

inp

Serializable inp(Serializable key)
                 throws RemoteException

In probe takes an entry from the space if one exists, return null otherwise.

Parameters:

key - Entry's key

Returns:

value or null

Throws:

RemoteException

rdp

Serializable rdp(Serializable key)
                 throws RemoteException

Read probe reads an entry from the space if one exists, return null otherwise.

Parameters:

key - Entry's key

Returns:

value or null

Throws:

RemoteException