SerialBlob (Java Platform SE 8 )

java.lang.Object
- javax.sql.rowset.serial.SerialBlob

All Implemented Interfaces:

Serializable， Cloneable， Blob
```
public class SerialBlob
extends Object
implements Blob, Serializable, Cloneable
```
序列化映射在一个SQL BLOB价值java编程语言。
的SerialBlob类提供了用于创建从一个Blob对象实例构造函数。请注意，Blob对象应该把SQL BLOB值的数据到客户端之前，SerialBlob对象是由它。一个SQL BLOB值的数据可以实现对客户端的字节数组（使用方法Blob.getBytes）或未解释的字节流（使用方法Blob.getBinaryStream）。

SerialBlob方法可以复制一个SerialBlob对象作为一个字节数组或流。他们也有可能找到一个给定的图案的字节或Blob对象在SerialBlob对象和更新或截断Blob对象。

线程安全

一个serialblob不安全使用多线程并发。如果一个serialblob是用于由多个线程访问的serialblob应该通过适当的同步控制。

另请参见：

Serialized Form

构造方法摘要

构造方法
Constructor and Description
`SerialBlob(Blob blob)` 构建了一个 `SerialBlob`对象，序列化版本给出的 `Blob`对象。
`SerialBlob(byte[] b)` 构建了一个 `SerialBlob`对象，序列化版本给出的 `byte`阵列。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`Object`	`clone()` 返回该 `SerialBlob`克隆。
`boolean`	`equals(Object obj)` 比较SerialBlob到指定的对象。
`void`	`free()` 这种方法使 `SeriableBlob`对象并释放资源，它拥有。
`InputStream`	`getBinaryStream()` 作为一个输入流返回此 `SerialBlob`对象。
`InputStream`	`getBinaryStream(long pos, long length)` 返回一个 `InputStream`对象包含一个部分 `Blob`价值，从指定的POS的字节，这是长度的字节长度。
`byte[]`	`getBytes(long pos, int length)` 复制指定的字节数，指定位置开始的，从这个 `SerialBlob`对象到另一个字节数组。
`int`	`hashCode()` 返回此 `SerialBlob`哈希代码。
`long`	`length()` 在这 `SerialBlob`字节检索对象的数组的字节数。
`long`	`position(Blob pattern, long start)` 返回的位置在这 `SerialBlob`对象在给定 `Blob`对象开始，从指定位置开始搜索。
`long`	`position(byte[] pattern, long start)` 返回的位置在这 `SerialBlob`对象在给定模式的字节开始，从指定位置开始搜索。
`OutputStream`	`setBinaryStream(long pos)` 检索一个流，可以用来写这 `Blob`对象代表 `BLOB`价值。
`int`	`setBytes(long pos, byte[] bytes)` 写了这 `Blob`对象代表 `BLOB`值的字节数组，开始位置 `pos`，返回写入的字节数。
`int`	`setBytes(long pos, byte[] bytes, int offset, int length)` 将全部或部分的给定的 `byte`阵列，这 `Blob`对象代表 `BLOB`值并返回写入的字节数。
`void`	`truncate(long length)` 截断这 `Blob`对象表示将 `len`字节长度的 `BLOB`价值。

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - SerialBlob
```
public SerialBlob(byte[] b)
           throws SerialException,
                  SQLException
```
    构建了一个 SerialBlob对象，序列化版本给出的 byte阵列。
    新SerialBlob对象是从byte阵列数据初始化，从而允许断开RowSet对象序列化对象建立Blob不接触数据源。
    
    参数
    
    b -被序列化的 Blob对象包含数据的 byte阵列
    
    异常
    
    SerialException -如果在序列化期间发生错误
    
    SQLException如果SQL错误发生
  - SerialBlob
```
public SerialBlob(Blob blob)
           throws SerialException,
                  SQLException
```
    构建了一个 SerialBlob对象，序列化版本给出的 Blob对象。
    新SerialBlob对象是从Blob对象数据初始化的对象；因此，Blob应该以前带SQL BLOB值的数据到客户端数据库。否则，新的SerialBlob对象将不包含数据。
    
    参数
    
    blob -从这 SerialBlob对象被构造， Blob对象；不能为空。
    
    异常
    
    SerialException -如果在序列化期间发生错误
    
    SQLException -如果 Blob通过这此构造函数是一种 null。
    
    另请参见：
    
    Blob
- 方法详细信息
  - getBytes
