study/uTools-Manuals
1
0
Fork 0
mirror of https://github.com/fofolee/uTools-Manuals.git synced 2025-07-06 09:02:49 +08:00
Code Issues Packages Projects Releases Wiki Activity
uTools-Manuals/docs/java/javax/sql/rowset/serial/SerialClob.html

1029 lines
46 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 SerialClob">Class SerialClob</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.SerialClob</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/Clob.html" title="java.sql中的接口">Clob</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">SerialClob</span>
extends <a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a>
implements <a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</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>在Java编程语言中的序列化映射为SQL <code>CLOB</code>值。</span>
<p> <span><code>SerialClob</code>类提供了一个用于从<code>Clob</code>对象创建实例的<code>Clob</code>函数。</span> <span>请注意， <code>Clob</code>对象应该在将<code>SerialClob</code>对象从其构造之前将SQL <code>CLOB</code>的数据带到客户端。</span> <span>SQL <code>CLOB</code>值的数据可以作为Unicode字符流在客户端上实现。</span> </p>
<p> <span><code>SerialClob</code>方法使得可以从<code>SerialClob</code>对象获取子<code>SerialClob</code>或找到字符模式的开始。</span> </p>
<h3> <span>线程安全</span> </h3>
<p> <span>SerialClob不能安全地被多个并发线程使用。</span> <span>如果一个SerialClob要由多个线程使用，则应该通过适当的同步来控制对SerialClob的访问。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../serialized-form.html#javax.sql.rowset.serial.SerialClob">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/SerialClob.html#SerialClob-char:A-">SerialClob</a></span>(char[] ch)</code>
<div class="block">
构造一个
<code>SerialClob</code>对象，它是给定的
<code>char</code>数组的序列化版本。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialClob.html#SerialClob-java.sql.Clob-">SerialClob</a></span>(<a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</a> clob)</code>
<div class="block">
构造一个
<code>SerialClob</code>对象，它是给定的
<code>Clob</code>对象的序列化版本。
</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/SerialClob.html#clone--">clone</a></span>()</code>
<div class="block">
返回此
<code>SerialClob</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/SerialClob.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">
将此SerialClob与指定对象进行比较。
</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/SerialClob.html#free--">free</a></span>()</code>
<div class="block">
此方法可以释放
<code>SeriableClob</code>对象并释放它所拥有的资源。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../../java/io/InputStream.html" title="class in java.io">InputStream</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialClob.html#getAsciiStream--">getAsciiStream</a></span>()</code>
<div class="block">
将此
<code>SerialClob</code>对象指定的
<code>CLOB</code>值作为ascii流
<code>SerialClob</code> 。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../../java/io/Reader.html" title="class in java.io">Reader</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialClob.html#getCharacterStream--">getCharacterStream</a></span>()</code>
<div class="block">
将此
<code>SerialClob</code>对象的数据作为Unicode字符流返回。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../../../java/io/Reader.html" title="class in java.io">Reader</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialClob.html#getCharacterStream-long-long-">getCharacterStream</a></span>(long pos, long length)</code>
<div class="block">
返回一个包含部分
<code>SerialClob</code>值的
<code>Reader</code>对象，以pos指定的字符开头，长度为长度字符。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<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/SerialClob.html#getSubString-long-int-">getSubString</a></span>(long pos, int length)</code>
<div class="block">
返回此
<code>SerialClob</code>对象中包含的子字符串的副本，从给定位置开始，并继续指定的数字或字符。
</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/SerialClob.html#hashCode--">hashCode</a></span>()</code>
<div class="block">
返回此
<code>SerialClob</code>的哈希码。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>long</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialClob.html#length--">length</a></span>()</code>
<div class="block">
检索此
<code>SerialClob</code>对象的字符数组中的字符数。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code>long</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialClob.html#position-java.sql.Clob-long-">position</a></span>(<a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</a> searchStr, long start)</code>
<div class="block">
返回此
<code>SerialClob</code>对象的位置，其中给定的
<code>Clob</code>签名开始，在指定位置开始搜索。
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>long</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialClob.html#position-java.lang.String-long-">position</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> searchStr, long start)</code>
<div class="block">
返回此
<code>SerialClob</code>对象中的位置，给定的
<code>String</code>对象开始，开始在指定位置的搜索。
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code><a href="../../../../java/io/OutputStream.html" title="class in java.io">OutputStream</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialClob.html#setAsciiStream-long-">setAsciiStream</a></span>(long pos)</code>
<div class="block">
检索用于将Ascii字符写入
<code>SerialClob</code>对象所代表的
<code>CLOB</code>值的流，从位置
<code>pos</code>开始。
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code><a href="../../../../java/io/Writer.html" title="class in java.io">Writer</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialClob.html#setCharacterStream-long-">setCharacterStream</a></span>(long pos)</code>
<div class="block">
检索用于将Unicode字符流写入此
<code>SerialClob</code>对象表示的
<code>CLOB</code>值的流，位置为
<code>pos</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/SerialClob.html#setString-long-java.lang.String-">setString</a></span>(long pos, <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> str)</code>
<div class="block">
将给定的Java
<code>String</code>写入
<code>SerialClob</code>对象表示的
<code>CLOB</code>值，位于位置
<code>pos</code> 。
</div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialClob.html#setString-long-java.lang.String-int-int-">setString</a></span>(long pos, <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> str, int offset, int length)</code>
<div class="block">
写入
<code>len</code>的字符
<code>str</code> ，起始于字符
<code>offset</code>到
<code>CLOB</code>值，这
<code>Clob</code>表示。
</div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialClob.html#truncate-long-">truncate</a></span>(long length)</code>
<div class="block">
截断此
<code>SerialClob</code>对象所代表的
<code>CLOB</code>值，使其长度为
<code>len</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#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="SerialClob-char:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>SerialClob</h4> <pre>public SerialClob(char[] ch)
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>SerialClob</code>对象，它是给定的<code>char</code>数组的序列化版本。</span>
<p> <span>新的<code>SerialClob</code>对象使用<code>char</code>阵列的数据<code>char</code> ，从而允许断开的<code>RowSet</code>对象建立一个序列化的<code>Clob</code>对象，而不用触摸数据源。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>ch</code> - 表示要序列化的
<code>Clob</code>对象的char数组
</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> - 如果在序列化期间发生错误
</dd>
<dd>
<code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 如果发生SQL错误
</dd>
</dl> </li>
</ul> <a name="SerialClob-java.sql.Clob-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>SerialClob</h4> <pre>public SerialClob(<a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</a> clob)
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>SerialClob</code>对象，该对象是给定<code>Clob</code>对象的序列化版本。</span>
<p> <span>新的<code>SerialClob</code>对象使用<code>SerialClob</code>对象的数据进行<code>Clob</code> ;</span> <span>因此， <code>Clob</code>对象之前应该已经将SQL <code>CLOB</code>的数据从数据库提交给客户端。</span> <span>否则，新的<code>SerialClob</code>对象对象将不包含任何数据。</span> </p>
<p> <span>注意：提供给此构造函数的<code>Clob</code>对象必须为<code>Clob.getCharacterStream()</code>和<code>Clob.getAsciiStream</code>方法返回非空值。</span> <span>这<code>SerialClob</code>构造函数不能序列化<code>Clob</code>在这个实例对象，将抛出<code>SQLException</code>对象。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>clob</code> - 要<code>Clob</code>此<code>SerialClob</code>对象的<code>SerialClob</code>对象;</span>
<span>不能为空</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> - 如果在序列化期间发生错误
</dd>
<dd>
<span><code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 如果在捕获CLOB时发生SQL错误;</span>
<span>如果<code>Clob</code>对象为空;</span>
<span>或者如果满足<code>Clob.getCharacterStream()</code>和<code>Clob.getAsciiStream()</code>的方法<code>Clob</code>返回一个空</span>
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../../java/sql/Clob.html" title="java.sql中的接口"><code>Clob</code></a></span>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="length--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>length</h4> <pre>public long length()
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></pre>
<div class="block">
检索此
<code>SerialClob</code>对象的字符数组中的字符数。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Clob.html#length--">length</a></code>在界面
<code><a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>long</code>表示这个
<code>SerialClob</code>对象的字符数组的字符长度
</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="getCharacterStream--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCharacterStream</h4> <pre>public <a href="../../../../java/io/Reader.html" title="class in java.io">Reader</a> getCharacterStream()
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></pre>
<div class="block">
<span>将此<code>SerialClob</code>对象的数据作为Unicode字符流返回。</span>
<span>与相关方法<code>getAsciiStream</code>不同，无论<code>SerialClob</code>对象是使用<code>Clob</code>对象还是<code>char</code>数组创建，都会生成流。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Clob.html#getCharacterStream--">getCharacterStream</a></code>在界面
<code><a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>java.io.Reader</code>此
<code>SerialClob</code>对象数据的
<code>SerialClob</code>对象
</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>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../java/sql/Clob.html#setCharacterStream-long-"><code>Clob.setCharacterStream(long)</code></a>
</dd>
</dl> </li>
</ul> <a name="getAsciiStream--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAsciiStream</h4> <pre>public <a href="../../../../java/io/InputStream.html" title="class in java.io">InputStream</a> getAsciiStream()
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>SerialClob</code>对象指定的<code>CLOB</code>值作为ascii流。</span>
<span>此方法转发<code>getAsciiStream</code>呼叫到底层<code>Clob</code>在事件对象，这<code>SerialClob</code>对象被实例化与<code>Clob</code>对象。</span>
<span>如果此<code>SerialClob</code>对象使用<code>char</code>数组实例化，则抛出<code>SerialException</code>对象。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Clob.html#getAsciiStream--">getAsciiStream</a></code>在界面
<code><a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>java.io.InputStream</code>此
<code>SerialClob</code>对象数据的
<code>SerialClob</code>对象
</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> - 如果此<code>SerialClob</code>对象未被实例<code>Clob</code>对象;</span>
<span>如果<code>free</code>以前已经被调用了这个对象</span>
</dd>
<dd>
<code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 如果访问由用于创建此
<code>SerialClob</code>对象的
<code>Clob</code>对象表示的
<code>CLOB</code>值存在错误
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../java/sql/Clob.html#setAsciiStream-long-"><code>Clob.setAsciiStream(long)</code></a>
</dd>
</dl> </li>
</ul> <a name="getSubString-long-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSubString</h4> <pre>public <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> getSubString(long pos,
int length)
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></pre>
<div class="block">
返回此
<code>SerialClob</code>对象中包含的子字符串的副本，从给定位置开始，并继续指定的数字或字符。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Clob.html#getSubString-long-int-">getSubString</a></code>在界面
<code><a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>pos</code> - 要复制的子串中第一个字符的位置;</span>
<span><code>SerialClob</code>对象的第一个字符在位置<code>1</code> ;</span>
<span>不得小于<code>1</code> ，并且<code>1</code>的起始位置和长度的总和必须小于此<code>SerialClob</code>对象的长度</span>
</dd>
<dd>
<span><code>length</code> - 要返回的子字符串中的字符数;</span>
<span>不能大于此<code>SerialClob</code>对象的长度，并且子字符串的起始位置和长度之和必须小于此<code>SerialClob</code>对象的长度</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>String</code>对象，该对象包含该给定位置开始的并包含指定数量的连续字符的
<code>SerialClob</code>对象的子字符串
</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="position-java.lang.String-long-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>position</h4> <pre>public long position(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> searchStr,
long start)
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>SerialClob</code>对象中的位置，给定的<code>String</code>对象开始，开始在指定位置的搜索。</span>
<span>如果找不到该模式，此方法返回<code>-1</code> 。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Clob.html#position-java.lang.String-long-">position</a></code>在界面
<code><a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>searchStr</code> - 要搜索的
<code>String</code>对象
</dd>
<dd>
<span><code>start</code> - 在此<code>SerialClob</code>对象中的位置开始搜索;</span>
<span>第一名是<code>1</code> ;</span>
<span>不得小于<code>1</code>也不得大于此<code>SerialClob</code>对象的长度</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>给定<code>String</code>对象开始的位置，在指定位置开始搜索;</span>
<span><code>-1</code>如果给定的<code>String</code>对象未找到或起始位置超出范围;</span>
<span>返回值的位置编号从<code>1</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>free</code>方法以前是在此对象上调用的
</dd>
<dd>
<code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 如果从数据库访问Clob值时出错。
</dd>
</dl> </li>
</ul> <a name="position-java.sql.Clob-long-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>position</h4> <pre>public long position(<a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</a> searchStr,
long start)
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>SerialClob</code>对象的位置，其中给定的<code>Clob</code>签名开始，在指定位置开始搜索。</span>
<span>如果找不到该模式，此方法返回<code>-1</code> 。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Clob.html#position-java.sql.Clob-long-">position</a></code>在界面
<code><a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>searchStr</code> - 要搜索的
<code>Clob</code>对象
</dd>
<dd>
<span><code>start</code> - 在此<code>SerialClob</code>对象中的位置开始搜索;</span>
<span>第一名是<code>1</code> ;</span>
<span>不得小于<code>1</code>也不得大于此<code>SerialClob</code>对象的长度</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
给定的
<code>Clob</code>对象在指定的起始位置或之后在该
<code>SerialClob</code>对象中开始的位置
</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> - 如果定位Clob签名出现错误;</span>
<span>如果<code>free</code>方法以前曾被调用此对象</span>
</dd>
<dd>
<code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 从数据库访问Clob值时是否存在错误
</dd>
</dl> </li>
</ul> <a name="setString-long-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setString</h4> <pre>public int setString(long pos,
<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> str)
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></pre>
<div class="block">
将给定的Java
<code>String</code>写入
<code>SerialClob</code>对象表示的
<code>CLOB</code>值，位于位置
<code>pos</code> 。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Clob.html#setString-long-java.lang.String-">setString</a></code>在界面
<code><a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>pos</code> - 开始写入这个<code>SerialClob</code>对象所代表的<code>CLOB</code>值的位置;</span>
<span>第一名是<code>1</code> ;</span>
<span>不得小于<code>1</code>也不得大于此<code>SerialClob</code>对象的长度</span>
</dd>
<dd>
<code>str</code> -字符串写入到
<code>CLOB</code>值，这
<code>SerialClob</code>对象表示
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
写入的字符数
</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> - 访问<code>CLOB</code>值时是否有错误;</span>
<span>如果设置无效位置;</span>
<span>如果设置了无效的偏移值;</span>
<span>要写入的字节数大于<code>SerialClob</code>长度;</span>
<span>或长度和偏移的组合值大于Clob缓冲区;</span>
<span>如果<code>free</code>方法以前曾被调用此对象</span>
</dd>
</dl> </li>
</ul> <a name="setString-long-java.lang.String-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setString</h4> <pre>public int setString(long pos,
<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> str,
int offset,
int length)
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></pre>
<div class="block">
写入
<code>len</code>的字符
<code>str</code> ，起始于字符
<code>offset</code>到
<code>CLOB</code>值，这
<code>Clob</code>表示。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Clob.html#setString-long-java.lang.String-int-int-">setString</a></code>在界面
<code><a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>pos</code> - 开始写入此<code>SerialClob</code>对象所代表的<code>CLOB</code>值的位置;</span>
<span>第一名是<code>1</code> ;</span>
<span>不得低于<code>1</code>也不得大于此<code>SerialClob</code>对象的长度</span>
</dd>
<dd>
<code>str</code> - 要写入
<code>Clob</code>对象代表的
<code>CLOB</code>值的字符串
</dd>
<dd>
<code>offset</code> - 偏移到
<code>str</code>开始读取要写入的字符
</dd>
<dd>
<code>length</code> - 要写入的字符数
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
写入的字符数
</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> -如果有访问误差<code>CLOB</code>值;</span>
<span>如果设置无效位置;</span>
<span>如果设置了无效的偏移值;</span>
<span>要写入的字节数大于<code>SerialClob</code>长度;</span>
<span>或长度和偏移的组合值大于Clob缓冲区;</span>
<span>如果<code>free</code>方法以前曾被调用此对象</span>
</dd>
</dl> </li>
</ul> <a name="setAsciiStream-long-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setAsciiStream</h4> <pre>public <a href="../../../../java/io/OutputStream.html" title="class in java.io">OutputStream</a> setAsciiStream(long pos)
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>检索用于将Ascii字符写入<code>SerialClob</code>对象表示的<code>CLOB</code>值的流，从位置<code>pos</code>开始。</span>
<span>此方法转发<code>setAsciiStream()</code>呼叫到底层<code>Clob</code>在事件对象，这<code>SerialClob</code>对象被实例化与<code>Clob</code>对象。</span>
<span>如果此<code>SerialClob</code>对象使用<code>char</code>数组实例化，则抛出<code>SerialException</code>对象。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Clob.html#setAsciiStream-long-">setAsciiStream</a></code>在界面
<code><a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>pos</code> - 开始写入
<code>CLOB</code>对象的位置
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
可以写入ASCII编码字符的流
</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> - 如果没有使用Clob对象实例化SerialClob;</span>
<span>如果<code>free</code>方法以前曾被调用此对象</span>
</dd>
<dd>
<code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 访问
<code>CLOB</code>值时是否存在错误
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../javax/sql/rowset/serial/SerialClob.html#getAsciiStream--"><code>getAsciiStream()</code></a>
</dd>
</dl> </li>
</ul> <a name="setCharacterStream-long-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setCharacterStream</h4> <pre>public <a href="../../../../java/io/Writer.html" title="class in java.io">Writer</a> setCharacterStream(long pos)
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>检索用于将Unicode字符流写入<code>SerialClob</code>对象所代表的<code>CLOB</code>值的流，位置为<code>pos</code> 。</span>
<span>此方法转发<code>setCharacterStream()</code>呼叫到底层<code>Clob</code>在事件对象，这<code>SerialClob</code>对象被实例化与<code>Clob</code>对象。</span>
<span>如果此<code>SerialClob</code>对象使用<code>char</code>数组<code>SerialException</code>则抛出<code>SerialException</code> 。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Clob.html#setCharacterStream-long-">setCharacterStream</a></code>在界面
<code><a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>pos</code> - 开始写入
<code>CLOB</code>值的位置
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
可编写Unicode编码字符的流
</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> - 如果SerialClob未用Clob对象实例化;</span>
<span>如果<code>free</code>方法以前曾被调用此对象</span>
</dd>
<dd>
<code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 访问
<code>CLOB</code>值时是否存在错误
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../javax/sql/rowset/serial/SerialClob.html#getCharacterStream--"><code>getCharacterStream()</code></a>
</dd>
</dl> </li>
</ul> <a name="truncate-long-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>truncate</h4> <pre>public void truncate(long length)
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></pre>
<div class="block">
<span>截断此<code>SerialClob</code>对象所代表的<code>CLOB</code>值，以使其长度为<code>len</code>字符。</span>
<p> <span>将<code>SerialClob</code>对象<code>SerialClob</code>为0，具有清除其内容的效果。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Clob.html#truncate-long-">truncate</a></code>在界面
<code><a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>length</code> - 应截断
<code>CLOB</code>值的长度（以字节为单位）
</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> - 访问<code>CLOB</code>值时是否有错误;</span>
<span>如果<code>free</code>方法以前曾被调用此对象</span>
</dd>
</dl> </li>
</ul> <a name="getCharacterStream-long-long-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCharacterStream</h4> <pre>public <a href="../../../../java/io/Reader.html" title="class in java.io">Reader</a> getCharacterStream(long pos,
long length)
throws <a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></pre>
<div class="block">
返回一个包含部分
<code>SerialClob</code>值的
<code>Reader</code>对象，以pos指定的字符开头，长度为长度字符。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Clob.html#getCharacterStream-long-long-">getCharacterStream</a></code>在界面
<code><a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>pos</code> - 要检索的部分值的第一个字符的偏移量。</span>
<span>在第一个字符<code>SerialClob</code>是在位置1。</span>
</dd>
<dd>
<code>length</code> - 要检索的部分值的字符长度。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>Reader</code>可以读取部分
<code>SerialClob</code>值。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 如果pos小于1或pos大于SerialClob中的
<code>SerialClob</code>数，或者如果pos +长度大于SerialClob中的
<code>SerialClob</code> ;
</dd>
<dd>
<code><a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></code> - 如果
<code>free</code>方法以前是在此对象上调用的
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
1.6
</dd>
</dl> </li>
</ul> <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>SeriableClob</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/Clob.html#free--">free</a></code>在界面
<code><a href="../../../../java/sql/Clob.html" title="interface in java.sql">Clob</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> - 如果发生错误，释放Clob的资源
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
1.6
</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>将此SerialClob与指定对象进行比较。</span>
<span>其结果是<code>true</code>当且仅当该参数不是<code>null</code>并且是<code>SerialClob</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>SerialClob</code>的对象
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果给定的对象代表一个
<code>SerialClob</code>相当于此SerialClob，
<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">
返回这个
<code>SerialClob</code>的哈希码。
</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>SerialClob</code>的克隆。</span>
<span>该副本将包含对内部字符数组的克隆的引用，而不是对此<code>SerialClob</code>对象的原始内部字符数组的引用。</span>
<span>底层的<code>Clob</code>对象将被设置为null。</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>
该SerialClob的克隆
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../../java/lang/Cloneable.html" title="java.lang中的接口"><code>Cloneable</code></a></span>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>
Reference in New Issue View Git Blame Copy Permalink