Spec-Zone .ru
спецификации, руководства, описания, API
|
public interface Clob
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 поддерживает тип данных.
Модификатор и Тип | Метод и Описание |
---|---|
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 не поддерживает этот методString getSubString(long pos, int length) throws SQLException
CLOB
значение определяется этим Clob
объект. Подстрока начинается в позиции pos
и имеет до length
последовательные символы.pos
- первый символ подстроки, которая будет извлечена. Первый символ в позиции 1.length
- число последовательных символов, которые будут скопированы; значение для длины должно быть 0 или большеString
это - указанная подстрока в CLOB
значение определяется этим Clob
объектSQLException
- если есть ошибка, получая доступ CLOB
значение; если на месте продажи меньше чем 1, или длина - меньше чем 0SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методReader getCharacterStream() throws SQLException
CLOB
значение определяется этим Clob
возразите как a java.io.Reader
объект (или как поток символов).java.io.Reader
объект, содержащий CLOB
данныеSQLException
- если есть ошибка, получая доступ CLOB
значениеSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методsetCharacterStream(long)
InputStream getAsciiStream() throws SQLException
CLOB
значение определяется этим Clob
возразите как ascii поток.java.io.InputStream
объект, содержащий CLOB
данныеSQLException
- если есть ошибка, получая доступ CLOB
значениеSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методsetAsciiStream(long)
long position(String searchstr, long start) throws SQLException
searchstr
появляется в SQL CLOB
значение представляется этим Clob
объект. Поиск начинается в позиции start
.searchstr
- подстрока, которую можно искатьstart
- позиция, в которой можно начать искать; первая позиция 1SQLException
- если есть ошибка, получая доступ CLOB
значение или если на месте продажи меньше чем 1SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методlong position(Clob searchstr, long start) throws SQLException
Clob
объект searchstr
появляется в этом Clob
объект. Поиск начинается в позиции start
.searchstr
- Clob
объект, который можно искатьstart
- позиция, в которой можно начать искать; первая позиция 1Clob
объект появляется или-1, если он не присутствует; первая позиция 1SQLException
- если есть ошибка, получая доступ CLOB
значение или если запуск - меньше чем 1SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методint setString(long pos, String str) throws SQLException
String
к CLOB
значение, что это Clob
объект определяет в позиции pos
. Строка перезапишет существующие символы в Clob
объект, запускающийся в позиции pos
. Если конец Clob
значение достигается при записи данной строки, тогда длина Clob
значение будет увеличено, чтобы разместить дополнительные символы.
Отметьте: Если значение, определенное для pos
больше тогда length+1 CLOB
значение тогда поведение неопределено. Некоторые драйверы JDBC могут бросить a SQLException
в то время как другие драйверы могут поддерживать эту работу.
pos
- позиция, в которой можно начать писать в CLOB
значение, что это Clob
объект представляет; первая позиция 1str
- строка, которая будет записана CLOB
значение, что это Clob
определяетSQLException
- если есть ошибка, получая доступ CLOB
значение или если на месте продажи меньше чем 1SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот метод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
объект; первая позиция 1str
- строка, которая будет записана CLOB
значение, что это Clob
объект представляетoffset
- смещение в str
начинать читать символы, которые будут записаныlen
- число символов, которые будут записаныSQLException
- если есть ошибка, получая доступ CLOB
значение или если на месте продажи меньше чем 1SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методOutputStream setAsciiStream(long pos) throws SQLException
CLOB
значение, что это Clob
объект представляет, запускаясь в позиции pos
. Символы, записанные потоку, перезапишут существующие символы в Clob
объект, запускающийся в позиции pos
. Если конец Clob
значение достигается при записи символов в поток, тогда длина Clob
значение будет увеличено, чтобы разместить дополнительные символы.
Отметьте: Если значение, определенное для pos
больше тогда length+1 CLOB
значение тогда поведение неопределено. Некоторые драйверы JDBC могут бросить a SQLException
в то время как другие драйверы могут поддерживать эту работу.
pos
- позиция, в которой можно начать писать в это CLOB
объект; первая позиция 1SQLException
- если есть ошибка, получая доступ CLOB
значение или если на месте продажи меньше чем 1SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetAsciiStream()
Writer setCharacterStream(long pos) throws SQLException
CLOB
значение, что это Clob
объект представляет в позиции pos
. Символы, записанные потоку, перезапишут существующие символы в Clob
объект, запускающийся в позиции pos
. Если конец Clob
значение достигается при записи символов в поток, тогда длина Clob
значение будет увеличено, чтобы разместить дополнительные символы.
Отметьте: Если значение, определенное для pos
больше тогда length+1 CLOB
значение тогда поведение неопределено. Некоторые драйверы JDBC могут бросить a SQLException
в то время как другие драйверы могут поддерживать эту работу.
pos
- позиция, в которой можно начать писать в CLOB
значение; первая позиция 1SQLException
- если есть ошибка, получая доступ CLOB
значение или если на месте продажи меньше чем 1SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetCharacterStream()
void truncate(long len) throws SQLException
CLOB
значение, что это Clob
определяет, чтобы иметь длину len
символы.
Отметьте: Если значение, определенное для pos
больше тогда length+1 CLOB
значение тогда поведение неопределено. Некоторые драйверы JDBC могут бросить a SQLException
в то время как другие драйверы могут поддерживать эту работу.
len
- длина та, в символах, к который CLOB
значение должно быть усеченнымSQLException
- если есть ошибка, получая доступ CLOB
значение или если len - меньше чем 0SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методvoid free() throws SQLException
Clob
возразите и высвобождает средства ресурсы, которые это содержит. Объект недопустим однажды free
метод вызывают. После free
был вызван, любая попытка вызвать метод кроме free
приведет к a SQLException
быть брошенным. Если free
вызывается многократно, последующие звонки free
обрабатываются как нет.
SQLException
- если ошибка происходит, высвобождая средства КлобаSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методReader getCharacterStream(long pos, long length) throws SQLException
Reader
объект, который содержит частичное Clob
значение, запускающееся с символа, определенного на месте продажи, который является символами длины в длине.pos
- смещение к первому символу частичного значения, которое будет получено. Первый символ в Clob в позиции 1.length
- длина в символах частичного значения, которое будет получено.Reader
через который частичное Clob
значение может быть считано.SQLException
- если на месте продажи меньше чем 1 или если на месте продажи больше чем число символов в Clob
или если на месте продажи + длина больше чем число символов в Clob
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот метод
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92