java.sql
인터페이스 SQLInput

public interface SQLInput

SQL 구조화형 또는 SQL 의 개별의 형태의 인스턴스를 나타내는 값의 스트림을 저장하는 입력 스트림입니다. 커스텀 매핑인 만큼 사용되는 이 인터페이스는 배후에 있는 드라이버에 의해 사용됩니다. 프로그래머가 SQLInput 메소드를 직접 호출할 수 없습니다. reader 메소드 (readLong,readBytes 등)를 사용하면(자),SQLInput 오브젝트의 값을 읽어들일 수가 있습니다. 메소드 wasNull 는 마지막에 읽힌 값이 SQL NULL 화도인지를 판별하기 위해서 사용됩니다.

getObject 메소드가 SQLData 인터페이스를 구현하는 클래스의 오브젝트로 불려 가면(자), JDBC 드라이버는 커스텀 매핑 되는 유저 정의형 (UDT)의 SQL 형을 판별하기 위해서 SQLData.getSQLType 메소드를 호출합니다. 드라이버는 UDT 의 속성으로 설정된 SQLInput 의 인스턴스를 생성합니다. 다음에, 드라이버는 입력 스트림을 SQLData.readSQL 메소드에 건네주어,SQLData.readSQL 메소드는 그 구현으로 입력 스트림으로부터 속성을 읽어들이기 위한 SQLInput reader 메소드를 호출합니다.

도입된 버젼:

1.2

메소드의 개요

Array	readArray () 스트림으로부터 SQL ARRAY 치를 읽어들여, 그 값을 Java 프로그램 언어의 Array 오브젝트로서 돌려줍니다.
InputStream	readAsciiStream () 스트림내의 다음의 속성을 읽어들여, 그것을 ASCII 캐릭터의 스트림으로서 돌려줍니다.
BigDecimal	readBigDecimal () 스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 java.math.BigDecimal 오브젝트로서 돌려줍니다.
InputStream	readBinaryStream () 스트림내의 다음의 속성을 읽어들여, 그것을 미해석의 바이트 스트림으로서 돌려줍니다.
Blob	readBlob () 스트림으로부터 SQL BLOB 치를 읽어들여, 그 값을 Java 프로그램 언어의 Blob 오브젝트로서 돌려줍니다.
boolean	readBoolean () 스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 boolean 로서 돌려줍니다.
byte	readByte () 스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 byte 로서 돌려줍니다.
byte[]	readBytes () 스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 바이트의 배열로서 돌려줍니다.
Reader	readCharacterStream () 스트림내의 다음의 속성을 읽어들여, 그것을 Unicode 캐릭터의 스트림으로서 돌려줍니다.
Clob	readClob () 스트림으로부터 SQL CLOB 치를 읽어들여, 그 값을 Java 프로그램 언어의 Clob 오브젝트로서 돌려줍니다.
Date	readDate () 스트림내의 다음의 속성을 읽어들여, 그것을 java.sql.Date 오브젝트로서 돌려줍니다.
double	readDouble () 스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 double 로서 돌려줍니다.
float	readFloat () 스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 float 로서 돌려줍니다.
int	readInt () 스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 int 로서 돌려줍니다.
long	readLong () 스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 long 로서 돌려줍니다.
Object	readObject () 스트림의 선두에 있는 데이터를 읽어들여, 그것을 Java 프로그램 언어의 Object 로서 돌려줍니다.
Ref	readRef () 스트림으로부터 SQL REF 치를 읽어들여, 그 값을 Java 프로그램 언어의 Ref 오브젝트로서 돌려줍니다.
short	readShort () 스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 short 로서 돌려줍니다.
String	readString () 스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 String 로서 돌려줍니다.
Time	readTime () 스트림내의 다음의 속성을 읽어들여, 그것을 java.sql.Time 오브젝트로서 돌려줍니다.
Timestamp	readTimestamp () 스트림내의 다음의 속성을 읽어들여, 그것을 java.sql.Timestamp 오브젝트로서 돌려줍니다.
URL	readURL () 스트림으로부터 SQL DATALINK 치를 읽어들여, 그 값을 Java 프로그램 언어의 java.net.URL 오브젝트로서 돌려줍니다.
boolean	wasNull () 마지막에 읽힌 값이 SQL NULL 화도인지를 취득합니다.

메소드의 상세

readString

public String  readString()
                  throws SQLException 

스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 String 로서 돌려줍니다.

반환값:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readBoolean

public boolean readBoolean()
                    throws SQLException 

스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 boolean 로서 돌려줍니다.

반환값:

속성. 값이 SQL NULL 의 경우는 false

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readByte

public byte readByte()
              throws SQLException 

스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 byte 로서 돌려줍니다.

반환값:

속성. 값이 SQL NULL 의 경우는 0

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readShort

public short readShort()
                throws SQLException 

스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 short 로서 돌려줍니다.

반환값:

속성. 값이 SQL NULL 의 경우는 0

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readInt

public int readInt()
            throws SQLException 

스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 int 로서 돌려줍니다.

반환값:

속성. 값이 SQL NULL 의 경우는 0

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readLong

public long readLong()
              throws SQLException 

스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 long 로서 돌려줍니다.

반환값:

속성. 값이 SQL NULL 의 경우는 0

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readFloat

public float readFloat()
                throws SQLException 

스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 float 로서 돌려줍니다.

반환값:

