Интерфейс RowSetMetaData

Все суперинтерфейсы:: ResultSetMetaData, Wrapper

Все известные реализующие классы:: RowSetMetaDataImpl

public interface RowSetMetaData extends ResultSetMetaData

Объект, содержащий сведения о столбцах объекта RowSet. Этот интерфейс расширяет интерфейс ResultSetMetaData методами для задания значений в объекте RowSetMetaData. Когда объект RowSetReader считывает данные в объект RowSet, он создает объект RowSetMetaData и инициализирует его с помощью методов интерфейса RowSetMetaData. Затем средство чтения передает объект RowSetMetaData набору строк.

Методы этого интерфейса вызываются внутри программы при вызове приложением метода RowSet.execute; программист приложения не должен использовать их напрямую.

Начиная с:: 1.4

Краткое описание полей

Поля, объявленные в интерфейсе ResultSetMetaData

columnNoNulls, columnNullable, columnNullableUnknown

Модификатор и тип	Поле	Описание
`static final int`	`columnNoNulls`	Константа, указывающая, что столбец не допускает значения `NULL`.
`static final int`	`columnNullable`	Константа, указывающая, что столбец допускает значения `NULL`.
`static final int`	`columnNullableUnknown`	Константа, указывающая, что возможность наличия null-значений в столбце неизвестна.

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

Модификатор и тип	Метод	Описание
`void`	`setAutoIncrement(int columnIndex, boolean property)`	Задает, нумеруется ли указанный столбец автоматически. По умолчанию столбцы объекта `RowSet` не нумеруются автоматически.
`void`	`setCaseSensitive(int columnIndex, boolean property)`	Задает, чувствителен ли указанный столбец к регистру.
`void`	`setCatalogName(int columnIndex, String catalogName)`	Задает для каталога таблицы указанного столбца, если он есть, указанное значение `String`.
`void`	`setColumnCount(int columnCount)`	Задает указанное число столбцов в объекте `RowSet`.
`void`	`setColumnDisplaySize(int columnIndex, int size)`	Задает обычную максимальную ширину указанного столбца в символах равной указанному значению `int`.
`void`	`setColumnLabel(int columnIndex, String label)`	Задает указанное значение `String` в качестве предполагаемого заголовка столбца для печати и отображения, если такой заголовок есть.
`void`	`setColumnName(int columnIndex, String columnName)`	Задает указанное значение `String` в качестве имени указанного столбца.
`void`	`setColumnType(int columnIndex, int SQLType)`	Задает для указанного столбца указанный тип SQL.
`void`	`setColumnTypeName(int columnIndex, String typeName)`	Задает для указанного столбца указанное значение `String` в качестве имени типа, специфичного для источника данных, если такое имя есть.
`void`	`setCurrency(int columnIndex, boolean property)`	Задает, является ли указанный столбец денежным значением.
`void`	`setNullable(int columnIndex, int property)`	Задает, можно ли присвоить значению указанного столбца значение `NULL`.
`void`	`setPrecision(int columnIndex, int precision)`	Задает указанное значение `int` в качестве числа десятичных цифр указанного столбца.
`void`	`setScale(int columnIndex, int scale)`	Задает указанное значение `int` в качестве числа цифр справа от десятичной точки в указанном столбце.
`void`	`setSchemaName(int columnIndex, String schemaName)`	Задает для схемы таблицы указанного столбца, если она есть, указанное значение `String`.
`void`	`setSearchable(int columnIndex, boolean property)`	Задает, можно ли использовать указанный столбец в предложении WHERE.
`void`	`setSigned(int columnIndex, boolean property)`	Задает, является ли указанный столбец знаковым числом.
`void`	`setTableName(int columnIndex, String tableName)`	Задает для имени таблицы указанного столбца, если оно есть, указанное значение `String`.

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

getCatalogName, getColumnClassName, getColumnCount, getColumnDisplaySize, getColumnLabel, getColumnName, getColumnType, getColumnTypeName, getPrecision, getScale, getSchemaName, getTableName, isAutoIncrement, isCaseSensitive, isCurrency, isDefinitelyWritable, isNullable, isReadOnly, isSearchable, isSigned, isWritable