```
public byte[] getBytes(long pos,
                       int length)
                throws SerialException
```
    复制指定的字节数，指定位置开始的，从这个 SerialBlob对象到另一个字节数组。
    注意，如果给定的字节数大于被复制的字节SerialBlob对象的数组的长度，给定的数字将缩短到数组的长度。
    
    Specified by:
    
    getBytes 接口 Blob
    
    参数
    
    pos -在这 SerialBlob对象的第一个字节被拷贝的序号位置；编号开始在 1；不得少于 1必须小于或等于此 SerialBlob对象的长度
    
    length -字节数被复制
    
    结果
    
    字节是一份本 SerialBlob物体区域的数组，指定位置开始的，包含了连续的字节数
    
    异常
    
    SerialException -如果给定的起始位置是出界；如果 free以前被称为该对象
    
    另请参见：
    
    Blob.setBytes(long, byte[])
  - length
```
public long length()
            throws SerialException
```
    在这 SerialBlob字节检索对象的数组的字节数。
    
    Specified by:
    
    length 接口 Blob
    
    结果
    
    一个 long指示在这 SerialBlob字节对象的字节数组的长度
    
    异常
    
    SerialException -如果发生错误；如果 free以前被称为该对象
  - getBinaryStream
```
public InputStream getBinaryStream()
                            throws SerialException
```
    作为一个输入流返回此 SerialBlob对象。与相关的方法， setBinaryStream、一个流生产无论 SerialBlob与 Blob对象或 byte阵列创建。
    
    Specified by:
    
    getBinaryStream 接口 Blob
    
    结果
    
    一个 java.io.InputStream对象包含的字节数组对象的 SerialBlob
    
    异常
    
    SerialException -如果发生错误；如果 free以前被称为该对象
    
    另请参见：
    
    setBinaryStream(long)
  - position
```
public long position(byte[] pattern,
                     long start)
              throws SerialException,
                     SQLException
```
    返回的位置在这 SerialBlob对象在给定模式的字节开始，从指定位置开始搜索。
    
    Specified by:
    
    position 接口 Blob
    
    参数
    
    pattern -字节的搜索模式
    
    start -在这 SerialBlob对象的字节位置开始搜索；第一的位置 1；不得小于或大于这个 1 SerialBlob对象的长度
    
    结果
    
    位置在这 SerialBlob对象在给定的模式开始，从指定位置； -1如果模式没有发现或给定的起始位置是出界；职位编号为返回值从 1
    
    异常
    
    SerialException -如果错误发生在序列化斑点；如果 free以前被称为该对象
    
    SQLException -如果有一个错误的数据库访问 BLOB价值
  - position
```
public long position(Blob pattern,
                     long start)
              throws SerialException,
                     SQLException
```
    返回的位置在这 SerialBlob对象在给定 Blob对象开始，从指定位置开始搜索。
    
    Specified by:
    
    position 接口 Blob
    
    参数
    
    pattern -要搜索的对象的 Blob；
    
    start -在这 SerialBlob对象的字节位置开始搜索；第一的位置 1；不得小于或大于这个 1 SerialBlob对象的长度
    
    结果
    
    位置在这 SerialBlob对象在给定 Blob对象开始，开始在指定的位置； -1如果模式没有发现或给定的起始位置是出界；职位编号为返回值从 1
    
    异常
    
    SerialException -如果错误发生在序列化斑点；如果 free以前被称为该对象
    
    SQLException -如果有一个错误的数据库访问 BLOB价值
  - setBytes
```
public int setBytes(long pos,
                    byte[] bytes)
             throws SerialException,
                    SQLException
```
    写了这 Blob对象代表 BLOB值的字节数组，开始位置 pos，返回写入的字节数。
    
    Specified by:
    
    setBytes 接口 Blob
    
    参数
    
    pos -在SQL BLOB值的位置开始写作。第一位是 1；不得小于或大于这个 1 SerialBlob对象的长度。
    
    bytes -字节被写入，这 Blob对象代表 BLOB值的数组
    
    结果
    
    写入的字节数
    
    异常
    
    SerialException -如果有错误访问 BLOB价值；或者如果一个无效的位置；如果一个无效的偏移值设置；如果 free以前被称为该对象
    
    SQLException -如果有一个错误的数据库访问 BLOB价值
    
    另请参见：
    
    getBytes(long, int)
  - setBytes