속성. 값이 SQL NULL 의 경우는 0

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readDouble

public double readDouble()
                  throws SQLException 

스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 double 로서 돌려줍니다.

반환값:

속성. 값이 SQL NULL 의 경우는 0

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readBigDecimal

public BigDecimal  readBigDecimal()
                          throws SQLException 

스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 java.math.BigDecimal 오브젝트로서 돌려줍니다.

반환값:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readBytes

public byte[] readBytes()
                 throws SQLException 

스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 바이트의 배열로서 돌려줍니다.

반환값:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readDate

public Date  readDate()
              throws SQLException 

스트림내의 다음의 속성을 읽어들여, 그것을 java.sql.Date 오브젝트로서 돌려줍니다.

반환값:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readTime

public Time  readTime()
              throws SQLException 

스트림내의 다음의 속성을 읽어들여, 그것을 java.sql.Time 오브젝트로서 돌려줍니다.

반환값:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readTimestamp

public Timestamp  readTimestamp()
                        throws SQLException 

스트림내의 다음의 속성을 읽어들여, 그것을 java.sql.Timestamp 오브젝트로서 돌려줍니다.

반환값:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readCharacterStream

public Reader  readCharacterStream()
                           throws SQLException 

스트림내의 다음의 속성을 읽어들여, 그것을 Unicode 캐릭터의 스트림으로서 돌려줍니다.

반환값:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readAsciiStream

public InputStream  readAsciiStream()
                            throws SQLException 

스트림내의 다음의 속성을 읽어들여, 그것을 ASCII 캐릭터의 스트림으로서 돌려줍니다.

반환값:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readBinaryStream

public InputStream  readBinaryStream()
                             throws SQLException 

스트림내의 다음의 속성을 읽어들여, 그것을 미해석의 바이트 스트림으로서 돌려줍니다.

반환값:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readObject

public Object  readObject()
                  throws SQLException 

스트림의 선두에 있는 데이터를 읽어들여, 그것을 Java 프로그램 언어의 Object 로서 돌려줍니다. 돌려주어지는 오브젝트의 실제의 형태는 디폴트의 형태 MAP 및 이 스트림의 이 스트림의 형태 MAP에 나타나는 커스터마이즈에 의해 판정됩니다.

형태 MAP는 스트림이 어플리케이션에게 건네지기 전에 JDBC 드라이버에 의해 스트림에 등록됩니다.

스트림의 선두에 있는 데이터가 SQL NULL 의 경우, 이 메소드는 null 를 돌려줍니다. 데이터가 SQL 구조화형 또는 개별의 형태의 경우는 스트림의 선두에 있는 데이터의 SQL 형을 판정합니다. 스트림의 형태 MAP에 SQL 형의 엔트리가 있는 경우는 드라이버는 적절한 클래스의 오브젝트를 구축하고 나서, 그 오브젝트로 메소드 SQLData.readSQL 를 호출합니다. SQLData.readSQL 메소드는 그 메소드를 위해서(때문에) 기술된 프로토콜을 사용해, 스트림으로부터 추가 데이터를 읽어들입니다.

반환값:

스트림의 선두에 있는 Java 프로그램 언어의 Object 로서의 데이터. 데이터가 SQL NULL 의 경우는 null

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readRef

public Ref  readRef()
            throws SQLException 

스트림으로부터 SQL REF 치를 읽어들여, 그 값을 Java 프로그램 언어의 Ref 오브젝트로서 돌려줍니다.

반환값:

스트림의 선두에 있는 SQL REF 치를 나타내는 Ref 오브젝트. 읽힌 값이 SQL NULL 의 경우는 null

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readBlob

public Blob  readBlob()
              throws SQLException 

스트림으로부터 SQL BLOB 치를 읽어들여, 그 값을 Java 프로그램 언어의 Blob 오브젝트로서 돌려줍니다.

반환값:

스트림의 선두에 있는 SQL BLOB 치의 데이터를 나타내는 Blob 오브젝트. 읽힌 값이 SQL NULL 의 경우는 null

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readClob

public Clob  readClob()
              throws SQLException 

스트림으로부터 SQL CLOB 치를 읽어들여, 그 값을 Java 프로그램 언어의 Clob 오브젝트로서 돌려줍니다.

반환값:

스트림의 선두에 있는 SQL CLOB 치의 데이터를 나타내는 Clob 오브젝트. 읽힌 값이 SQL NULL 의 경우는 null

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readArray

public Array  readArray()
                throws SQLException 

스트림으로부터 SQL ARRAY 치를 읽어들여, 그 값을 Java 프로그램 언어의 Array 오브젝트로서 돌려줍니다.

반환값:

스트림의 선두에 있는 SQL ARRAY 치의 데이터를 나타내는 Array 오브젝트. 읽힌 값이 SQL NULL 의 경우는 null

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

wasNull

public boolean wasNull()
                throws SQLException 

마지막에 읽힌 값이 SQL NULL 화도인지를 취득합니다.

반환값:

마지막에 읽힌 SQL 치가 SQL NULL 의 경우는 true, 그렇지 않은 경우는 false

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readURL

public URL  readURL()
            throws SQLException 

스트림으로부터 SQL DATALINK 치를 읽어들여, 그 값을 Java 프로그램 언어의 java.net.URL 오브젝트로서 돌려줍니다.

반환값:

java.net.URL 오브젝트

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 URL 가 무효의 경우

도입된 버젼:

1.4