compact3

javax.sql.rowset.serial

Класс SerialArray

java.lang. Объект

javax.sql.rowset.serial. SerialArray

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable, Массив

public class SerialArray
extends Object
implements Array, Serializable, Cloneable

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

SerialArray class предоставляет конструктору для того, чтобы он создал a SerialArray экземпляр от Array объект, методы для того, чтобы получить базовый тип и SQL называют для базового типа, и методов для того, чтобы скопировать все или часть a SerialArray объект.

Отметьте: Для этого class, чтобы функционировать правильно, соединение с источником данных должно быть доступным для SQL Array объект, который будет осуществлен (имеют все его элементы, принесенные к клиент-серверному), в случае необходимости. В это время в настоящий момент не поддерживаются логические указатели на данные в источнике данных, такие как локаторы.

Потокобезопасность

SerialArray не безопасен для использования многократными параллельными потоками. Если SerialArray должен использоваться больше чем одним потоком тогда, доступом к SerialArray должна управлять соответствующая синхронизация.

См. Также:

Сериализированная Форма

Сводка конструктора

Конструкторы

Конструктор и Описание
SerialArray(Array array) Создает новое SerialArray объект от данного Array объект.
SerialArray(Array array, Map<String,Class<?>> map) Создает новое SerialArray объект от данного Array объект, используя данную карту типа для пользовательского отображения каждого элемента, когда элементы являются SQL UDTs.

Сводка метода

Модификатор и Тип	Метод и Описание
Объект	clone() Возвращает клона этого SerialArray.
boolean	equals(Object obj) Сравнивает этот SerialArray с указанным объектом.
void	free() Этот метод освобождает SeriableArray возразите и высвобождает средства, которые это содержит.
Объект	getArray() Возвращает новый массив, который является копией этого SerialArray объект.
Объект	getArray(long index, int count) Возвращает новый массив, который является копией части этого SerialArray объект, запускающийся с элемента в данном, индексирует и содержащий данное число последовательных элементов.
Объект	getArray(long index, int count, Map<String,Class<?>> map) Возвращает новый массив, который является копией части этого SerialArray объект, запускающийся с элемента в данном, индексирует и содержащий данное число последовательных элементов.
Объект	getArray(Map<String,Class<?>> map) Возвращает новый массив, который является копией этого SerialArray объект, используя данную карту типа для пользовательского отображения каждого элемента, когда элементы являются SQL UDTs.
int	getBaseType() Получает тип SQL элементов в этом SerialArray объект.
Строка	getBaseTypeName() Получает специфичное для DBMS имя типа для элементов в этом SerialArray объект.
ResultSet	getResultSet() Получает a ResultSet объект, который содержит все элементы в ARRAY значение, что это SerialArray объект представляет.
ResultSet	getResultSet(long index, int count) Получает a ResultSet объект, содержащий элементы подмассива, который запускается в, индексирует, индексируют, и содержит, чтобы считать последовательные элементы.
ResultSet	getResultSet(long index, int count, Map<String,Class<?>> map) Получает набор результатов, содержащий элементы подмассива, который запускается в, Получает a ResultSet объект, который содержит подмассив элементов в этом SerialArray объект, запускающийся в, индексирует, индексируют и содержащий, чтобы считать последовательные элементы.
ResultSet	getResultSet(Map<String,Class<?>> map) Получает a ResultSet объект, который содержит все элементы SQL ARRAY значение представляется этим SerialArray объект.
int	hashCode() Возвращает хэш-код для этого SerialArray.

Методы, наследованные от class java.lang. Объект

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

SerialArray

public SerialArray(Array array,
                   Map<String,Class<?>> map)
            throws SerialException,
                   SQLException

Создает новое SerialArray объект от данного Array объект, используя данную карту типа для пользовательского отображения каждого элемента, когда элементы являются SQL UDTs.

Этот метод делает пользовательское отображение, если элементы массива являются UDT, и у данной карты типа есть запись для этого UDT. Пользовательское отображение является рекурсивным, означая, что, если, например, элемент SQL структурированный тип является SQL структурированный тип, у которого непосредственно есть элемент, который является SQL структурированный тип, каждый структурированный тип, у которого есть пользовательское отображение, будет отображен согласно данной карте типа.

Новое SerialArray объект содержит те же самые элементы как Array объект, из которого это создается, кроме тех случаев, когда базовый тип является типом SQL STRUCT, ARRAY, BLOB, CLOB, DATALINK или JAVA_OBJECT. В этом случае, каждый элемент в новом SerialArray объект является соответствующей сериализированной формой, то есть, a SerialStruct, SerialArray, SerialBlob, SerialClob, SerialDatalink, или SerialJavaObject объект.

Отметьте: (1) Array объект тот, от который a SerialArray объект создается, должно быть, осуществил SQL ARRAY данные значения на клиенте прежде, чем это передадут конструктору. Иначе, новое SerialArray объект не будет содержать данных.

Отметьте: (2), Если Array содержит java.sql.Types.JAVA_OBJECT типы, SerialJavaObject конструктора вызывают, где проверки осуществляются, чтобы гарантировать, что этот объект сериализуем.

