SerialClob (Java Platform SE 8 )

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

All Implemented Interfaces:

Serializable， Cloneable， Clob
```
public class SerialClob
extends Object
implements Clob, Serializable, Cloneable
```
序列化映射在一个SQL CLOB价值java编程语言。
的SerialClob类提供了用于创建从一个Clob对象实例构造函数。请注意，Clob对象应该把SQL CLOB值的数据到客户端之前，SerialClob对象是由它。一个SQL CLOB值的数据可以实现在客户端作为一个流的Unicode字符。

SerialClob方法使人们有可能从一个SerialClob对象或子串定位模式的字符开始。

线程安全

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

另请参见：

Serialized Form

构造方法摘要

构造方法
Constructor and Description
`SerialClob(char[] ch)` 构建了一个 `SerialClob`对象，序列化版本给出的 `char`阵列。
`SerialClob(Clob clob)` 构建了一个 `SerialClob`对象，序列化版本给出的 `Clob`对象。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`Object`	`clone()` 返回该 `SerialClob`克隆。
`boolean`	`equals(Object obj)` 比较SerialClob到指定的对象。
`void`	`free()` 这种方法使 `SeriableClob`对象并释放资源，它拥有。
`InputStream`	`getAsciiStream()` 检索 `CLOB`值指定的 `SerialClob`对象作为一个ASCII流。
`Reader`	`getCharacterStream()` 作为一个流的Unicode字符，返回此对象的数据 `SerialClob`。
`Reader`	`getCharacterStream(long pos, long length)` 返回一个 `Reader`对象包含一个部分 `SerialClob`价值，从指定的POS机的特点，这是长度的字符。
`String`	`getSubString(long pos, int length)` 返回包含在这 `SerialClob`对象副本的指定位置开始的子串，并继续为指定数字或字符。
`int`	`hashCode()` 返回此 `SerialClob`哈希代码。
`long`	`length()` 在这 `SerialClob`字符检索对象的数组中的字符数。
`long`	`position(Clob searchStr, long start)` 返回的位置在这 `SerialClob`对象在给定 `Clob`签名开始，从指定位置开始搜索。
`long`	`position(String searchStr, long start)` 返回的位置在这 `SerialClob`对象在给定 `String`对象开始，从指定位置开始搜索。
`OutputStream`	`setAsciiStream(long pos)` 检索一个流是用来写字的ASCII字符，这 `SerialClob`对象代表 `CLOB`价值，开始位置 `pos`。
`Writer`	`setCharacterStream(long pos)` 检索一个流来写一个流的Unicode字符，这 `SerialClob`对象代表 `CLOB`值，在位置 `pos`。
`int`	`setString(long pos, String str)` 写了 `String` java，这 `SerialClob`对象代表 `CLOB`值，在位置 `pos`。
`int`	`setString(long pos, String str, int offset, int length)` 写 `str` `len`字符，在字符 `offset`，这种 `Clob`代表 `CLOB`价值。
`void`	`truncate(long length)` 截断这 `SerialClob`对象表示，它的长度 `len`人物 `CLOB`价值。

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

- Constructor Detail
  - SerialClob
```
public SerialClob(char[] ch)
           throws SerialException,
                  SQLException
```
    构建了一个 SerialClob对象，序列化版本给出的 char阵列。
    新SerialClob对象是从char阵列数据初始化，从而允许断开RowSet对象建立对象序列化Clob不接触数据源。
    
    参数
    
    ch代表 Clob对象被序列化的数组
    
    异常
    
    SerialException -如果在序列化期间发生错误
    
    SQLException如果SQL错误发生
  - SerialClob
```
public SerialClob(Clob clob)
           throws SerialException,
                  SQLException
```
    构建了一个 SerialClob对象，序列化版本给出的 Clob对象。
    新SerialClob对象是从Clob对象数据初始化的对象；因此，Clob应该以前带SQL CLOB值的数据到客户端数据库。否则，新的SerialClob对象将不包含数据。
    
    注：本Clob对象提供此构造函数必须返回的Clob.getCharacterStream()和Clob.getAsciiStream方法非空。这SerialClob构造函数不能序列化的对象在这种情况Clob将抛出一个SQLException对象。
    
    参数
    
    clob -从这 SerialClob对象被构造， Clob对象；不能为空
    
    异常
    
    SerialException -如果在序列化期间发生错误
    
    SQLException如果捕捉CLOB出现SQL错误；如果 Clob对象为空；或者在 Clob的 Clob.getCharacterStream()和 Clob.getAsciiStream()方法返回一个空
    
    另请参见：
    
    Clob
- 方法详细信息
  - length
```
public long length()
            throws SerialException
```
    在这 SerialClob字符检索对象的数组中的字符数。
    
    Specified by:
    
    length 接口 Clob
    
    结果
    
    一个 long指示在性格这 SerialClob对象的字符数组的长度
    
    异常
    
    SerialException -如果发生错误；如果 free以前被称为该对象
  - getCharacterStream
