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값의 요소를 매핑 하는데 사용됩니다. 일반적으로 형태 맵은 제공되지 않고, 그 경우에는 접속의 형태 맵이 디폴트로 사용됩니다. 접속의 형태 맵 또는 메서드에 제공된 형태 맵이 기저형의 엔트리를 가지고 있지 않은 경우, 요소는 표준 맵에 따라 매핑 됩니다.

도입된 버전 :

1.2

메서드 개요

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 - 형명에의 액세스중에 에러가 발생했을 경우

도입된 버전 :

1.2

getBaseType

int getBaseType()
                throws SQLException 

이 Array 객체에 의해 지정된 배열의 요소의 JDBC 형태를 취득합니다.

반환값:

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

예외:

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

도입된 버전 :

1.2

getArray

Object  getArray()
                throws SQLException 

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

반환값:

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

예외:

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

도입된 버전 :

1.2

getArray

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

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

파라미터:

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

반환값:

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

예외:

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

도입된 버전 :

1.2

getArray

Object  getArray(long index,
                int count)
                throws SQLException 

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

파라미터:

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

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

반환값:

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

예외:

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

도입된 버전 :

1.2

getArray

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

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

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

파라미터:

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

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

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

반환값:

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

예외:

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

도입된 버전 :

1.2

getResultSet

ResultSet  getResultSet()
                       throws SQLException 

이 Array 객체에 의해 지정된 SQL ARRAY값의 요소가 포함되고 있는 결과 세트를 취득합니다. 적절한 경우는 배열의 요소는 접속의 형태 맵을 사용해 매핑 됩니다. 그렇지 않은 경우는 표준의 맵이 사용됩니다.

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

반환값:

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

예외:

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

도입된 버전 :

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 - 배열에의 액세스중에 에러가 발생했을 경우

도입된 버전 :

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 - 배열에의 액세스중에 에러가 발생했을 경우

도입된 버전 :

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 - 배열에의 액세스중에 에러가 발생했을 경우

도입된 버전 :

1.2