Модификатор и тип	Метод	Описание
`String`	`getCatalogName(int column)`	Возвращает имя каталога таблицы указанного столбца.
`String`	`getColumnClassName(int column)`	Возвращает полное имя класса Java, экземпляры которого создаются при вызове метода `ResultSet.getObject` для получения значения из столбца.
`int`	`getColumnCount()`	Возвращает число столбцов в этом объекте `ResultSet`.
`int`	`getColumnDisplaySize(int column)`	Указывает обычную максимальную ширину указанного столбца в символах.
`String`	`getColumnLabel(int column)`	Возвращает предполагаемый заголовок указанного столбца для печати и отображения.
`String`	`getColumnName(int column)`	Возвращает имя указанного столбца.
`int`	`getColumnType(int column)`	Возвращает тип SQL указанного столбца.
`String`	`getColumnTypeName(int column)`	Возвращает имя типа указанного столбца, специфичное для базы данных.
`int`	`getPrecision(int column)`	Возвращает заданный размер указанного столбца.
`int`	`getScale(int column)`	Возвращает число цифр справа от десятичной точки в указанном столбце. Для типов данных, к которым масштаб не применим, возвращается 0.
`String`	`getSchemaName(int column)`	Возвращает схему таблицы указанного столбца.
`String`	`getTableName(int column)`	Возвращает имя таблицы указанного столбца.
`boolean`	`isAutoIncrement(int column)`	Указывает, нумеруется ли указанный столбец автоматически.
`boolean`	`isCaseSensitive(int column)`	Указывает, имеет ли значение регистр символов в столбце.
`boolean`	`isCurrency(int column)`	Указывает, является ли указанный столбец денежным значением.
`boolean`	`isDefinitelyWritable(int column)`	Указывает, будет ли операция записи в указанный столбец заведомо успешной.
`int`	`isNullable(int column)`	Указывает возможность наличия null-значений в указанном столбце.
`boolean`	`isReadOnly(int column)`	Указывает, что запись в указанный столбец заведомо невозможна.
`boolean`	`isSearchable(int column)`	Указывает, можно ли использовать указанный столбец в предложении WHERE.
`boolean`	`isSigned(int column)`	Указывает, являются ли значения в указанном столбце знаковыми числами.
`boolean`	`isWritable(int column)`	Указывает, может ли операция записи в указанный столбец быть успешной.

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

isWrapperFor, unwrap

Модификатор и тип	Метод	Описание
`boolean`	`isWrapperFor(Class<?> iface)`	Возвращает true, если этот объект реализует интерфейс-аргумент или прямо либо косвенно является оболочкой объекта, который его реализует.
`<T> T`	`unwrap(Class<T> iface)`	Возвращает объект, реализующий указанный интерфейс, чтобы обеспечить доступ к нестандартным методам или стандартным методам, не предоставляемым прокси-объектом.

Подробное описание методов

setColumnCount

void setColumnCount(int columnCount) throws SQLException

Задает указанное число столбцов в объекте RowSet.

Параметры:: columnCount — число столбцов в объекте RowSet
Выбрасывает исключение:: SQLException — если происходит ошибка доступа к базе данных

setAutoIncrement

void setAutoIncrement(int columnIndex, boolean property) throws SQLException

Задает, нумеруется ли указанный столбец автоматически. По умолчанию столбцы объекта RowSet не нумеруются автоматически.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; property — true, если столбец нумеруется автоматически; false, если нет
Выбрасывает исключение:: SQLException — если происходит ошибка доступа к базе данных

setCaseSensitive

void setCaseSensitive(int columnIndex, boolean property) throws SQLException

Задает, чувствителен ли указанный столбец к регистру. По умолчанию используется значение false.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; property — true, если столбец чувствителен к регистру; false, если нет
Выбрасывает исключение:: SQLException — если происходит ошибка доступа к базе данных

setSearchable

void setSearchable(int columnIndex, boolean property) throws SQLException

Задает, можно ли использовать указанный столбец в предложении WHERE. По умолчанию используется значение false.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; property — true, если столбец можно использовать в предложении WHERE; false, если нельзя
Выбрасывает исключение:: SQLException — если происходит ошибка доступа к базе данных

setCurrency

void setCurrency(int columnIndex, boolean property) throws SQLException

Задает, является ли указанный столбец денежным значением. По умолчанию используется значение false.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; property — true, если столбец является денежным значением; false, если нет
Выбрасывает исключение:: SQLException — если происходит ошибка доступа к базе данных

setNullable

void setNullable(int columnIndex, int property) throws SQLException

Задает, можно ли присвоить значению указанного столбца значение NULL. По умолчанию используется значение ResultSetMetaData.columnNullableUnknown

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; property — одна из следующих констант: ResultSetMetaData.columnNoNulls, ResultSetMetaData.columnNullable или ResultSetMetaData.columnNullableUnknown
Выбрасывает исключение:: SQLException — если происходит ошибка доступа к базе данных

setSigned

void setSigned(int columnIndex, boolean property) throws SQLException

Задает, является ли указанный столбец знаковым числом. По умолчанию используется значение false.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; property — true, если столбец является знаковым числом; false, если нет
Выбрасывает исключение:: SQLException — если происходит ошибка доступа к базе данных

setColumnDisplaySize

void setColumnDisplaySize(int columnIndex, int size) throws SQLException

Задает обычную максимальную ширину указанного столбца в символах равной указанному значению int.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; size — обычное максимальное число символов для указанного столбца
Выбрасывает исключение:: SQLException — если происходит ошибка доступа к базе данных

setColumnLabel

void setColumnLabel(int columnIndex, String label) throws SQLException

Задает указанное значение String в качестве предполагаемого заголовка столбца для печати и отображения, если такой заголовок есть.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; label — заголовок столбца
Выбрасывает исключение:: SQLException — если происходит ошибка доступа к базе данных

setColumnName

void setColumnName(int columnIndex, String columnName) throws SQLException

Задает указанное значение String в качестве имени указанного столбца.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; columnName — имя указанного столбца
Выбрасывает исключение:: SQLException — если происходит ошибка доступа к базе данных

setSchemaName

void setSchemaName(int columnIndex, String schemaName) throws SQLException

Задает для схемы таблицы указанного столбца, если она есть, указанное значение String.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; schemaName — имя схемы
Выбрасывает исключение:: SQLException — если происходит ошибка доступа к базе данных

setPrecision

void setPrecision(int columnIndex, int precision) throws SQLException

Задает указанное значение int в качестве числа десятичных цифр указанного столбца.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; precision — общее число десятичных цифр
Выбрасывает исключение:: SQLException — если происходит ошибка доступа к базе данных

setScale

void setScale(int columnIndex, int scale) throws SQLException

Задает указанное значение int в качестве числа цифр справа от десятичной точки в указанном столбце.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; scale — число цифр справа от десятичной точки
Выбрасывает исключение:: SQLException — если происходит ошибка доступа к базе данных

setTableName

void setTableName(int columnIndex, String tableName) throws SQLException

Задает для имени таблицы указанного столбца, если оно есть, указанное значение String.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; tableName — имя таблицы столбца
Выбрасывает исключение:: SQLException — если происходит ошибка доступа к базе данных

setCatalogName

void setCatalogName(int columnIndex, String catalogName) throws SQLException

Задает для каталога таблицы указанного столбца, если он есть, указанное значение String.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; catalogName — имя каталога столбца
Выбрасывает исключение:: SQLException — если происходит ошибка доступа к базе данных

setColumnType

void setColumnType(int columnIndex, int SQLType) throws SQLException

Задает указанный тип SQL для указанного столбца.

Параметры:

columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.

SQLType — тип SQL столбца

Выбрасывает исключение:

SQLException — если происходит ошибка доступа к базе данных

См. также:

setColumnTypeName

void setColumnTypeName(int columnIndex, String typeName) throws SQLException

Задает указанное значение String в качестве имени типа указанного столбца, специфичного для источника данных, если такое имя есть.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; typeName — имя типа, специфичное для источника данных.
Выбрасывает исключение:: SQLException — если происходит ошибка доступа к базе данных

© 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.