SQLInput (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

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

java.sql
인터페이스 SQLInput

기존의 구현 클래스의 일람:: SQLInputImpl

public interface SQLInput

SQL 구조화형 또는 SQL 의 개별의 형태의 인스턴스를 나타내는 값의 스트림을 포함하는 입력 스트림입니다. 커스텀 매핑에만 사용되는 이 인터페이스는 드라이버에 의해 내부에서 사용되어SQLInput 메소드를 프로그래머가 직접 호출할 수 없습니다. reader 메소드 (readLong,readBytes 등)를 사용하면(자),SQLInput 객체의 값을 읽어들이기 위해서(때문에) SQLData 인터페이스를 구현할 수가 있습니다. SQLData 로 설명했던 대로, reader 메소드의 호출은, 대응하는 속성이 형태의 SQL 정의에 출현하는 순서로 행해질 필요가 있습니다. 최종치가 SQL NULL 였는지 어떠했는지의 확인에는,wasNull 메소드가 사용됩니다.

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` 로서 돌려줍니다.
`NClob`	`readNClob ()` 스트림로부터 SQL `NCLOB` 치를 읽어들여, 그 값을 Java 프로그램 언어의 `NClob` 객체로서 돌려줍니다.
`String`	`readNString ()` 스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 `String` 로서 돌려줍니다.
`Object`	`readObject ()` 스트림의 선두에 있는 데이터를 읽어들여, 그것을 Java 프로그램 언어의 `Object` 로서 돌려줍니다.
`Ref`	`readRef ()` 스트림로부터 SQL `REF` 치를 읽어들여, 그 값을 Java 프로그램 언어의 `Ref` 객체로서 돌려줍니다.
`RowId`	`readRowId ()` 스트림로부터 SQL `ROWID` 치를 읽어들여, 그 값을 Java 프로그램 언어의 `RowId` 객체로서 돌려줍니다.
`short`	`readShort ()` 스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 `short` 로서 돌려줍니다.
`SQLXML`	`readSQLXML ()` 스트림로부터 SQL `XML` 치를 읽어들여, 그 값을 Java 프로그램 언어의 `SQLXML` 객체로서 돌려줍니다.
`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 - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readBoolean

boolean readBoolean()
                    throws SQLException

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

반환값:: 속성. 값이 SQL NULL 의 경우는 false
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readByte

byte readByte()
              throws SQLException

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

반환값:: 속성. 값이 SQL NULL 의 경우는 0
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readShort

short readShort()
                throws SQLException

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

반환값:: 속성. 값이 SQL NULL 의 경우는 0
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readInt

int readInt()
            throws SQLException

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

반환값:: 속성. 값이 SQL NULL 의 경우는 0
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readLong

long readLong()
              throws SQLException

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

반환값:: 속성. 값이 SQL NULL 의 경우는 0
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readFloat

float readFloat()
                throws SQLException

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

반환값:: 속성. 값이 SQL NULL 의 경우는 0
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readDouble

double readDouble()
                  throws SQLException

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

반환값:: 속성. 값이 SQL NULL 의 경우는 0
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readBigDecimal

BigDecimal  readBigDecimal()
                          throws SQLException

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

반환값:: 속성. 값이 SQL NULL 의 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readBytes

byte[] readBytes()
                 throws SQLException

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

반환값:: 속성. 값이 SQL NULL 의 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readDate

Date  readDate()
              throws SQLException

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

반환값:: 속성. 값이 SQL NULL 의 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readTime

Time  readTime()
              throws SQLException

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

반환값:: 속성. 값이 SQL NULL 의 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readTimestamp

Timestamp  readTimestamp()
                        throws SQLException

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

반환값:: 속성. 값이 SQL NULL 의 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readCharacterStream

Reader  readCharacterStream()
                           throws SQLException

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

반환값:: 속성. 값이 SQL NULL 의 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readAsciiStream

InputStream  readAsciiStream()
                            throws SQLException

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

반환값:: 속성. 값이 SQL NULL 의 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readBinaryStream

InputStream  readBinaryStream()
                             throws SQLException

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

반환값:: 속성. 값이 SQL NULL 의 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readObject

Object  readObject()
                  throws SQLException

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

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

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

반환값:: 스트림의 선두에 있는 Java 프로그램 언어의 Object 로서의 데이터. 데이터가 SQL NULL 의 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readRef

Ref  readRef()
            throws SQLException

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

반환값:: 스트림의 선두에 있는 SQL REF 치를 나타내는 Ref 객체. 읽힌 값이 SQL NULL 의 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readBlob

Blob  readBlob()
              throws SQLException

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

반환값:: 스트림의 선두에 있는 SQL BLOB 치의 데이터를 나타내는 Blob 객체. 읽힌 값이 SQL NULL 의 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readClob

Clob  readClob()
              throws SQLException

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

반환값:: 스트림의 선두에 있는 SQL CLOB 치의 데이터를 나타내는 Clob 객체. 읽힌 값이 SQL NULL 의 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readArray

Array  readArray()
                throws SQLException

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

반환값:: 스트림의 선두에 있는 SQL ARRAY 치의 데이터를 나타내는 Array 객체. 읽힌 값이 SQL NULL 의 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

wasNull

boolean wasNull()
                throws SQLException

마지막에 읽힌 값이 SQL NULL 화도인지를 가져옵니다.

반환값:: 마지막에 읽힌 SQL 치가 SQL NULL 의 경우는 true, 그렇지 않은 경우는 false
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.2

readURL

URL  readURL()
            throws SQLException

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

반환값:: java.net.URL 객체
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 URL 가 무효의 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.4

readNClob

NClob  readNClob()
                throws SQLException

스트림로부터 SQL NCLOB 치를 읽어들여, 그 값을 Java 프로그램 언어의 NClob 객체로서 돌려줍니다.

반환값:: 스트림의 선두에 있는 SQL NCLOB 치의 데이터를 나타내는 NClob 객체. 읽힌 값이 SQL NULL 의 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.6

readNString

String  readNString()
                   throws SQLException

스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 String 로서 돌려줍니다. NCHAR,NVARCHAR, 및 LONGNVARCHAR 열에 액세스 할 경우에 사용합니다.

반환값:: 속성. 값이 SQL NULL 의 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.6

readSQLXML

SQLXML  readSQLXML()
                  throws SQLException

스트림로부터 SQL XML 치를 읽어들여, 그 값을 Java 프로그램 언어의 SQLXML 객체로서 돌려줍니다.

반환값:: 스트림의 선두에 있는 SQL XML 치의 데이터를 나타내는 SQLXML 객체. 읽힌 값이 SQL NULL 의 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.6

readRowId

RowId  readRowId()
                throws SQLException

스트림로부터 SQL ROWID 치를 읽어들여, 그 값을 Java 프로그램 언어의 RowId 객체로서 돌려줍니다.

반환값:: 스트림의 선두에 있는 SQL ROWID 치의 데이터를 나타내는 RowId 객체. 읽힌 값이 SQL NULL 의 경우는 null
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:: 1.6

개요