javax.sql.rowset.serial
클래스 SQLInputImpl

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

모든 구현된 인터페이스:

SQLInput

public class SQLInputImpl
extends Object 
implements SQLInput 

사용자 정의형 (UDT)의 커스텀 매핑용 입력 스트림입니다. SQLInputImpl객체는 UDT 속성에 상당하는 값의 스트림을 포함하는 입력 스트림입니다.

이 클래스는 커스텀 매핑을 가지는 SQL 구조형 또는 SQL 개별형으로 getObject 메서드가 불려 갈 때, 배후에서 드라이버에 의해 사용됩니다. 프로그래머가 직접 SQLInputImpl 메서드를 호출할 것은 없습니다. 이것들은, RowSet 구현을 출력하는 수단으로서 제공되고 있습니다.

SQLInputImpl 클래스는 ResultSet 취득 메서드와 유사한 일련의 리더 메서드 세트를 제공합니다. 이러한 메서드에는 SQLInputImpl 객체내의 값의 독해를 가능하게 하는 기능이 있습니다.

최종값이 SQL NULL 였는지 어떠했는지의 확인에는 wasNull 메서드가 사용됩니다.

getObject 메서드가 SQLData인터페이스를 구현하는 클래스의 객체로 불려가 면, JDBC 드라이버는 커스텀 매핑 되는 UDT SQL 형을 판별하기 위해서 SQLData.getSQLType 메서드를 호출합니다. 드라이버는 SQLInputImpl 인스턴스를 작성해, UDT 속성을 이식합니다. 다음에 입력 스트림을 SQLData.readSQL 메서드에 건네줍니다. 그러자(면), 이 메서드는 SQLInputImpl reader 메서드를 호출해, 입력 스트림로부터 속성을 읽어냅니다.

관련 항목:

SQLData

생성자 개요

SQLInputImpl (Object [] attributes, Map <String, Class <? >> map)
지정된 속성의 배열과 형태 맵으로 초기화된 SQLInputImpl 객체를 작성합니다.

메서드 개요

Array	readArray () 스트림로부터 SQL ARRAY값을 읽기, 그 값을 Java 프로그램 언어의 Array 객체로서 리턴합니다.
InputStream	readAsciiStream () 이 SQLInputImpl 객체내의 다음의 속성을 ASCII 문자 스트림로서 취득합니다.
BigDecimal	readBigDecimal () 이 SQLInputImpl 객체내의 다음의 속성을 java.math.BigDecimal로 서 취득합니다.
InputStream	readBinaryStream () 이 SQLInputImpl 객체내의 다음의 속성을 미해석의 바이트 스트림로서 취득합니다.
Blob	readBlob () 이 SQLInputImpl 객체의 선두의 BLOB값을 Java 프로그램 언어의 Blob 객체로서 취득합니다.
boolean	readBoolean () 이 SQLInputImpl 객체내의 다음의 속성을 Java 프로그램 언어의 boolean로 서 취득합니다.
byte	readByte () 이 SQLInputImpl 객체내의 다음의 속성을 Java 프로그램 언어의 byte로 서 취득합니다.
byte[]	readBytes () 이 SQLInputImpl 객체내의 다음의 속성을 바이트 배열로서 취득합니다.
Reader	readCharacterStream () 이 SQLInputImpl 객체내의 다음의 속성을 Unicode 문자 스트림로서 취득합니다.
Clob	readClob () 이 SQLInputImpl 객체의 선두의 CLOB값을 Java 프로그램 언어의 Clob 객체로서 취득합니다.
Date	readDate () 이 SQLInputImpl 내의 다음의 속성을 java.sql.Date 객체로서 취득합니다.
double	readDouble () 이 SQLInputImpl 객체내의 다음의 속성을 Java 프로그램 언어의 double로 서 취득합니다.
float	readFloat () 이 SQLInputImpl 객체내의 다음의 속성을 Java 프로그램 언어의 float로 서 취득합니다.
int	readInt () 이 SQLInputImpl 객체내의 다음의 속성을 Java 프로그램 언어의 int로 서 취득합니다.
long	readLong () 이 SQLInputImpl 객체내의 다음의 속성을 Java 프로그램 언어의 long로 서 취득합니다.
Object	readObject () 이 SQLInputImpl 객체의 선두의 값을 Java 프로그램 언어의 Object로 서 취득합니다.
Ref	readRef () 이 SQLInputImpl 객체의 선두의 값을 Java 프로그램 언어의 Ref 객체로서 취득합니다.
short	readShort () 이 SQLInputImpl 객체내의 다음의 속성을 Java 프로그램 언어의 short로 서 취득합니다.
String	readString () 이 SQLInputImpl 객체내의 다음의 속성을 Java 프로그램 언어의 String로 서 취득합니다.
Time	readTime () 이 SQLInputImpl 객체내의 다음의 속성을 java.sql.Time 객체로서 취득합니다.
Timestamp	readTimestamp () 이 SQLInputImpl 객체내의 다음의 속성을 java.sql.Timestamp 객체로서 취득합니다.
URL	readURL () 스트림로부터 SQL DATALINK값을 읽기, 그 값을 Java 프로그램 언어의 URL 객체로서 리턴합니다.
boolean	wasNull () 이 SQLInputImpl 객체로부터 마지막에 읽힌 값이 SQL NULL 화도인지를 확인합니다.

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

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

