SerialClob (Платформа Java SE 7)

java.lang. Объект
- javax.sql.rowset.serial. SerialClob

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable, Clob
```
public class SerialClob
extends Object
implements Clob, Serializable, Cloneable
```
Сериализированное отображение в языке программирования Java SQL CLOB значение.
SerialClob класс предоставляет конструктору для того, чтобы он создал экземпляр из a Clob объект. Отметьте что Clob объект должен был принести SQL CLOB данные значения клиенту прежде a SerialClob объект создается из этого. Данные SQL CLOB значение может быть осуществлено на клиенте как поток символов Unicode.
SerialClob методы позволяют получить подстроку от a SerialClob возразите или определять местоположение запуска образца символов.

См. Также:
Сериализированная Форма

Сводка конструктора

Конструкторы
Конструктор и Описание
`SerialClob(char[] ch)` Конструкции a `SerialClob` объект, который является сериализированной версией данного `char` массив.
`SerialClob(Clob clob)` Конструкции a `SerialClob` объект, который является сериализированной версией данного `Clob` объект.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`void`	`free()` Этот метод освобождает `Clob` возразите и высвобождает средства ресурсы, которые это содержит.
`InputStream`	`getAsciiStream()` Получает `CLOB` значение определяется этим `SerialClob` возразите как ascii поток.
`Читатель`	`getCharacterStream()` Возвраты это `SerialClob` данные объекта как поток символов Unicode.
`Читатель`	`getCharacterStream(long pos, long length)` Возвраты a `Reader` объект, который содержит частичное `Clob` значение, запускающееся с символа, определенного на месте продажи, который является символами длины в длине.
`Строка`	`getSubString(long pos, int length)` Возвращает копию подстроки, содержавшейся в этом `SerialClob` объект, запускающийся в данной позиции и продолжающийся для конкретного количества или символов.
`long`	`length()` Получает число символов в этом `SerialClob` массив объекта символов.
`long`	`position(Clob searchStr, long start)` Возвращает позицию в этом `SerialClob` возразите где данный `Clob` подпись начинается, запуская поиск в указанной позиции.
`long`	`position(String searchStr, long start)` Возвращает позицию в этом `SerialClob` возразите где данный `String` объект начинается, запуская поиск в указанной позиции.
`OutputStream`	`setAsciiStream(long pos)` Получает поток, который будет использоваться, чтобы записать символы Аския в `CLOB` значение, что это `SerialClob` объект представляет, запускаясь в позиции `pos`.
`Писатель`	`setCharacterStream(long pos)` Получает поток, который будет использоваться, чтобы записать поток символов Unicode к `CLOB` значение, что это `SerialClob` объект представляет в позиции `pos`.
`int`	`setString(long pos, String str)` Пишет данный Java `String` к `CLOB` значение, что это `SerialClob` объект представляет в позиции `pos`.
`int`	`setString(long pos, String str, int offset, int length)` Записи `len` символы `str`, запуск в символе `offset`, к `CLOB` значение, что это `Clob` представляет.
`void`	`truncate(long length)` Усекает `CLOB` значение, что это `SerialClob` объект представляет так, чтобы у него была длина `len` символы.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - SerialClob
```
public SerialClob(char[] ch)
           throws SerialException,
                  SQLException
```
    Конструкции a SerialClob объект, который является сериализированной версией данного char массив.
    Новое SerialClob объект инициализируется с данными от char массив, таким образом позволяя разъединенный RowSet объекты установить сериализированный Clob объект, не касаясь источника данных.
    
    Параметры:
    ch - массив случайной работы, представляющий Clob объект, который будет сериализирован
    
    Броски:
    
    SerialException - если ошибка происходит во время сериализации
    
    SQLException - если ошибка SQL происходит
  - SerialClob
