|
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 も参照してください。