java.sql
인터페이스 Array

기존의 구현 클래스의 일람:

SerialArray

public interface Array

SQL 형 ARRAY 의 Java 프로그램 언어에서의 매핑입니다. 디폴트에서는,Array 치는 SQL ARRAY 치에의 트랜잭션(transaction) 기간중의 참조입니다. 디폴트에서는,Array 객체는 내부적으로 SQL LOCATOR(array)를 사용해 구현됩니다. 이것은 즉,Array 객체는,ARRAY 치의 데이터를 포함하는 것이 아니라, SQL ARRAY 치의 데이터에의 논리 포인터를 포함한다고 하는 것입니다.

Array 인터페이스는, SQL ARRAY 치의 데이터를 배열 또는 ResultSet 객체로서 클라이언트에 건네주는 메소드를 제공합니다. SQL ARRAY 의 요소가 UDT 의 경우, 요소는 커스텀 매핑 됩니다. 커스텀 매핑을 작성하기 위해서, 프로그래머는 다음의 2 개를 실시할 필요가 있습니다.

• 커스텀 매핑 되는 UDT SQLData 인터페이스를 구현하는 클래스를 작성합니다.
• 다음의 항목을 포함한 형태 맵에 엔트리를 작성합니다.
  • UDT 의 완전 지정된 SQL 의 형명
  • SQLData 를 구현하는 클래스의 Class 객체

기저형의 엔트리를 가지는 형태 맵이 getArray 및 getResultSet 메소드에 제공되면(자), 그 형태 맵에 포함되는 매핑은,ARRAY 치의 요소를 매핑 하는데 사용됩니다. 일반적으로은 형태 맵은 제공되지 않고, 그 경우에는 접속의 형태 맵이 디폴트로 사용됩니다. 접속의 형태 맵 또는 메소드에 제공된 형태 맵이 기저형의 엔트리를 가지고 있지 않은 경우, 요소는 표준 맵에 따라 매핑 됩니다.

JDBC 드라이버가 그 데이터형을 지원하는 경우는,Array 인터페이스의 모든 메소드가 완전하게 구현될 필요가 있습니다.

도입된 버젼:

1.2

메소드의 개요

void	free () 이 메소드는,Array 객체를 해제해, 보관 유지되고 있는 자원을 해제합니다.
Object	getArray () 이 Array 객체에 의해 지정된 SQL ARRAY 치의 내용을, Java 프로그램 언어의 배열의 형식에서 꺼냅니다.
Object	getArray (long index, int count) 이 Array 객체에 의해 지정된 SQL ARRAY 치의 일부를 꺼냅니다.
Object	getArray (long index, int count, Map <String ,Class <? >> map) 이 Array 객체에 의해 지정된 SQL ARRAY 치의 일부를 꺼냅니다.
Object	getArray (Map <String ,Class <? >> map) 이 Array 객체에 의해 지정된 SQL ARRAY 치의 내용을 꺼냅니다.
int	getBaseType () 이 Array 객체에 의해 지정된 배열의 요소의 JDBC 의 형태를 가져옵니다.
String	getBaseTypeName () 이 Array 객체에 의해 지정된 배열의 요소의 SQL 의 형명을 가져옵니다.
ResultSet	getResultSet () 이 Array 객체에 의해 지정된 SQL ARRAY 치의 요소를 포함한 결과 세트를 가져옵니다.
ResultSet	getResultSet (long index, int count) 인덱스 index 로 시작되어, 최대로 count 가 연속한 요소가 포함되고 있는 부분 배열의 요소를 보관 유지하는 결과 세트를 가져옵니다.
ResultSet	getResultSet (long index, int count, Map <String ,Class <? >> map) 인덱스 index 로 시작되어, 최대로 count 가 연속한 요소가 포함되고 있는 부분 배열의 요소를 보관 유지하는 결과 세트를 가져옵니다.
ResultSet	getResultSet (Map <String ,Class <? >> map) 이 Array 객체에 의해 지정된 SQL ARRAY 치의 요소를 포함한 결과 세트를 가져옵니다.

메소드의 상세