Отметьте: (3) Array объект, предоставленный этому конструктору, не может возвратиться null для любого Array.getArray() методы. SerialArray не может сериализировать нулевые значения массива.

Параметры:

array - Array объект, который будет сериализирован

map - a java.util.Map объект, в котором каждая запись состоит из 1) a String объект, дающий полностью определенное имя UDT (SQL структурированный тип или отличный тип) и 2) Class объект для SQLData реализация, которая определяет, как UDT должен быть отображен. Параметр карты не имеет никакого эффекта для Blob, Clob, DATALINK, или JAVA_OBJECT типы.

Броски:

SerialException - если ошибка происходит, сериализируя Array объект

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

SerialArray

public SerialArray(Array array)
            throws SerialException,
                   SQLException

Создает новое SerialArray объект от данного Array объект.

Этот конструктор не делает пользовательского отображения. Если базовый тип массива является SQL, структурированный тип и пользовательское отображение требуются, конструктор SerialArray(Array array, Map map) должен использоваться.

Новое SerialArray объект содержит те же самые элементы как Array объект, из которого это создается, кроме тех случаев, когда базовый тип является типом SQL BLOB, CLOB, DATALINK или JAVA_OBJECT. В этом случае, каждый элемент в новом SerialArray объект является соответствующей сериализированной формой, то есть, a SerialBlob, SerialClob, SerialDatalink, или SerialJavaObject объект.

Отметьте: (1) Array объект тот, от который a SerialArray объект создается, должно быть, осуществил SQL ARRAY данные значения на клиенте прежде, чем это передадут конструктору. Иначе, новое SerialArray объект не будет содержать данных.

Отметьте: (2) Array объект, предоставленный этому конструктору, не может возвратиться null для любого Array.getArray() методы. SerialArray не может сериализировать null значения массива.

Параметры:

array - Array объект, который будет сериализирован

Броски:

SerialException - если ошибка происходит, сериализируя Array объект

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

Деталь метода

свободный

public void free()
          throws SQLException

Этот метод освобождает SeriableArray возразите и высвобождает средства, которые это содержит. Объект недопустим однажды free метод вызывают.

Если free вызывается многократно, последующие звонки free обрабатываются как нет.

Определенный:

free в интерфейсе Array

Броски:

SQLException - если ошибка происходит, высвобождая средства SerialArray

С тех пор:

1.6

getArray

public Object getArray()
                throws SerialException

Возвращает новый массив, который является копией этого SerialArray объект.

Определенный:

getArray в интерфейсе Array

Возвраты:

копия этого SerialArray возразите как Object в языке программирования Java

Броски:

SerialException - если ошибка происходит; если free был ранее вызван на этом объекте

getArray

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

Возвращает новый массив, который является копией этого SerialArray объект, используя данную карту типа для пользовательского отображения каждого элемента, когда элементы являются SQL UDTs.

Этот метод делает пользовательское отображение, если элементы массива являются UDT, и у данной карты типа есть запись для этого UDT. Пользовательское отображение является рекурсивным, означая, что, если, например, элемент SQL структурированный тип является SQL структурированный тип, у которого непосредственно есть элемент, который является SQL структурированный тип, каждый структурированный тип, у которого есть пользовательское отображение, будет отображен согласно данной карте типа.

Определенный:

getArray в интерфейсе Array

Параметры:

map - a java.util.Map объект, в котором каждая запись состоит из 1) a String объект, дающий полностью определенное имя UDT и 2) Class объект для SQLData реализация, которая определяет, как UDT должен быть отображен

Возвраты:

копия этого SerialArray возразите как Object в языке программирования Java

Броски:

SerialException - если ошибка происходит; если free был ранее вызван на этом объекте

getArray

public Object getArray(long index,
                       int count)
                throws SerialException

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

Определенный:

getArray в интерфейсе Array

Параметры:

index - индексирование в это SerialArray объект первого элемента, который будет скопирован; индексирование первого элемента 0

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

Возвраты:

копия определяемых элементов в этом SerialArray возразите как Object в языке программирования Java

Броски:

SerialException - если ошибка происходит; если free был ранее вызван на этом объекте

getArray

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

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

Этот метод делает пользовательское отображение, если элементы массива являются UDT, и у данной карты типа есть запись для этого UDT. Пользовательское отображение является рекурсивным, означая, что, если, например, элемент SQL структурированный тип является SQL структурированный тип, у которого непосредственно есть элемент, который является SQL структурированный тип, каждый структурированный тип, у которого есть пользовательское отображение, будет отображен согласно данной карте типа.

Определенный:

getArray в интерфейсе Array

Параметры:

index - индексирование в это SerialArray объект первого элемента, который будет скопирован; индексирование первого элемента в массиве 0

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

map - a java.util.Map объект, в котором каждая запись состоит из 1) a String объект, дающий полностью определенное имя UDT и 2) Class объект для SQLData реализация, которая определяет, как UDT должен быть отображен

Возвраты:

