javax.sql.rowset.serial
클래스 SerialArray

java.lang.Object 
  javax.sql.rowset.serial.SerialArray

모든 구현된 인터페이스:

Serializable, Cloneable, Array

public class SerialArray
extends Object 
implements Array,
 Serializable,
 Cloneable 

Array 객체의 직렬화 버전이며, Java 프로그램 언어에서의 SQL ARRAY값의 매핑입니다.

SerialArray 클래스는 Array 객체로부터 SerialArray인스턴스를 작성하기 위한 생성자과 기저형과 그 SQL 명을 취득하기 위한 메서드와SerialArray 객체의 일부 또는 전부를 카피하기 위한 메서드를 제공합니다.

주: 이 클래스를 정상적으로 동작시키기 위해서는 필요에 따라서 SQL Array 객체를 생성하는 (그 모든 요소를 클라이언트서버에 이동시킨다) 위해 데이터 소스 접속이 이용 가능한 필요가 있습니다. 현시점에서는 locator등의 데이터 소스의 데이터에의 논리 포인터는 지원 되지 않습니다.

관련 항목:

직렬화 된 형식

생성자 개요

SerialArray (Array array)
지정된 Array 객체로부터 새로운 SerialArray 객체를 구축합니다.

SerialArray (Array array, Map <String, Class <? >> map)
요소가 SQL UDT 일 때, 각 요소의 커스텀 매핑에 사용되는 지정의 형태 맵을 사용해, 지정된 Array 객체로부터 새로운 SerialArray 객체를 구축합니다.

메서드 개요

Object	getArray () 이 SerialArray 객체의 복사인 새로운 배열을 리턴합니다.
Object	getArray (long index, int count) 이 SerialArray 객체의 슬라이스의 카피가 되는 새로운 배열 (지정된 인덱스 위치의 요소로부터 지정의 요소 몇분 계속된다)을 리턴합니다.
Object	getArray (long index, int count, Map <String, Class <? >> map) 이 SerialArray 객체의 슬라이스의 카피가 되는 새로운 배열 (지정된 인덱스 위치의 요소로부터 지정의 요소 몇분 계속된다)을 리턴합니다.
Object	getArray (Map <String, Class <? >> map) 요소가 SQL UDT 일 때, 각 요소의 커스텀 매핑에 사용되는 지정의 형태 맵을 사용해, 이 SerialArray 객체의 복사인 새로운 배열을 리턴합니다.
int	getBaseType () 이 SerialArray 객체내의 요소의 SQL 형을 취득합니다.
String	getBaseTypeName () 이 SerialArray 객체내에 포함된 요소의 DBMS 고유의 형명을 취득합니다.
ResultSet	getResultSet () 이 SerialArray 객체에 의해 표현하는 ARRAY값의 모든 요소가 포함되고 있는 ResultSet 객체를 취득합니다.
ResultSet	getResultSet (long index, int count) 인덱스 index 로 시작되어, 최대로 count 개가 연속한 부분 배열의 요소가 포함되고 있는 ResultSet 객체를 취득합니다.
ResultSet	getResultSet (long index, int count, Map <String, Class <? >> map) 인덱스 index 로 시작되어, 최대로 count 개가 연속한 요소를 포함하는 SerialArray 객체의 요소의 부분 배열을 포함하는 ResultSet 객체를 리턴합니다.
ResultSet	getResultSet (Map <String, Class <? >> map) 이 SerialArray 객체에 의해 표현된 SQL ARRAY값의 모든 요소를 포함한 ResultSet 객체를 취득합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

생성자 상세

SerialArray

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

                   SQLException 

요소가 SQL UDT 일 때, 각 요소의 커스텀 매핑에 사용되는 지정의 형태 맵을 사용해, 지정된 Array 객체로부터 새로운 SerialArray 객체를 구축합니다.

이 메서드는 배열 요소가 UDT 로 지정된 형태 맵에 UDT 엔트리가 있는 경우에 커스텀 매핑을 실시합니다. 커스텀 매핑은 재귀적입니다. 예를 들어 SQL 구조형이 있는 요소가 그 자체 SQL 구조형의 요소를 가지는 SQL 구조형인 경우, 커스텀 매핑을 가지는 각 구조형이, 지정의 형태 맵에 따라 맵 됩니다.