getBaseTypeName

String  getBaseTypeName()
                       throws SQLException 

이 Array 객체에 의해 지정된 배열의 요소의 SQL 의 형명을 가져옵니다. 요소가 짜넣어 형태의 경우, 이 메소드는 요소의 데이타베이스 특유의 형명을 돌려줍니다. 요소가 사용자 정의형 (UDT)의 경우, 이 메소드는 완전 지정의 SQL 의 형명을 돌려줍니다.

반환값:

편입 기저형의 경우는 데이타베이스 특유의 이름인 String, UDT 의 기저형의 경우는 완전 지정의 SQL 의 형명

예외:

SQLException - 형명에의 액세스중에 에러가 발생했을 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.2

getBaseType

int getBaseType()
                throws SQLException 

이 Array 객체에 의해 지정된 배열의 요소의 JDBC 의 형태를 가져옵니다.

반환값:

이 Array 객체에 의해 지정된 배열의 요소의 형태 코드인,Types 클래스로부터의 정수

예외:

SQLException - 기저형에의 액세스중에 에러가 발생했을 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.2

getArray

Object  getArray()
                throws SQLException 

이 Array 객체에 의해 지정된 SQL ARRAY 치의 내용을, Java 프로그램 언어의 배열의 형식에서 꺼냅니다. 이 버젼의 getArray 메소드는, 형태 맵의 커스터마이즈를 위한 접속에 관련한 형태 맵을 사용합니다.

주: getArray 를 사용해 프리미티브(primitive) 데이터형에 매핑 하는 기저형을 생성하는 경우, 반환되는 배열이 그 프리미티브(primitive) 데이터형의 배열과 Object 의 배열의 어디에서 있을까는, 구현으로 정의됩니다.

반환값:

이 Array 객체에 의해 지정된 SQL ARRAY 치의 순서 첨부 요소가 포함되고 있는, Java 프로그램 언어의 배열

예외:

SQLException - 배열에의 액세스중에 에러가 발생했을 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.2

getArray

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

이 Array 객체에 의해 지정된 SQL ARRAY 치의 내용을 꺼냅니다. 이 메소드는, 지정된 map 를 형태 맵의 커스터마이즈에 사용합니다. 다만 배열의 기저형이 map 의 사용자 정의형과 일치하지 않는 경우는, 대신에 표준의 맵이 사용됩니다. 이 버젼의 getArray 메소드는, 지정된 형태 맵인가, 표준 맵의 어느 쪽인지를 사용합니다. 접속에 관련한 형태 맵은 사용되지 않습니다.

주: getArray 를 사용해 프리미티브(primitive) 데이터형에 매핑 하는 기저형을 생성하는 경우, 반환되는 배열이 그 프리미티브(primitive) 데이터형의 배열과 Object 의 배열의 어디에서 있을까는, 구현으로 정의됩니다.

파라미터:

map - SQL 의 형명의 Java 프로그램 언어의 클래스에의 맵이 포함되고 있는 java.util.Map 객체

반환값:

이 객체에 의해 지정된 SQL 배열의 순서 첨부 요소가 포함되고 있는, Java 프로그램 언어의 배열

예외:

SQLException - 배열에의 액세스중에 에러가 발생했을 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.2

getArray

Object  getArray(long index,
                int count)
                throws SQLException 

이 Array 객체에 의해 지정된 SQL ARRAY 치의 일부를 꺼냅니다. 지정된 index 로 시작되어, 최대로 count 가 연속하는 SQL 배열 요소가 포함됩니다. 이 메소드는, 형태 맵의 커스터마이즈에는, 접속에 관련하는 형태 맵을 사용합니다.

주: getArray 를 사용해 프리미티브(primitive) 데이터형에 매핑 하는 기저형을 생성하는 경우, 반환되는 배열이 그 프리미티브(primitive) 데이터형의 배열과 Object 의 배열의 어디에서 있을까는, 구현으로 정의됩니다.

파라미터:

index - 최초로 꺼내는 요소의 배열 인덱스. 최초의 요소의 인덱스는 1

count - 꺼내는 연속하는 SQL 배열 요소의 수

