Интерфейс Array

public interface Array

Сопоставление в языке программирования Java для типа SQL ARRAY. По умолчанию, значение Array представляет собой ссылку на период транзакции на значение SQL ARRAY. По умолчанию, объект Array реализуется с помощью внутреннего SQL LOCATOR(array), что означает, что объект Array содержит логическую ссылку на данные в значении SQL ARRAY, а не содержит данные значения ARRAY.

Интерфейс Array предоставляет методы для передачи данных значения SQL ARRAY клиенту в виде массива или объекта ResultSet. Если элементы SQL ARRAY являются UDT, они могут иметь пользовательское сопоставление. Для создания пользовательского сопоставления программисту необходимо сделать два шага:

• создать класс, реализующий интерфейс SQLData для UDT, подлежащего пользовательскому сопоставлению.
• создать запись в таблице типов, содержащую
  • полное имя типа SQL UDT
  • объект Class для класса, реализующего SQLData

Когда в методы getArray и getResultSet передается таблица типов со записью для базового типа, используемое в ней сопоставление будет использовано для сопоставления элементов значения ARRAY. Если таблица типов не передана, что обычно происходит, по умолчанию используется таблица типов подключения. Если таблица типов подключения или таблица типов, переданная в метод, не содержит записи для базового типа, элементы сопоставляются в соответствии со стандартным сопоставлением.

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

Методы

getBaseTypeName

String getBaseTypeName()
                throws SQLException

Возвращает имя SQL типа элементов в массиве, обозначенном этим Array объектом. Если элементы являются встроенным типом, возвращается имя типа, специфичное для базы данных. Если элементы являются пользователем определенным типом (UDT), этот метод возвращает полное имя SQL типа.

Возвращает:

строку, представляющую собой имя типа, специфичное для базы данных для встроенного базового типа; или полное имя SQL типа для базового типа, являющегося UDT

Выбрасывает:

SQLException - если при попытке получить имя типа возникла ошибка

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.2

getBaseType

int getBaseType()
         throws SQLException

Возвращает JDBC тип элементов в массиве, обозначенном этим Array объектом.

Возвращает:

константу из класса Types, которая представляет собой код типа элементов в массиве, обозначенном этим Array объектом

Выбрасывает:

SQLException - если при попытке получить базовый тип возникла ошибка

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.2

getArray

Object getArray()
         throws SQLException

Возвращает:

массив на языке программирования Java, содержащий упорядоченные элементы SQL ARRAY значения, обозначенного этим Array объектом

Выбрасывает:

SQLException - если при попытке получить массив возникла ошибка

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.2

getArray

Object getArray(Map<String,Class<?>> map)
         throws SQLException

Параметры:

map - объект java.util.Map, содержащий сопоставления имен SQL типов с классами на языке программирования Java

Возвращает:

массив на языке программирования Java, содержащий упорядоченные элементы SQL массива, обозначенного этим объектом

Выбрасывает:

SQLException - если при попытке получить массив возникла ошибка

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.2

getArray

Object getArray(long index,
                int count)
         throws SQLException

Параметры:

index - индекс массива первого элемента для извлечения; первый элемент имеет индекс 1

count - количество последовательных элементов SQL массива для извлечения

Возвращает:

массив, содержащий до count последовательных элементов SQL массива, начиная с элемента index

Выбрасывает:

SQLException - если при попытке получить массив возникла ошибка

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.2

getArray

Object getArray(long index,
                int count,
                Map<String,Class<?>> map)
         throws SQLException

Параметры:

index - индекс массива первого элемента для извлечения; первый элемент имеет индекс 1

count - количество последовательных элементов SQL массива для извлечения

map - объект java.util.Map, содержащий имена SQL типов и классы на языке программирования Java, которым они сопоставляются

Возвращает:

массив, содержащий до count последовательных элементов SQL ARRAY значения, обозначенного этим Array объектом, начиная с элемента index

Выбрасывает:

SQLException - если при попытке получить массив возникла ошибка

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.2

getResultSet

ResultSet getResultSet()
                throws SQLException

Возвращает:

объект ResultSet, содержащий по одной строке для каждого элемента в массиве, обозначенном этим Array объектом, с упорядочиванием строк по возрастанию на основе индексов.

Выбрасывает:

SQLException - если при попытке получить массив возникла ошибка

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.2

getResultSet

ResultSet getResultSet(Map<String,Class<?>> map)
                throws SQLException

Параметры:

map - содержит сопоставление SQL пользовательских типов с классами на языке программирования Java

Возвращает:

объект ResultSet, содержащий по одной строке для каждого элемента в массиве, обозначенном этим Array объектом, с упорядочиванием строк по возрастанию на основе индексов.

Выбрасывает:

SQLException - если при попытке получить массив возникла ошибка

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.2

getResultSet

ResultSet getResultSet(long index,
                       int count)
                throws SQLException

Параметры:

index - индекс массива первого элемента для извлечения; первый элемент имеет индекс 1

count - количество последовательных элементов SQL массива для извлечения

Возвращает:

объект ResultSet, содержащий до count последовательных элементов SQL массива, обозначенного этим Array объектом, начиная с индекса index.

Выбрасывает:

SQLException - если при попытке получить массив возникла ошибка

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.2

getResultSet

ResultSet getResultSet(long index,
                       int count,
                       Map<String,Class<?>> map)
                throws SQLException

Параметры:

index - индекс массива первого извлекаемого элемента; первый элемент имеет индекс 1

count - количество последовательных элементов SQL-массива для извлечения

map - объект Map, содержащий отображение имен типов SQL на классы языка программирования Java(tm)

Возвращает:

объект ResultSet, содержащий до count последовательных элементов SQL-массива, обозначенного этим объектом Array, начиная с индекса index.

Исключения:

SQLException - если возникла ошибка при попытке доступа к массиву

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

С:

1.2

free

void free()
   throws SQLException

Исключения:

SQLException - если при освобождении ресурсов массива произошла ошибка

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

С:

1.6