compact2, compact3

java.sql

Interface Blob

所有已知实现类：

SerialBlob

public interface Blob

表示（映射）在™java编程语言SQL BLOB价值。一个SQL BLOB内置式存储二进制大对象中的行中的数据库表列值。默认情况下，驱动程序实现 Blob使用SQL locator(BLOB)，这意味着一个 Blob对象包含一个逻辑指向SQL BLOB数据而不是数据本身。一个 Blob对象是有效的，交易时间是被创造的。

方法在接口ResultSet，CallableStatement，和PreparedStatement，如getBlob和setBlob允许程序员访问SQL BLOB价值。的Blob接口提供了获取SQL BLOB长度方法（二进制大对象）的价值，实现BLOB值在客户端，并确定在BLOB价值模式的字节位置。此外，该接口已更新BLOB值的方法。

在Blob接口的所有方法都必须完全执行如果JDBC驱动程序支持的数据类型。

从以下版本开始：

一点二

方法摘要

Modifier and Type	Method and Description
void	free() 这种方法使 Blob对象并释放资源，它拥有。
InputStream	getBinaryStream() 检索指定的 Blob实例作为流的 BLOB价值。
InputStream	getBinaryStream(long pos, long length) 返回一个 InputStream对象包含一个部分 Blob价值，从指定的POS的字节，这是长度的字节长度。
byte[]	getBytes(long pos, int length) 检索所有或部分的 BLOB值，这 Blob对象表示，作为字节数组。
long	length() 返回值的 BLOB字节数指定的 Blob对象。
long	position(Blob pattern, long start) 在 BLOB检索值的字节位置指定的对象， pattern开始 Blob。
long	position(byte[] pattern, long start) 检索字节位置在指定的字节数组 pattern开始在这 Blob对象代表 BLOB价值。
OutputStream	setBinaryStream(long pos) 检索一个流，可以用来写这 Blob对象代表 BLOB价值。
int	setBytes(long pos, byte[] bytes) 写了这 Blob对象代表 BLOB值的字节数组，开始位置 pos，返回写入的字节数。
int	setBytes(long pos, byte[] bytes, int offset, int len) 将全部或部分的给定的 byte阵列，这 Blob对象代表 BLOB值并返回写入的字节数。
void	truncate(long len) 截断这 Blob对象表示将 len字节长度的 BLOB价值。

方法详细信息

length

long length()
     throws SQLException

返回值的 BLOB字节数指定的 Blob对象。

结果

在 BLOB字节的长度

异常

SQLException -如果有一个错误的访问 BLOB长度

SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法

从以下版本开始：

一点二

getBytes

byte[] getBytes(long pos,
                int length)
         throws SQLException

检索所有或部分的 BLOB值，这 Blob对象表示，作为字节数组。这 byte数组包含了 length连续字节的位置开始 pos。

参数

pos在 BLOB值的第一个字节被提取的序号位置；第一个字节是1位

length -连续的字节数进行复制；长度的值必须大于或等于0

结果

一个包含了 length连续字节从 BLOB值指定的字节数组 Blob对象，在开始的位置 pos字节

异常

SQLException -如果有错误访问 BLOB值；如果POS小于1或长度小于0

SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法

从以下版本开始：

一点二

另请参见：

setBytes(long, byte[])

getBinaryStream

InputStream getBinaryStream()
                     throws SQLException

这 Blob检索实例指定为流 BLOB价值。

结果

流包含的 BLOB数据

异常

SQLException -如果有错误访问 BLOB价值

SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法

从以下版本开始：

一点二

另请参见：

setBinaryStream(long)

position

long position(byte[] pattern,
              long start)
       throws SQLException

检索字节位置在指定的字节数组 pattern开始在这 Blob对象代表 BLOB价值。对于 pattern搜索位置 start开始。

参数

pattern -要搜索的字节数组

start在哪个位置开始搜索；第一位为1

结果

模式出现的位置，否则- 1

异常

SQLException -如果开始小于1有错误或访问 BLOB

SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法

从以下版本开始：

一点二

position

long position(Blob pattern,
              long start)
       throws SQLException

在 BLOB检索值的字节位置指定的对象， pattern开始 Blob。搜索位置 start开始。

参数

pattern - Blob对象指定为 BLOB搜索值

start在其中 BLOB值的位置开始搜索；第一位为1

结果

