All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class org.omg.CORBA.Context 

java.lang.Object
   |
   +----org.omg.CORBA.Context
public abstract class Context
extends Object

IDL definition: 
interface Context {
readonly attribute ::CORBA::Identifier context_name;
readonly attribute ::CORBA::Context parent;
void set_one_value(
in ::CORBA::Identifier prop_name,
in any value
);
void set_values(
in ::CORBA::NVList values
);
::CORBA::NVList get_values(
in ::CORBA::Identifier start_scope,
in ::CORBA::Flags op_flags,
in ::CORBA::Identifier prop_name
);
void delete_values(
in ::CORBA::Identifier prop_name
);
::CORBA::Context create_child(
in ::CORBA::Identifier child_context_name
);
};

The Context interface contains a property list, which is propagated from the client to the server in a request. These properties are left to the user and implementor to define: the CORBA specifation does not define the contents of a Context. The global default context is obtained from the ORB singleton. Contexts are organized as a tree: each context contains a pointer to its parent context. The root context is the global default context, whose parent is null.

See Also:
get_default_context

Constructor Index

o Context()

Method Index

o context_name()
Get the name of the context.
o create_child(String)
Creates a child (leaf) context with the specified parent context.
o delete_values(String)
Removes all properties with the specified name.
o get_values(String, int, String)
Get all values for the specified property.
o parent()
Get the parent of the context.
o set_one_value(String, Any)
Adds a property to the current context.
o set_values(NVList)
Sets the properties of the current context.

Constructors

o Context 
 public Context()

Methods

o context_name 
 public abstract String context_name()
Get the name of the context.

Reader for attribute: ::CORBA::Context::context_name. 

readonly attribute ::CORBA::Identifier context_name;

o parent 
 public abstract Context parent()
Get the parent of the context. Returns null if the context is the global default context.

Reader for attribute: ::CORBA::Context::parent. 

readonly attribute ::CORBA::Context parent;

o set_one_value 
 public abstract void set_one_value(String prop_name,
                                    Any value)
Adds a property to the current context.

Operation: ::CORBA::Context::set_one_value. 

void set_one_value(
in ::CORBA::Identifier prop_name,
in any value
);

Parameters:
prop_name - The name of the new property.
value - The value of the property.
o set_values 
 public abstract void set_values(NVList values)
Sets the properties of the current context.

Operation: ::CORBA::Context::set_values. 

void set_values(
in ::CORBA::NVList values
);

Parameters:
values - The new properties for the context.
o get_values 
 public abstract NVList get_values(String start_scope,
                                   int op_flags,
                                   String prop_name)
Get all values for the specified property. The '*' character can be used as a wild card at the end of the prop_name.

Operation: ::CORBA::Context::get_values. 

::CORBA::NVList get_values(
in ::CORBA::Identifier start_scope,
in ::CORBA::Flags op_flags,
in ::CORBA::Identifier prop_name
);

Parameters:
start_scope - The name of the context at which to start searching.
op_flags - The search mode.
prop_name - The name of the property to obtain.
Returns:
A name value list for the specified search.
Throws: BAD_PARAM
If the start_scope is non null and the corresponding context is not found.
o delete_values 
 public abstract void delete_values(String prop_name)
Removes all properties with the specified name. The '*' character can be used as a wild card at the end of the prop_name.

Operation: ::CORBA::Context::delete_values. 

void delete_values(
in ::CORBA::Identifier prop_name
);

Parameters:
name - The name of the property to remove from the property list.
o create_child 
 public abstract Context create_child(String child_context_name)
Creates a child (leaf) context with the specified parent context.

Operation: ::CORBA::Context::create_child. 

::CORBA::Context create_child(
in ::CORBA::Identifier child_context_name
);

Parameters:
child_context_name - The name of new child context.
Returns:
The newly created child context. 
All Packages  Class Hierarchy  This Package  Previous  Next  Index