생성자 상세

SQLInputImpl

public SQLInputImpl(Object [] attributes,
                    Map <String,
Class <? >> map)
             throws SQLException 

지정된 속성의 배열과 형태 맵으로 초기화된 SQLInputImpl 객체를 작성합니다. 지정된 속성안에 UDT 속성이 있어, 그 이름의 엔트리가 형태 맵내에 존재하는 경우, 이 속성은 대응하는 SQLData 구현에 따라 맵 됩니다.

파라미터:

attributes - Object인스턴스의 배열. 배열의 각 요소는 UDT 속성. 배열내의 속성의 줄 순서는 UDT 정의 대로

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

예외:

SQLException - attributes 또는 map가 null인 경우

메서드의 상세

readString

public String  readString()
                  throws SQLException 

이 SQLInputImpl 객체내의 다음의 속성을 Java 프로그램 언어의 String로 서 취득합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현에 정의되고 있는 대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readString

반환값:

이 SQLInputImpl 객체의 다음의 속성. 값이 SQL NULL인 경우, 반환값은 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readBoolean

public boolean readBoolean()
                    throws SQLException 

이 SQLInputImpl 객체내의 다음의 속성을 Java 프로그램 언어의 boolean로 서 취득합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현에 정의되고 있는 대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readBoolean

반환값:

이 SQLInputImpl 객체의 다음의 속성. 값이 SQL NULL인 경우, 반환값은 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readByte

public byte readByte()
              throws SQLException 

이 SQLInputImpl 객체내의 다음의 속성을 Java 프로그램 언어의 byte로 서 취득합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현에 정의되고 있는 대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readByte

반환값:

이 SQLInputImpl 객체의 다음의 속성. 값이 SQL NULL인 경우, 반환값은 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readShort

public short readShort()
                throws SQLException 

이 SQLInputImpl 객체내의 다음의 속성을 Java 프로그램 언어의 short로 서 취득합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현에 정의되고 있는 대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readShort

반환값:

이 SQLInputImpl 객체의 다음의 속성. 값이 SQL NULL인 경우, 반환값은 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readInt

public int readInt()
            throws SQLException 

이 SQLInputImpl 객체내의 다음의 속성을 Java 프로그램 언어의 int로 서 취득합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현에 정의되고 있는 대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readInt

반환값:

이 SQLInputImpl 객체의 다음의 속성. 값이 SQL NULL인 경우, 반환값은 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readLong

public long readLong()
              throws SQLException 

이 SQLInputImpl 객체내의 다음의 속성을 Java 프로그램 언어의 long로 서 취득합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현에 정의되고 있는 대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readLong

반환값:

이 SQLInputImpl 객체의 다음의 속성. 값이 SQL NULL인 경우, 반환값은 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readFloat

public float readFloat()
                throws SQLException 

이 SQLInputImpl 객체내의 다음의 속성을 Java 프로그램 언어의 float로 서 취득합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현에 정의되고 있는 대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readFloat

반환값:

이 SQLInputImpl 객체의 다음의 속성. 값이 SQL NULL인 경우, 반환값은 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readDouble

public double readDouble()
                  throws SQLException 

이 SQLInputImpl 객체내의 다음의 속성을 Java 프로그램 언어의 double로 서 취득합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현에 정의되고 있는 대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readDouble

반환값:

이 SQLInputImpl 객체의 다음의 속성. 값이 SQL NULL인 경우, 반환값은 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readBigDecimal

public BigDecimal  readBigDecimal()
                          throws SQLException 

이 SQLInputImpl 객체내의 다음의 속성을 java.math.BigDecimal로 서 취득합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현에 정의되고 있는 대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readBigDecimal

반환값:

이 SQLInputImpl 객체의 다음의 속성. 값이 SQL NULL인 경우, 반환값은 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readBytes

public byte[] readBytes()
                 throws SQLException 

이 SQLInputImpl 객체내의 다음의 속성을 바이트 배열로서 취득합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현에 정의되고 있는 대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readBytes

반환값:

이 SQLInputImpl 객체의 다음의 속성. 값이 SQL NULL인 경우, 반환값은 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readDate

public Date  readDate()
              throws SQLException 

이 SQLInputImpl 내의 다음의 속성을 java.sql.Date 객체로서 취득합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현에 정의되고 있는 대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readDate

반환값:

이 SQLInputImpl 객체의 다음의 속성. 값이 SQL NULL인 경우, 반환값은 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readTime

public Time  readTime()
              throws SQLException 

이 SQLInputImpl 객체내의 다음의 속성을 java.sql.Time 객체로서 취득합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readTime

반환값:

속성. 값이 SQL NULL인 경우는 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readTimestamp

