Spec-Zone .ru
спецификации, руководства, описания, API
|
public interface Array
ARRAY
. По умолчанию, Array
значение является ссылкой продолжительности транзакции на SQL ARRAY
значение. По умолчанию, Array
объект реализуется, используя ЛОКАТОР SQL (массив) внутренне, что означает что Array
объект содержит логический указатель на данные в SQL ARRAY
значение вместо содержания ARRAY
данные значения. Array
интерфейс обеспечивает методы для того, чтобы они принесли SQL ARRAY
данные значения клиенту или как массив или как a ResultSet
объект. Если элементы SQL ARRAY
UDT, они могут быть пользовательские отображенный. Чтобы создать пользовательское отображение, программист должен сделать две вещи:
SQLData
интерфейс для UDT, чтобы быть пользовательский отображенный. Class
объект для реализации class SQLData
Когда карта типа с записью для базового типа предоставляется методам getArray
и getResultSet
, отображение этого содержит, будет использоваться, чтобы отобразить элементы ARRAY
значение. Если бы никакая карта типа не предоставляется, который обычно имел бы место, карта типа соединения используется по умолчанию. Если у карты типа соединения или карты типа, предоставленной методу, нет никакой записи для базового типа, элементы отображаются согласно стандартному отображению.
Все методы на Array
интерфейс должен быть полностью реализован, если драйвер JDBC поддерживает тип данных.
Модификатор и Тип | Метод и Описание |
---|---|
void |
free()
Этот метод освобождает
Array возразите и высвобождает средства, которые это содержит. |
Объект |
getArray()
Получает содержание SQL
ARRAY значение определяется этим Array объект в форме массива в языке программирования Java. |
Объект |
getArray(long index, int count)
Получает часть SQL
ARRAY значение определяется этим Array объект, начинаясь с указанного index и содержание до count последовательные элементы массива SQL. |
Объект |
getArray(long index, int count, Map<String,Class<?>> map)
Retreives часть SQL
ARRAY значение определяется этим Array объект, начинаясь с указанного index и содержание до count последовательные элементы массива SQL. |
Объект |
getArray(Map<String,Class<?>> map)
Получает содержание SQL
ARRAY значение определяется этим Array объект. |
int |
getBaseType()
Получает тип JDBC элементов в массиве, назначенном этим
Array объект. |
Строка |
getBaseTypeName()
Получает имя типа SQL элементов в массиве, назначенном этим
Array объект. |
ResultSet |
getResultSet()
Получает набор результатов, который содержит элементы SQL
ARRAY значение определяется этим Array объект. |
ResultSet |
getResultSet(long index, int count)
Получает набор результатов, содержащий элементы подмассива, который запускается в, индексируют
index и содержит до count последовательные элементы. |
ResultSet |
getResultSet(long index, int count, Map<String,Class<?>> map)
Получает набор результатов, содержащий элементы подмассива, который запускается в, индексируют
index и содержит до count последовательные элементы. |
ResultSet |
getResultSet(Map<String,Class<?>> map)
Получает набор результатов, который содержит элементы SQL
ARRAY значение определяется этим Array объект. |
String getBaseTypeName() throws SQLException
Array
объект. Если элементы являются встроенным типом, он возвращает специфичное для базы данных имя типа элементов. Если элементы являются определяемым пользователем типом (UDT), этот метод возвращает полностью определенное имя типа SQL.String
это - специфичное для базы данных имя для встроенного базового типа; или полностью определенное имя типа SQL для базового типа, который является UDTSQLException
- если ошибка происходит, пытаясь получить доступ к имени типаSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методint getBaseType() throws SQLException
Array
объект.Types
это - код типа для элементов в массиве, назначенном этим Array
объектSQLException
- если ошибка происходит, пытаясь получить доступ к базовому типуSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методObject getArray() throws SQLException
ARRAY
значение определяется этим Array
объект в форме массива в языке программирования Java. Эта версия метода getArray
использует карту типа, связанную с соединением для настроек отображений типа.
Отметьте: Когда getArray
используется, чтобы осуществить базовый тип, который отображается на примитивный тип данных, тогда это определяется с помощью реализации, является ли возвращенный массив массивом того примитивного типа данных или массивом Object
.
ARRAY
значение определяется этим Array
объектSQLException
- если ошибка происходит, пытаясь получить доступ к массивуSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методObject getArray(Map<String,Class<?>> map) throws SQLException
ARRAY
значение определяется этим Array
объект. Этот метод использует указанное map
поскольку тип отображает настройки, если базовый тип массива не соответствует определяемый пользователем тип в map
, когда это использует стандартное отображение. Эта версия метода getArray
использование или данный тип отображается или стандартное отображение; это никогда не использует карту типа, связанную с соединением.
Отметьте: Когда getArray
используется, чтобы осуществить базовый тип, который отображается на примитивный тип данных, тогда это определяется с помощью реализации, является ли возвращенный массив массивом того примитивного типа данных или массивом Object
.
map
- a java.util.Map
объект, который содержит отображения имен типов SQL к классам в языке программирования JavaSQLException
- если ошибка происходит, пытаясь получить доступ к массивуSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методObject getArray(long index, int count) throws SQLException
ARRAY
значение определяется этим Array
объект, начинаясь с указанного index
и содержание до count
последовательные элементы массива SQL. Этот метод использует карту типа, связанную с соединением для настроек отображений типа.
Отметьте: Когда getArray
используется, чтобы осуществить базовый тип, который отображается на примитивный тип данных, тогда это определяется с помощью реализации, является ли возвращенный массив массивом того примитивного типа данных или массивом Object
.
index
- массив индексирует первого элемента, чтобы получить; первый элемент в, индексируют 1count
- число последовательного SQL выстраивает элементы, чтобы получитьcount
последовательные элементы массива SQL, начинаясь с элемента index
SQLException
- если ошибка происходит, пытаясь получить доступ к массивуSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методObject getArray(long index, int count, Map<String,Class<?>> map) throws SQLException
ARRAY
значение определяется этим Array
объект, начинаясь с указанного index
и содержание до count
последовательные элементы массива SQL. Этот метод использует указанное map
поскольку тип отображает настройки, если базовый тип массива не соответствует определяемый пользователем тип в map
, когда это использует стандартное отображение. Эта версия метода getArray
использование или данный тип отображается или стандартное отображение; это никогда не использует карту типа, связанную с соединением.
Отметьте: Когда getArray
используется, чтобы осуществить базовый тип, который отображается на примитивный тип данных, тогда это определяется с помощью реализации, является ли возвращенный массив массивом того примитивного типа данных или массивом Object
.
index
- массив индексирует первого элемента, чтобы получить; первый элемент в, индексируют 1count
- число последовательного SQL выстраивает элементы, чтобы получитьmap
- a java.util.Map
объект, который содержит имена типов SQL и классы в языке программирования Java, на который они отображаютсяcount
последовательные элементы SQL ARRAY
значение определяется этим Array
объект, начинаясь с элемента index
SQLException
- если ошибка происходит, пытаясь получить доступ к массивуSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методResultSet getResultSet() throws SQLException
ARRAY
значение определяется этим Array
объект. Если приспособлено, элементы массива отображаются, используя карту типа соединения; иначе, стандартное отображение используется. Набор результатов содержит одну строку для каждого элемента массива с двумя столбцами в каждой строке. Второй столбец хранит значение элемента; первый столбец хранит индексирование в массив для того элемента (с первым элементом массива, являющимся в, индексируют 1). Строки в порядке возрастания соответствуют порядку индексов.
ResultSet
объект, содержащий одну строку для каждого из элементов в массиве, определяется этим Array
объект, со строками, в порядке возрастания основанными на индексах.SQLException
- если ошибка происходит, пытаясь получить доступ к массивуSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методResultSet getResultSet(Map<String,Class<?>> map) throws SQLException
ARRAY
значение определяется этим Array
объект. Этот метод использует указанное map
поскольку тип отображает настройки, если базовый тип массива не соответствует определяемый пользователем тип в map
, когда это использует стандартное отображение. Эта версия метода getResultSet
использование или данный тип отображается или стандартное отображение; это никогда не использует карту типа, связанную с соединением. Набор результатов содержит одну строку для каждого элемента массива с двумя столбцами в каждой строке. Второй столбец хранит значение элемента; первый столбец хранит индексирование в массив для того элемента (с первым элементом массива, являющимся в, индексируют 1). Строки в порядке возрастания соответствуют порядку индексов.
map
- содержит отображение SQL определяемые пользователем типы к классам в языке программирования JavaResultSet
объект, содержащий одну строку для каждого из элементов в массиве, определяется этим Array
объект, со строками, в порядке возрастания основанными на индексах.SQLException
- если ошибка происходит, пытаясь получить доступ к массивуSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методResultSet getResultSet(long index, int count) throws SQLException
index
и содержит до count
последовательные элементы. Этот метод использует карту типа соединения, чтобы отобразить элементы массива, если карта содержит запись для базового типа. Иначе, стандартное отображение используется. Набор результатов ссорится для каждого элемента массива SQL, назначенного этим объектом, с первой строкой, содержащей элемент в, индексируют index
. Набор результатов имеет до count
строки, в порядке возрастания основанные на индексах. У каждой строки есть два столбца: второй столбец хранит значение элемента; первый столбец хранит индексирование в массив для того элемента.
index
- массив индексирует первого элемента, чтобы получить; первый элемент в, индексируют 1count
- число последовательного SQL выстраивает элементы, чтобы получитьResultSet
объект, содержащий до count
последовательные элементы массива SQL определяются этим Array
объект, запускающийся в, индексирует index
.SQLException
- если ошибка происходит, пытаясь получить доступ к массивуSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методResultSet getResultSet(long index, int count, Map<String,Class<?>> map) throws SQLException
index
и содержит до count
последовательные элементы. Этот метод использует указанное map
поскольку тип отображает настройки, если базовый тип массива не соответствует определяемый пользователем тип в map
, когда это использует стандартное отображение. Эта версия метода getResultSet
использование или данный тип отображается или стандартное отображение; это никогда не использует карту типа, связанную с соединением. Набор результатов ссорится для каждого элемента массива SQL, назначенного этим объектом, с первой строкой, содержащей элемент в, индексируют index
. Набор результатов имеет до count
строки, в порядке возрастания основанные на индексах. У каждой строки есть два столбца: второй столбец хранит значение элемента; первый столбец stroes индексирование в массив для того элемента.
index
- массив индексирует первого элемента, чтобы получить; первый элемент в, индексируют 1count
- число последовательного SQL выстраивает элементы, чтобы получитьmap
- Map
объект, который содержит отображение имен типов SQL к классам в Java (ТМ) язык программированияResultSet
объект, содержащий до count
последовательные элементы массива SQL определяются этим Array
объект, запускающийся в, индексирует index
.SQLException
- если ошибка происходит, пытаясь получить доступ к массивуSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методvoid free() throws SQLException
Array
возразите и высвобождает средства, которые это содержит. Объект недопустим однажды free
метод вызывают. После free
был вызван, любая попытка вызвать метод кроме free
приведет к a SQLException
быть брошенным. Если free
вызывается многократно, последующие звонки free
обрабатываются как нет.
SQLException
- если ошибка происходит, высвобождая средства МассиваSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот метод
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92