копия определяемых элементов в этом SerialArray возразите как Object в языке программирования Java

Броски:

SerialException - если ошибка происходит; если free был ранее вызван на этом объекте

getBaseType

public int getBaseType()
                throws SerialException

Получает тип SQL элементов в этом SerialArray объект. int возвращенный одна из констант в class java.sql.Types.

Определенный:

getBaseType в интерфейсе Array

Возвраты:

одна из констант в java.sql.Types, указание на тип SQL элементов в этом SerialArray объект

Броски:

SerialException - если ошибка происходит; если free был ранее вызван на этом объекте

getBaseTypeName

public String getBaseTypeName()
                       throws SerialException

Получает специфичное для DBMS имя типа для элементов в этом SerialArray объект.

Определенный:

getBaseTypeName в интерфейсе Array

Возвраты:

имя типа SQL используется DBMS для базового типа этого SerialArray объект

Броски:

SerialException - если ошибка происходит; если free был ранее вызван на этом объекте

getResultSet

public ResultSet getResultSet(long index,
                              int count)
                       throws SerialException

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

Определенный:

getResultSet в интерфейсе Array

Параметры:

index - индексирование в это SerialArray объект первого элемента, который будет скопирован; индексирование первого элемента в массиве 0

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

Возвраты:

a ResultSet объект, содержащий определяемые элементы в этом SerialArray объект, с отдельной строкой для каждого элемента

Броски:

SerialException - если вызвано с набором причины к UnsupportedOperationException

getResultSet

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

Получает a ResultSet объект, который содержит все элементы SQL ARRAY значение представляется этим SerialArray объект. Этот метод использует указанную карту для настроек карты типа, если базовый тип массива не соответствует определяемый пользователем тип (UDT) в карте, когда это использует стандартное отображение. Эта версия метода getResultSet использование или данный тип отображается или стандартное отображение; это никогда не использует карту типа, связанную с соединением.

Определенный:

getResultSet в интерфейсе Array

Параметры:

map - a java.util.Map объект, в котором каждая запись состоит из 1) a String объект, дающий полностью определенное имя UDT и 2) Class объект для SQLData реализация, которая определяет, как UDT должен быть отображен

Возвраты:

a ResultSet объект, содержащий все элементы в этом SerialArray объект, с отдельной строкой для каждого элемента

Броски:

SerialException - если вызвано с набором причины к UnsupportedOperationException

getResultSet

public ResultSet getResultSet()
                       throws SerialException

Получает a ResultSet объект, который содержит все элементы в ARRAY значение, что это SerialArray объект представляет. Если приспособлено, элементы массива отображаются, используя карту типа соединения; иначе, стандартное отображение используется.

Определенный:

getResultSet в интерфейсе Array

Возвраты:

a ResultSet объект, содержащий все элементы в этом SerialArray объект, с отдельной строкой для каждого элемента

Броски:

SerialException - если вызвано с набором причины к UnsupportedOperationException

getResultSet

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

Получает набор результатов, содержащий элементы подмассива, который запускается в, Получает a ResultSet объект, который содержит подмассив элементов в этом SerialArray объект, запускающийся в, индексирует, индексируют и содержащий, чтобы считать последовательные элементы. Этот метод использует указанную карту для настроек карты типа, если базовый тип массива не соответствует определяемый пользователем тип (UDT) в карте, когда это использует стандартное отображение. Эта версия метода getResultSet использование или данный тип отображается или стандартное отображение; это никогда не использует карту типа, связанную с соединением.

Определенный:

getResultSet в интерфейсе Array

Параметры:

index - индексирование в это SerialArray объект первого элемента, который будет скопирован; индексирование первого элемента в массиве 0

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

map - a java.util.Map объект, в котором каждая запись состоит из 1) a String объект, дающий полностью определенное имя UDT и 2) Class объект для SQLData реализация, которая определяет, как UDT должен быть отображен

Возвраты:

a ResultSet объект, содержащий определяемые элементы в этом SerialArray объект, с отдельной строкой для каждого элемента

Броски:

SerialException - если вызвано с набором причины к UnsupportedOperationException

равняется

public boolean equals(Object obj)

Сравнивает этот SerialArray с указанным объектом. Результат true если и только если параметр не null и a SerialArray возразите, чьи элементы идентичны элементам этого объекта

Переопределения:

equals в class Object

Параметры:

obj - Объект сравнить это SerialArray против

Возвраты:

true если данный объект представляет a SerialArray эквивалентный этому SerialArray, false иначе

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

Возвращает хэш-код для этого SerialArray. Хэш-код для a SerialArray объект вычисляется, используя хэш-коды элементов SerialArray объект

Переопределения:

hashCode в class Object

Возвраты:

значение хэш-кода для этого объекта.

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

клон

public Object clone()

Возвращает клона этого SerialArray. Копия будет содержать ссылку на клона базового массива объектов, не ссылку на исходный базовый объектный массив этого SerialArray объект.

Переопределения:

clone в class Object

Возвраты:

клон этого SerialArray

См. Также:

Cloneable