context.html

API資料大全

</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class java.lang.<A HREF="../../../java/lang/Object.html">Object</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../java/lang/Object.html#clone()">clone</A>, <A HREF="../../../java/lang/Object.html#equals(java.lang.Object)">equals</A>, <A HREF="../../../java/lang/Object.html#finalize()">finalize</A>, <A HREF="../../../java/lang/Object.html#getClass()">getClass</A>, <A HREF="../../../java/lang/Object.html#hashCode()">hashCode</A>, <A HREF="../../../java/lang/Object.html#notify()">notify</A>, <A HREF="../../../java/lang/Object.html#notifyAll()">notifyAll</A>, <A HREF="../../../java/lang/Object.html#toString()">toString</A>, <A HREF="../../../java/lang/Object.html#wait()">wait</A>, <A HREF="../../../java/lang/Object.html#wait(long)">wait</A>, <A HREF="../../../java/lang/Object.html#wait(long, int)">wait</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->


<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="Context()"><!-- --></A><H3>
Context</H3>
<PRE>
public <B>Context</B>()</PRE>
<DL>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="context_name()"><!-- --></A><H3>
context_name</H3>
<PRE>
public abstract <A HREF="../../../java/lang/String.html">String</A> <B>context_name</B>()</PRE>
<DL>
<DD>Retrieves the name of this <code>Context</code> object.<DD><DL>
<DT><B>Returns:</B><DD>the name of this <code>Context</code> object</DL>
</DD>
</DL>
<HR>

<A NAME="parent()"><!-- --></A><H3>
parent</H3>
<PRE>
public abstract <A HREF="../../../org/omg/CORBA/Context.html">Context</A> <B>parent</B>()</PRE>
<DL>
<DD>Retrieves the parent of this <code>Context</code> object.<DD><DL>
<DT><B>Returns:</B><DD>the <code>Context</code> object that is the
                    parent of this <code>Context</code> object</DL>
</DD>
</DL>
<HR>

<A NAME="create_child(java.lang.String)"><!-- --></A><H3>
create_child</H3>
<PRE>
public abstract <A HREF="../../../org/omg/CORBA/Context.html">Context</A> <B>create_child</B>(<A HREF="../../../java/lang/String.html">String</A>&nbsp;child_ctx_name)</PRE>
<DL>
<DD>Creates a <code>Context</code> object with the given string as its
 name and with this <code>Context</code> object set as its parent.
 <P>
 The new <code>Context</code> object is chained into its parent
 <code>Context</code> 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.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>child_ctx_name</CODE> - the <code>String</code> object to be set as
                        the name of the new <code>Context</code> object<DT><B>Returns:</B><DD>the newly-created child <code>Context</code> object
                    initialized with the specified name</DL>
</DD>
</DL>
<HR>

<A NAME="set_one_value(java.lang.String, org.omg.CORBA.Any)"><!-- --></A><H3>
set_one_value</H3>
<PRE>
public abstract void <B>set_one_value</B>(<A HREF="../../../java/lang/String.html">String</A>&nbsp;propname,
                                   <A HREF="../../../org/omg/CORBA/Any.html">Any</A>&nbsp;propvalue)</PRE>
<DL>
<DD>Creates a <code>NamedValue</code> object and adds it to this
 <code>Context</code> object.  The <code>name</code> field of the
 new <code>NamedValue</code> object is set to the given string,
 the <code>value</code> field is set to the given <code>Any</code>
 object, and the <code>flags</code> field is set to zero.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>propname</CODE> - the name of the property to be set<DD><CODE>propvalue</CODE> - the <code>Any</code> object to which the
                        value of the property will be set.  The
                        <code>Any</code> object's <code>value</code>
                        field contains the value to be associated
                        with the given propname; the
                        <code>kind</code> field must be set to
                        <code>TCKind.tk_string</code>.</DL>
</DD>
</DL>
<HR>