```
public SerialClob(Clob clob)
           throws SerialException,
                  SQLException
```
    Конструкции a SerialClob объект, который является сериализированной версией данного Clob объект.
    Новое SerialClob объект инициализируется с данными от Clob объект; поэтому, Clob объект должен был ранее принести SQL CLOB данные значения клиенту от базы данных. Иначе, новое SerialClob объектный объект не будет содержать данных.
    Отметьте: Clob объект, предоставленный этому конструктору, должен возвратить ненуль для обоих Clob.getCharacterStream() и Clob.getAsciiStream методы. Это SerialClob конструктор не может сериализировать a Clob объект в этом экземпляре и бросит SQLException объект.
    
    Параметры:
    clob - Clob объект тот, от который это SerialClob объект состоит в том, чтобы быть создан; не может быть нуль
    
    Броски:
    
    SerialException - если ошибка происходит во время сериализации
    
    SQLException - если ошибка SQL происходит в получении CLOB; если Clob объект является нулем; или если любой из Clob.getCharacterStream() и Clob.getAsciiStream() методы на Clob возвращает нуль
    См. Также:
    Clob
- Деталь метода
  - длина
```
public long length()
            throws SerialException
```
    Получает число символов в этом SerialClob массив объекта символов.
    
    Определенный:
    
    length в интерфейсе Clob
    
    Возвраты:
    a long указание на длину в символах этого SerialClob массив объекта символа
    
    Броски:
    
    SerialException - если ошибка происходит
  - getCharacterStream
```
public Reader getCharacterStream()
                          throws SerialException
```
    Возвраты это SerialClob данные объекта как поток символов Unicode. В отличие от связанного метода, getAsciiStream, поток производится независимо от ли SerialClob объект создавался с a Clob объект или a char массив.
    
    Определенный:
    
    getCharacterStream в интерфейсе Clob
    
    Возвраты:
    a java.io.Reader объект, содержащий это SerialClob данные объекта
    
    Броски:
    
    SerialException - если ошибка происходит
    См. Также:
    Clob.setCharacterStream(long)
  - getAsciiStream
```
public InputStream getAsciiStream()
                           throws SerialException,
                                  SQLException
```
    Получает CLOB значение определяется этим SerialClob возразите как ascii поток. Этот метод вперед getAsciiStream призовите к базовому Clob возразите когда это SerialClob объект инстанцируют с a Clob объект. Если это SerialClob объект инстанцируют с a char массив, a SerialException объект бросается.
    
    Определенный:
    
    getAsciiStream в интерфейсе Clob
    
    Возвраты:
    a java.io.InputStream объект, содержащий это SerialClob данные объекта
    
    Броски:
    
    SerialException - если это SerialClob объект не инстанцировали с a Clob объект
    
    SQLException - если есть ошибка, получая доступ CLOB значение, представленное Clob объект, который использовался, чтобы создать это SerialClob объект
    См. Также:
    Clob.setAsciiStream(long)
  - getSubString
```
public String getSubString(long pos,
                  int length)
                    throws SerialException
```
    Возвращает копию подстроки, содержавшейся в этом SerialClob объект, запускающийся в данной позиции и продолжающийся для конкретного количества или символов.
    
    Определенный:
    
    getSubString в интерфейсе Clob
    
    Параметры:
    pos - позиция первого символа в подстроке, которая будет скопирована; первый символ SerialClob объект в позиции 1; не должны быть меньше чем 1, и сумма стартовой позиции и длина подстроки должны быть меньше чем длина этого SerialClob объект
    length - число символов в подстроке, которая будет возвращена; не должно быть больше чем длина этого SerialClob объект, и сумма стартовой позиции и длина подстроки должны быть меньше чем длина этого SerialClob объект
    
    Возвраты:
    a String объект, содержащий подстроку этого SerialClob объект, начинающийся в данной позиции и содержащий конкретное количество последовательных символов
    
    Броски:
    
    SerialException - если любой из параметров за пределы
  - позиция
