Интерфейс NClob

Все суперинтерфейсы:: AutoCloseable, Clob

public interface NClob extends Clob

Отображение типа SQL NCLOB в языке программирования Java. Тип SQL NCLOB — это встроенный тип, который хранит большой символьный объект с использованием национального набора символов в качестве значения столбца строки таблицы базы данных.

Интерфейс NClob расширяет интерфейс Clob, предоставляющий методы для получения длины значения SQL NCLOB, материализации значения NCLOB на клиенте и поиска подстроки или объекта NCLOB в значении NCLOB. Объект NClob, как и объект Clob, действителен в течение транзакции, в которой он был создан. Методы интерфейсов ResultSet, CallableStatement и PreparedStatement, такие как getNClob и setNClob, позволяют программисту получить доступ к значению SQL NCLOB. Кроме того, этот интерфейс содержит методы для обновления значения NCLOB.

Чтобы освободить ресурсы, используемые объектом NClob, приложения должны вызвать метод Clob.free() или Clob.close(). Любая попытка вызвать метод, отличный от Clob.free() или Clob.close(), после закрытия объекта NClob приведёт к выбрасыванию исключения SQLException.

Если драйвер JDBC поддерживает этот тип данных, все методы интерфейса NClob должны быть полностью реализованы.

Начиная с версии:: 1.6

Краткое описание методов

Методы, объявленные в интерфейсе Clob

close, free, getAsciiStream, getCharacterStream, getCharacterStream, getSubString, length, position, position, setAsciiStream, setCharacterStream, setString, setString, truncate

Модификатор и тип	Метод	Описание
`default void`	`close()`	Закрывает объект `Clob` и освобождает удерживаемые им ресурсы.
`void`	`free()`	Закрывает объект `Clob` и освобождает удерживаемые им ресурсы.
`InputStream`	`getAsciiStream()`	Получает значение `CLOB`, заданное этим объектом `Clob`, в виде потока ASCII.
`Reader`	`getCharacterStream()`	Получает значение `CLOB`, заданное этим объектом `Clob`, в виде объекта `java.io.Reader` (или потока символов).
`Reader`	`getCharacterStream(long pos, long length)`	Возвращает объект `Reader`, содержащий часть значения `Clob`, начиная с символа, указанного параметром pos, и имеющий длину, равную length.
`String`	`getSubString(long pos, int length)`	Получает копию указанной подстроки в значении `CLOB`, заданном этим объектом `Clob`.
`long`	`length()`	Получает количество символов в значении `CLOB`, заданном этим объектом `Clob`.
`long`	`position(String searchstr, long start)`	Получает позицию символа, в которой указанная подстрока `searchstr` встречается в значении SQL `CLOB`, представленном этим объектом `Clob`.
`long`	`position(Clob searchstr, long start)`	Получает позицию символа, в которой указанный объект `Clob` `searchstr` встречается в этом объекте `Clob`.
`OutputStream`	`setAsciiStream(long pos)`	Получает поток для записи символов ASCII в значение `CLOB`, представленное этим объектом `Clob`, начиная с позиции `pos`.
`Writer`	`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` символов.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.