```
public Reader getCharacterStream()
                          throws SerialException
```
    作为一个流的Unicode字符，返回此对象的数据 SerialClob。与相关的方法， getAsciiStream、一个流生产无论 SerialClob对象是一个 Clob对象或 char阵列创建。
    
    Specified by:
    
    getCharacterStream 接口 Clob
    
    结果
    
    包含此对象的数据对象 SerialClob java.io.Reader
    
    异常
    
    SerialException -如果发生错误；如果 free以前被称为该对象
    
    另请参见：
    
    Clob.setCharacterStream(long)
  - getAsciiStream
```
public InputStream getAsciiStream()
                           throws SerialException,
                                  SQLException
```
    检索 CLOB值指定的 SerialClob对象作为一个ASCII流。该方法将 getAsciiStream调用基础 Clob对象的事件，这 SerialClob对象实例化一个对象 Clob。如果这 SerialClob对象实例化一个 char阵列，一个 SerialException抛出对象。
    
    Specified by:
    
    getAsciiStream 接口 Clob
    
    结果
    
    包含此对象的数据对象 SerialClob java.io.InputStream
    
    异常
    
    SerialException -如果这 SerialClob对象没有实例化一个 Clob对象；如果 free以前被称为该对象
    
    SQLException -如果有一个错误的 Clob访问对象，用于创建此 SerialClob对象表示的 CLOB价值
    
    另请参见：
    
    Clob.setAsciiStream(long)
  - getSubString
```
public String getSubString(long pos,
                           int length)
                    throws SerialException
```
    返回包含在这 SerialClob对象副本的指定位置开始的子串，并继续为指定数字或字符。
    
    Specified by:
    
    getSubString 接口 Clob
    
    参数
    
    pos的子字符串的第一个字符的位置被复制；对 SerialClob对象的第一个字符位置为 1；不得少于 1，和起始位置和子字符串的长度必须小于这个 SerialClob对象的长度
    
    length -子字符串的字符数退还；不得超过本 SerialClob对象的长度和起始位置和子字符串的长度必须小于这个 SerialClob对象的长度
    
    结果
    
    包含子串的 SerialClob对象在给定位置和包含指定数量的连续字符的开始 String对象
    
    异常
    
    SerialException -如果实参是出界；如果 free以前被称为该对象
  - position
```
public long position(String searchStr,
                     long start)
              throws SerialException,
                     SQLException
```
    返回的位置在这 SerialClob对象在给定 String对象开始，从指定位置开始搜索。此方法返回 -1如果模式没有被发现。
    
    Specified by:
    
    position 接口 Clob
    
    参数
    
    searchStr -要搜索的对象的 String
    
    start -在这 SerialClob对象在该位置开始搜索；第一的位置 1；不得小于或大于这个 1 SerialClob对象的长度
    
    结果
    
    在这个位置的给定的 String对象开始，从指定位置开始搜索； -1如果给定的 String未发现目标或起始位置是出界；职位编号为返回值从 1
    
    异常
    
    SerialException -如果 free方法以前称为对象
    
    SQLException -如果有一个错误的数据库访问CLOB值。
  - position
```
public long position(Clob searchStr,
                     long start)
              throws SerialException,
                     SQLException
```
    返回的位置在这 SerialClob对象在给定 Clob签名开始，从指定位置开始搜索。此方法返回 -1如果模式没有被发现。
    
    Specified by:
    
    position 接口 Clob
    
    参数
    
    searchStr -要搜索的对象的 Clob
    
    start -在这 SerialClob对象在该位置开始搜索；第一的位置 1；不得小于或大于这个 1 SerialClob对象的长度
    
    结果
    
    在这个位置的给定的 Clob对象开始在这 SerialClob对象，或在指定的起始位置
    
    异常
    
    SerialException -如果出现错误定位的CLOB签名；如果 free方法以前称为对象
    
    SQLException -如果有一个错误的数据库访问CLOB值
  - setString
```
public int setString(long pos,
                     String str)
              throws SerialException
```
    写了 String java，这 SerialClob对象代表 CLOB值，在位置 pos。
    
    Specified by:
    
    setString 接口 Clob
    
    参数
    
    在这 pos位置开始写作，这 SerialClob对象代表 CLOB价值；第一的位置 1；不得小于或大于这个 1 SerialClob对象的长度
    
    str -被写入，这 SerialClob对象代表 CLOB值的字符串
    
    结果
    
    写的字符数
    
    异常
    
    SerialException -如果有错误访问 CLOB值；如果一个无效的位置；如果一个无效的偏移值设置；如果要写入的字节数大于 SerialClob长度；或长度和偏移的组合值大于最大缓冲区；如果 free方法以前呼吁这个对象
  - setString
```
public int setString(long pos,
                     String str,
                     int offset,
                     int length)
              throws SerialException
```
    写 len人物性格 str，开始 offset，这种 Clob代表 CLOB价值。
    
    Specified by:
    
    setString 接口 Clob
    
    参数
    
    在这 pos位置开始写作，这 SerialClob对象代表 CLOB价值；第一的位置 1；不得小于或大于这个 1 SerialClob对象的长度
    
    str -被写入，这 Clob对象代表 CLOB值的字符串
    
    offset -偏移到 str开始读取的字符被写入
    
    length -要写入的字符数
    
    结果
    
    写的字符数
    
    异常
    
    SerialException -如果有错误访问 CLOB值；如果一个无效的位置；如果一个无效的偏移值设置；如果要写入的字节数大于 SerialClob长度；或长度和偏移的组合值大于最大缓冲区；如果 free方法以前呼吁这个对象
  - setAsciiStream
