|
Préférences
Moteurs de recherche
|
||||||||||||||||||||||
JavaTM 2 Platform Std. Ed. v1.6.0
org.omg.CORBA
|
Constructor Summary | |
---|---|
Context()
|
Method Summary | |
---|---|
abstract String |
context_name()
Retrieves the name of this Context object. |
abstract Context |
create_child(String child_ctx_name)
Creates a Context object with the given string as its
name and with this Context object set as its parent. |
abstract void |
delete_values(String propname)
Deletes from this Context object the
NamedValue object(s) whose
name field matches the given property name. |
abstract NVList |
get_values(String start_scope,
int op_flags,
String pattern)
Retrieves the NamedValue objects whose
name field matches the given name or name
pattern. |
abstract Context |
parent()
Retrieves the parent of this Context object. |
abstract void |
set_one_value(String propname,
Any propvalue)
Creates a NamedValue object and adds it to this
Context object. |
abstract void |
set_values(NVList values)
I Sets one or more property values in this Context
object. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public Context()
Method Detail |
---|
public abstract String context_name()
Context
object.
Context
objectpublic abstract Context parent()
Context
object.
Context
object that is the
parent of this Context
objectpublic abstract Context create_child(String child_ctx_name)
Context
object with the given string as its
name and with this Context
object set as its parent.
The new Context
object is chained into its parent
Context
object. This means that in a search for
matching property names, if a match is not found in this context,
the search will continue in the parent. If that is not successful,
the search will continue in the grandparent, if there is one, and
so on.
child_ctx_name
- the String
object to be set as
the name of the new Context
object
Context
object
initialized with the specified namepublic abstract void set_one_value(String propname, Any propvalue)
NamedValue
object and adds it to this
Context
object. The name
field of the
new NamedValue
object is set to the given string,
the value
field is set to the given Any
object, and the flags
field is set to zero.
propname
- the name of the property to be setpropvalue
- the Any
object to which the
value of the property will be set. The
Any
object's value
field contains the value to be associated
with the given propname; the
kind
field must be set to
TCKind.tk_string
.public abstract void set_values(NVList values)
Context
object. The NVList
supplied to this method
contains one or more NamedValue
objects.
In each NamedValue
object,
the name
field holds the name of the property, and
the flags
field must be set to zero.
The NamedValue
object's value
field
contains an Any
object, which, in turn, contains the value
for the property. Since the value is always a string,
the Any
object must have the kind
field of its TypeCode
set to TCKind.tk_string
.
values
- an NVList containing the property
names and associated values to be setget_values(java.lang.String, int, java.lang.String)
,
NamedValue
,
Any
public abstract void delete_values(String propname)
Context
object the
NamedValue
object(s) whose
name
field matches the given property name.
If the String
object supplied for
propname
has a
trailing wildcard character ("*"), then
all NamedValue
objects whose name
fields match will be deleted. The search scope is always
limited to this Context
object.
If no matching property is found, an exception is returned.
propname
- name of the property to be deletedpublic abstract NVList get_values(String start_scope, int op_flags, String pattern)
NamedValue
objects whose
name
field matches the given name or name
pattern. This method allows for wildcard searches,
which means that there can be multiple matches and
therefore multiple values returned. 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 match is found, an error is returned and no property list is returned.
start_scope
- a String
object indicating the
context object level at which to initiate the
search for the specified properties
(for example, "_USER", "_GROUP", "_SYSTEM"). Valid scope
names are implementation-specific. If a
scope name is omitted, the search
begins with the specified context
object. If the specified scope name is
not found, an exception is returned.op_flags
- an operation flag. The one flag
that may be specified is CTX_RESTRICT_SCOPE
.
If this flag is specified, searching is limited to the
specified start_scope
or this
Context
object.pattern
- the property name whose values are to
be retrieved. pattern
may be a
name or a name with a
trailing wildcard character ("*").
NVList
containing all the property values
(in the form of NamedValue
objects)
whose associated property name matches the given name or
name patternset_values(org.omg.CORBA.NVList)
,
NamedValue