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.

Constructor Index

 o Context()

Method Index

 o context_name()
name accessor.
 o create_child(String)
create_child creates a context with the current context set as it's parent.
 o delete_values(String)
The delete_values operation deletes the specified property value(s) values from the context object.
 o get_values(String, int, String)
The get_values operation retrieves the specified context property value(s).
 o parent()
parent accessor.
 o set_one_value(String, Any)
set_one_value sets the value of the string property name to the Any provided.
 o set_values(NVList)
The set_values operation sets one or more property values in the context object.

Constructors

 o Context
  public Context()

Methods

 o context_name
  public abstract String context_name() throws SystemException
name accessor.
Returns:
name of the context.
 o parent
  public abstract Context parent() throws SystemException
parent accessor.
Returns:
parent of this context.
 o 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.
 o 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.
 o 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.
 o 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.
 o 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