```
public OutputStream setAsciiStream(long pos)
                            throws SerialException,
                                   SQLException
```
    检索一个流是用来写字的ASCII字符，这 SerialClob对象代表 CLOB价值，开始位置 pos。该方法将 setAsciiStream()调用基础 Clob对象的事件，这 SerialClob对象实例化一个对象 Clob。如果这 SerialClob对象实例化一个 char阵列，一个 SerialException抛出对象。
    
    Specified by:
    
    setAsciiStream 接口 Clob
    
    参数
    
    在这 pos位置开始写的 CLOB对象
    
    结果
    
    流，ASCII编码的字符可以写
    
    异常
    
    SerialException -如果SerialClob不使用CLOB对象；如果 free方法以前称为对象
    
    SQLException -如果有错误访问 CLOB价值
    
    另请参见：
    
    getAsciiStream()
  - setCharacterStream
```
public Writer setCharacterStream(long pos)
                          throws SerialException,
                                 SQLException
```
    检索一个流来写一个流的Unicode字符，这 SerialClob对象代表 CLOB值，在位置 pos。该方法将 setCharacterStream()调用基础 Clob对象的事件，这 SerialClob对象实例化一个对象 Clob。如果这 SerialClob对象实例化一个 char阵列，一个 SerialException抛出。
    
    Specified by:
    
    setCharacterStream 接口 Clob
    
    参数
    
    在这 pos位置开始写的 CLOB价值
    
    结果
    
    一个流中的Unicode编码的字符可以写
    
    异常
    
    SerialException -如果serialclob不使用CLOB对象；如果 free方法以前称为对象
    
    SQLException -如果有错误访问 CLOB价值
    
    另请参见：
    
    getCharacterStream()
  - truncate
```
public void truncate(long length)
              throws SerialException
```
    截断这 SerialClob对象表示，它的长度 len人物 CLOB价值。
    截断SerialClob对象长度0具有清其含量的影响。
    
    Specified by:
    
    truncate 接口 Clob
    
    参数
    
    length的长度，以字节为单位，而 CLOB值应被截断
    
    异常
    
    SerialException -如果有错误访问 CLOB值；如果 free方法以前称为对象
  - getCharacterStream
```
public Reader getCharacterStream(long pos,
                                 long length)
                          throws SQLException
```
    返回一个 Reader对象包含一个部分 SerialClob价值，从指定的POS机的特点，这是长度的字符。
    
    Specified by:
    
    getCharacterStream 接口 Clob
    
    参数
    
    pos -偏移量的部分值的第一个字符进行检索。在 SerialClob第一个字符位置为1。
    
    length在部分价值特征长度要检索。
    
    结果
    
    Reader通过这部分 SerialClob值可以读取。
    
    异常
    
    SQLException如果POS小于1或者大于 SerialClob POS中的字符数或如果POS +长度大于在 SerialClob字符数；
    
    SerialException -如果 free方法以前称为对象
    
    从以下版本开始：
    
    一点六
  - free
```
public void free()
          throws SQLException
```
    这种方法使 SeriableClob对象并释放资源，它拥有。物体一旦 free方法是无效的。
    如果free调用多次，以free随后电话被视为一个空操作。
    
    Specified by:
    
    free 接口 Clob
    
    异常
    
    SQLException -如果出现错误释放CLOB的资源
    
    从以下版本开始：
    
    一点六
  - equals
```
public boolean equals(Object obj)
```
    比较SerialClob到指定的对象。其结果是 true如果只有参数不 null是 SerialClob表示相同的字符序列对象。
    
    重写：
    
    equals 方法重写，继承类 Object
    
    参数
    
    obj的对象比较 SerialClob反对
    
    结果
    
    true如果给定对象代表一个 SerialClob相当于这serialclob， false否则
    
    另请参见：
    
    Object.hashCode()， HashMap
  - hashCode
```
public int hashCode()
```
    返回此 SerialClob哈希代码。
    
    重写：
    
    hashCode 方法重写，继承类 Object
    
    结果
    
    此对象的哈希代码值。
    
    另请参见：
    
    Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)
  - clone
```
public Object clone()
```
    返回该 SerialClob克隆。的副本将包含一个指向字符数组的内部的一个克隆，不参考原始内部的字符数组，这个 SerialClob对象。潜在的 Clob对象将被设置为null。
    
    重写：
    
    clone 方法重写，继承类 Object
    
    结果
    
    这个SerialClob的克隆
    
    另请参见：
    
    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 SerialClob

线程安全

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

SerialClob

SerialClob

方法详细信息

length

getCharacterStream

getAsciiStream

getSubString

position

position

setString

setString

setAsciiStream

setCharacterStream

truncate

getCharacterStream

free

equals

hashCode

clone