uTools-Manuals/docs/java/org/omg/CORBA/NamedValue.html

215 lines
9.2 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
org.omg.CORBA
</div>
<h2 class="title" title="Class NamedValue">Class NamedValue</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li>org.omg.CORBA.NamedValue</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">NamedValue</span>
extends <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
<div class="block">
<span>DII和DSI中使用的对象来描述参数和返回值。</span>
<span><code>NamedValue</code>对象也被用在<code>Context</code>对象例程中传递属性名和值的列表。</span>
<p> <span>一个<code>NamedValue</code>对象包含:</span> </p>
<ul>
<li> <span>一个名称 - 如果<code>NamedValue</code>对象用于描述请求的参数则该名称将是OMG IDL接口定义中为要描述的操作指定的参数标识符。</span> </li>
<li> <span>一个值 - 一个<code>Any</code>对象</span> </li>
<li> <span>参数模式标志 - 以下之一:</span>
<ul>
<li> <code>ARG_IN.value</code> </li>
<li> <code>ARG_OUT.value</code> </li>
<li> <code>ARG_INOUT.value</code> </li>
<li> <span>零-如果此<code>NamedValue</code>对象表示一个属性<code>Context</code>对象,而不是参数或返回值</span> </li>
</ul></li>
</ul>
<p> <span><code>NamedValue</code>类有三种访问其领域的方法。</span> <span>以下代码片段演示了创建一个<code>NamedValue</code>对象,然后访问其字段:</span> </p>
<pre> <span>ORB orb = ORB.init(args, null);
String s = "argument_1";
org.omg.CORBA.Any myAny = orb.create_any();
myAny.insert_long(12345);
int in = org.omg.CORBA.ARG_IN.value;
org.omg.CORBA.NamedValue nv = orb.create_named_value(
s, myAny, in);
System.out.println("This nv name is " + nv.name());
try {
System.out.println("This nv value is " + nv.value().extract_long());
System.out.println("This nv flag is " + nv.flags());
} catch (org.omg.CORBA.BAD_OPERATION b) {
System.out.println("extract failed");
}</span> </pre>
<p> <span>如果这个代码片段被放在一个<code>main</code>方法中,输出将如下所示:</span> </p>
<pre> <span>This nv name is argument_1
This nv value is 12345
This nv flag is 1</span> </pre>
<p> <span>请注意,方法<code>value</code>返回一个<code>Any</code>对象。</span> <span>为了访问所述<code>long</code>包含在<code>Any</code>对象,我们使用的方法<code>extract_long</code></span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
JDK1.2
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../org/omg/CORBA/Any.html" title="在org.omg.CORBA中的类"><code>Any</code></a> <a href="../../../org/omg/CORBA/ARG_IN.html" title="在org.omg.CORBA中的接口"><code>ARG_IN</code></a> <a href="../../../org/omg/CORBA/ARG_INOUT.html" title="在org.omg.CORBA中的接口"><code>ARG_INOUT</code></a> <a href="../../../org/omg/CORBA/ARG_OUT.html" title="在org.omg.CORBA中的接口"><code>ARG_OUT</code></a></span>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../org/omg/CORBA/NamedValue.html#NamedValue--">NamedValue</a></span>()</code> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code>abstract int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/CORBA/NamedValue.html#flags--">flags</a></span>()</code>
<div class="block">
检索此
<code>NamedValue</code>对象的参数模式标志。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>abstract <a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/CORBA/NamedValue.html#name--">name</a></span>()</code>
<div class="block">
检索此
<code>NamedValue</code>对象的名称。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>abstract <a href="../../../org/omg/CORBA/Any.html" title="class in org.omg.CORBA">Any</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/CORBA/NamedValue.html#value--">value</a></span>()</code>
<div class="block">
检索此
<code>NamedValue</code>对象的值。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <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></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="NamedValue--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>NamedValue</h4> <pre>public NamedValue()</pre> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="name--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>name</h4> <pre>public abstract <a href="../../../java/lang/String.html" title="class in java.lang">String</a> name()</pre>
<div class="block">
检索此
<code>NamedValue</code>对象的名称。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>String</code>对象,代表这个
<code>NamedValue</code>对象的名字
</dd>
</dl> </li>
</ul> <a name="value--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>value</h4> <pre>public abstract <a href="../../../org/omg/CORBA/Any.html" title="class in org.omg.CORBA">Any</a> value()</pre>
<div class="block">
检索此
<code>NamedValue</code>对象的值。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个包含该
<code>Any</code>对象的值的
<code>NamedValue</code>对象
</dd>
</dl> </li>
</ul> <a name="flags--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>flags</h4> <pre>public abstract int flags()</pre>
<div class="block">
检索此
<code>NamedValue</code>对象的参数模式标志。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>int</code>表示这个
<code>NamedValue</code>对象的参数模式
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>