|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.sql
接口 Clob
- 所有已知实现类:
- SerialClob
-
public interface Clob
SQL 类型 CLOB
在 JavaTM 编程语言中的映射关系。SQL CLOB
是内置类型,它将 Character Large Object 存储为数据库表的某一行中的一个列值。默认情况下,驱动程序使用 SQL locator(CLOB)
实现 Clob
对象,这意味着 CLOB
对象包含一个指向 SQL CLOB
数据而不是数据本身的逻辑指针。Clob
对象在它被创建的事务处理期间有效。
CLOB
接口提供某些方法来获得 SQL CLOB
(Character Large Object) 值长度、在客户端实现 CLOB
值以及搜索子字符串或 CLOB
值中的 CLOB
对象。接口 ResultSet
、CallableStatement
和 PreparedStatement
中的方法(如 getClob
和 setClob
)允许编程人员访问 SQL CLOB
值。此外,此接口还拥有更新 CLOB
值的方法。
- 从以下版本开始:
- 1.2
方法摘要 | |
---|---|
InputStream |
getAsciiStream() 以 ascii 流形式检索由此 Clob 对象指定的 CLOB 值。 |
Reader |
getCharacterStream() 以 java.io.Reader 对象形式(或字符流形式)检索此 Clob 对象指定的 CLOB 值。 |
String |
getSubString(long pos, int length) 检索此 Clob 对象指定的 CLOB 值中指定子字符串的副本。 |
long |
length() 检索此 Clob 对象指定的 CLOB 值中的字符数。 |
long |
position(Clob searchstr, long start) 检索此 Clob 对象中指定的 Clob 对象 searchstr 出现的字符位置。 |
long |
position(String searchstr, long start) 检索由此 Clob 对象表示的 SQL CLOB 值中指定子字符串 searchstr 出现的字符位置。 |
OutputStream |
setAsciiStream(long pos) 检索用于将 Ascii 字符写入此 Clob 对象表示的 Clob 值中的流,从位置 pos 处开始。 |
Writer |
setCharacterStream(long pos) 检索用于将 Unicode 字符流写入此 Clob 对象表示的 CLOB 值中(位置 pos 处)的流。 |
int |
setString(long pos, String str) 在位置 pos 处将给定 Java String 写入此 Clob 对象指定的 CLOB 值中。 |
int |
setString(long pos, String str, int offset, int len) 将 str 的 len 个字符写入此 Clob 表示的 CLOB 值中,从字符 offset 开始。 |
void |
truncate(long len) 截取此 Clob 指定的 CLOB 值,使其长度为 len 个字符。 |
方法详细信息 |
---|
length
long length() throws SQLException
-
检索此
Clob
对象指定的CLOB
值中的字符数。 -
- 返回:
-
CLOB
的字符长度 - 抛出:
-
SQLException
- 如果访问CLOB
值的长度时发生错误 - 从以下版本开始:
- 1.2
getSubString
String getSubString(long pos, int length) throws SQLException
-
检索此
Clob
对象指定的CLOB
值中指定子字符串的副本。子字符串开始于位置pos
处,有length
个连续字符。 -
- 参数:
-
pos
- 要提取的子字符串的第一个字符。第一个字符位于位置 1 处。 -
length
- 要复制的连续字符的数量 - 返回:
-
一个
String
,它是由此Clob
对象指定的CLOB
值中的指定子字符串 - 抛出:
-
SQLException
- 如果访问CLOB
值时发生错误 - 从以下版本开始:
- 1.2
getCharacterStream
Reader getCharacterStream() throws SQLException
-
以
java.io.Reader
对象形式(或字符流形式)检索此Clob
对象指定的CLOB
值。 -
- 返回:
-
包含
CLOB
数据的java.io.Reader
对象 - 抛出:
-
SQLException
- 如果访问CLOB
值时发生错误 - 从以下版本开始:
- 1.2
- 另请参见:
-
setCharacterStream(long)
getAsciiStream
InputStream getAsciiStream() throws SQLException
-
以 ascii 流形式检索由此
Clob
对象指定的CLOB
值。 -
- 返回:
-
包含
CLOB
数据的java.io.InputStream
对象 - 抛出:
-
SQLException
- 如果访问CLOB
值时发生错误 - 从以下版本开始:
- 1.2
- 另请参见:
-
setAsciiStream(long)
position
long position(String searchstr, long start) throws SQLException
-
检索由此
Clob
对象表示的 SQLCLOB
值中指定子字符串searchstr
出现的字符位置。从位置start
开始搜索。 -
- 参数:
-
searchstr
- 要搜索的子字符串 -
start
- 开始搜索的位置;第一个位置是 1 - 返回:
- 子字符串出现的位置,如果子字符串没有出现,则返回 -1;第一个位置是 1
- 抛出:
-
SQLException
- 如果访问CLOB
值时发生错误 - 从以下版本开始:
- 1.2
position
long position(Clob searchstr, long start) throws SQLException
-
检索此
Clob
对象中指定的Clob
对象searchstr
出现的字符位置。从位置start
开始搜索。 -
- 参数:
-
searchstr
- 要搜索的Clob
对象 -
start
- 开始搜索的位置;第一个位置是 1 - 返回:
-
Clob
对象出现的位置,如果子字符串没有出现,则返回 -1;第一个位置是 1 - 抛出:
-
SQLException
- 如果访问CLOB
值时发生错误 - 从以下版本开始:
- 1.2
setString
int setString(long pos, String str) throws SQLException
-
在位置
pos
处将给定 JavaString
写入此Clob
对象指定的CLOB
值中。 -
- 参数:
-
pos
- 开始写入此Clob
对象表示的CLOB
值的位置 -
str
- 要写入此Clob
指定的CLOB
值中的字符串 - 返回:
- 写入的字符数
- 抛出:
-
SQLException
- 如果访问CLOB
值时发生错误 - 从以下版本开始:
- 1.4