```
public long position(String searchStr,
            long start)
              throws SerialException,
                     SQLException
```
    Возвращает позицию в этом SerialClob возразите где данный String объект начинается, запуская поиск в указанной позиции. Этот метод возвраты -1 если образец не находится.
    
    Определенный:
    
    position в интерфейсе Clob
    
    Параметры:
    searchStr - String объект, который можно искать
    start - позиция в этом SerialClob объект, в котором можно запустить поиск; первая позиция 1; не должны быть меньше чем 1 ни больше чем длина этого SerialClob объект
    
    Возвраты:
    позиция та, в который данный String объект начинается, запуская поиск в указанной позиции; -1 если данный String объект не находится, или стартовая позиция за пределы; нумерация позиции для возвращаемого значения запускается в 1
    
    Броски:
    
    SerialException - если ошибка происходит, определяя местоположение Строковой подписи
    
    SQLException - если есть ошибка, получая доступ к значению Блоба от базы данных.
  - позиция
```
public long position(Clob searchStr,
            long start)
              throws SerialException,
                     SQLException
```
    Возвращает позицию в этом SerialClob возразите где данный Clob подпись начинается, запуская поиск в указанной позиции. Этот метод возвраты -1 если образец не находится.
    
    Определенный:
    
    position в интерфейсе Clob
    
    Параметры:
    searchStr - Clob объект, который можно искать
    start - позиция в этом SerialClob объект, в котором можно начать поиск; первая позиция 1; не должны быть меньше чем 1 ни больше чем длина этого SerialClob объект
    
    Возвраты:
    позиция та, в который данный Clob объект начинается в этом SerialClob объект, в или после указанной стартовой позиции
    
    Броски:
    
    SerialException - если ошибка происходит, определяя местоположение подписи Clob
    
    SQLException - если есть ошибка, получая доступ к значению Блоба от базы данных
  - setString
```
public int setString(long pos,
            String str)
              throws SerialException
```
    Пишет данный Java String к CLOB значение, что это SerialClob объект представляет в позиции pos.
    
    Определенный:
    
    setString в интерфейсе Clob
    
    Параметры:
    pos - позиция, в которой можно начать писать в CLOB значение, что это SerialClob объект представляет; первая позиция 1; не должны быть меньше чем 1 ни больше чем длина этого SerialClob объект
    str - строка, которая будет записана CLOB значение, что это SerialClob объект представляет
    
    Возвраты:
    число записанных символов
    
    Броски:
    
    SerialException - если есть ошибка, получая доступ CLOB значение; если недопустимая позиция устанавливается; если недопустимое значение смещения устанавливается; если число байтов, которые будут записаны, больше чем SerialClob длина; или общая стоимость длины и смещения больше чем буфер Clob
  - setString
```
public int setString(long pos,
            String str,
            int offset,
            int length)
              throws SerialException
```
    Записи len символы str, запуск в символе offset, к CLOB значение, что это Clob представляет.
    
    Определенный:
    
    setString в интерфейсе Clob
    
    Параметры:
    pos - позиция, в которой можно начать писать в CLOB значение, что это SerialClob объект представляет; первая позиция 1; не должны быть меньше чем 1 ни больше чем длина этого SerialClob объект
    str - строка, которая будет записана CLOB значение, что это Clob объект представляет
    offset - смещение в str начинать читать символы, которые будут записаны
    length - число символов, которые будут записаны
    
    Возвраты:
    число записанных символов
    
    Броски:
    
    SerialException - если есть ошибка, получая доступ CLOB значение; если недопустимая позиция устанавливается; если недопустимое значение смещения устанавливается; если число байтов, которые будут записаны, больше чем SerialClob длина; или общая стоимость длины и смещения больше чем буфер Clob
  - setAsciiStream
