org.jpos.util

Class NameRegistrar

java.lang.Object

org.jpos.util.NameRegistrar

All Implemented Interfaces:

Loggeable

public class NameRegistrar
extends java.lang.Object
implements Loggeable

Allow runtime binding of jPOS's components (ISOChannels, Logger, MUXes, etc)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NameRegistrar.NotFoundException

Method Summary

Modifier and Type	Method and Description
void	dump(java.io.PrintStream p, java.lang.String indent)
void	dump(java.io.PrintStream p, java.lang.String indent, boolean detail)
static <T> T	get(java.lang.String key) Get a value from the registry.
static <T> T	get(java.lang.String key, long timeout) Get a value from the registry - wait for it specified time.
static java.util.Map<java.lang.String,java.lang.Object>	getAsMap()
static <T> T	getIfExists(java.lang.String key) Get a value from the registry - without casting NotFoundException.
static NameRegistrar	getInstance()
static TSpace<java.lang.String,java.lang.Object>	getSpace()
static void	register(java.lang.String key, java.lang.Object value) register object
static void	unregister(java.lang.String key)

Methods inherited from class java.lang.Object

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

Method Detail

getSpace

public static TSpace<java.lang.String,java.lang.Object> getSpace()

getAsMap

public static java.util.Map<java.lang.String,java.lang.Object> getAsMap()

Returns:

a copy of the NameRegistrar's entries as a Map

getInstance

public static NameRegistrar getInstance()

Returns:

singleton instance

register

public static void register(java.lang.String key,
                            java.lang.Object value)

register object

Parameters:

key - - key with which the specified value is to be associated.

value - - value to be associated with the specified key

unregister

public static void unregister(java.lang.String key)

Parameters:

key - key whose mapping is to be removed from registrar.

get

public static <T> T get(java.lang.String key)
                 throws NameRegistrar.NotFoundException

Get a value from the registry.

Type Parameters:

T - desired type of entry value.

Parameters:

key - the key whose associated value is to be returned.

Returns:

a value

Throws:

NameRegistrar.NotFoundException - if key not present in registrar

get

public static <T> T get(java.lang.String key,
                        long timeout)

Get a value from the registry - wait for it specified time.

Type Parameters:

T - desired type of value.

Parameters:

key - the key whose associated value is to be returned.

timeout - the maximum waiting time (in miliseconds) for the appearance of value in the registry.

Returns:

a value or null if it does not exist

getIfExists

public static <T> T getIfExists(java.lang.String key)

Get a value from the registry - without casting NotFoundException.

Type Parameters:

T - desired type of value.

Parameters:

key - the key whose associated value is to be returned.

Returns:

a value or null if it does not exist

dump

public void dump(java.io.PrintStream p,
                 java.lang.String indent)

Specified by:

dump in interface Loggeable

dump

public void dump(java.io.PrintStream p,
                 java.lang.String indent,
                 boolean detail)