반환값:

요소 index 로 시작되어, 최대로 count 가 연속하는 SQL 배열 요소가 포함되고 있는 배열

예외:

SQLException - 배열에의 액세스중에 에러가 발생했을 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.2

getArray

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

이 Array 객체에 의해 지정된 SQL ARRAY 치의 일부를 꺼냅니다. 지정된 index 로 시작되어, 최대로 count 가 연속하는 SQL 배열 요소가 포함됩니다.

이 메소드는, 지정된 map 를 형태 맵의 커스터마이즈에 사용합니다. 다만 배열의 기저형이 map 의 사용자 정의형과 일치하지 않는 경우는, 대신에 표준의 맵이 사용됩니다. 이 버젼의 getArray 메소드는, 지정된 형태 맵인가, 표준 맵의 어느 쪽인지를 사용합니다. 접속에 관련한 형태 맵은 사용되지 않습니다.

주: getArray 를 사용해 프리미티브(primitive) 데이터형에 매핑 하는 기저형을 생성하는 경우, 반환되는 배열이 그 프리미티브(primitive) 데이터형의 배열과 Object 의 배열의 어디에서 있을까는, 구현으로 정의됩니다.

파라미터:

index - 최초로 꺼내는 요소의 배열 인덱스. 최초의 요소의 인덱스는 1

count - 꺼내는 연속하는 SQL 배열 요소의 수

map - SQL 의 형명과 그것들이 매핑 되는 Java 프로그램 언어의 클래스가 포함되고 있는 java.util.Map 객체

반환값:

이 Array 객체에 의해 지정된 SQL ARRAY 치의, 요소 index 로 시작되어, 최대로 count 가 연속하는 요소가 포함되고 있는 배열

예외:

SQLException - 배열에의 액세스중에 에러가 발생했을 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.2

getResultSet

ResultSet  getResultSet()
                       throws SQLException 

이 Array 객체에 의해 지정된 SQL ARRAY 치의 요소를 포함한 결과 세트를 가져옵니다. 해당하는 경우는, 배열의 요소가 접속의 형태 맵을 사용해 매핑 됩니다. 그렇지 않은 경우는, 표준의 맵이 사용됩니다.

결과 세트는 배열 요소 마다 1 행을 포함해, 각 행에는 2 개의 열이 있습니다. 2 번째의 열에는 요소의 값이 포함되어 1 번째의 열에는 배열내의 대응하는 요소의 인덱스가 포함됩니다 (최초의 배열 요소의 인덱스는 1). 행은, 인덱스에 근거하는 승순으로 늘어놓을 수 있습니다.

반환값:

이 Array 객체에 의해 지정된 배열의 요소 마다 1 행이 포함되고 있는 ResultSet 객체. 행은 인덱스에 근거하는 승순으로 나란해질 수 있고라고 있다

예외:

SQLException - 배열에의 액세스중에 에러가 발생했을 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.2

getResultSet

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

이 Array 객체에 의해 지정된 SQL ARRAY 치의 요소를 포함한 결과 세트를 가져옵니다. 이 메소드는, 지정된 map 를 형태 맵의 커스터마이즈에 사용합니다. 다만 배열의 기저형이 map 의 사용자 정의형과 일치하지 않는 경우는, 대신에 표준의 맵이 사용됩니다. 이 버젼의 getResultSet 메소드는, 지정된 형태 맵인가, 표준 맵의 어느 쪽인지를 사용합니다. 접속에 관련한 형태 맵은 사용되지 않습니다.

결과 세트는 배열 요소 마다 1 행을 포함해, 각 행에는 2 개의 열이 있습니다. 2 번째의 열에는 요소의 값이 포함되어 1 번째의 열에는 배열내의 대응하는 요소의 인덱스가 포함됩니다 (최초의 배열 요소의 인덱스는 1). 행은, 인덱스에 근거하는 승순으로 늘어놓을 수 있습니다.

파라미터:

map - SQL 사용자 정의형의 Java 프로그램 언어의 클래스에의 매핑을 포함한다

반환값:

이 Array 객체에 의해 지정된 배열의 요소 마다 1 행이 포함되고 있는 ResultSet 객체. 행은 인덱스에 근거하는 승순으로 나란해질 수 있고라고 있다

예외:

SQLException - 배열에의 액세스중에 에러가 발생했을 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.2

getResultSet

ResultSet  getResultSet(long index,
                       int count)
                       throws SQLException 

인덱스 index 로 시작되어, 최대로 count 가 연속한 요소가 포함되고 있는 부분 배열의 요소를 보관 유지하는 결과 세트를 가져옵니다. 맵에 기저형의 엔트리가 포함되고 있는 경우, 이 메소드는 접속의 형태 맵을 사용해 배열의 요소를 매핑 합니다. 그렇지 않은 경우는, 표준의 맵이 사용됩니다.

결과 세트는, 이 객체로 지정된 SQL 배열의 요소 마다 1 행을 포함해, 최초의 행에는 인덱스 index 에 있는 요소가 포함됩니다. 결과 세트에는, 최대로 count 의 행이 인덱스에 근거하는 승순으로 포함됩니다. 각 행에는 2 개의 열이 있습니다. 2 번째의 열에는 요소의 값이 포함되어 1 번째의 열에는 배열내의 요소에 대응하는 인덱스가 포함됩니다.

파라미터:

index - 최초로 꺼내는 요소의 배열 인덱스. 최초의 요소의 인덱스는 1

count - 꺼내는 연속하는 SQL 배열 요소의 수

반환값:

이 Array 객체에 의해 지정된 SQL 배열의, 인덱스 index 로 시작되어, 최대로 count 가 연속한 요소가 포함되고 있는 ResultSet 객체

예외:

SQLException - 배열에의 액세스중에 에러가 발생했을 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.2

getResultSet

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

인덱스 index 로 시작되어, 최대로 count 가 연속한 요소가 포함되고 있는 부분 배열의 요소를 보관 유지하는 결과 세트를 가져옵니다. 이 메소드는, 지정된 map 를 형태 맵의 커스터마이즈에 사용합니다. 다만 배열의 기저형이 map 의 사용자 정의형과 일치하지 않는 경우는, 대신에 표준의 맵이 사용됩니다. 이 버젼의 getResultSet 메소드는, 지정된 형태 맵인가, 표준 맵의 어느 쪽인지를 사용합니다. 접속에 관련한 형태 맵은 사용되지 않습니다.

결과 세트는, 이 객체로 지정된 SQL 배열의 요소 마다 1 행을 포함해, 최초의 행에는 인덱스 index 에 있는 요소가 포함됩니다. 결과 세트에는, 최대로 count 의 행이 인덱스에 근거하는 승순으로 포함됩니다. 각 행에는 2 개의 열이 있습니다. 2 번째의 열에는 요소의 값이 포함되어 1 번째의 열에는 배열내의 요소에 대응하는 인덱스가 포함됩니다.

파라미터:

index - 최초로 꺼내는 요소의 배열 인덱스. 최초의 요소의 인덱스는 1

count - 꺼내는 연속하는 SQL 배열 요소의 수

map - SQL 형명의 Java 프로그램 언어의 클래스에의 맵이 포함되고 있는 Map 객체

반환값:

이 Array 객체에 의해 지정된 SQL 배열의, 인덱스 index 로 시작되어, 최대로 count 가 연속한 요소가 포함되고 있는 ResultSet 객체

예외:

SQLException - 배열에의 액세스중에 에러가 발생했을 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.2

free

void free()
          throws SQLException 

이 메소드는,Array 객체를 해제해, 보관 유지되고 있는 자원을 해제합니다. free 메소드가 한 번 불려 간 뒤는, 객체는 무효가 됩니다.

free 가 불려 가면(자),free 이외의 메소드를 호출하려고 해도,SQLException 가 throw 됩니다. free 를 여러 차례 호출했을 경우, 2 번째 이후의 free 호출은 아무것도 실시하지 않는 것으로서 다루어집니다.

예외:

SQLException - Array 의 자원의 해제시에 에러가 발생했을 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.6