|
JavaTM Platform Standard Ed. 6 |
|||||||||
앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
java.lang.Object javax.sql.rowset.serial.SQLInputImpl
public class SQLInputImpl
사용자 정의형 (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 로서 가져옵니다. |
NClob |
readNClob ()
스트림로부터 SQL NCLOB 치를 읽어들여, 그 값을 Java 프로그램 언어의 Clob 객체로서 돌려줍니다. |
String |
readNString ()
스트림내의 다음의 속성을 읽어들여, 그것을 Java 프로그램 언어의 String 로서 돌려줍니다. |
Object |
readObject ()
이 SQLInputImpl 객체의 선두의 값을 Java 프로그램 언어의 Object 로서 가져옵니다. |
Ref |
readRef ()
이 SQLInputImpl 객체의 선두의 값을 Java 프로그램 언어의 Ref 객체로서 가져옵니다. |
RowId |
readRowId ()
스트림로부터 SQL ROWID 치를 읽어들여, 그 값을 Java 프로그램 언어의 RowId 객체로서 돌려줍니다. |
short |
readShort ()
이 SQLInputImpl 객체내의 다음의 속성을 Java 프로그램 언어의 short 로서 가져옵니다. |
SQLXML |
readSQLXML ()
스트림로부터 SQL XML 치를 읽어들여, 그 값을 Java 프로그램 언어의 SQLXML 객체로서 돌려줍니다. |
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 |
생성자 의 상세 |
---|
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
치의 경우메소드의 상세 |
---|
public String readString() throws SQLException
SQLInputImpl
객체내의 다음의 속성을 Java 프로그램 언어의 String
로서 가져옵니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현에 정의되고 있는 대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readString
SQLInputImpl
객체의 다음의 속성.
값이 SQL NULL
의 경우는 null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public boolean readBoolean() throws SQLException
SQLInputImpl
객체내의 다음의 속성을 Java 프로그램 언어의 boolean
로서 가져옵니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현에 정의되고 있는 대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readBoolean
SQLInputImpl
객체의 다음의 속성.
값이 SQL NULL
의 경우는 null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public byte readByte() throws SQLException
SQLInputImpl
객체내의 다음의 속성을 Java 프로그램 언어의 byte
로서 가져옵니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현에 정의되고 있는 대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readByte
SQLInputImpl
객체의 다음의 속성.
값이 SQL NULL
의 경우는 null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public short readShort() throws SQLException
SQLInputImpl
객체내의 다음의 속성을 Java 프로그램 언어의 short
로서 가져옵니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현에 정의되고 있는 대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readShort
SQLInputImpl
객체의 다음의 속성.
값이 SQL NULL
의 경우는 null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public int readInt() throws SQLException
SQLInputImpl
객체내의 다음의 속성을 Java 프로그램 언어의 int
로서 가져옵니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현에 정의되고 있는 대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readInt
SQLInputImpl
객체의 다음의 속성.
값이 SQL NULL
의 경우는 null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public long readLong() throws SQLException
SQLInputImpl
객체내의 다음의 속성을 Java 프로그램 언어의 long
로서 가져옵니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현에 정의되고 있는 대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readLong
SQLInputImpl
객체의 다음의 속성.
값이 SQL NULL
의 경우는 null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public float readFloat() throws SQLException
SQLInputImpl
객체내의 다음의 속성을 Java 프로그램 언어의 float
로서 가져옵니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현에 정의되고 있는 대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readFloat
SQLInputImpl
객체의 다음의 속성.
값이 SQL NULL
의 경우는 null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public double readDouble() throws SQLException
SQLInputImpl
객체내의 다음의 속성을 Java 프로그램 언어의 double
로서 가져옵니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현에 정의되고 있는 대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readDouble
SQLInputImpl
객체의 다음의 속성.
값이 SQL NULL
의 경우는 null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public BigDecimal readBigDecimal() throws SQLException
SQLInputImpl
객체내의 다음의 속성을 java.math.BigDecimal
로서 가져옵니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현에 정의되고 있는 대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readBigDecimal
SQLInputImpl
객체의 다음의 속성.
값이 SQL NULL
의 경우는 null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public byte[] readBytes() throws SQLException
SQLInputImpl
객체내의 다음의 속성을 바이트 배열로서 가져옵니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현에 정의되고 있는 대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readBytes
SQLInputImpl
객체의 다음의 속성.
값이 SQL NULL
의 경우는 null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public Date readDate() throws SQLException
SQLInputImpl
내의 다음의 속성을 java.sql.Date
객체로서 가져옵니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현에 정의되고 있는 대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readDate
SQLInputImpl
객체의 다음의 속성.
값이 SQL NULL
의 경우는 null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public Time readTime() throws SQLException
SQLInputImpl
객체내의 다음의 속성을 java.sql.Time
객체로서 가져옵니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readTime
SQL NULL
의 경우는
null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public Timestamp readTimestamp() throws SQLException
SQLInputImpl
객체내의 다음의 속성을 java.sql.Timestamp
객체로서 가져옵니다.
SQLInput
내의 readTimestamp
SQL NULL
의 경우는
null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public Reader readCharacterStream() throws SQLException
SQLInputImpl
객체내의 다음의 속성을 Unicode 문자 스트림로서 가져옵니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readCharacterStream
SQL NULL
의 경우는 null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public InputStream readAsciiStream() throws SQLException
SQLInputImpl
객체내의 다음의 속성을 ASCII 문자 스트림로서 가져옵니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readAsciiStream
SQL NULL
의 경우는
null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public InputStream readBinaryStream() throws SQLException
SQLInputImpl
객체내의 다음의 속성을 미해석의 바이트 스트림로서 가져옵니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readBinaryStream
SQL NULL
의 경우는
null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public Object readObject() throws SQLException
SQLInputImpl
객체의 선두의 값을 Java 프로그램 언어의 Object
로서 가져옵니다. 실제로 반환되는 객체의 형태는, SQL 형과 Java 프로그램 언어의 형태의 디폴트 매핑에 의해 결정됩니다. 다만, 커스텀 매핑이 존재하는 경우, 반환되는 객체의 형태는 이 스트림의 형태 맵에 의해 결정됩니다. JDBC 테크놀러지 대응의 드라이버는, 어플리케이션에 스트림을 건네주기 전에, 이 스트림에 형태 맵을 등록합니다.
이 메소드는, 스트림의 선두의 데이터가 SQL NULL
인 경우,null
를 돌려줍니다. 데이터가 커스텀 매핑을 가지는 SQL 구조형 또는 개별형인 경우, 스트림의 선두의 데이터의 SQL 형을 판별해, 적절한 클래스의 객체를 구축해, 이 객체상에서 SQLData.readSQL
메소드를 호출합니다. 그러자(면),readSQL
메소드에 의해, 적절한 SQLInputImpl.readXXX
메소드가 불려 가 스트림로부터 속성치가 꺼내집니다.
SQLInput
내의 readObject
Object
로서 나타내진다
스트림의 선두의 값.
값이 SQL NULL
의 경우는 null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public Ref readRef() throws SQLException
SQLInputImpl
객체의 선두의 값을 Java 프로그램 언어의 Ref
객체로서 가져옵니다.
SQLInput
내의 readRef
REF
치를
나타내는 Ref
객체.
값이 SQL NULL
의 경우는 null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public Blob readBlob() throws SQLException
SQLInputImpl
객체의 선두의 BLOB
치를 Java 프로그램 언어의 Blob
객체로서 가져옵니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readBlob
BLOB
치를
나타내는 Blob
객체.
값이 SQL NULL
의 경우는
null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public Clob readClob() throws SQLException
SQLInputImpl
객체의 선두의 CLOB
치를 Java 프로그램 언어의 Clob
객체로서 가져옵니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readClob
CLOB
치를
나타내는 Clob
객체.
값이 SQL NULL
의 경우는
null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public Array readArray() throws SQLException
ARRAY
치를 읽어들여, 그 값을 Java 프로그램 언어의 Array
객체로서 돌려줍니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readArray
ARRAY
치를
나타내는 Array
객체. *
값이 SQL NULL
의 경우는
null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public boolean wasNull() throws SQLException
SQLInputImpl
객체로부터 마지막에 읽힌 값이 SQL NULL
화도인지를 확인합니다.
SQLInput
내의 wasNull
null
의 경우는
true
, 그렇지 않은 경우는 false
.
디폴트의 반환값은 false
SQLException
- 마지막에 읽힌 값이 null
화도인지를 확인중에
에러가 발생했을 경우public URL readURL() throws SQLException
DATALINK
치를 읽어들여, 그 값을 Java 프로그램 언어의 URL
객체로서 돌려줍니다.
이 메소드는, 기대 대로의 형태가 돌려주어질지 어떨지를 판정하는 형태 보증 (type-safe)된 체크를 실시하지 않습니다. 이 체크는,SQLData
구현대로, UDT 매핑에 위양 됩니다.
SQLInput
내의 readURL
DATALINK
치를
나타내는 URL
객체. *
값이 SQL NULL
의 경우는
null
SQLException
- 읽기 위치가 무효인 경우,
또는 스트림내에 더 이상 값이 없는 경우public NClob readNClob() throws SQLException
NCLOB
치를 읽어들여, 그 값을 Java 프로그램 언어의 Clob
객체로서 돌려줍니다.
SQLInput
내의 readNClob
NCLOB
치의 데이터를 나타내는 NClob
객체.
읽힌 값이 SQL NULL
의 경우는
null
SQLException
- 데이타베이스 액세스 에러가 발생했을 경우public String readNString() throws SQLException
String
로서 돌려줍니다. NCHAR
,NVARCHAR
, 및 LONGNVARCHAR
열에 액세스 할 경우에 사용합니다.
SQLInput
내의 readNString
NULL
의 경우는 null
SQLException
- 데이타베이스 액세스 에러가 발생했을 경우public SQLXML readSQLXML() throws SQLException
XML
치를 읽어들여, 그 값을 Java 프로그램 언어의 SQLXML
객체로서 돌려줍니다.
SQLInput
내의 readSQLXML
XML
치의 데이터를 나타내는 SQLXML
객체.
읽힌 값이 SQL NULL
의 경우는
null
SQLException
- 데이타베이스 액세스 에러가 발생했을 경우public RowId readRowId() throws SQLException
ROWID
치를 읽어들여, 그 값을 Java 프로그램 언어의 RowId
객체로서 돌려줍니다.
SQLInput
내의 readRowId
ROWID
치의 데이터를 나타내는 RowId
객체.
읽힌 값이 SQL NULL
의 경우는
null
SQLException
- 데이타베이스 액세스 에러가 발생했을 경우
|
JavaTM Platform Standard Ed. 6 |
|||||||||
앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.