java.sql
인터페이스 Array

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 인터페이스를 구현하는 클래스를 작성합니다.
• 다음의 항목을 포함한 형태 MAP에 엔트리를 작성합니다.
  • UDT 의 완전 지정된 SQL 의 형명
  • SQLData 를 구현하는 클래스의 Class 오브젝트

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

도입된 버젼:

1.2

메소드의 개요

Object	getArray () 이 Array 오브젝트에 의해 지정된 SQL ARRAY 치의 내용을, Java 프로그램 언어의 배열의 형식에서 꺼냅니다.
Object	getArray (long index, int count) 이 Array 오브젝트에 의해 지정된 SQL ARRAY 치의 일부를 꺼냅니다.
Object	getArray (long index, int count, Map map) 이 Array 오브젝트에 의해 지정된 SQL ARRAY 치의 일부를 꺼냅니다.
Object	getArray (Map 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 map) 인덱스 index 로 시작되어, 최대로 count 가 연속한 요소가 저장되고 있는 부분 배열의 요소를 보관 유지하는 결과 세트를 취득합니다.
ResultSet	getResultSet (Map map) 이 Array 오브젝트에 의해 지정된 SQL ARRAY 치의 요소를 포함한 결과 세트를 취득합니다.

메소드의 상세

getBaseTypeName

public String  getBaseTypeName()
                       throws SQLException 

이 Array 오브젝트에 의해 지정된 배열의 요소의 SQL 의 형명을 취득합니다. 요소가 짜넣어 형태의 경우, 이 메소드는 요소의 데이타베이스 특유의 형명을 돌려줍니다. 요소가 유저 정의형 (UDT)의 경우, 이 메소드는 완전 지정의 SQL 의 형명을 돌려줍니다.

반환값:

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

예외:

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

도입된 버젼:

1.2

getBaseType

public int getBaseType()
                throws SQLException 

이 Array 오브젝트에 의해 지정된 배열의 요소의 JDBC 의 형태를 취득합니다.

반환값:

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

예외:

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

도입된 버젼:

1.2

getArray

public Object  getArray()
                throws SQLException 

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

반환값:

이 Array 오브젝트에 의해 지정된 SQL ARRAY 치의 순서 첨부 요소가 저장되고 있는 Java 프로그램 언어의 배열

예외:

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

도입된 버젼:

1.2

getArray

public Object  getArray(Map  map)
                throws SQLException 

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

파라미터:

map - SQL 의 형명의 Java 프로그램 언어의 클래스에의 MAP가 저장되고 있는 java.util.Map 오브젝트

반환값:

이 오브젝트에 의해 지정된 SQL 배열의 순서 첨부 요소가 저장되고 있는 Java 프로그램 언어의 배열

예외:

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

도입된 버젼:

1.2

getArray

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

이 Array 오브젝트에 의해 지정된 SQL ARRAY 치의 일부를 꺼냅니다. 지정된 index 로 시작되어, 최대로 count 가 연속하는 SQL 배열 요소가 저장됩니다. 이 메소드는 형태 MAP의 커스터마이즈를 위한 접속에 관련한 형태 MAP를 사용합니다.

파라미터:

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

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

반환값:

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

예외:

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

도입된 버젼:

1.2

getArray

public Object  getArray(long index,
                       int count,
                       Map  map)
                throws SQLException 

이 Array 오브젝트에 의해 지정된 SQL ARRAY 치의 일부를 꺼냅니다. 지정된 index 로 시작되어, 최대로 count 가 연속하는 SQL 배열 요소가 저장됩니다.

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

파라미터:

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

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

map - SQL 의 형명과 그것들이 매핑 되는 Java 프로그램 언어의 클래스가 저장되고 있는 java.util.Map 오브젝트

반환값:

이 Array 오브젝트에 의해 지정된 SQL ARRAY 치의, 요소 index 로 시작되어, 최대로 count 가 연속하는 요소가 저장되고 있는 배열

예외:

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

도입된 버젼:

1.2

getResultSet

public ResultSet  getResultSet()
                       throws SQLException 

이 Array 오브젝트에 의해 지정된 SQL ARRAY 치의 요소가 저장되고 있는 결과 세트를 취득합니다. 적절한 경우는 배열의 요소는 접속의 형태 MAP를 사용해 매핑 됩니다. 그렇지 않은 경우는 표준의 MAP가 사용됩니다.

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

반환값:

이 Array 오브젝트에 의해 지정된 배열의 요소 마다 1 행이 저장되고 있는 ResultSet 오브젝트. 행은 인덱스에 근거하는 승순으로 나란해질 수 있고라고 있다

예외:

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

도입된 버젼:

1.2

getResultSet

public ResultSet  getResultSet(Map  map)
                       throws SQLException 

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

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

파라미터:

map - SQL 유저 정의형의 Java 프로그램 언어의 클래스에의 매핑을 저장한다

반환값:

이 Array 오브젝트에 의해 지정된 배열의 요소 마다 1 행이 저장되고 있는 ResultSet 오브젝트. 행은 인덱스에 근거하는 승순으로 나란해질 수 있고라고 있다

예외:

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

도입된 버젼:

1.2

getResultSet

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

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

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

파라미터:

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

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

반환값:

이 Array 오브젝트에 의해 지정된 SQL 배열의, 인덱스 index 로 시작되어, 최대로 count 가 연속한 요소가 저장되고 있는 ResultSet 오브젝트

예외:

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

도입된 버젼:

1.2

getResultSet

public ResultSet  getResultSet(long index,
                              int count,
                              Map  map)
                       throws SQLException 

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

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

파라미터:

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

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

map - SQL 형명의 Java 프로그램 언어의 클래스에의 MAP가 저장되고 있는 Map 오브젝트

반환값:

이 Array 오브젝트에 의해 지정된 SQL 배열의, 인덱스 index 로 시작되어, 최대로 count 가 연속한 요소가 저장되고 있는 ResultSet 오브젝트

예외:

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

도입된 버젼:

1.2