Package org.omg.CORBA
Class ContextList
java.lang.Object
org.omg.CORBA.ContextList
- Direct Known Subclasses:
ContextListImpl
An object containing a modifiable list of
String
objects
that represent property names.
This class is used in Request
operations to
describe the contexts that need to be resolved and sent with the
invocation. (A context is resolved by giving a property name
and getting back the value associated with it.) This is done
by calling the Context
method
get_values
and supplying a string from a
ContextList
object as the third parameter.
The method get_values
returns an NVList
object containing the NamedValue
objects that hold
the value(s) identified by the given string.
A ContextList
object is created by the ORB, as
illustrated here:
ORB orb = ORB.init(args, null); org.omg.CORBA.ContextList ctxList = orb.create_context_list();The variable
ctxList
represents an empty
ContextList
object. Strings are added to
the list with the method add
, accessed
with the method item
, and removed with the
method remove
.- Since:
- JDK1.2
- Version:
- 1.2, 09/09/97
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionabstract void
Adds aString
object to thisContextList
object.abstract int
count()
Returns the number ofString
objects in thisContextList
object.abstract String
item
(int index) Returns theString
object at the given index.abstract void
remove
(int index) Removes theString
object at the given index.
-
Constructor Details
-
ContextList
public ContextList()
-
-
Method Details
-
count
public abstract int count()Returns the number ofString
objects in thisContextList
object.- Returns:
- an
int
representing the number ofString
s in thisContextList
object
-
add
Adds aString
object to thisContextList
object.- Parameters:
ctx
- theString
object to be added
-
item
Returns theString
object at the given index.- Parameters:
index
- the index of the string desired, with 0 being the index of the first string- Returns:
- the string at the given index
- Throws:
Bounds
- if the index is greater than or equal to the number of strings in thisContextList
object
-
remove
Removes theString
object at the given index. Note that the indices of all strings following the one removed are shifted down by one.- Parameters:
index
- the index of theString
object to be removed, with 0 designating the first string- Throws:
Bounds
- if the index is greater than or equal to the number ofString
objects in thisContextList
object
-