things.universe.server
Class UniverseRegistry_Simple

java.lang.Object
  extended by things.universe.server.UniverseRegistry_Simple
All Implemented Interfaces:
Verbose, UniverseRegistry

public class UniverseRegistry_Simple
extends java.lang.Object
implements UniverseRegistry

A simple universe registry. It'll manage a properties based registry. The configuration will snapshot'd when the registry starts. It will never save.

REGISTRY DATA for ALL:
CONFIG_LIST list=u1,u2 List of names. Names may not have whitespace.
CONFIG_ROOT root=u1

REGISTRY DATA for UNIVERSE_LOCAL:
u1.id=
u1.type=local
u1.path=

Version:
1.0

Version History

EPG - Initial - 18 MAY 04
 
Author:
Erich P. Gatejen

Field Summary
 
Fields inherited from interface things.universe.UniverseRegistry
UNIVERSE_INVALID, UNIVERSE_LOCAL, UNIVERSE_LOCAL_name
 
Constructor Summary
UniverseRegistry_Simple()
           
 
Method Summary
 Universe getAccessor(java.lang.String name)
          Get an accessor to a universe by local name.
 Universe getAccessor(UniverseID theUniverse)
          Manufacture an accessor to a universe.
 Clearance getClearance(java.lang.String name)
          Get an clearance for a universe by localName
 Clearance getClearance(UniverseID theUniverse)
          Get an clearance for a universe by id.
 boolean isVerbose()
          Is it set to verbose?
 void loadRegistry(ThingsPropertyView config)
          Load a registry from a configuration node.
 void register(int type, ThingsPropertyView config)
          Register a universe.
 void safetyTheRegistry()
          Safety the Registry.
 void screech(java.lang.String message)
          Post a verbose message if verbose mode is on.
 void verboseOff()
          Turn it off
 void verboseOn(StringPoster poster)
          Turn on.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

UniverseRegistry_Simple

public UniverseRegistry_Simple()
Method Detail

getAccessor

public Universe getAccessor(UniverseID theUniverse)
                     throws UniverseException
Manufacture an accessor to a universe.

Specified by:
getAccessor in interface UniverseRegistry
Parameters:
theUniverse - ID for the universe to access
Returns:
a Universe or null if the universe doesn't exist ( or isn't loaded ).
Throws:
UniverseException

getAccessor

public Universe getAccessor(java.lang.String name)
                     throws UniverseException
Get an accessor to a universe by local name.

Specified by:
getAccessor in interface UniverseRegistry
Parameters:
name - the name
Returns:
a Universe or null if the universe doesn't exist ( or isn't loaded ).
Throws:
UniverseException

getClearance

public Clearance getClearance(UniverseID theUniverse)
                       throws UniverseException
Get an clearance for a universe by id.

Specified by:
getClearance in interface UniverseRegistry
Parameters:
theUniverse - ID for the universe to access
Returns:
a Universe or null if the universe doesn't exist ( or isn't loaded ).
Throws:
UniverseException

getClearance

public Clearance getClearance(java.lang.String name)
                       throws UniverseException
Get an clearance for a universe by localName

Specified by:
getClearance in interface UniverseRegistry
Parameters:
name - the local name
Returns:
a Universe or null if the universe doesn't exist ( or isn't loaded ).
Throws:
UniverseException

register

public void register(int type,
                     ThingsPropertyView config)
              throws UniverseException
Register a universe.

Specified by:
register in interface UniverseRegistry
Parameters:
type - numeric as specific in this class
config - information
Throws:
UniverseException

loadRegistry

public void loadRegistry(ThingsPropertyView config)
                  throws UniverseException
Load a registry from a configuration node. See documentation above for expected properties.

Specified by:
loadRegistry in interface UniverseRegistry
Parameters:
config - a configuration node
Throws:
UniverseException
See Also:
ThingsPropertyView

safetyTheRegistry

public void safetyTheRegistry()
                       throws UniverseException
Safety the Registry. If the confiration node supports it, the registry will be checkpointed and/or saved. This effectively sets the last known good configuration.

Specified by:
safetyTheRegistry in interface UniverseRegistry
Throws:
UniverseException

verboseOn

public void verboseOn(StringPoster poster)
               throws ThingsException
Turn on. It will test the poster and will throw a ThingsException if it has a problem.

Specified by:
verboseOn in interface Verbose
Parameters:
poster - StringPoster where to put the debug info
Throws:
ThingsException

verboseOff

public void verboseOff()
Turn it off

Specified by:
verboseOff in interface Verbose

screech

public void screech(java.lang.String message)
Post a verbose message if verbose mode is on. It will never throw an exception. The implementation may find a way to report exceptions.

Specified by:
screech in interface Verbose
Parameters:
message - The message.

isVerbose

public boolean isVerbose()
Is it set to verbose?

Specified by:
isVerbose in interface Verbose
Returns:
true if it is verbose, otherwise false.


Things.