```
public int setBytes(long pos,
                    byte[] bytes,
                    int offset,
                    int length)
             throws SerialException,
                    SQLException
```
    将全部或部分的给定的 byte阵列，这 Blob对象代表 BLOB值并返回写入的字节数。在 BLOB值位置 pos写作开始；伦恩字节从给定的字节数组写入。
    
    Specified by:
    
    setBytes 接口 Blob
    
    参数
    
    pos在其中 BLOB对象的位置开始写作。第一位是 1；不得小于或大于这个 1 SerialBlob对象的长度。
    
    bytes -字节被写入到 BLOB值的数组
    
    offset在 byte阵列在开始读取的字节偏移量。第一个偏移位置 0；不得小于或大于 0的 byte数组的长度
    
    length -字节数写入字节数组从字节 BLOB价值。
    
    结果
    
    写入的字节数
    
    异常
    
    SerialException -如果有错误访问 BLOB值；如果一个无效的位置；如果一个无效的偏移值设置；如果要写入的字节数大于 SerialBlob长度；或长度和偏移的组合值大于BLOB缓存；如果 free曾呼吁这个对象
    
    SQLException -如果有一个错误的数据库访问 BLOB价值。
    
    另请参见：
    
    getBytes(long, int)
  - setBinaryStream
```
public OutputStream setBinaryStream(long pos)
                             throws SerialException,
                                    SQLException
```
    检索一个流，可以用来写这 Blob对象代表 BLOB价值。小溪在 pos开始位置。该方法将 setBinaryStream()调用的事件，这 SerialBlob对象实例化一个 Blob底层 Blob。如果这 SerialBlob实例化一 byte阵列，一个 SerialException抛出。
    
    Specified by:
    
    setBinaryStream 接口 Blob
    
    参数
    
    pos在其中 BLOB值的位置开始写作
    
    结果
    
    一个 java.io.OutputStream对象中的数据可被写入
    
    异常
    
    SQLException -如果有错误访问 BLOB价值
    
    SerialException -如果不使用一个支持 setBinaryStream() Blob对象的serialblob；如果 free以前被称为该对象
    
    另请参见：
    
    getBinaryStream()
  - truncate
```
public void truncate(long length)
              throws SerialException
```
    截断这 Blob对象表示将 len字节长度的 BLOB价值。
    
    Specified by:
    
    truncate 接口 Blob
    
    参数
    
    length的长度，以字节为单位，而这 Blob对象代表应被截断的 BLOB价值
    
    异常
    
    SerialException -如果有错误访问BLOB值；或长形大，serialblob长度；如果 free以前被称为该对象
  - getBinaryStream
```
public InputStream getBinaryStream(long pos,
                                   long length)
                            throws SQLException
```
    返回一个 InputStream对象包含一个部分 Blob价值，从指定的POS的字节，这是长度的字节长度。
    
    Specified by:
    
    getBinaryStream 接口 Blob
    
    参数
    
    pos -偏移量的部分值的第一个字节进行检索。在 Blob第一个字节是1位
    
    length在偏值的字节长度进行检索
    
    结果
    
    InputStream通过这部分 Blob值可以读取。
    
    异常
    
    SQLException如果POS小于1或者大于 Blob POS中的字节数，或者如果POS +长度大于在 Blob字节数
    
    SerialException -如果 free方法以前称为对象
    
    从以下版本开始：
    
    一点六
  - free
```
public void free()
          throws SQLException
```
    这种方法使 SeriableBlob对象并释放资源，它拥有。物体一旦 free方法是无效的。
    如果free调用多次，以free随后电话被视为一个空操作。
    
    Specified by:
    
    free 接口 Blob
    
    异常
    
    SQLException -如果出现错误释放BLOB的资源
    
    从以下版本开始：
    
    一点六
  - equals
```
public boolean equals(Object obj)
```
    比较SerialBlob到指定的对象。其结果是 true如果只有参数不 null是 SerialBlob表示字节顺序相同对象。
    
    重写：
    
    equals 方法重写，继承类 Object
    
    参数
    
    obj的对象比较 SerialBlob反对
    
    结果
    
    true如果给定对象代表一个 SerialBlob相当于这serialblob， false否则
    
    另请参见：
    
    Object.hashCode()， HashMap
  - hashCode
```
public int hashCode()
```
    返回此 SerialBlob哈希代码。
    
    重写：
    
    hashCode 方法重写，继承类 Object
    
    结果
    
    此对象的哈希代码值。
    
    另请参见：
    
    Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)
  - clone
```
public Object clone()
```
    返回该 SerialBlob克隆。的副本将包含一个参考的内部字节数组克隆，不参考原始内部字节数组这 SerialBlob对象。潜在的 Blob对象将被设置为null。
    
    重写：
    
    clone 方法重写，继承类 Object
    
    结果
    
    这个SerialBlob的克隆
    
    另请参见：
    
    Cloneable

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class SerialBlob

线程安全

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

SerialBlob

SerialBlob

方法详细信息

getBytes

length

getBinaryStream

position

position

setBytes

setBytes

setBinaryStream

truncate

getBinaryStream

free

equals

hashCode

clone