Класс SerialArray

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

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

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

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

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

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

Примечание: (3) Объект Array, переданный в этот конструктор, не может возвращать null для любых методов Array.getArray(). 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 представляет собой соответствующую сериализованную форму, то есть объект SerialBlob, SerialClob, SerialDatalink, или SerialJavaObject.

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

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

public void free() throws SQLException

Этот метод освобождает объект SerialArray и высвобождает ресурсы, которые он удерживает. Объект становится недействительным после вызова метода free.

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

public Object getArray() throws SerialException

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

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

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

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

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

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

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

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

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

public int getBaseType() throws SerialException

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

public String getBaseTypeName() throws SerialException

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

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

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

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

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

public ResultSet getResultSet() throws SerialException

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

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

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

public boolean equals(Object obj)

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

public int hashCode()

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

public Object clone()

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