|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.util.AbstractMap<K,V>
java.util.TreeMap
org.openorb.tns.MapNamingContext
public class MapNamingContext
This class can be used for an easy to use transient naming context. The context implements the SortedMap interface, and stores all it's bindings as name/value pairs. Using the put operation with a key containing a non-existent context parent(s) will result in the parent contexts being created.
Special notes: Deleting an internal context with the remove operation on any of the associated iterators or collections will cause undefined behaviour. This may change in the future.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class java.util.AbstractMap |
---|
java.util.AbstractMap.SimpleEntry<K,V>, java.util.AbstractMap.SimpleImmutableEntry<K,V> |
Field Summary | |
---|---|
static java.lang.String |
DEFAULT_FORMAT
|
static int |
SHUTDOWN_DESTROY_ORB
|
static int |
SHUTDOWN_DESTROY_POA
|
static int |
SHUTDOWN_DISALLOW
|
Constructor Summary | |
---|---|
MapNamingContext(org.omg.CORBA.ORB orb,
org.omg.PortableServer.POA rootPOA,
org.apache.avalon.framework.logger.Logger logger)
Create a new MapNamingContext. |
Method Summary | |
---|---|
void |
activate()
Start the NamingService. |
org.omg.CosNaming.NamingContextExt |
addContext(org.omg.CosNaming.NameComponent[] name)
Add a context to the map, adding ancestor contexts as neccicary. |
org.omg.CosNaming.NamingContextExt |
addContext(java.lang.String context)
Add a context to the map, adding ancestor contexts as neccicary. |
static org.apache.avalon.framework.logger.Logger |
createLogger(java.lang.String name)
|
void |
deactivate(boolean waitForComplete)
Deactivate the server reference, and all other naming contexts created with the create_context operation. |
boolean |
getAllowSelfDestruct()
Will the destroy_context operation work on the root context? |
java.lang.String |
getCorbaname(org.omg.CosNaming.NameComponent[] name)
Return a corbaname style address for the name passed. |
java.lang.String |
getCorbaname(java.lang.String str)
Return a corbaname style address for the string name passed. |
org.apache.avalon.framework.logger.Logger |
getLogger()
|
org.omg.CosNaming.NamingContextExt |
getRootCtxt()
Get a reference to the root naming context. |
boolean |
isContext(java.lang.String context)
Determine if the specified name is a subcontext and must be removed with the removeContext operation. |
java.lang.Object |
put(java.lang.Object key,
java.lang.Object value)
Add a binding to the map. |
void |
putAll(java.util.Map p1)
|
org.omg.CORBA.Object |
putName(org.omg.CosNaming.NameComponent[] name,
org.omg.CORBA.Object obj)
Add a binding to the map, creating ancestor contexts as neccicary. |
org.omg.CORBA.Object |
putStr(java.lang.String str,
org.omg.CORBA.Object obj)
Add a binding to the map, creating ancestor contexts as neccicary. |
boolean |
removeContext(java.lang.String context)
Remove a context. |
void |
setAllowSelfDestruct(boolean allowSelfDestruct)
When this is set to true the root context may be destroyed with the destroy operation. |
void |
setShutdownMode(int shutdownMode)
When this is set to true the root context may be destroyed with the destroy operation. |
Methods inherited from class java.util.TreeMap |
---|
ceilingEntry, ceilingKey, clear, clone, comparator, containsKey, containsValue, descendingKeySet, descendingMap, entrySet, firstEntry, firstKey, floorEntry, floorKey, get, headMap, headMap, higherEntry, higherKey, keySet, lastEntry, lastKey, lowerEntry, lowerKey, navigableKeySet, pollFirstEntry, pollLastEntry, remove, size, subMap, subMap, tailMap, tailMap, values |
Methods inherited from class java.util.AbstractMap |
---|
equals, hashCode, isEmpty, toString |
Methods inherited from class java.lang.Object |
---|
getClass, notify, notifyAll, wait, wait, wait |
Methods inherited from interface java.util.Map |
---|
equals, hashCode, isEmpty |
Field Detail |
---|
public static final java.lang.String DEFAULT_FORMAT
public static final int SHUTDOWN_DISALLOW
public static final int SHUTDOWN_DESTROY_POA
public static final int SHUTDOWN_DESTROY_ORB
Constructor Detail |
---|
public MapNamingContext(org.omg.CORBA.ORB orb, org.omg.PortableServer.POA rootPOA, org.apache.avalon.framework.logger.Logger logger)
orb
- orb under which the context is to be activated.rootPOA
- parent POA under which to create the context's poa.
If null the orb's root POA is used.logger
- for use in class -- may not be null.Method Detail |
---|
public static org.apache.avalon.framework.logger.Logger createLogger(java.lang.String name)
public org.apache.avalon.framework.logger.Logger getLogger()
public void activate()
public org.omg.CosNaming.NamingContextExt getRootCtxt()
public java.lang.String getCorbaname(java.lang.String str)
str
- stringified corbaname of target.
java.lang.IllegalArgumentException
- if str is not a valid stringified name
java.lang.IllegalStateException
- nameservice has not been bound as a corbaloc.public java.lang.String getCorbaname(org.omg.CosNaming.NameComponent[] name)
name
- the name to use.
java.lang.IllegalArgumentException
- if name is invalid for some reason.
java.lang.IllegalStateException
- nameservice has not been bound as a corbaloc.public boolean getAllowSelfDestruct()
public void setAllowSelfDestruct(boolean allowSelfDestruct)
allowSelfDestruct
- New value of property allowSelfDestruct.public void setShutdownMode(int shutdownMode)
shutdownMode
- New value of property shutdownMode.public void deactivate(boolean waitForComplete)
waitForComplete
- wait for completion before returning. If this
parameter is true and this operation is called from a server thread
an exception will be thrown.public java.lang.Object put(java.lang.Object key, java.lang.Object value)
To insert a new empty context into the map use a key string ending in / The object reference in this case will be ignored.
put
in interface java.util.Map
put
in class java.util.TreeMap
key
- String or NameComponent[] composing the binding's name.value
- org.omg.CORBA.Object to be bound to the name.
java.lang.NullPointerException
- if key is null.
java.lang.ClassCastException
- if key or value is the wrong type.
java.lang.IllegalArgumentException
- the key is not a valid name.
java.lang.IllegalStateException
- the name is bound to a context, or one of
it's ancestors are bound to an object.public org.omg.CORBA.Object putName(org.omg.CosNaming.NameComponent[] name, org.omg.CORBA.Object obj)
name
- The binding's name.obj
- org.omg.CORBA.Object to be bound to the name.
java.lang.NullPointerException
- if key is null.
java.lang.IllegalArgumentException
- the key is not a valid name.
java.lang.IllegalStateException
- the name is bound to a context, or one of
it's ancestors are bound to an object.public org.omg.CORBA.Object putStr(java.lang.String str, org.omg.CORBA.Object obj)
To insert a new empty context into the map use a key string ending in / The object reference in this case will be ignored.
str
- The binding's name.obj
- org.omg.CORBA.Object to be bound to the name.
java.lang.NullPointerException
- if key is null.
java.lang.IllegalArgumentException
- the key is not a valid name.
java.lang.IllegalStateException
- the name is bound to a context, or one of
it's ancestors are bound to an object.public org.omg.CosNaming.NamingContextExt addContext(java.lang.String context)
context
- Name of the context.
java.lang.NullPointerException
- if context is null.
java.lang.IllegalArgumentException
- the context is not a valid name.
java.lang.IllegalStateException
- the context or one of
it's ancestors are bound to an object.public org.omg.CosNaming.NamingContextExt addContext(org.omg.CosNaming.NameComponent[] name)
name
- Name of the context.
java.lang.NullPointerException
- if name is null.
java.lang.IllegalArgumentException
- the name is not a valid name.
java.lang.IllegalStateException
- the name or one of
it's ancestors are bound to an object.public boolean removeContext(java.lang.String context)
context
- the name of the context.
public boolean isContext(java.lang.String context)
context
- the name of the context.
public void putAll(java.util.Map p1)
putAll
in interface java.util.Map
putAll
in class java.util.TreeMap
|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |