Интерфейс Struct
- Все известные реализующие классы:
SerialStruct
public interface Struct
Стандартное отображение в языке программирования Java для SQL-структурированного типа. Объект Struct содержит значение для каждого атрибута SQL-структурированного типа, который он представляет. По умолчанию экземпляр Struct является допустимым, пока приложение имеет на него ссылку.
Все методы интерфейса Struct должны быть полностью реализованы, если драйвер JDBC поддерживает тип данных.
- С момента:
- 1.2
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
Object[] | getAttributes() | Возвращает упорядоченные значения атрибутов SQL-структурированного типа, который представляет данный объект |
Object[] | getAttributes(Map<String,Class<?>> map) | Возвращает упорядоченные значения атрибутов SQL-структурированного типа, который представляет данный объект |
String | getSQLTypeName() | Возвращает имя SQL-типа SQL-структурированного типа, который представляет данный объект |
Методы
getSQLTypeName
String getSQLTypeName()
throws SQLExceptionВозвращает имя SQL-типа SQL-структурированного типа, который представляет данный объект Struct.
- Возвращает:
- полное имя типа SQL-структурированного типа, для которого данный объект
Structявляется обобщенным представлением - Выбрасывает:
-
SQLException- если произошла ошибка доступа к базе данных -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С момента:
- 1.2
getAttributes
Object[] getAttributes()
throws SQLExceptionВозвращает упорядоченные значения атрибутов SQL-структурированного типа, который представляет данный объект Struct. При обработке отдельных атрибутов этот метод использует карту типов, связанную с соединением, для настройки отображений типов. Если в карте типов соединения нет записи, соответствующей структурированному типу, который представляет атрибут, драйвер использует стандартное отображение.
По сути, этот метод вызывает метод getObject для каждого атрибута структурированного типа и возвращает массив Java, содержащий результат.
- Возвращает:
- массив, содержащий упорядоченные значения атрибутов
- Выбрасывает:
-
SQLException- если произошла ошибка доступа к базе данных -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С момента:
- 1.2
getAttributes
Object[] getAttributes(Map<String,Class<?>> map)
throws SQLExceptionВозвращает упорядоченные значения атрибутов SQL-структурированного типа, который представляет данный объект Struct. При обработке отдельных атрибутов этот метод использует заданную карту типов для настройки отображений типов. Если в заданной карте типов нет записи, соответствующей структурированному типу, который представляет атрибут, драйвер использует стандартное отображение. Этот метод никогда не использует карту типов, связанную с соединением.
По сути, этот метод вызывает метод getObject для каждого атрибута структурированного типа и возвращает массив Java, содержащий результат.
- Параметры:
-
map- отображение имен SQL-типов на классы Java - Возвращает:
- массив, содержащий упорядоченные значения атрибутов
- Выбрасывает:
-
SQLException- если произошла ошибка доступа к базе данных -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С момента:
- 1.2
© 1993, 2020, 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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.sql/java/sql/Struct.html