SQLInput (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | 생성자 | 메서드

상세: 필드 | 생성자 | 메서드

java.sql
인터페이스 SQLInput

알려진 구현 클래스 목록:: SQLInputImpl

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

String  readString()
                  throws SQLException

스트림내의 다음의 속성을 읽기, 그것을 Java 프로그램 언어의 String로 서 리턴합니다.

반환값:: 속성. 값이 SQL NULL인 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readBoolean

boolean readBoolean()
                    throws SQLException

스트림내의 다음의 속성을 읽기, 그것을 Java 프로그램 언어의 boolean로 서 리턴합니다.

반환값:: 속성. 값이 SQL NULL인 경우는 false
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readByte

byte readByte()
              throws SQLException

스트림내의 다음의 속성을 읽기, 그것을 Java 프로그램 언어의 byte로 서 리턴합니다.

반환값:: 속성. 값이 SQL NULL인 경우는 0
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readShort

short readShort()
                throws SQLException

스트림내의 다음의 속성을 읽기, 그것을 Java 프로그램 언어의 short로 서 리턴합니다.

반환값:: 속성. 값이 SQL NULL인 경우는 0
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readInt

int readInt()
            throws SQLException

스트림내의 다음의 속성을 읽기, 그것을 Java 프로그램 언어의 int로 서 리턴합니다.

반환값:: 속성. 값이 SQL NULL인 경우는 0
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readLong

long readLong()
              throws SQLException

스트림내의 다음의 속성을 읽기, 그것을 Java 프로그램 언어의 long로 서 리턴합니다.

반환값:: 속성. 값이 SQL NULL인 경우는 0
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readFloat

float readFloat()
                throws SQLException

스트림내의 다음의 속성을 읽기, 그것을 Java 프로그램 언어의 float로 서 리턴합니다.

반환값:: 속성. 값이 SQL NULL인 경우는 0
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readDouble

double readDouble()
                  throws SQLException

스트림내의 다음의 속성을 읽기, 그것을 Java 프로그램 언어의 double로 서 리턴합니다.

반환값:: 속성. 값이 SQL NULL인 경우는 0
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readBigDecimal

BigDecimal  readBigDecimal()
                          throws SQLException

스트림내의 다음의 속성을 읽기, 그것을 Java 프로그램 언어의 java.math.BigDecimal 객체로서 리턴합니다.

반환값:: 속성. 값이 SQL NULL인 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readBytes

byte[] readBytes()
                 throws SQLException

스트림내의 다음의 속성을 읽기, 그것을 Java 프로그램 언어의 바이트의 배열로서 리턴합니다.

반환값:: 속성. 값이 SQL NULL인 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readDate

Date  readDate()
              throws SQLException

스트림내의 다음의 속성을 읽기, 그것을 java.sql.Date 객체로서 리턴합니다.

반환값:: 속성. 값이 SQL NULL인 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readTime

Time  readTime()
              throws SQLException

스트림내의 다음의 속성을 읽기, 그것을 java.sql.Time 객체로서 리턴합니다.

반환값:: 속성. 값이 SQL NULL인 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readTimestamp

Timestamp  readTimestamp()
                        throws SQLException

스트림내의 다음의 속성을 읽기, 그것을 java.sql.Timestamp 객체로서 리턴합니다.

반환값:: 속성. 값이 SQL NULL인 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readCharacterStream

Reader  readCharacterStream()
                           throws SQLException

스트림내의 다음의 속성을 읽기, 그것을 Unicode 문자의 스트림로서 리턴합니다.

반환값:: 속성. 값이 SQL NULL인 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readAsciiStream

InputStream  readAsciiStream()
                            throws SQLException

스트림내의 다음의 속성을 읽기, 그것을 ASCII 문자의 스트림로서 리턴합니다.

반환값:: 속성. 값이 SQL NULL인 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readBinaryStream

InputStream  readBinaryStream()
                             throws SQLException

스트림내의 다음의 속성을 읽기, 그것을 미해석의 바이트 스트림로서 리턴합니다.

반환값:: 속성. 값이 SQL NULL인 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readObject

Object  readObject()
                  throws SQLException

스트림의 선두에 있는 데이터를 읽기, 그것을 Java 프로그램 언어의 Object로 서 리턴합니다. 리턴된 객체의 실제의 형태는 디폴트의 형태 맵 및 이 스트림의 이 스트림의 형태 맵에 나타나는 커스터마이즈에 의해 판정됩니다.

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

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

반환값:: 스트림의 선두에 있는 Java 프로그램 언어의 Object로서의 데이터. 데이터가 SQL NULL인 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readRef

Ref  readRef()
            throws SQLException

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

반환값:: 스트림의 선두에 있는 SQL REF값을 나타내는 Ref 객체. 읽힌 값이 SQL NULL인 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readBlob

Blob  readBlob()
              throws SQLException

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

반환값:: 스트림의 선두에 있는 SQL BLOB값의 데이터를 나타내는 Blob 객체. 읽힌 값이 SQL NULL인 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readClob

Clob  readClob()
              throws SQLException

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

반환값:: 스트림의 선두에 있는 SQL CLOB값의 데이터를 나타내는 Clob 객체. 읽힌 값이 SQL NULL인 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readArray

Array  readArray()
                throws SQLException

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

반환값:: 스트림의 선두에 있는 SQL ARRAY값의 데이터를 나타내는 Array 객체. 읽힌 값이 SQL NULL인 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

wasNull

boolean wasNull()
                throws SQLException

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

반환값:: 마지막에 읽힌 SQL 값이 SQL NULL인 경우는 true, 그렇지 않은 경우는 false
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

readURL

URL  readURL()
            throws SQLException

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

반환값:: java.net.URL 객체
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 URL가 무효의 경우
도입된 버전 :: 1.4

개요