Class org.omg.CORBA.Context
All Packages Class Hierarchy This Package Previous Next Index
Class org.omg.CORBA.Context
java.lang.Object
|
+----org.omg.CORBA.Context
- public class Context
- extends Object
The Context class is used in the request operations to describe
specify the context object in which context strings must be
resolved before being sent along with the request invocation.
-
Context()
-
-
context_name()
- name accessor.
-
create_child(String)
- create_child creates a context with the current context set as
it's parent.
-
delete_values(String)
- The delete_values operation deletes the specified property
value(s) values from the context object.
-
get_values(String, int, String)
-
The get_values operation retrieves the specified context property
value(s).
-
parent()
- parent accessor.
-
set_one_value(String, Any)
- set_one_value sets the value of the string property name to the
Any provided.
-
set_values(NVList)
- The set_values operation sets one or more property values in the
context object.
Context
public Context()
context_name
public abstract String context_name() throws SystemException
- name accessor.
- Returns:
- name of the context.
parent
public abstract Context parent() throws SystemException
- parent accessor.
- Returns:
- parent of this context.
create_child
public abstract Context create_child(String name) throws SystemException
- create_child creates a context with the current context set as
it's parent.
- Parameters:
- name - string to be set as name of the context.
- Returns:
- the context object created.
set_one_value
public abstract void set_one_value(String propName,
Any propValue) throws SystemException
- set_one_value sets the value of the string property name to the
Any provided.
- Parameters:
- propName - name of the property to be set.
- propValue - Any to set as value of the property.
set_values
public abstract void set_values(NVList values) throws SystemException
- The set_values operation sets one or more property values in the
context object. In the NVList, the flags field must be set to
zero, and the TypeCode field associated with an attribute value
must be TC_string.
- Parameters:
- values - the NVList describing the property
names and values to be set.
delete_values
public abstract void delete_values(String propName) throws SystemException
- The delete_values operation deletes the specified property
value(s) values from the context object. If propName has a
trailing wildcard character ("*"), then all property names that
match will be deleted. Search scope is always limited to the
specified context object. If no matching property is found, an
exception is returned.
- Parameters:
- propName - name of the property to be deleted.
get_values
public abstract NVList get_values(String startScope,
int opFlags,
String propName) throws SystemException
- The get_values operation retrieves the specified context property
value(s). It allows for wildcard searches as well. If the
property is not found at the indicated level, the search
continues up the context object tree until a match is found or
all context objects in the chain have been exhausted. If no
properties are found an error is returned, and no property list
is returned.
- Parameters:
- startScope - startScope indicates the context
object level at which to initiate the
search for the specified properties
(e.g. "_USER", "_SYSTEM"). Valid scope
names are implementation-specific. If
scope name is omitted, the search
begins with the specified context
object. If the specified scope name is
not found, an exception is returned.
- opFlags - if the CTX_RESTRICT_SCOPE flag is
specified, searching is limited to the
specified search scope or context
object.
- propName - the property name whose values are to
be retrieved. If propName has a
trailing wildcard character ("*"),
then all matching properties and their
values are returned.
All Packages Class Hierarchy This Package Previous Next Index