|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
| 개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 | |||||||||
java.lang.Objectjavax.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 도 참조해 주세요.