개요   패키지    클래스  사용   계층 트리   비추천 API   색인   헬프  
JavaTM Platform
Standard Ed. 6
 전의 클래스    다음의 클래스 프레임 있어    프레임 없음    
개요: 상자 | 필드  | 생성자  | 메소드 상세: 필드  | 생성자  | 메소드

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 객체를 구축합니다.
 
메소드의 개요
 void free ()
          이 메소드는,Array 객체를 해제해, 보관 유지되고 있는 자원을 해제합니다.
 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 의 몇개의 객체가 됩니다.  

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

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

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

파라미터:
array - 직렬화 되는 Array 객체
map - java.util.Map 객체. 객체내의 각 엔트리는, (1) UDT 의 완전 수식명을 지정하는 String 객체와 (2) UDT 의 맵 방법을 정의한다 SQLData 구현의 Class 객체로 구성된다. 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 의 몇개의 객체가 됩니다.  

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

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

파라미터:
array - 직렬화 되는 Array 객체
예외:
SerialException - Array 객체의 직렬화시에 에러가 발생했을 경우
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 array 파라미터가 null 의 경우
메소드의 상세

free

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

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

정의:
인터페이스 Array 내의 free
예외:
SQLException - Array 의 자원의 해제시에 에러가 발생했을 경우
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.6

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 한다
개요   패키지    클래스  사용   계층 트리   비추천 API   색인   헬프  
JavaTM Platform
Standard Ed. 6
 전의 클래스    다음의 클래스 프레임 있어    프레임 없음    
개요: 상자 | 필드  | 생성자  | 메소드 상세: 필드  | 생성자  | 메소드
버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.