새로운 SerialArray객체는 그 구축에 사용되는 Array 객체와 같은 요소를 포함합니다. 다만, 기저형이 SQL 형의 STRUCT, ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT인 경우를 제외합니다. 이 경우 새로운 SerialArray 객체내의 각 요소는 적절한 직렬화 폼, 즉 SerialStruct, SerialArray, SerialBlob, SerialClob, SerialDatalink, SerialJavaObject 몇개의 객체가 됩니다.

주: (1) SerialArray 객체의 작성에 사용되는 Array객체는 생성자에게 건네지기 전에 클라이언트에 SQL ARRAY값의 데이터를 건네주지 않으면 안됩니다. 그렇게 하지 않으면 새로운 SerialArray객체는 데이터를 가지지 않는 객체가 됩니다.

주: (2) Array에 java.sql.Types.JAVA_OBJECT 형이 포함되고 있는 경우, SerialJavaObject 생성자가 불려가 이 객체가 직렬화 가능하다라고 하는 것이 확인됩니다.

주: (3) 이 생성자 으로 지정된 Array객체는 Array.getArray() 메서드에 대해서 null을 돌려줄 수 없습니다. SerialArray는 null 배열치를 직렬화할 수 없습니다.

파라미터:

array - 직렬화 되는 Array 객체

map - 각 엔트리가 1) UDT (SQL 구조형 또는 SQL 개별형)의 완전 수식명을 지정하는 String 객체와 2) UDT 맵 방법을 정의하는SQLData 구현의 Class 객체로부터 구성되는 java.util.Map 객체입니다. map 파라미터는 Blob, Clob, DATALINK, 또는 JAVA_OBJECT 형에 대해서는 무효입니다.

예외:

SerialException - Array 객체의 직렬화시에 에러가 발생했을 경우

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 array 나 map 값이 null인 경우

SerialArray

public SerialArray(Array  array)
            throws SerialException,

                   SQLException 

지정된 Array 객체로부터 새로운 SerialArray 객체를 구축합니다.

이 생성자는 커스텀 매핑을 실시하지 않습니다. 배열의 기저형이 SQL 구조형이며, 커스텀 매핑이 필요한 경우는 생성자 SerialArray(Array array, Map map)를 사용할 필요가 있습니다.

새로운 SerialArray객체는 그 구축에 사용된 Array 객체와 같은 요소를 포함합니다. 다만, 기저형이 SQL 형의 BLOB, CLOB, DATALINK, JAVA_OBJECT인 경우를 제외합니다. 이 경우 새로운 SerialArray 객체내의 각 요소는 적절한 직렬화 폼, 즉 SerialBlob, SerialClob, SerialDatalink, SerialJavaObject 몇개의 객체가 됩니다.

주: (1) SerialArray 객체의 작성에 사용되는 Array객체는 생성자에게 건네지기 전에 클라이언트에 SQL ARRAY값의 데이터를 건네주지 않으면 안됩니다. 그렇게 하지 않으면 새로운 SerialArray객체는 데이터를 가지지 않는 객체가 됩니다.

주: (2) 이 생성자 으로 지정된 Array객체는 Array.getArray() 메서드에 대해서 null을 돌려줄 수 없습니다. SerialArray는 null 배열치를 직렬화할 수 없습니다.

파라미터:

array - 직렬화 되는 Array 객체

예외:

SerialException - Array 객체의 직렬화시에 에러가 발생했을 경우

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 array 파라미터가 null인 경우

메서드의 상세

getArray

public Object  getArray()
                throws SerialException 

이 SerialArray 객체의 복사인 새로운 배열을 리턴합니다.

정의:

인터페이스 Array 내의 getArray

반환값:

이 SerialArray 객체의 카피에 상당하는 Java 프로그램 언어에서의 Object

예외:

SerialException - 이 SerialArray 객체의 복제의 취득시에 에러가 발생했을 경우

getArray

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

요소가 SQL UDT 일 때, 각 요소의 커스텀 매핑에 사용되는 지정의 형태 맵을 사용해, 이 SerialArray 객체의 복사인 새로운 배열을 리턴합니다.

