861 lines
45 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">
compact3
</div>
<div class="subTitle">
javax.sql.rowset.serial
</div>
<h2 class="title" title="Class SerialArray">Class SerialArray</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>javax.sql.rowset.serial.SerialArray</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Implemented Interfaces:
</dt>
<dd>
<span><a href="../../../../java/io/Serializable.html" title="java.io中的接口">Serializable</a> <a href="../../../../java/lang/Cloneable.html" title="java.lang中的接口">Cloneable</a> <a href="../../../../java/sql/Array.html" title="java.sql中的接口">Array</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">SerialArray</span>
extends <a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a>
implements <a href="../../../../java/sql/Array.html" title="interface in java.sql">Array</a>, <a href="../../../../java/io/Serializable.html" title="interface in java.io">Serializable</a>, <a href="../../../../java/lang/Cloneable.html" title="interface in java.lang">Cloneable</a></pre>
<div class="block">
<span><code>Array</code>对象的序列化版本它是Java编程语言中的SQL <code>ARRAY</code>值的映射。</span>
<p> <span><code>SerialArray</code>类提供了一个构造函数,用于从<code>Array</code>对象创建一个<code>SerialArray</code>实例获取基类型的基本类型和SQL名称的方法以及复制<code>SerialArray</code>对象全部或部分的方法。</span> </p>
<p> <span>注意为了使此类正常运行必须连接数据源才能使SQL <code>Array</code>对象实现(如果需要,将其所有元素都带到客户端服务器)。</span> <span>此时,当前不支持对数据源中的数据(如定位器)的逻辑指针。</span> </p>
<h3> <span>线程安全</span> </h3>
<span>SerialArray不能安全地被多个并发线程使用。</span>
<span>如果一个SerialArray由多个线程使用则应通过适当的同步来控制对SerialArray的访问。</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../../serialized-form.html#javax.sql.rowset.serial.SerialArray">Serialized Form</a>
</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="../../../../javax/sql/rowset/serial/SerialArray.html#SerialArray-java.sql.Array-">SerialArray</a></span>(<a href="../../../../java/sql/Array.html" title="interface in java.sql">Array</a> array)</code>
<div class="block">
构造一个新
<code>SerialArray</code>从给定对象
<code>Array</code>对象。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialArray.html#SerialArray-java.sql.Array-java.util.Map-">SerialArray</a></span>(<a href="../../../../java/sql/Array.html" title="interface in java.sql">Array</a> array, <a href="../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../java/lang/String.html" title="class in java.lang">String</a>,<a href="../../../../java/lang/Class.html" title="class in java.lang"></a>&lt;?&gt;&gt; map)</code>
<div class="block">
从给定的
<code>Array</code>对象构造一个新的
<code>SerialArray</code>对象当元素为SQL UDT时使用给定的类型映射来定制每个元素的映射。
</div> </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="t4"><span><a href="javascript:show(8);">具体的方法</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="../../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialArray.html#clone--">clone</a></span>()</code>
<div class="block">
返回此
<code>SerialArray</code>的克隆。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialArray.html#equals-java.lang.Object-">equals</a></span>(<a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a> obj)</code>
<div class="block">
将此SerialArray与指定的对象进行比较。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialArray.html#free--">free</a></span>()</code>
<div class="block">
该方法可以释放
<code>SeriableArray</code>对象并释放它所拥有的资源。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialArray.html#getArray--">getArray</a></span>()</code>
<div class="block">
返回一个新数组,该数组是该
<code>SerialArray</code>对象的副本。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialArray.html#getArray-long-int-">getArray</a></span>(long index, int count)</code>
<div class="block">
返回一个新数组,该数组是该
<code>SerialArray</code>对象的一个片段的副本,从给定索引处的元素开始,并包含给定数量的连续元素。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialArray.html#getArray-long-int-java.util.Map-">getArray</a></span>(long index, int count, <a href="../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../java/lang/String.html" title="class in java.lang">String</a>,<a href="../../../../java/lang/Class.html" title="class in java.lang"></a>&lt;?&gt;&gt; map)</code>
<div class="block">
返回一个新数组,它是此
<code>SerialArray</code>对象的一个片段的副本,从给定索引处的元素开始,并包含给定数量的连续元素。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialArray.html#getArray-java.util.Map-">getArray</a></span>(<a href="../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../java/lang/String.html" title="class in java.lang">String</a>,<a href="../../../../java/lang/Class.html" title="class in java.lang"></a>&lt;?&gt;&gt; map)</code>
<div class="block">
返回一个新数组,该数组是该
<code>SerialArray</code>对象的副本当元素为SQL UDT时使用给定的类型映射来为每个元素的自定义映射。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialArray.html#getBaseType--">getBaseType</a></span>()</code>
<div class="block">
检索此
<code>SerialArray</code>对象中的元素的SQL类型。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<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="../../../../javax/sql/rowset/serial/SerialArray.html#getBaseTypeName--">getBaseTypeName</a></span>()</code>
<div class="block">
检索此
<code>SerialArray</code>对象中元素的DBMS特定类型名称。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code><a href="../../../../java/sql/ResultSet.html" title="interface in java.sql">ResultSet</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialArray.html#getResultSet--">getResultSet</a></span>()</code>
<div class="block">
检索一个
<code>ResultSet</code>对象,该对象包含该
<code>SerialArray</code>对象所代表的
<code>ARRAY</code>值中的所有元素。
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code><a href="../../../../java/sql/ResultSet.html" title="interface in java.sql">ResultSet</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialArray.html#getResultSet-long-int-">getResultSet</a></span>(long index, int count)</code>
<div class="block">
检索保存从索引
<i>索引</i>开始的子阵列的元素的
<code>ResultSet</code>对象,并包含最多
<i>计数</i>连续的元素。
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code><a href="../../../../java/sql/ResultSet.html" title="interface in java.sql">ResultSet</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialArray.html#getResultSet-long-int-java.util.Map-">getResultSet</a></span>(long index, int count, <a href="../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../java/lang/String.html" title="class in java.lang">String</a>,<a href="../../../../java/lang/Class.html" title="class in java.lang"></a>&lt;?&gt;&gt; map)</code>
<div class="block">
检索设置保持其开始于检索所述子阵列的元素的结果
<code>ResultSet</code>对象,其中包含在该元件的子阵列
<code>SerialArray</code>对象,开始于索引
<i>指数</i>和包含
<i>count</i>个连续元素。
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code><a href="../../../../java/sql/ResultSet.html" title="interface in java.sql">ResultSet</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialArray.html#getResultSet-java.util.Map-">getResultSet</a></span>(<a href="../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../java/lang/String.html" title="class in java.lang">String</a>,<a href="../../../../java/lang/Class.html" title="class in java.lang"></a>&lt;?&gt;&gt; map)</code>
<div class="block">
检索
<code>ResultSet</code>对象它包含所有的SQL的元件的
<code>ARRAY</code>由该表示值
<code>SerialArray</code>对象。
</div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialArray.html#hashCode--">hashCode</a></span>()</code>
<div class="block">
返回此SerialArray的哈希码。
</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#finalize--">finalize</a>, <a href="../../../../java/lang/Object.html#getClass--">getClass</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="SerialArray-java.sql.Array-java.util.Map-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>SerialArray</h4> <pre>public SerialArray(<a href="../../../../java/sql/Array.html" title="interface in java.sql">Array</a> array,
<a href="../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../java/lang/String.html" title="class in java.lang">String</a>,<a href="../../../../java/lang/Class.html" title="class in java.lang"></a>&lt;?&gt;&gt; map)
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a>,
<a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></pre>
<div class="block">
<span>从给定的<code>Array</code>对象构造一个新的<code>SerialArray</code>对象当元素是SQL UDT时使用给定的类型映射来定义每个元素的映射。</span>
<p> <span>如果数组元素是UDT并且给定的类型映射具有该UDT的条目则此方法将执行自定义映射。</span> <span>自定义映射是递归的这意味着如果例如SQL结构化类型的元素是SQL结构类型其本身具有作为SQL结构类型的元素那么具有自定义映射的每个结构化类型将根据给定类型地图。</span> </p>
<p> <span><code>SerialArray</code>对象包含相同的元素, <code>Array</code>从其中它是建立除非当基类型是SQL类型对象<code>STRUCT</code> <code>ARRAY</code> <code>BLOB</code> <code>CLOB</code> <code>DATALINK</code><code>JAVA_OBJECT</code></span> <span>在这种情况下,在新的每一个元素<code>SerialArray</code>目的是适当的串行化的形式,即, <code>SerialStruct</code> <code>SerialArray</code> <code>SerialBlob</code> <code>SerialClob</code> <code>SerialDatalink</code> ,或<code>SerialJavaObject</code>对象。</span> </p>
<p> <span>1 <code>Array</code>从一个对象<code>SerialArray</code>创建对象必须已经在SQL <code>ARRAY</code>它传递给构造之前在客户端上值的数据。</span> <span>否则,新的<code>SerialArray</code>对象将不包含任何数据。</span> </p>
<p> <span>注意2如果<code>Array</code>包含<code>java.sql.Types.JAVA_OBJECT</code>类型,则<code>SerialJavaObject</code> SerialJavaObject构造函数以确保此对象可串行化。</span> </p>
<p> <span>注意3提供给此构造函数的<code>Array</code>对象不能为任何<code>Array.getArray()</code>方法返回<code>null</code></span> <span><code>SerialArray</code>无法序列化空数组值。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>array</code> - 要
<code>Array</code>对象
</dd>
<dd>
<span><code>map</code> -一个<code>java.util.Map</code>对象其中每个条目包含1一个<code>String</code>对象给出UDTSQL结构类型或不同类型和2所述的完全合格的名称<code></code>对象为<code>SQLData</code>执行定义UDT是如何被映射。</span>
<span><i>地图</i>参数没有任何效果<code>Blob</code> <code>Clob</code> <code>DATALINK</code> ,或<code>JAVA_OBJECT</code>类型。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></code> - 如果序列化
<code>Array</code>对象发生错误
</dd>
<dd>
<code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 如果发生数据库访问错误或
<i>数组</i>
<i>映射</i>值为
<code>null</code>
</dd>
</dl> </li>
</ul> <a name="SerialArray-java.sql.Array-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>SerialArray</h4> <pre>public SerialArray(<a href="../../../../java/sql/Array.html" title="interface in java.sql">Array</a> array)
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a>,
<a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></pre>
<div class="block">
<span>构造一个新<code>SerialArray</code>从给定对象<code>Array</code>对象。</span>
<p> <span>此构造函数不执行自定义映射。</span> <span>如果阵列的基本类型是SQL结构类型并且需要自定义映射则应使用构造<code>SerialArray(Array array, Map map)</code></span> </p>
<p> <span><code>SerialArray</code>对象包含相同的元素, <code>Array</code>从其中它是建立除非当基类型是SQL类型对象<code>BLOB</code> <code>CLOB</code> <code>DATALINK</code><code>JAVA_OBJECT</code></span> <span>在这种情况下,在新的每一个元素<code>SerialArray</code>目的是适当的串行化的形式,即, <code>SerialBlob</code> <code>SerialClob</code> <code>SerialDatalink</code> ,或<code>SerialJavaObject</code>对象。</span> </p>
<p> <span>1 <code>Array</code>从一个对象<code>SerialArray</code>创建对象必须已经在SQL <code>ARRAY</code>它传递给构造之前在客户端上值的数据。</span> <span>否则,新的<code>SerialArray</code>对象将不包含任何数据。</span> </p>
<p> <span>注意2提供给此构造函数的<code>Array</code>对象不能为任何<code>Array.getArray()</code>方法返回<code>null</code></span> <span><code>SerialArray</code>无法序列化<code>null</code>数组值。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>array</code> - 要
<code>Array</code>对象
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></code> - 如果串行化
<code>Array</code>对象发生错误
</dd>
<dd>
<code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 如果发生数据库访问错误或
<i>数组</i>参数为
<code>null</code>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="free--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>free</h4> <pre>public void free()
throws <a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></pre>
<div class="block">
<span>此方法可以释放<code>SeriableArray</code>对象并释放其拥有的资源。</span>
<span>调用<code>free</code>方法后,该对象无效。</span>
<p> <span>如果<code>free</code>被多次调用,则后续调用<code>free</code>被视为无操作。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Array.html#free--">free</a></code>在界面
<code><a href="../../../../java/sql/Array.html" title="interface in java.sql">Array</a></code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 如果发布错误发生SerialArray的资源
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.6
</dd>
</dl> </li>
</ul> <a name="getArray--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getArray</h4> <pre>public <a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a> getArray()
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></pre>
<div class="block">
返回一个新数组,该数组是此
<code>SerialArray</code>对象的副本。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Array.html#getArray--">getArray</a></code>在界面
<code><a href="../../../../java/sql/Array.html" title="interface in java.sql">Array</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
这个副本
<code>SerialArray</code>对象为
<code>Object</code> Java编程语言
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></code> - 如果发生错误;</span>
<span>如果<code>free</code>以前已经被调用了这个对象</span>
</dd>
</dl> </li>
</ul> <a name="getArray-java.util.Map-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getArray</h4> <pre>public <a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a> getArray(<a href="../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../java/lang/String.html" title="class in java.lang">String</a>,<a href="../../../../java/lang/Class.html" title="class in java.lang"></a>&lt;?&gt;&gt; map)
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></pre>
<div class="block">
<span>返回一个新数组,该数组是该<code>SerialArray</code>对象的副本当元素为SQL UDT时使用给定的类型映射表示每个元素的自定义映射。</span>
<p> <span>如果数组元素是UDT并且给定的类型映射具有该UDT的条目则此方法将执行自定义映射。</span> <span>自定义映射是递归的这意味着如果例如SQL结构化类型的元素是SQL结构类型其本身具有作为SQL结构类型的元素那么具有自定义映射的每个结构化类型将根据给定类型地图。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Array.html#getArray-java.util.Map-">getArray</a></code>在界面
<code><a href="../../../../java/sql/Array.html" title="interface in java.sql">Array</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>map</code> - 一个
<code>java.util.Map</code>对象其中每个条目由1
<code>String</code>对象提供UDT的完全限定名称2
<code></code>实现的
<code>SQLData</code>对象定义如何映射UDT
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
这个副本
<code>SerialArray</code>对象为
<code>Object</code> Java编程语言
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></code> - 如果发生错误;</span>
<span>如果<code>free</code>以前已经被调用了这个对象</span>
</dd>
</dl> </li>
</ul> <a name="getArray-long-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getArray</h4> <pre>public <a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a> getArray(long index,
int count)
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></pre>
<div class="block">
返回一个新数组,它是此
<code>SerialArray</code>对象的一个片段的副本,从给定索引处的元素开始,并包含给定数量的连续元素。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Array.html#getArray-long-int-">getArray</a></code>在界面
<code><a href="../../../../java/sql/Array.html" title="interface in java.sql">Array</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>index</code> - 要复制的第一个元素的索引到这个<code>SerialArray</code>对象;</span>
<span>第一个元素的索引是<code>0</code></span>
</dd>
<dd>
<code>count</code> - 从给定索引开始的要复制的连续元素的数量
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
在这个指定的元素的副本
<code>SerialArray</code>对象为
<code>Object</code> Java编程语言
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></code> - 如果发生错误;</span>
<span>如果<code>free</code>以前已经被调用了这个对象</span>
</dd>
</dl> </li>
</ul> <a name="getArray-long-int-java.util.Map-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getArray</h4> <pre>public <a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a> getArray(long index,
int count,
<a href="../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../java/lang/String.html" title="class in java.lang">String</a>,<a href="../../../../java/lang/Class.html" title="class in java.lang"></a>&lt;?&gt;&gt; map)
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></pre>
<div class="block">
<span>返回一个新数组,该数组是此<code>SerialArray</code>对象的一个片段的副本,从给定索引处的元素开始,并包含给定数量的连续元素。</span>
<p> <span>如果数组元素是UDT并且给定的类型映射具有该UDT的条目则此方法将执行自定义映射。</span> <span>自定义映射是递归的这意味着如果例如SQL结构化类型的元素是SQL结构类型其本身具有作为SQL结构类型的元素那么具有自定义映射的每个结构化类型将根据给定类型地图。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Array.html#getArray-long-int-java.util.Map-">getArray</a></code>在界面
<code><a href="../../../../java/sql/Array.html" title="interface in java.sql">Array</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>index</code> - 要复制的第一个元素的这个<code>SerialArray</code>对象的索引;</span>
<span>数组中第一个元素的索引为<code>0</code></span>
</dd>
<dd>
<code>count</code> - 从给定索引开始的要复制的连续元素的数量
</dd>
<dd>
<code>map</code> - 一个
<code>java.util.Map</code>对象其中每个条目由1提供UDT的完全限定名称的
<code>String</code>对象组成2
<code></code>实现的
<code>SQLData</code>对象该对象定义如何映射UDT
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
在这个指定的元素的副本
<code>SerialArray</code>对象为
<code>Object</code> Java编程语言
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></code> - 如果发生错误;</span>
<span>如果<code>free</code>以前已经被调用了这个对象</span>
</dd>
</dl> </li>
</ul> <a name="getBaseType--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getBaseType</h4> <pre>public int getBaseType()
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></pre>
<div class="block">
<span>检索此<code>SerialArray</code>对象中的元素的SQL类型。</span>
<span><code>int</code>返回的是java.sql.Types类中的<code>java.sql.Types</code></span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Array.html#getBaseType--">getBaseType</a></code>在界面
<code><a href="../../../../java/sql/Array.html" title="interface in java.sql">Array</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
java.sql.Types中的一个
<code>java.sql.Types</code> ,表示这个
<code>SerialArray</code>对象中的元素的SQL类型
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></code> - 如果发生错误;</span>
<span>如果<code>free</code>以前曾被调用此对象</span>
</dd>
</dl> </li>
</ul> <a name="getBaseTypeName--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getBaseTypeName</h4> <pre>public <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> getBaseTypeName()
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></pre>
<div class="block">
检索此
<code>SerialArray</code>对象中元素的DBMS特定类型名称。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Array.html#getBaseTypeName--">getBaseTypeName</a></code>在界面
<code><a href="../../../../java/sql/Array.html" title="interface in java.sql">Array</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
DBMS为此
<code>SerialArray</code>对象的基本类型使用的SQL类型名称
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></code> - 如果发生错误;</span>
<span>如果<code>free</code>以前已经被调用了这个对象</span>
</dd>
</dl> </li>
</ul> <a name="getResultSet-long-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getResultSet</h4> <pre>public <a href="../../../../java/sql/ResultSet.html" title="interface in java.sql">ResultSet</a> getResultSet(long index,
int count)
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></pre>
<div class="block">
<span>检索保存从索引<i>索引</i>开始的子阵列的元素的<code>ResultSet</code>对象,并包含最多<i>计数</i>连续元素。</span>
<span>如果地图包含基本类型的条目,则此方法使用连接的类型映射来映射数组的元素。</span>
<span>否则,使用标准映射。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Array.html#getResultSet-long-int-">getResultSet</a></code>在界面
<code><a href="../../../../java/sql/Array.html" title="interface in java.sql">Array</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>index</code> - 要复制的第一个元素的这个<code>SerialArray</code>对象的索引;</span>
<span>数组中第一个元素的索引为<code>0</code></span>
</dd>
<dd>
<code>count</code> - 从给定索引开始的要复制的连续元素的数量
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>ResultSet</code>对象,包含此
<code>SerialArray</code>对象中的指定元素,每个元素分别有一行
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></code> - 如果调用原因设置为
<code>UnsupportedOperationException</code>
</dd>
</dl> </li>
</ul> <a name="getResultSet-java.util.Map-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getResultSet</h4> <pre>public <a href="../../../../java/sql/ResultSet.html" title="interface in java.sql">ResultSet</a> getResultSet(<a href="../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../java/lang/String.html" title="class in java.lang">String</a>,<a href="../../../../java/lang/Class.html" title="class in java.lang"></a>&lt;?&gt;&gt; map)
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></pre>
<div class="block">
<span>检索<code>ResultSet</code>对象它包含所有的SQL的元件的<code>ARRAY</code>由该表示值<code>SerialArray</code>对象。</span>
<span>这种方法使用了类型映射自定义指定映射除非数组的基本类型不匹配在<i>地图</i>上用户定义的类型UDT在这种情况下它使用标准映射。</span>
<span>方法<code>getResultSet</code>此版本使用给定类型映射或标准映射;</span>
<span>它从不使用与连接相关联的类型映射。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Array.html#getResultSet-java.util.Map-">getResultSet</a></code>在界面
<code><a href="../../../../java/sql/Array.html" title="interface in java.sql">Array</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>map</code> - 一个
<code>java.util.Map</code>对象其中每个条目由1提供UDT的完全限定名称的
<code>String</code>对象组成2用于定义UDT如何映射的
<code>SQLData</code>实现的
<code></code>对象
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>ResultSet</code>对象,包含此
<code>SerialArray</code>对象中的所有元素,每个元素都有一个单独的行
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></code> - 如果调用原因设置为
<code>UnsupportedOperationException</code>
</dd>
</dl> </li>
</ul> <a name="getResultSet--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getResultSet</h4> <pre>public <a href="../../../../java/sql/ResultSet.html" title="interface in java.sql">ResultSet</a> getResultSet()
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></pre>
<div class="block">
<span>检索<code>ResultSet</code>对象,该对象包含该<code>SerialArray</code>对象所代表的<code>ARRAY</code>值中的所有元素。</span>
<span>如果适当,使用连接的类型映射映射数组的元素;</span>
<span>否则,使用标准映射。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Array.html#getResultSet--">getResultSet</a></code>在界面
<code><a href="../../../../java/sql/Array.html" title="interface in java.sql">Array</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>ResultSet</code>对象,包含此
<code>SerialArray</code>对象中的所有元素,每个元素都有一个单独的行
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></code> - 如果调用原因设置为
<code>UnsupportedOperationException</code>
</dd>
</dl> </li>
</ul> <a name="getResultSet-long-int-java.util.Map-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getResultSet</h4> <pre>public <a href="../../../../java/sql/ResultSet.html" title="interface in java.sql">ResultSet</a> getResultSet(long index,
int count,
<a href="../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../java/lang/String.html" title="class in java.lang">String</a>,<a href="../../../../java/lang/Class.html" title="class in java.lang"></a>&lt;?&gt;&gt; map)
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></pre>
<div class="block">
<span>检索一个结果集,其中保存元素的起始于检索<code>ResultSet</code>对象,该对象包含此<code>SerialArray</code>对象中的元素的子阵列,从索引<i>索引</i>开始,并包含最多<i>计数</i>连续元素。</span>
<span>这种方法使用了类型映射自定义指定映射除非数组的基本类型不匹配在<i>地图</i>上用户定义的类型UDT在这种情况下它使用标准映射。</span>
<span>方法<code>getResultSet</code>此版本使用给定类型映射或标准映射;</span>
<span>它从不使用与连接相关联的类型映射。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Array.html#getResultSet-long-int-java.util.Map-">getResultSet</a></code>在界面
<code><a href="../../../../java/sql/Array.html" title="interface in java.sql">Array</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>index</code> - 要复制的第一个元素的这个<code>SerialArray</code>对象的索引;</span>
<span>数组中第一个元素的索引为<code>0</code></span>
</dd>
<dd>
<code>count</code> - 从给定索引开始的要复制的连续元素的数量
</dd>
<dd>
<code>map</code> - 一个
<code>java.util.Map</code>对象其中每个条目由1
<code>String</code>对象提供UDT的完全限定名称2
<code></code>实现的
<code>SQLData</code>对象定义如何映射UDT
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>ResultSet</code>
<code>SerialArray</code>对象中指定元素的
<code>SerialArray</code>对象,每个元素分别有一行
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></code> - 如果调用原因设置为
<code>UnsupportedOperationException</code>
</dd>
</dl> </li>
</ul> <a name="equals-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>equals</h4> <pre>public boolean equals(<a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a> obj)</pre>
<div class="block">
<span>将此SerialArray与指定的对象进行比较。</span>
<span>结果是<code>true</code>当且仅当参数不是<code>null</code>并且是一个<code>SerialArray</code>对象的元素是相同的这个对象的元素</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写:</span>
</dt>
<dd>
<code><a href="../../../../java/lang/Object.html#equals-java.lang.Object-">equals</a></code>
<code><a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>obj</code> - 对比这个
<code>SerialArray</code>的对象
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果给定的对象表示
<code>SerialArray</code>相当于此SerialArray
<code>false</code>否则
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../../java/lang/Object.html#hashCode--"><code>Object.hashCode()</code></a> <a href="../../../../java/util/HashMap.html" title="java.util中的类"><code>HashMap</code></a></span>
</dd>
</dl> </li>
</ul> <a name="hashCode--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>hashCode</h4> <pre>public int hashCode()</pre>
<div class="block">
<span>返回此SerialArray的哈希码。</span>
<span>要的哈希码<code>SerialArray</code>对象使用的元素的哈希码计算<code>SerialArray</code>对象</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写:</span>
</dt>
<dd>
<code><a href="../../../../java/lang/Object.html#hashCode--">hashCode</a></code>在类别
<code><a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
该对象的哈希码值。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../../java/lang/Object.html#equals-java.lang.Object-"><code>Object.equals(java.lang.Object)</code></a>
<a href="../../../../java/lang/System.html#identityHashCode-java.lang.Object-"><code>System.identityHashCode(java.lang.Object)</code></a>
</dd>
</dl> </li>
</ul> <a name="clone--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>clone</h4> <pre>public <a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a> clone()</pre>
<div class="block">
<span>返回此<code>SerialArray</code>的克隆。</span>
<span>该副本将包含对底层对象数组的克隆的引用,而不是对此<code>SerialArray</code>对象的原始底层对象数组的引用。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写:</span>
</dt>
<dd>
<code><a href="../../../../java/lang/Object.html#clone--">clone</a></code>在类别
<code><a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
这个SerialArray的一个克隆
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../../java/lang/Cloneable.html" title="interface in java.lang"><code>Cloneable</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>