<A NAME="set_values(org.omg.CORBA.NVList)"><!-- --></A><H3>
set_values</H3>
<PRE>
public abstract void <B>set_values</B>(<A HREF="../../../org/omg/CORBA/NVList.html">NVList</A>&nbsp;values)</PRE>
<DL>
<DD>I Sets one or more property values in this <code>Context</code>
 object. The <code>NVList</code> supplied to this method
 contains one or more <code>NamedValue</code> objects.
 In each <code>NamedValue</code> object,
 the <code>name</code> field holds the name of the property, and
 the <code>flags</code> field must be set to zero.
 The <code>NamedValue</code> object's <code>value</code> field
 contains an <code>Any</code> object, which, in turn, contains the value
 for the property.  Since the value is always a string,
 the <code>Any</code> object must have the <code>kind</code>
 field of its <code>TypeCode</code> set to <code>TCKind.tk_string</code>.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>values</CODE> - an NVList containing the property
 				    names and associated values to be set<DT><B>See Also: </B><DD><A HREF="../../../org/omg/CORBA/NamedValue.html"><CODE>NamedValue</CODE></A>, 
<A HREF="../../../org/omg/CORBA/Any.html"><CODE>Any</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="delete_values(java.lang.String)"><!-- --></A><H3>
delete_values</H3>
<PRE>
public abstract void <B>delete_values</B>(<A HREF="../../../java/lang/String.html">String</A>&nbsp;propname)</PRE>
<DL>
<DD>Deletes from this <code>Context</code> object the
 <code>NamedValue</code> object(s) whose
 <code>name</code> field matches the given property name.
 If the <code>String</code> object supplied for
 <code>propname</code> has a
 trailing wildcard character ("*"), then
 all <code>NamedValue</code> objects whose <code>name</code>
 fields match will be deleted. The search scope is always
 limited to this <code>Context</code> object.
 <P>
 If no matching property is found, an exception is returned.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>propname</CODE> - name of the property to be deleted</DL>
</DD>
</DL>
<HR>

<A NAME="get_values(java.lang.String, int, java.lang.String)"><!-- --></A><H3>
get_values</H3>
<PRE>
public abstract <A HREF="../../../org/omg/CORBA/NVList.html">NVList</A> <B>get_values</B>(<A HREF="../../../java/lang/String.html">String</A>&nbsp;start_scope,
                                  int&nbsp;op_flags,
                                  <A HREF="../../../java/lang/String.html">String</A>&nbsp;pattern)</PRE>
<DL>
<DD>Retrieves the <code>NamedValue</code> objects whose
 <code>name</code> 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 <code>Context</code> objects in the chain have been exhausted.
 <P>
 If no match is found, an error is returned and no property list
 is returned.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>start_scope</CODE> - a <code>String</code> 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.<DD><CODE>op_flags</CODE> - an operation flag.  The one flag
                that may be specified is <code>CTX_RESTRICT_SCOPE</code>.
                If this flag is specified, searching is limited to the
				specified <code>start_scope</code> or this
                <code>Context</code> object.<DD><CODE>pattern</CODE> - the property name whose values are to
				be retrieved. <code>pattern</code> may be a
                name or a name with a
				trailing wildcard character ("*").<DT><B>Returns:</B><DD>an <code>NVList</code> containing all the property values
                (in the form of <code>NamedValue</code> objects)
                whose associated property name matches the given name or
                name pattern<DT><B>See Also: </B><DD><A HREF="../../../org/omg/CORBA/NamedValue.html"><CODE>NamedValue</CODE></A></DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/Context.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Java<sup><font size=-2>TM</font></sup>&nbsp;2&nbsp;Platform<br>Std.&nbsp;Ed. v1.3</b></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../org/omg/CORBA/CompletionStatusHelper.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../org/omg/CORBA/ContextList.html"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="Context.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: &nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->

<HR>
<font size="-1"><a href="http://java.sun.com/cgi-bin/bugreport.cgi">Submit a bug or feature</a><br>For further API reference and developer documentation, see <a href="http://java.sun.com/products/jdk/1.3/devdocs-vs-specs.html">Java 2 SDK SE Developer Documentation</a>. That documentation  contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples. <p>Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road<br>Palo Alto, California, 94303, U.S.A.  All Rights Reserved.</font>
</BODY>
</HTML>