Класс 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 не может сериализовать значения массивов null.

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 объекта.