org.jpos.space
Interface RemoteSpace

All Superinterfaces:

java.rmi.Remote

All Known Implementing Classes:

SpaceProxy

public interface RemoteSpace
extends java.rmi.Remote

RMI based Space proxy

Since:

2.0

Version:

$Revision: 2706 $ $Date: 2009-03-05 03:24:43 -0800 (Thu, 05 Mar 2009) $

Author:

Alejandro Revilla

See Also:

Space

Method Summary

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

Method Detail

out

void out(java.io.Serializable key,
         java.io.Serializable value)
         throws java.rmi.RemoteException

Write a new entry into the Space

Parameters:

key - Entry's key

value - Object value

Throws:

java.rmi.RemoteException

out

void out(java.io.Serializable key,
         java.io.Serializable value,
         long timeout)
         throws java.rmi.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:

java.rmi.RemoteException

See Also:

LeasedReference

in

java.io.Serializable in(java.io.Serializable key)
                        throws java.rmi.RemoteException

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

Parameters:

key - Entry's key

Returns:

value

Throws:

java.rmi.RemoteException

rd

java.io.Serializable rd(java.io.Serializable key)
                        throws java.rmi.RemoteException

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

Parameters:

key - Entry's key

Returns:

value

Throws:

java.rmi.RemoteException

in

java.io.Serializable in(java.io.Serializable key,
                        long timeout)
                        throws java.rmi.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:

java.rmi.RemoteException

rd

java.io.Serializable rd(java.io.Serializable key,
                        long timeout)
                        throws java.rmi.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:

java.rmi.RemoteException

inp

java.io.Serializable inp(java.io.Serializable key)
                         throws java.rmi.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:

java.rmi.RemoteException

rdp

java.io.Serializable rdp(java.io.Serializable key)
                         throws java.rmi.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:

java.rmi.RemoteException