模式开始的位置，其他- 1

异常

SQLException -如果开始小于1有错误值或访问 BLOB

SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法

从以下版本开始：

一点二

setBytes

int setBytes(long pos,
             byte[] bytes)
      throws SQLException

写了这 Blob对象代表 BLOB值的字节数组，开始位置 pos，返回写入的字节数。字节数组将覆盖现有的字节在 Blob对象从位置 pos。如果 Blob值的结束而写的字节数组，然后对 Blob值的长度将增加以容纳额外的字节。

注：如果指定pos价值大于长度+ 1的BLOB价值的行为是未定义的。一些JDBC驱动程序可能在其他司机可能支持此操作把一SQLException。

参数

pos在其中 BLOB对象的位置开始写作；第一位为1

bytes -字节被写入，这 Blob对象代表 BLOB值的数组

结果

写入的字节数

异常

SQLException -如果POS小于1有错误值或访问 BLOB

SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法

从以下版本开始：

一点四

另请参见：

getBytes(long, int)

setBytes

int setBytes(long pos,
             byte[] bytes,
             int offset,
             int len)
      throws SQLException

将全部或部分的给定的 byte阵列，这 Blob对象代表 BLOB值并返回写入的字节数。在 BLOB值位置 pos写作开始； len字节从给定的字节数组写入。字节数组将覆盖现有的字节在 Blob对象从位置 pos。如果 Blob值的结束而写的字节数组，然后对 Blob值的长度将增加以容纳额外的字节。

注：如果指定pos价值大于长度+ 1的BLOB价值的行为是未定义的。一些JDBC驱动程序可能在其他司机可能支持此操作把一SQLException。

参数

pos在其中 BLOB对象的位置开始写作；第一位为1

bytes -字节被写入到这个 BLOB对象数组

offset -偏移的阵列 bytes开始读取的字节进行设置

len -被写入的字节数组从 bytes BLOB值的字节数

结果

写入的字节数

异常

SQLException -如果POS小于1有错误值或访问 BLOB

SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法

从以下版本开始：

一点四

另请参见：

getBytes(long, int)

setBinaryStream

OutputStream setBinaryStream(long pos)
                      throws SQLException

检索一个流，可以用来写这 Blob对象代表 BLOB价值。小溪在 pos开始位置的字节写入流将覆盖现有的字节在 Blob对象从位置 pos。如果 Blob值的结束而写入流，然后对 Blob值的长度将增加以容纳额外的字节。

注：如果指定pos价值大于长度+ 1的BLOB价值的行为是未定义的。一些JDBC驱动程序可能在其他司机可能支持此操作把一SQLException。

参数

pos在其中 BLOB值的位置开始写作；第一位为1

结果

一个 java.io.OutputStream对象中的数据可被写入

异常

SQLException -如果POS小于1有错误值或访问 BLOB

SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法

从以下版本开始：

一点四

另请参见：

getBinaryStream()

truncate

void truncate(long len)
       throws SQLException

截断这 Blob对象表示将在 len字节长度 BLOB价值。

注：如果指定pos价值大于长度+ 1的BLOB价值的行为是未定义的。一些JDBC驱动程序可能在其他司机可能支持此操作把一SQLException。

参数

len的长度，以字节为单位，而这 Blob对象代表应被截断的 BLOB价值

异常

SQLException -如果len小于0时有一个错误的 BLOB值或访问

SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法

从以下版本开始：

一点四

free

void free()
   throws SQLException

这种方法使 Blob对象并释放资源，它拥有。物体一旦 free方法是无效的。

在free一直叫，任何试图调用其他比free将导致SQLException抛出一个方法。如果free调用多次，以free随后电话被视为一个空操作。

异常

SQLException -如果出现错误释放BLOB的资源

SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法

从以下版本开始：

一点六

getBinaryStream

InputStream getBinaryStream(long pos,
                            long length)
                     throws SQLException

返回一个 InputStream对象包含一个部分 Blob价值，从指定的POS的字节，这是长度的字节长度。

参数

pos -偏移量的部分值的第一个字节进行检索。在 Blob第一个字节是1位

length在偏值的字节长度进行检索

结果

InputStream通过这部分 Blob值可以读取。

异常

SQLException如果POS小于1或者大于 Blob POS中的字节数，或者如果POS +长度大于在 Blob字节数

SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法

从以下版本开始：

一点六