uTools-Manuals/docs/java/org/omg/DynamicAny/DynValueOperations.html

255 lines
18 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.DynamicAny
</div>
<h2 class="title" title="Interface DynValueOperations">Interface DynValueOperations</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Superinterfaces:
</dt>
<dd>
<span><a href="../../../org/omg/DynamicAny/DynAnyOperations.html" title="界面在org.omg.DynamicAny中">DynAnyOperations</a> <a href="../../../org/omg/DynamicAny/DynValueCommonOperations.html" title="界面在org.omg.DynamicAny中">DynValueCommonOperations</a></span>
</dd>
</dl>
<dl>
<dt>
All Known Subinterfaces:
</dt>
<dd>
<span><a href="../../../org/omg/DynamicAny/DynValue.html" title="界面在org.omg.DynamicAny中">DynValue</a></span>
</dd>
</dl>
<dl>
<dt>
所有已知实现类:
</dt>
<dd>
<span><a href="../../../org/omg/DynamicAny/_DynValueStub.html" title="org.omg.DynamicAny中的类">_DynValueStub</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">DynValueOperations</span>
extends <a href="../../../org/omg/DynamicAny/DynValueCommonOperations.html" title="interface in org.omg.DynamicAny">DynValueCommonOperations</a></pre>
<div class="block">
<span>DynValue对象支持IDL非盒装值类型的操作。</span>
<span>DynValue接口可以表示null和非null值类型。</span>
<span>对于表示非空值类型的DynValueDynValue的组件按照定义的顺序包含值类型的公有成员和私有成员包括从具体基类型继承的类型。</span>
<span>表示空值类型的DynValue没有组件当前位置为-1。</span>
<p> <span>警告:不加区别地改变私有价值类型成员的内容可能导致价值类型实现通过违反内部约束而中断。</span> <span>提供访问私有成员以支持ORB桥接和调试等活动不应被用来任意违反价值类型的封装。</span> </p>
</div> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ========== 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><a href="../../../org/omg/CORBA/TCKind.html" title="class in org.omg.CORBA">TCKind</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/DynamicAny/DynValueOperations.html#current_member_kind--">current_member_kind</a></span>()</code>
<div class="block">
返回与当前位置的成员关联的TCKind。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><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/DynamicAny/DynValueOperations.html#current_member_name--">current_member_name</a></span>()</code>
<div class="block">
返回当前位置的成员名称。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../org/omg/DynamicAny/NameDynAnyPair.html" title="class in org.omg.DynamicAny">NameDynAnyPair</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/DynamicAny/DynValueOperations.html#get_members_as_dyn_any--">get_members_as_dyn_any</a></span>()</code>
<div class="block">
返回一个NameDynAnyPairs序列描述值类型中每个成员的名称和值。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../org/omg/DynamicAny/NameValuePair.html" title="class in org.omg.DynamicAny">NameValuePair</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/DynamicAny/DynValueOperations.html#get_members--">get_members</a></span>()</code>
<div class="block">
返回一个NameValuePairs序列描述值类型中每个成员的名称和值。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/DynamicAny/DynValueOperations.html#set_members_as_dyn_any-org.omg.DynamicAny.NameDynAnyPair:A-">set_members_as_dyn_any</a></span>(<a href="../../../org/omg/DynamicAny/NameDynAnyPair.html" title="class in org.omg.DynamicAny">NameDynAnyPair</a>[] value)</code>
<div class="block">
从NameDynAnyPairs序列初始化值类型的成员。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/DynamicAny/DynValueOperations.html#set_members-org.omg.DynamicAny.NameValuePair:A-">set_members</a></span>(<a href="../../../org/omg/DynamicAny/NameValuePair.html" title="class in org.omg.DynamicAny">NameValuePair</a>[] value)</code>
<div class="block">
从NameValuePairs序列初始化值类型的成员。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.omg.DynamicAny.DynValueCommonOperations">
<!-- --> </a> <h3>Methods inherited from interface org.omg.DynamicAny.<a href="../../../org/omg/DynamicAny/DynValueCommonOperations.html" title="interface in org.omg.DynamicAny">DynValueCommonOperations</a></h3> <code><a href="../../../org/omg/DynamicAny/DynValueCommonOperations.html#is_null--">is_null</a>, <a href="../../../org/omg/DynamicAny/DynValueCommonOperations.html#set_to_null--">set_to_null</a>, <a href="../../../org/omg/DynamicAny/DynValueCommonOperations.html#set_to_value--">set_to_value</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.omg.DynamicAny.DynAnyOperations">
<!-- --> </a> <h3>Methods inherited from interface org.omg.DynamicAny.<a href="../../../org/omg/DynamicAny/DynAnyOperations.html" title="interface in org.omg.DynamicAny">DynAnyOperations</a></h3> <code><a href="../../../org/omg/DynamicAny/DynAnyOperations.html#assign-org.omg.DynamicAny.DynAny-">assign</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#component_count--">component_count</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#copy--">copy</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#current_component--">current_component</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#destroy--">destroy</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#equal-org.omg.DynamicAny.DynAny-">equal</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#from_any-org.omg.CORBA.Any-">from_any</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_any--">get_any</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_boolean--">get_boolean</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_char--">get_char</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_double--">get_double</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_dyn_any--">get_dyn_any</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_float--">get_float</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_long--">get_long</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_longlong--">get_longlong</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_octet--">get_octet</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_reference--">get_reference</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_short--">get_short</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_string--">get_string</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_typecode--">get_typecode</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_ulong--">get_ulong</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_ulonglong--">get_ulonglong</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_ushort--">get_ushort</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_val--">get_val</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_wchar--">get_wchar</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#get_wstring--">get_wstring</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_any-org.omg.CORBA.Any-">insert_any</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_boolean-boolean-">insert_boolean</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_char-char-">insert_char</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_double-double-">insert_double</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_dyn_any-org.omg.DynamicAny.DynAny-">insert_dyn_any</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_float-float-">insert_float</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_long-int-">insert_long</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_longlong-long-">insert_longlong</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_octet-byte-">insert_octet</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_reference-org.omg.CORBA.Object-">insert_reference</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_short-short-">insert_short</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_string-java.lang.String-">insert_string</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_typecode-org.omg.CORBA.TypeCode-">insert_typecode</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_ulong-int-">insert_ulong</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_ulonglong-long-">insert_ulonglong</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_ushort-short-">insert_ushort</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_val-java.io.Serializable-">insert_val</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_wchar-char-">insert_wchar</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#insert_wstring-java.lang.String-">insert_wstring</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#next--">next</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#rewind--">rewind</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#seek-int-">seek</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#to_any--">to_any</a>, <a href="../../../org/omg/DynamicAny/DynAnyOperations.html#type--">type</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="current_member_name--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>current_member_name</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> current_member_name()
throws <a href="../../../org/omg/DynamicAny/DynAnyPackage/TypeMismatch.html" title="class in org.omg.DynamicAny.DynAnyPackage">TypeMismatch</a>,
<a href="../../../org/omg/DynamicAny/DynAnyPackage/InvalidValue.html" title="class in org.omg.DynamicAny.DynAnyPackage">InvalidValue</a></pre>
<div class="block">
<span>返回当前位置的成员名称。</span>
<span>此操作可能返回一个空字符串因为被操作的值的TypeCode可能不包含成员的名称。</span>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>TypeMismatch</code> - 如果DynValue表示空值类型。
</dd>
<dd>
<code>InvalidValue</code> - 如果当前位置不表示会员
</dd>
</dl> </li>
</ul> <a name="current_member_kind--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>current_member_kind</h4> <pre><a href="../../../org/omg/CORBA/TCKind.html" title="class in org.omg.CORBA">TCKind</a> current_member_kind()
throws <a href="../../../org/omg/DynamicAny/DynAnyPackage/TypeMismatch.html" title="class in org.omg.DynamicAny.DynAnyPackage">TypeMismatch</a>,
<a href="../../../org/omg/DynamicAny/DynAnyPackage/InvalidValue.html" title="class in org.omg.DynamicAny.DynAnyPackage">InvalidValue</a></pre>
<div class="block">
返回与当前位置的成员关联的TCKind。
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>TypeMismatch</code> - 如果DynValue表示空值类型。
</dd>
<dd>
<code>InvalidValue</code> - 如果当前位置不表示成员
</dd>
</dl> </li>
</ul> <a name="get_members--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>get_members</h4> <pre><a href="../../../org/omg/DynamicAny/NameValuePair.html" title="class in org.omg.DynamicAny">NameValuePair</a>[] get_members()
throws <a href="../../../org/omg/DynamicAny/DynAnyPackage/InvalidValue.html" title="class in org.omg.DynamicAny.DynAnyPackage">InvalidValue</a></pre>
<div class="block">
<span>返回一个NameValuePairs序列描述值类型中每个成员的名称和值。</span>
<span>该序列包含与DynValue的TypeCode所指示的成员的声明顺序相同的成员。</span>
<span>当前位置不受影响。</span>
<span>如果DynValue的TypeCode不包含成员名称则返回的序列中的成员名称将为空字符串。</span>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>InvalidValue</code> - 如果此对象表示空值类型
</dd>
</dl> </li>
</ul> <a name="set_members-org.omg.DynamicAny.NameValuePair:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>set_members</h4> <pre>void set_members(<a href="../../../org/omg/DynamicAny/NameValuePair.html" title="class in org.omg.DynamicAny">NameValuePair</a>[] value)
throws <a href="../../../org/omg/DynamicAny/DynAnyPackage/TypeMismatch.html" title="class in org.omg.DynamicAny.DynAnyPackage">TypeMismatch</a>,
<a href="../../../org/omg/DynamicAny/DynAnyPackage/InvalidValue.html" title="class in org.omg.DynamicAny.DynAnyPackage">InvalidValue</a></pre>
<div class="block">
<span>从NameValuePairs序列初始化值类型的成员。</span>
<span>如果传递的序列具有非零长度,则操作将当前位置设置为零。</span>
<span>否则,如果通过一个空序列,当前位置被设置为-1。</span>
<span>可以使用此方法将空值类型初始化为非空值类型。</span>
<p> <span>成员必须按照DynValue的TypeCode所指示的值类型的IDL规范显示的顺序出现在NameValuePairs中或者它们必须是空字符串。</span> <span>该操作不会尝试基于成员名称分配成员值。</span> </p>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>TypeMismatch</code> - 如果传递的序列中提供的成员名称与DynValue的TypeCode中的对应成员名称不匹配并且它们不是空字符串
</dd>
<dd>
<code>InvalidValue</code> - 如果传递的序列具有与DynValue的TypeCode所指示的成员数不一致的元素数
</dd>
</dl> </li>
</ul> <a name="get_members_as_dyn_any--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>get_members_as_dyn_any</h4> <pre><a href="../../../org/omg/DynamicAny/NameDynAnyPair.html" title="class in org.omg.DynamicAny">NameDynAnyPair</a>[] get_members_as_dyn_any()
throws <a href="../../../org/omg/DynamicAny/DynAnyPackage/InvalidValue.html" title="class in org.omg.DynamicAny.DynAnyPackage">InvalidValue</a></pre>
<div class="block">
<span>返回一个NameDynAnyPairs序列描述值类型中每个成员的名称和值。</span>
<span>该序列包含与DynValue的TypeCode所指示的成员的声明顺序相同的成员。</span>
<span>当前位置不受影响。</span>
<span>如果DynValue的TypeCode不包含成员名称则返回的序列中的成员名称将为空字符串。</span>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>InvalidValue</code> - 如果此对象表示空值类型
</dd>
</dl> </li>
</ul> <a name="set_members_as_dyn_any-org.omg.DynamicAny.NameDynAnyPair:A-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>set_members_as_dyn_any</h4> <pre>void set_members_as_dyn_any(<a href="../../../org/omg/DynamicAny/NameDynAnyPair.html" title="class in org.omg.DynamicAny">NameDynAnyPair</a>[] value)
throws <a href="../../../org/omg/DynamicAny/DynAnyPackage/TypeMismatch.html" title="class in org.omg.DynamicAny.DynAnyPackage">TypeMismatch</a>,
<a href="../../../org/omg/DynamicAny/DynAnyPackage/InvalidValue.html" title="class in org.omg.DynamicAny.DynAnyPackage">InvalidValue</a></pre>
<div class="block">
<span>从NameDynAnyPairs序列初始化值类型的成员。</span>
<span>如果传递的序列具有非零长度,则操作将当前位置设置为零。</span>
<span>否则,如果通过一个空序列,当前位置被设置为-1。</span>
<span>可以使用此方法将空值类型初始化为非空值类型。</span>
<p> <span>成员必须按照DynValue的TypeCode所指示的值类型的IDL规范出现的顺序出现在NameDynAnyPairs中或者它们必须是空字符串。</span> <span>该操作不会尝试基于成员名称分配成员值。</span> </p>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>TypeMismatch</code> - 如果传递的序列中提供的成员名称与DynValue的TypeCode中的相应成员名称不匹配并且它们不为空字符串
</dd>
<dd>
<code>InvalidValue</code> - 如果传递的序列有许多与DynValue的TypeCode所指示的成员数不符的元素
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>