public Timestamp  readTimestamp()
                        throws SQLException 

이 SQLInputImpl 객체내의 다음의 속성을 java.sql.Timestamp 객체로서 취득합니다.

정의:

인터페이스 SQLInput 내의 readTimestamp

반환값:

속성. 값이 SQL NULL인 경우는 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readCharacterStream

public Reader  readCharacterStream()
                           throws SQLException 

이 SQLInputImpl 객체내의 다음의 속성을 Unicode 문자 스트림로서 취득합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readCharacterStream

반환값:

속성. 값이 SQL NULL인 경우는 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readAsciiStream

public InputStream  readAsciiStream()
                            throws SQLException 

이 SQLInputImpl 객체내의 다음의 속성을 ASCII 문자 스트림로서 취득합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readAsciiStream

반환값:

속성. 값이 SQL NULL인 경우는 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readBinaryStream

public InputStream  readBinaryStream()
                             throws SQLException 

이 SQLInputImpl 객체내의 다음의 속성을 미해석의 바이트 스트림로서 취득합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readBinaryStream

반환값:

속성. 값이 SQL NULL인 경우는 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readObject

public Object  readObject()
                  throws SQLException 

이 SQLInputImpl 객체의 선두의 값을 Java 프로그램 언어의 Object로 서 취득합니다. 실제로 리턴된 객체의 형태는 SQL 형과 Java 프로그램 언어의 형태의 디폴트 매핑에 결정됩니다. 다만, 커스텀 매핑이 존재하는 경우, 리턴된 객체의 형태는 이 스트림의 형태 맵에 결정됩니다.

JDBC 테크놀러지 대응의 드라이버는 어플리케이션에 스트림을 건네주기 전에 이 스트림에 형태 맵을 등록합니다.

이 메서드는 스트림의 선두의 데이터가 SQL NULL인 경우, null을 리턴합니다. 데이터가 커스텀 매핑을 가지는 SQL 구조형 또는 개별형인 경우, 스트림의 선두의 데이터의 SQL 형을 판별해, 적절한 클래스의 객체를 구축해, 이 객체상에서 SQLData.readSQL 메서드를 호출합니다. 그러자(면), readSQL 메서드에의해 적절한 SQLInputImpl.readXXX 메서드가 불려가 스트림로부터 속성값이 꺼내집니다.

정의:

인터페이스 SQLInput 내의 readObject

반환값:

Java 프로그램 언어의 Object로 서 나타내지는 스트림의 선두의 값. 값이 SQL NULL인 경우는 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readRef

public Ref  readRef()
            throws SQLException 

이 SQLInputImpl 객체의 선두의 값을 Java 프로그램 언어의 Ref 객체로서 취득합니다.

정의:

인터페이스 SQLInput 내의 readRef

반환값:

스트림의 선두의 SQL REF값을 나타내는 Ref 객체. 값이 SQL NULL인 경우는 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readBlob

public Blob  readBlob()
              throws SQLException 

이 SQLInputImpl 객체의 선두의 BLOB값을 Java 프로그램 언어의 Blob 객체로서 취득합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readBlob

반환값:

스트림의 선두의 SQL BLOB값을 나타내는 Blob 객체. 값이 SQL NULL인 경우는 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readClob

public Clob  readClob()
              throws SQLException 

이 SQLInputImpl 객체의 선두의 CLOB값을 Java 프로그램 언어의 Clob 객체로서 취득합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readClob

반환값:

스트림의 선두의 SQL CLOB값을 나타내는 Clob 객체. 값이 SQL NULL인 경우는 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

readArray

public Array  readArray()
                throws SQLException 

스트림로부터 SQL ARRAY값을 읽기, 그 값을 Java 프로그램 언어의 Array 객체로서 리턴합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readArray

반환값:

스트림의 선두의 SQL ARRAY값을 나타내는 Array 객체. 값이 SQL NULL인 경우는 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우

wasNull

public boolean wasNull()
                throws SQLException 

이 SQLInputImpl 객체로부터 마지막에 읽힌 값이 SQL NULL 화도인지를 확인합니다.

정의:

인터페이스 SQLInput 내의 wasNull

반환값:

마지막에 읽힌 SQL 값이 null인 경우는 true, 그렇지 않은 경우는 false. 디폴트의 반환값은 false

예외:

SQLException - 마지막에 읽힌 값이 null 화도인지를 확인중에 에러가 발생했을 경우

readURL

public URL  readURL()
            throws SQLException 

스트림로부터 SQL DATALINK값을 읽기, 그 값을 Java 프로그램 언어의 URL 객체로서 리턴합니다.

이 메서드는 기대 대로의 형태가 돌려주고질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는 SQLData 구현대로 UDT 매핑에 위양 됩니다.

정의:

인터페이스 SQLInput 내의 readURL

반환값:

스트림의 선두의 SQL DATALINK값을 나타내는 URL 객체. 값이 SQL NULL인 경우는 null

예외:

SQLException - 독해 위값이 무효인 경우, 또는 스트림내에 더 이상 값이 없는 경우