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

Все Известные Подынтерфейсы:

NClob

Все Известные Классы с реализацией:

SerialClob
```
public interface Clob
```
Отображение в языке программирования ^JavaTM для SQL CLOB ввести. SQL CLOB встроенный тип, который хранит Символьный Большой Объект как значение столбца подряд таблицы базы данных. Драйверами по умолчанию реализуют a Clob объект используя SQL locator(CLOB), что означает это a Clob объект содержит логический указатель на SQL CLOB данные, а не данные непосредственно. A Clob объект допустим для продолжительности транзакции, в которой это создавалось.
Clob интерфейс обеспечивает методы для того, чтобы они получили длину SQL CLOB (Символьный Большой Объект) значение, для того, чтобы осуществить a CLOB значение на клиенте, и для того, чтобы искать подстроку или CLOB объект в пределах a CLOB значение. Методы в интерфейсах ResultSet, CallableStatement, и PreparedStatement, такой как getClob и setClob позвольте программисту получать доступ к SQL CLOB значение. Кроме того, у этого интерфейса есть методы для того, чтобы обновить a CLOB значение.
Все методы на Clob интерфейс должен быть полностью реализован, если драйвер JDBC поддерживает тип данных.

С тех пор:

1.2

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

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

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

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

Интерфейсный Clob

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

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

длина

getSubString

getCharacterStream

getAsciiStream

позиция

позиция

setString

setString

setAsciiStream

setCharacterStream

усеченный

свободный

getCharacterStream