```
public OutputStream setAsciiStream(long pos)
                            throws SerialException,
                                   SQLException
```
    Получает поток, который будет использоваться, чтобы записать символы Аския в CLOB значение, что это SerialClob объект представляет, запускаясь в позиции pos. Этот метод вперед setAsciiStream() призовите к базовому Clob возразите когда это SerialClob объект инстанцируют с a Clob объект. Если это SerialClob объект инстанцируют с a char массив, a SerialException объект бросается.
    
    Определенный:
    
    setAsciiStream в интерфейсе Clob
    
    Параметры:
    pos - позиция, в которой можно начать писать в CLOB объект
    
    Возвраты:
    поток, которому ASCII могут быть записаны закодированные символы
    
    Броски:
    
    SerialException - если SerialClob не инстанцируют с объектом Clob, который поддерживает setAsciiStream
    
    SQLException - если есть ошибка, получая доступ CLOB значение
    См. Также:
    getAsciiStream()
  - setCharacterStream
```
public Writer setCharacterStream(long pos)
                          throws SerialException,
                                 SQLException
```
    Получает поток, который будет использоваться, чтобы записать поток символов Unicode к CLOB значение, что это SerialClob объект представляет в позиции pos. Этот метод вперед setCharacterStream() призовите к базовому Clob возразите когда это SerialClob объект инстанцируют с a Clob объект. Если это SerialClob объект инстанцируют с a char массив, a SerialException бросается.
    
    Определенный:
    
    setCharacterStream в интерфейсе Clob
    
    Параметры:
    pos - позиция, в которой можно начать писать в CLOB значение
    
    Возвраты:
    поток, которому Unicode могут быть записаны закодированные символы
    
    Броски:
    
    SerialException - если SerialClob не инстанцируют с объектом Clob, который поддерживает setCharacterStream
    
    SQLException - если есть ошибка, получая доступ CLOB значение
    См. Также:
    getCharacterStream()
  - усеченный
```
public void truncate(long length)
              throws SerialException
```
    Усекает CLOB значение, что это SerialClob объект представляет так, чтобы у него была длина len символы.
    Усечение a SerialClob возразите против длины 0, имеет эффект очистки его содержания.
    
    Определенный:
    
    truncate в интерфейсе Clob
    
    Параметры:
    length - длина та, в байтах, к который CLOB значение должно быть усеченным
    
    Броски:
    
    SQLException - если есть ошибка, получая доступ CLOB значение
    
    SerialException
  - getCharacterStream
```
public Reader getCharacterStream(long pos,
                        long length)
                          throws SQLException
```
    Описание скопировало с интерфейса: Clob
    
    Возвраты a Reader объект, который содержит частичное Clob значение, запускающееся с символа, определенного на месте продажи, который является символами длины в длине.
    
    Определенный:
    
    getCharacterStream в интерфейсе Clob
    
    Параметры:
    pos - смещение к первому символу частичного значения, которое будет получено. Первый символ в Clob в позиции 1.
    length - длина в символах частичного значения, которое будет получено.
    
    Возвраты:
    Reader через который частичное Clob значение может быть считано.
    
    Броски:
    
    SQLException - если на месте продажи меньше чем 1 или если на месте продажи больше чем число символов в Clob или если на месте продажи + длина больше чем число символов в Clob
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
  - свободный
```
public void free()
          throws SQLException
```
    Описание скопировало с интерфейса: Clob
    
    Этот метод освобождает Clob возразите и высвобождает средства ресурсы, которые это содержит. Объект недопустим однажды free метод вызывают.
    После free был вызван, любая попытка вызвать метод кроме free приведет к a SQLException быть брошенным. Если free вызывается многократно, последующие звонки free обрабатываются как нет.
    
    Определенный:
    
    free в интерфейсе Clob
    
    Броски:
    
    SQLException - если ошибка происходит, высвобождая средства Клоба
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс SerialClob

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

SerialClob

SerialClob

Деталь метода

длина

getCharacterStream

getAsciiStream

getSubString

позиция

позиция

setString

setString

setAsciiStream

setCharacterStream

усеченный

getCharacterStream

свободный