이 메서드는 배열 요소가 UDT 로 지정된 형태 맵에 UDT 엔트리가 있는 경우에 커스텀 매핑을 실시합니다. 커스텀 매핑은 재귀적입니다. 예를 들어 SQL 구조형이 있는 요소가 그 자체 SQL 구조형의 요소를 가지는 SQL 구조형인 경우, 커스텀 매핑을 가지는 각 구조형이, 지정의 형태 맵에 따라 맵 됩니다.

정의:

인터페이스 Array 내의 getArray

파라미터:

map - java.util.Map 객체. 객체내의 각 엔트리는 (1) UDT 완전 수식명을 지정하는 String 객체와(2) UDT 매핑 방법을 정의하는 SQLData 구현의 Class 객체로 구성된다

반환값:

이 SerialArray 객체의 카피에 상당하는 Java 프로그램 언어에서의 Object

예외:

SerialException - 에러가 발생했을 경우

getArray

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

이 SerialArray 객체의 슬라이스의 카피가 되는 새로운 배열 (지정된 인덱스 위치의 요소로부터 지정의 요소 몇분 계속된다)을 리턴합니다.

정의:

인터페이스 Array 내의 getArray

파라미터:

index - 이 SerialArray 객체내에서 최초의 요소가 카피되는 위치를 나타내는 인덱스. 최초의 요소의 인덱스는 0

count - 카피되는 연속한 요소수. 지정된 인덱스 위치로부터 개시된다

반환값:

이 SerialArray 객체내의 지정된 요소의 카피에 상당하는 Java 프로그램 언어에서의 Object

예외:

SerialException - 에러가 발생했을 경우

getArray

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

이 SerialArray 객체의 슬라이스의 카피가 되는 새로운 배열 (지정된 인덱스 위치의 요소로부터 지정의 요소 몇분 계속된다)을 리턴합니다.

이 메서드는 배열 요소가 UDT 로 지정된 형태 맵에 UDT 엔트리가 있는 경우에 커스텀 매핑을 실시합니다. 커스텀 매핑은 재귀적입니다. 예를 들어 SQL 구조형이 있는 요소가 그 자체 SQL 구조형의 요소를 가지는 SQL 구조형인 경우, 커스텀 매핑을 가지는 각 구조형이, 지정의 형태 맵에 따라 맵 됩니다.

정의:

인터페이스 Array 내의 getArray

파라미터:

index - 이 SerialArray 객체내에서 최초의 요소가 카피되는 위치를 나타내는 인덱스. 배열내의 최초의 요소의 인덱스는 0

count - 카피되는 연속한 요소수. 지정된 인덱스 위치로부터 개시되는

map - java.util.Map 객체. 객체내의 각 엔트리는 (1) UDT 완전 수식명을 지정하는 String 객체와(2) UDT 매핑 방법을 정의하는 SQLData 구현의 Class 객체로 구성된다

반환값:

이 SerialArray 객체내의 지정된 요소의 카피에 상당하는 Java 프로그램 언어에서의 Object

예외:

SerialException - 에러가 발생했을 경우

getBaseType

public int getBaseType()
                throws SerialException 

이 SerialArray 객체내의 요소의 SQL 형을 취득합니다. 리턴된 int는 java.sql.Types 클래스의 정수의 1개 입니다.

정의:

인터페이스 Array 내의 getBaseType

반환값:

java.sql.Types 내의 정수의 1개. 이 SerialArray 객체내의 요소의 SQL 형을 나타낸다

예외:

SerialException - 에러가 발생했을 경우

getBaseTypeName

public String  getBaseTypeName()
                       throws SerialException 

이 SerialArray 객체내에 포함된 요소의 DBMS 고유의 형명을 취득합니다.

정의:

인터페이스 Array 내의 getBaseTypeName

반환값:

이 SerialArray 객체의 기저형의 DBMS에 의해 사용되는 SQL 형명

예외:

SerialException - 에러가 발생했을 경우

getResultSet

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

