Package org.jpos.space
Class TSpace<K,V>
- java.lang.Object
-
- org.jpos.space.TSpace<K,V>
-
- All Implemented Interfaces:
java.lang.Runnable
,LocalSpace<K,V>
,Space<K,V>
,Loggeable
public class TSpace<K,V> extends java.lang.Object implements LocalSpace<K,V>, Loggeable, java.lang.Runnable
TSpace implementation- Since:
- !.4.9
-
-
Constructor Summary
Constructors Constructor Description TSpace()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
addListener(java.lang.Object key, SpaceListener listener)
add a SpaceListener associated with a given keyvoid
addListener(java.lang.Object key, SpaceListener listener, long timeout)
add a SpaceListener associated with a given key for a given period of time.void
dump(java.io.PrintStream p, java.lang.String indent)
boolean
existAny(K[] keys)
boolean
existAny(K[] keys, long timeout)
void
gc()
java.util.Map
getEntries()
unstandard method (required for space replication) - use with carejava.lang.String
getKeysAsString()
java.util.Set<K>
getKeySet()
V
in(java.lang.Object key)
Take an entry from the space, waiting forever until one exists.V
in(java.lang.Object key, long timeout)
Take an entry from the space, waiting a limited amount of time until one exists.V
inp(java.lang.Object key)
In probe takes an entry from the space if one exists, return null otherwise.boolean
isEmpty()
void
notifyListeners(java.lang.Object key, java.lang.Object value)
void
nrd(java.lang.Object key)
Nrd (not read) waits forever until Key is not present in space Resolution for expiring entries is implementation dependant, but a minimum one-second is suggested.V
nrd(java.lang.Object key, long timeout)
Nrd (not read) waits up to timeout until Key is not present in space Resolution for expiring entries is implementation dependant, but a minimum one-second is suggested.void
out(K key, V value)
Write a new entry into the Spacevoid
out(K key, V value, long timeout)
Write a new entry into the Space, with an timeout valuevoid
push(K key, V value)
Write a new entry at the head of a queue.void
push(K key, V value, long timeout)
Write a new entry at the head of the queue with a timeout valuevoid
put(K key, V value)
Write a single entry at the head of the queue discarding the other entriesvoid
put(K key, V value, long timeout)
Write a single entry at the head of the queue discarding the other entries, with timeout.V
rd(java.lang.Object key)
Read an entry from the space, waiting forever until one exists.V
rd(java.lang.Object key, long timeout)
Read an entry from the space, waiting a limited amount of time until one exists.V
rdp(java.lang.Object key)
Read probe reads an entry from the space if one exists, return null otherwise.void
removeListener(java.lang.Object key, SpaceListener listener)
removes a SpaceListener associated with a given keyvoid
run()
void
setEntries(java.util.Map entries)
unstandard method (required for space replication) - use with careint
size(java.lang.Object key)
-
-
-
Field Detail
-
entries
protected java.util.Map entries
-
GCDELAY
public static final long GCDELAY
- See Also:
- Constant Field Values
-
-
Constructor Detail
-
TSpace
public TSpace()
-
-
Method Detail
-
out
public void out(K key, V value)
Description copied from interface:Space
Write a new entry into the Space
-
out
public void out(K key, V value, long timeout)
Description copied from interface:Space
Write a new entry into the Space, with an timeout value
-
rdp
public V rdp(java.lang.Object key)
Description copied from interface:Space
Read probe reads an entry from the space if one exists, return null otherwise.
-
inp
public V inp(java.lang.Object key)
Description copied from interface:Space
In probe takes an entry from the space if one exists, return null otherwise.
-
in
public V in(java.lang.Object key)
Description copied from interface:Space
Take an entry from the space, waiting forever until one exists.
-
in
public V in(java.lang.Object key, long timeout)
Description copied from interface:Space
Take an entry from the space, waiting a limited amount of time until one exists.
-
rd
public V rd(java.lang.Object key)
Description copied from interface:Space
Read an entry from the space, waiting forever until one exists.
-
rd
public V rd(java.lang.Object key, long timeout)
Description copied from interface:Space
Read an entry from the space, waiting a limited amount of time until one exists.
-
nrd
public void nrd(java.lang.Object key)
Description copied from interface:Space
Nrd (not read) waits forever until Key is not present in space Resolution for expiring entries is implementation dependant, but a minimum one-second is suggested.
-
nrd
public V nrd(java.lang.Object key, long timeout)
Description copied from interface:Space
Nrd (not read) waits up to timeout until Key is not present in space Resolution for expiring entries is implementation dependant, but a minimum one-second is suggested.
-
run
public void run()
- Specified by:
run
in interfacejava.lang.Runnable
-
gc
public void gc()
-
size
public int size(java.lang.Object key)
- Specified by:
size
in interfaceLocalSpace<K,V>
- Returns:
- number of entries in a given key
-
addListener
public void addListener(java.lang.Object key, SpaceListener listener)
Description copied from interface:LocalSpace
add a SpaceListener associated with a given key- Specified by:
addListener
in interfaceLocalSpace<K,V>
- Parameters:
key
- Entry's keylistener
- a SpaceListener
-
addListener
public void addListener(java.lang.Object key, SpaceListener listener, long timeout)
Description copied from interface:LocalSpace
add a SpaceListener associated with a given key for a given period of time. Warning: not supported by all space implementations.- Specified by:
addListener
in interfaceLocalSpace<K,V>
- Parameters:
key
- Entry's keylistener
- a SpaceListenertimeout
- listener registration timeout in millis
-
removeListener
public void removeListener(java.lang.Object key, SpaceListener listener)
Description copied from interface:LocalSpace
removes a SpaceListener associated with a given key- Specified by:
removeListener
in interfaceLocalSpace<K,V>
- Parameters:
key
- Entry's keylistener
- the SpaceListener
-
isEmpty
public boolean isEmpty()
-
getKeySet
public java.util.Set<K> getKeySet()
- Specified by:
getKeySet
in interfaceLocalSpace<K,V>
- Returns:
- Set containing all keys in Space
-
getKeysAsString
public java.lang.String getKeysAsString()
-
dump
public void dump(java.io.PrintStream p, java.lang.String indent)
-
notifyListeners
public void notifyListeners(java.lang.Object key, java.lang.Object value)
-
push
public void push(K key, V value)
Description copied from interface:Space
Write a new entry at the head of a queue.
-
push
public void push(K key, V value, long timeout)
Description copied from interface:Space
Write a new entry at the head of the queue with a timeout value
-
put
public void put(K key, V value)
Description copied from interface:Space
Write a single entry at the head of the queue discarding the other entries
-
put
public void put(K key, V value, long timeout)
Description copied from interface:Space
Write a single entry at the head of the queue discarding the other entries, with timeout.
-
getEntries
public java.util.Map getEntries()
unstandard method (required for space replication) - use with care- Returns:
- underlying entry map
-
setEntries
public void setEntries(java.util.Map entries)
unstandard method (required for space replication) - use with care- Parameters:
entries
- underlying entry map
-
-