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 класс предоставляет конструктору для того, чтобы он создал a SerialArray экземпляр от Array объект, методы для того, чтобы получить базовый тип и SQL называют для базового типа, и методов для того, чтобы скопировать все или часть a SerialArray объект.

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

См. Также:

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

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

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

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

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

Методы

Модификатор и Тип	Метод и Описание
void	free() Этот метод освобождает Array возразите и высвобождает средства, которые это содержит.
Объект	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 объект.

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

clone, equals, finalize, getClass, hashCode, 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

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

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

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

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

Броски:

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

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

С тех пор:

1.6

getArray

public Object getArray()
                throws SerialException

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

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

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

Возвраты:

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

Броски:

SerialException - если ошибка происходит, получая копию этого SerialArray объект

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 - если ошибка происходит

getArray

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

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

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

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

Параметры:

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

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

Возвраты:

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

Броски:

SerialException - если ошибка происходит

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 - если ошибка происходит

getBaseType

public int getBaseType()
                throws SerialException

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

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

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

Возвраты:

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

Броски:

SerialException - если ошибка происходит

getBaseTypeName

public String getBaseTypeName()
                       throws SerialException

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

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

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

Возвраты:

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

Броски:

SerialException - если ошибка происходит

getResultSet

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

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

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

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

Параметры:

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

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

Возвраты:

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

Броски:

SerialException, - который поочередно бросает UnsupportedOperationException, если этот метод вызывают

SerialException

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, если этот метод вызывают

SerialException

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