인덱스 index 로 시작되어, 최대로 count 개가 연속한 부분 배열의 요소가 포함되고 있는 ResultSet 객체를 취득합니다. 맵에 기저형의 엔트리가 포함되고 있는 경우, 이 메서드는 접속의 형태 맵을 사용해 배열의 요소를 매핑 합니다. 그렇지 않은 경우는 표준의 맵이 사용됩니다.

정의:

인터페이스 Array 내의 getResultSet

파라미터:

index - 이 SerialArray 객체내에서 최초의 요소가 카피되는 위치를 나타내는 인덱스. 배열내의 최초의 요소의 인덱스는 0

count - 카피되는 연속한 요소수. 지정된 인덱스 위치로부터 개시된다

반환값:

이 SerialArray 객체내의 지정의 요소를 포함하는 ResultSet 객체. 각 요소는 다른 행에 나타난다

예외:

SerialException, - 이 메서드가 불려 갔을 경우, UnsupportedOperationException가 Throw 된다

SerialException

getResultSet

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

이 SerialArray 객체에 의해 표현된 SQL ARRAY값의 모든 요소를 포함한 ResultSet 객체를 취득합니다. 이 메서드는 지정된 map를 형태 맵의 커스터마이즈에 사용합니다. 다만 배열의 기저형이 map 사용자 정의형 (UDT)과 일치하지 않는 경우는 대신에 표준의 매핑이 사용됩니다. 이 버전의 getResultSet 메서드는 지정된 형태 맵인가 표준 맵의 어느 쪽인지를 사용합니다. 접속에 관련한 형태 맵은 사용되지 않습니다.

정의:

인터페이스 Array 내의 getResultSet

파라미터:

map - java.util.Map 객체. 객체내의 각 엔트리는 (1) UDT 완전 수식명을 지정하는 String 객체와(2) UDT 매핑 방법을 정의하는 SQLData 구현의 Class 객체로 구성된다

반환값:

이 SerialArray 객체내의 모든 요소를 포함하는 ResultSet 객체. 각 요소는 다른 행에 나타난다

예외:

SerialException, - 이 메서드가 불려 갔을 경우, UnsupportedOperationException가 Throw 된다

SerialException

getResultSet

public ResultSet  getResultSet()
                       throws SerialException 

이 SerialArray 객체에 의해 표현하는 ARRAY값의 모든 요소가 포함되고 있는 ResultSet 객체를 취득합니다. 해당하는 경우는 배열의 요소가 접속의 형태 맵을 사용해 매핑 됩니다. 그렇지 않은 경우는 표준의 맵이 사용됩니다.

정의:

인터페이스 Array 내의 getResultSet

반환값:

이 SerialArray 객체내의 모든 요소를 포함하는 ResultSet 객체. 각 요소는 다른 행에 나타난다

예외:

SerialException - 이 메서드가 불려 갔을 경우, UnsupportedOperationException가 Throw 된다

getResultSet

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

인덱스 index 로 시작되어, 최대로 count 개가 연속한 요소를 포함하는 SerialArray 객체의 요소의 부분 배열을 포함하는 ResultSet 객체를 리턴합니다. 이 메서드는 지정된 map를 형태 맵의 커스터마이즈에 사용합니다. 다만 배열의 기저형이 map 사용자 정의형 (UDT)과 일치하지 않는 경우는 대신에 표준의 맵이 사용됩니다. 이 버전의 getResultSet 메서드는 지정된 형태 맵인가 표준 맵의 어느 쪽인지를 사용합니다. 접속에 관련한 형태 맵은 사용되지 않습니다.

정의:

인터페이스 Array 내의 getResultSet

파라미터:

index - 이 SerialArray 객체내에서 최초의 요소가 카피되는 위치를 나타내는 인덱스. 배열내의 최초의 요소의 인덱스는 0

count - 카피되는 연속한 요소수. 지정된 인덱스 위치로부터 개시되는

map - java.util.Map 객체. 객체내의 각 엔트리는 (1) UDT 완전 수식명을 지정하는 String 객체와(2) UDT 매핑 방법을 정의하는 SQLData 구현의 Class 객체로 구성된다

반환값:

이 SerialArray 객체내의 지정의 요소를 포함하는 ResultSet 객체. 각 요소는 다른 행에 나타난다

예외:

SerialException - 불려 갔을 경우, UnsupportedOperationException을 Throw 한다