|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.sql
接口 Blob
- 所有已知实现类:
- SerialBlob
-
public interface Blob
SQL BLOB
值在 JavaTM 编程语言中的表示形式(映射关系)。SQL BLOB
是内置类型,它将 Binary Large Object 存储为数据库表的某一行中的一个列值。默认情况下,驱动程序使用 SQL locator(BLOB)
实现 Blob
,这意味着 Blob
对象包含一个指向 SQL BLOB
数据而不是数据本身的逻辑指针。Blob
对象在它被创建的事务处理期间有效。
接口 ResultSet
、CallableStatement
和 PreparedStatement
中的方法(如 getBlob
和 setBlob
)允许编程人员访问 SQL BLOB
值。Blob
接口提供某些方法来获得 SQL BLOB
(Binary Large Object) 值的长度、在客户端实现 BLOB
值以及确定 BLOB
值中某一字节样本的位置。此外,此接口还拥有更新 BLOB
值的方法。
- 从以下版本开始:
- 1.2
方法摘要 | |
---|---|
InputStream |
getBinaryStream() 以流的形式检索此 Blob 实例指定的 BLOB 值。 |
byte[] |
getBytes(long pos, int length) 以字节数组的形式检索此 Blob 对象表示的全部或部分 BLOB 值。 |
long |
length() 返回由此 Blob 对象指定的 BLOB 值中的字节数。 |
long |
position(Blob pattern, long start) 检索此 Blob 对象指定的 BLOB 值中 pattern 开始处的字节位置。 |
long |
position(byte[] pattern, long start) 检索此 Blob 对象表示的 BLOB 值中指定字节数组 pattern 开始处的字节位置。 |
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 对象表示的 BLOB 值,使其长度为 len 个字节。 |
方法详细信息 |
---|
length
long length() throws SQLException
-
返回由此
Blob
对象指定的BLOB
值中的字节数。 -
- 返回:
-
BLOB
的字节长度 - 抛出:
-
SQLException
- 如果访问BLOB
的长度时发生错误 - 从以下版本开始:
- 1.2
getBytes
byte[] getBytes(long pos, int length) throws SQLException
-
以字节数组的形式检索此
Blob
对象表示的全部或部分BLOB
值。此byte
数组包含从位置pos
开始的length
个连续字节。 -
- 参数:
-
pos
- 要提取的BLOB
值中第一个字节的顺序位置;第一个字节位于位置 1 处 -
length
- 要复制的连续字节的数量 - 返回:
-
一个字节数组,它包含此
Blob
对象指定的BLOB
值中的length
个连续字节(从位置pos
处的字节开始) - 抛出:
-
SQLException
- 如果访问BLOB
值时发生错误 - 从以下版本开始:
- 1.2
- 另请参见:
-
setBytes(long, byte[])
getBinaryStream
InputStream getBinaryStream() throws SQLException
-
以流的形式检索此
Blob
实例指定的BLOB
值。 -
- 返回:
-
包含
BLOB
数据的流 - 抛出:
-
SQLException
- 如果访问BLOB
值时发生错误 - 从以下版本开始:
- 1.2
- 另请参见:
-
setBinaryStream(long)
position
long position(byte[] pattern, long start) throws SQLException
-
检索此
Blob
对象表示的BLOB
值中指定字节数组pattern
开始处的字节位置。对pattern
的搜索从位置start
开始。 -
- 参数:
-
pattern
- 要搜索的字节数组 -
start
- 开始搜索的位置;第一个位置是 1 - 返回:
- pattern 出现的位置,否则返回 -1
- 抛出:
-
SQLException
- 如果访问BLOB
时发生错误 - 从以下版本开始:
- 1.2
position
long position(Blob pattern, long start) throws SQLException
-
检索此
Blob
对象指定的BLOB
值中pattern
开始处的字节位置。从位置start
开始搜索。 -
- 参数:
-
pattern
- 指定要搜索的BLOB
值的Blob
对象 -
start
-BLOB
值中开始进行搜索的位置;第一个位置是 1 - 返回:
- pattern 开始处的位置,否则返回 -1
- 抛出:
-
SQLException
- 如果访问BLOB
值时发生错误 - 从以下版本开始:
- 1.2
setBytes
int setBytes(long pos, byte[] bytes) throws SQLException
-
将给定字节数组写入此
Blob
对象表示的BLOB
值(从位置pos
处开始),并返回写入的字节数。 -
- 参数:
-
pos
-BLOB
对象开始进行写入操作的位置 -
bytes
- 要写入此Blob
对象表示的BLOB
值中的字节数组 - 返回:
- 写入的字节数
- 抛出:
-
SQLException
- 如果访问BLOB
值时发生错误 - 从以下版本开始:
- 1.4
- 另请参见:
-
getBytes(long, int)
setBytes
int setBytes(long pos, byte[] bytes, int offset, int len) throws SQLException
-
将所有或部分给定的
byte
数组写入此Blob
对象表示的BLOB
值中,并返回写入的字节数。写入操作从BLOB
值中的位置pos
处开始;写入给定字节数组中的len
个字节。 -
- 参数:
-
pos
-BLOB
对象开始进行写入操作的位置 -
bytes
- 要写入此BLOB
对象中的字节数组 -
offset
- 数组bytes
中的偏移量,从此处开始读取要设置的字节 -
len
- 字节数组bytes
中写入BLOB
值的字节数 - 返回:
- 写入的字节数
- 抛出:
-
SQLException
- 如果访问BLOB
值时发生错误 - 从以下版本开始:
- 1.4
- 另请参见:
-
getBytes(long, int)