study/uTools-Manuals
1
0
Fork 0
mirror of https://github.com/fofolee/uTools-Manuals.git synced 2025-07-05 16:22:43 +08:00
Code Issues Packages Projects Releases Wiki Activity
uTools-Manuals/docs/java/javax/sql/rowset/serial/SerialBlob.html

936 lines
41 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 SerialBlob">Class SerialBlob</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.SerialBlob</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/Blob.html" title="java.sql中的接口">Blob</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">SerialBlob</span>
extends <a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a>
implements <a href="../../../../java/sql/Blob.html" title="interface in java.sql">Blob</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>BLOB</code>值。</span>
<p> <span><code>SerialBlob</code>类提供了一个用于从<code>Blob</code>对象创建实例的<code>Blob</code>函数。</span> <span>需要注意的是<code>Blob</code>的对象应该已经将SQL <code>BLOB</code>值的数据置于客户端之前<code>SerialBlob</code>对象从它建造。</span> <span>一个SQL的数据<code>BLOB</code>值可以在客户端上以字节（使用方法的阵列<code>Blob.getBytes</code> ），或者作为未解释的字节流（使用方法<code>Blob.getBinaryStream</code> ）。</span> </p>
<p> <span><code>SerialBlob</code>方法可以使<code>SerialBlob</code>对象的副本作为字节数组或流。</span> <span>它们还可以在<code>Blob</code>对象中找到给定的字节模式或<code>SerialBlob</code>对象，并更新或截断<code>Blob</code>对象。</span> </p>
<h3> <span>线程安全</span> </h3>
<p> <span>SerialBlob不能安全地被多个并发线程使用。</span> <span>如果一个SerialBlob要由多个线程使用，则应该通过适当的同步来控制对SerialBlob的访问。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../serialized-form.html#javax.sql.rowset.serial.SerialBlob">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/SerialBlob.html#SerialBlob-java.sql.Blob-">SerialBlob</a></span>(<a href="../../../../java/sql/Blob.html" title="interface in java.sql">Blob</a> blob)</code>
<div class="block">
构造一个
<code>SerialBlob</code>对象，它是给定的
<code>Blob</code>对象的序列化版本。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialBlob.html#SerialBlob-byte:A-">SerialBlob</a></span>(byte[] b)</code>
<div class="block">
构造一个
<code>SerialBlob</code>对象，它是给定的
<code>byte</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/SerialBlob.html#clone--">clone</a></span>()</code>
<div class="block">
返回此
<code>SerialBlob</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/SerialBlob.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">
将此SerialBlob与指定对象进行比较。
</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/SerialBlob.html#free--">free</a></span>()</code>
<div class="block">
此方法可以释放
<code>SeriableBlob</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/SerialBlob.html#getBinaryStream--">getBinaryStream</a></span>()</code>
<div class="block">
返回此
<code>SerialBlob</code>对象作为输入流。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<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/SerialBlob.html#getBinaryStream-long-long-">getBinaryStream</a></span>(long pos, long length)</code>
<div class="block">
返回一个包含部分
<code>Blob</code>值的
<code>InputStream</code>对象，从pos指定的字节开始，长度为字节长度。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>byte[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialBlob.html#getBytes-long-int-">getBytes</a></span>(long pos, int length)</code>
<div class="block">
将指定的字节数（从给定位置开始）从此
<code>SerialBlob</code>对象复制到另一个字节数组。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialBlob.html#hashCode--">hashCode</a></span>()</code>
<div class="block">
返回此
<code>SerialBlob</code>的哈希码。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>long</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialBlob.html#length--">length</a></span>()</code>
<div class="block">
检索此
<code>SerialBlob</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/SerialBlob.html#position-java.sql.Blob-long-">position</a></span>(<a href="../../../../java/sql/Blob.html" title="interface in java.sql">Blob</a> pattern, long start)</code>
<div class="block">
返回此
<code>SerialBlob</code>对象中的位置，给定的
<code>Blob</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/SerialBlob.html#position-byte:A-long-">position</a></span>(byte[] pattern, long start)</code>
<div class="block">
返回此
<code>SerialBlob</code>对象中给定字节模式开始的位置，在指定位置开始搜索。
</div> </td>
</tr>
<tr class="altColor" id="i10">
<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/SerialBlob.html#setBinaryStream-long-">setBinaryStream</a></span>(long pos)</code>
<div class="block">
检索可用于写入此
<code>Blob</code>对象所代表的
<code>BLOB</code>值的流。
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialBlob.html#setBytes-long-byte:A-">setBytes</a></span>(long pos, byte[] bytes)</code>
<div class="block">
将给定的字节数组写入
<code>Blob</code>对象表示的
<code>BLOB</code>值，从位置
<code>pos</code>开始，并返回写入的字节数。
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialBlob.html#setBytes-long-byte:A-int-int-">setBytes</a></span>(long pos, byte[] bytes, int offset, int length)</code>
<div class="block">
将给定的
<code>byte</code>数组的全部或部分写入
<code>Blob</code>对象表示的
<code>BLOB</code>值，并返回写入的字节数。
</div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sql/rowset/serial/SerialBlob.html#truncate-long-">truncate</a></span>(long length)</code>
<div class="block">
截断此
<code>Blob</code>对象表示的长度为
<code>len</code>字节的
<code>BLOB</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="SerialBlob-byte:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>SerialBlob</h4> <pre>public SerialBlob(byte[] b)
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>SerialBlob</code>对象，它是给定的<code>byte</code>数组的序列化版本。</span>
<p> <span>新的<code>SerialBlob</code>对象使用<code>byte</code>阵列的数据进行<code>byte</code> ，从而允许断开<code>RowSet</code>对象建立序列化的<code>Blob</code>对象，而无需触及数据源。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>b</code> - 包含
<code>byte</code>序列化的
<code>Blob</code>对象的数据的
<code>byte</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> - 如果在序列化期间发生错误
</dd>
<dd>
<code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 如果发生SQL错误
</dd>
</dl> </li>
</ul> <a name="SerialBlob-java.sql.Blob-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>SerialBlob</h4> <pre>public SerialBlob(<a href="../../../../java/sql/Blob.html" title="interface in java.sql">Blob</a> blob)
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>SerialBlob</code>对象，它是给定的<code>Blob</code>对象的序列化版本。</span>
<p> <span>新的<code>SerialBlob</code>对象使用<code>SerialBlob</code>对象的数据进行<code>Blob</code> ;</span> <span>因此， <code>Blob</code>对象之前应该已经将SQL <code>BLOB</code>的数据从数据库提交给客户端。</span> <span>否则，新的<code>SerialBlob</code>对象将不包含任何数据。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>blob</code> - 要<code>Blob</code>此<code>SerialBlob</code>对象的<code>SerialBlob</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>
<code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 如果
<code>Blob</code>传递给这个构造函数是
<code>null</code> 。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../../java/sql/Blob.html" title="java.sql中的接口"><code>Blob</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="getBytes-long-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getBytes</h4> <pre>public byte[] getBytes(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">
<span>将从指定位置开始的指定数量的字节从此<code>SerialBlob</code>对象复制到另一个字节数组。</span>
<p> <span>请注意，如果要复制的给定字节数大于此<code>SerialBlob</code>对象的字节数组的长度，则给定的数字将缩短到数组的长度。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Blob.html#getBytes-long-int-">getBytes</a></code>在界面
<code><a href="../../../../java/sql/Blob.html" title="interface in java.sql">Blob</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>pos</code> - 要复制的<code>SerialBlob</code>对象中的第一个字节的顺序位置;</span>
<span>编号起始于<code>1</code> ;</span>
<span>不得低于<code>1</code> ，且必须小于或等于此<code>SerialBlob</code>对象的长度</span>
</dd>
<dd>
<code>length</code> - 要复制的字节数
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个字节数组，它是这个
<code>SerialBlob</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/Blob.html#setBytes-long-byte:A-"><code>Blob.setBytes(long, byte[])</code></a>
</dd>
</dl> </li>
</ul> <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>SerialBlob</code>对象的字节数组中的字节数。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Blob.html#length--">length</a></code>在界面
<code><a href="../../../../java/sql/Blob.html" title="interface in java.sql">Blob</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>long</code>指示此
<code>SerialBlob</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="getBinaryStream--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getBinaryStream</h4> <pre>public <a href="../../../../java/io/InputStream.html" title="class in java.io">InputStream</a> getBinaryStream()
throws <a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></pre>
<div class="block">
<span>返回此<code>SerialBlob</code>对象作为输入流。</span>
<span>与相关方法<code>setBinaryStream</code>不同，无论<code>SerialBlob</code>是使用<code>Blob</code>对象还是<code>byte</code>阵列创建，都会生成流。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Blob.html#getBinaryStream--">getBinaryStream</a></code>在界面
<code><a href="../../../../java/sql/Blob.html" title="interface in java.sql">Blob</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>java.io.InputStream</code>对象包含此
<code>SerialBlob</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="../../../../javax/sql/rowset/serial/SerialBlob.html#setBinaryStream-long-"><code>setBinaryStream(long)</code></a>
</dd>
</dl> </li>
</ul> <a name="position-byte:A-long-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>position</h4> <pre>public long position(byte[] pattern,
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">
返回此
<code>SerialBlob</code>对象中给定字节模式开始的位置，在指定位置开始搜索。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Blob.html#position-byte:A-long-">position</a></code>在界面
<code><a href="../../../../java/sql/Blob.html" title="interface in java.sql">Blob</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>pattern</code> - 要搜索的字节模式
</dd>
<dd>
<span><code>start</code> - 此<code>SerialBlob</code>对象中开始搜索的字节的位置;</span>
<span>第一名是<code>1</code> ;</span>
<span>不得小于<code>1</code>也不得大于此<code>SerialBlob</code>对象的长度</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>在该指定位置开始的给定模式中的此<code>SerialBlob</code>对象中的位置;</span>
<span><code>-1</code>如果没有找到模式或给定的起始位置超出范围;</span>
<span>返回值的位置编号从<code>1</code>开始</span>
</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> - 如果串行化blob时发生错误;</span>
<span>如果<code>free</code>以前已经被调用了这个对象</span>
</dd>
<dd>
<code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 访问数据库中的
<code>BLOB</code>值是否有错误
</dd>
</dl> </li>
</ul> <a name="position-java.sql.Blob-long-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>position</h4> <pre>public long position(<a href="../../../../java/sql/Blob.html" title="interface in java.sql">Blob</a> pattern,
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">
返回此
<code>SerialBlob</code>对象中的位置，给定的
<code>Blob</code>对象开始，开始在指定位置的搜索。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Blob.html#position-java.sql.Blob-long-">position</a></code>在界面
<code><a href="../../../../java/sql/Blob.html" title="interface in java.sql">Blob</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>pattern</code> - 要搜索的
<code>Blob</code>对象;
</dd>
<dd>
<span><code>start</code> - <code>SerialBlob</code>开始搜索的<code>SerialBlob</code>对象中的字节的位置;</span>
<span>第一名是<code>1</code> ;</span>
<span>不得小于<code>1</code>也不得大于此<code>SerialBlob</code>对象的长度</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>在这个<code>SerialBlob</code>对象中的位置，给定的<code>Blob</code>对象从指定的位置开始;</span>
<span><code>-1</code>如果没有找到模式或给定的起始位置超出范围;</span>
<span>返回值的位置编号从<code>1</code>开始</span>
</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> - 如果串行化blob时发生错误;</span>
<span>如果<code>free</code>以前曾被调用此对象</span>
</dd>
<dd>
<code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 从数据库
<code>BLOB</code>值时是否有错误
</dd>
</dl> </li>
</ul> <a name="setBytes-long-byte:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setBytes</h4> <pre>public int setBytes(long pos,
byte[] bytes)
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">
将给定的字节数组写入
<code>Blob</code>对象表示的
<code>BLOB</code>值，从位置
<code>pos</code>开始，并返回写入的字节数。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Blob.html#setBytes-long-byte:A-">setBytes</a></code>在界面
<code><a href="../../../../java/sql/Blob.html" title="interface in java.sql">Blob</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>pos</code> - 在SQL <code>BLOB</code>值中开始写入的位置。</span>
<span>第一名是<code>1</code> ;</span>
<span>不得低于<code>1</code>也不得大于此<code>SerialBlob</code>对象的长度。</span>
</dd>
<dd>
<code>bytes</code> - 要写入
<code>Blob</code>对象代表的
<code>BLOB</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>BLOB</code>值时是否有错误;</span>
<span>或者如果设置无效位置;</span>
<span>如果设置了无效的偏移值;</span>
<span>如果<code>free</code>以前已经被调用了这个对象</span>
</dd>
<dd>
<code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 如果从数据库
<code>BLOB</code>值时出现错误
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../javax/sql/rowset/serial/SerialBlob.html#getBytes-long-int-"><code>getBytes(long, int)</code></a>
</dd>
</dl> </li>
</ul> <a name="setBytes-long-byte:A-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setBytes</h4> <pre>public int setBytes(long pos,
byte[] bytes,
int offset,
int length)
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>byte</code>数组的全部或部分写入<code>Blob</code>对象表示的<code>BLOB</code>值，并返回写入的字节数。</span>
<span>写作起始于<code>pos</code>的<code>BLOB</code>值;</span>
<span>写入来自给定字节数组的<i>len</i>字节。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Blob.html#setBytes-long-byte:A-int-int-">setBytes</a></code>在界面
<code><a href="../../../../java/sql/Blob.html" title="interface in java.sql">Blob</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>pos</code> - 在开始写作的<code>BLOB</code>对象中的位置。</span>
<span>第一名是<code>1</code> ;</span>
<span>不得小于<code>1</code>也不得大于此<code>SerialBlob</code>对象的长度。</span>
</dd>
<dd>
<code>bytes</code> - 要写入
<code>BLOB</code>值的字节数组
</dd>
<dd>
<span><code>offset</code> - 在开始读取字节的<code>byte</code>数组中的偏移量。</span>
<span>第一个偏移位置是<code>0</code> ;</span>
<span>不得小于<code>0</code>也不得大于<code>byte</code>阵列的长度</span>
</dd>
<dd>
<code>length</code> - 要从字节数组字节写入
<code>BLOB</code>值的字节
<i>数</i> 。
</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>BLOB</code>值时是否有错误;</span>
<span>如果设置无效位置;</span>
<span>如果设置了无效的偏移值;</span>
<span>要写入的字节数大于<code>SerialBlob</code>长度;</span>
<span>或长度和偏移的组合值大于Blob缓冲区;</span>
<span>如果<code>free</code>先前已被调用此对象</span>
</dd>
<dd>
<code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 如果从数据库
<code>BLOB</code>值出错。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../javax/sql/rowset/serial/SerialBlob.html#getBytes-long-int-"><code>getBytes(long, int)</code></a>
</dd>
</dl> </li>
</ul> <a name="setBinaryStream-long-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setBinaryStream</h4> <pre>public <a href="../../../../java/io/OutputStream.html" title="class in java.io">OutputStream</a> setBinaryStream(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>检索可用于写入此<code>Blob</code>对象所代表的<code>BLOB</code>值的流。</span>
<span>流从位置<code>pos</code>开始。</span>
<span>如果此<code>SerialBlob</code>对象使用Blob <code>Blob</code> ，则此方法将<code>setBinaryStream()</code>调用转发到<code>setBinaryStream()</code> <code>Blob</code> 。</span>
<span>如果这<code>SerialBlob</code>与实例<code>byte</code>阵列，一个<code>SerialException</code>被抛出。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Blob.html#setBinaryStream-long-">setBinaryStream</a></code>在界面
<code><a href="../../../../java/sql/Blob.html" title="interface in java.sql">Blob</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>pos</code> - 在开始写作的
<code>BLOB</code>值的位置
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个可以写入数据的
<code>java.io.OutputStream</code>对象
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 访问
<code>BLOB</code>值时是否存在错误
</dd>
<dd>
<span><code><a href="../../../../javax/sql/rowset/serial/SerialException.html" title="class in javax.sql.rowset.serial">SerialException</a></code> - 如果SerialBlob未实例化与支持<code>setBinaryStream()</code>的<code>Blob</code>对象;</span>
<span>如果<code>free</code>以前已经被调用了这个对象</span>
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../javax/sql/rowset/serial/SerialBlob.html#getBinaryStream--"><code>getBinaryStream()</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">
截断此
<code>Blob</code>对象表示的长度为
<code>len</code>字节的
<code>BLOB</code>值。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Blob.html#truncate-long-">truncate</a></code>在界面
<code><a href="../../../../java/sql/Blob.html" title="interface in java.sql">Blob</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>length</code> - 此
<code>Blob</code>对象所代表的
<code>BLOB</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> - 访问Blob值是否有错误;</span>
<span>或者截断长度大于SerialBlob长度;</span>
<span>如果<code>free</code>以前已经被调用了这个对象</span>
</dd>
</dl> </li>
</ul> <a name="getBinaryStream-long-long-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getBinaryStream</h4> <pre>public <a href="../../../../java/io/InputStream.html" title="class in java.io">InputStream</a> getBinaryStream(long pos,
long length)
throws <a href="../../../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></pre>
<div class="block">
返回一个
<code>InputStream</code>对象，该对象包含部分
<code>Blob</code>值，以pos指定的字节开头，长度为长度字节。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/sql/Blob.html#getBinaryStream-long-long-">getBinaryStream</a></code>在界面
<code><a href="../../../../java/sql/Blob.html" title="interface in java.sql">Blob</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>pos</code> - 要检索的部分值的第一个字节的偏移量。</span>
<span><code>Blob</code>的第一个字节在位置1</span>
</dd>
<dd>
<code>length</code> - 要检索的部分值的字节长度
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>InputStream</code>可以读取部分
<code>Blob</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大于
<code>Blob</code>中的字节数，或者如果pos +长度大于
<code>Blob</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>SeriableBlob</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/Blob.html#free--">free</a></code>在界面
<code><a href="../../../../java/sql/Blob.html" title="interface in java.sql">Blob</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> - 如果发布错误发布Blob的资源
</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>将此SerialBlob与指定对象进行比较。</span>
<span>结果是<code>true</code>当且仅当参数不是<code>null</code>并且是<code>SerialBlob</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>SerialBlob</code>的对象
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果给定的对象表示
<code>SerialBlob</code>相当于此SerialBlob，
<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>SerialBlob</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>SerialBlob</code>的克隆。</span>
<span>该副本将包含对内部字节数组的克隆的引用，而不是引用此<code>SerialBlob</code>对象的原始内部字节数组。</span>
<span>底层的<code>Blob</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>
这个SerialBlob的一个克隆
</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