public class SQLInputImpl extends Object implements SQLInput
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 オブジェクトから最後に読み込まれた値が null かどうかを確認します。 |
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 マッピングに委譲されます。
readString
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値が SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public boolean readBoolean() throws SQLException
SQLInputImpl
オブジェクト内の次の属性を Java プログラミング言語の boolean
として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDT マッピングに委譲されます。
readBoolean
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値が SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public byte readByte() throws SQLException
SQLInputImpl
オブジェクト内の次の属性を Java プログラミング言語の byte
として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDT マッピングに委譲されます。
readByte
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値が SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public short readShort() throws SQLException
SQLInputImpl
オブジェクト内の次の属性を Java プログラミング言語の short
として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDT マッピングに委譲されます。
readShort
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値が SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public int readInt() throws SQLException
SQLInputImpl
オブジェクト内の次の属性を Java プログラミング言語の int
として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDT マッピングに委譲されます。
readInt
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値が SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public long readLong() throws SQLException
SQLInputImpl
オブジェクト内の次の属性を Java プログラミング言語の long
として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDT マッピングに委譲されます。
readLong
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値が SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public float readFloat() throws SQLException
SQLInputImpl
オブジェクト内の次の属性を Java プログラミング言語の float
として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDT マッピングに委譲されます。
readFloat
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値が SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public double readDouble() throws SQLException
SQLInputImpl
オブジェクト内の次の属性を Java プログラミング言語の double
として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDT マッピングに委譲されます。
readDouble
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値が SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public BigDecimal readBigDecimal() throws SQLException
SQLInputImpl
オブジェクト内の次の属性を java.math.BigDecimal
として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDT マッピングに委譲されます。
readBigDecimal
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値が SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public byte[] readBytes() throws SQLException
SQLInputImpl
オブジェクト内の次の属性をバイト配列として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDT マッピングに委譲されます。
readBytes
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値が SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public Date readDate() throws SQLException
SQLInputImpl
内の次の属性を java.sql.Date
オブジェクトとして取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDT マッピングに委譲されます。
readDate
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値が SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public Time readTime() throws SQLException
SQLInputImpl
オブジェクト内の次の属性を java.sql.Time
オブジェクトとして取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装のとおり、UDT マッピングに委譲されます。
readTime
、インタフェース: SQLInput
SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public Timestamp readTimestamp() throws SQLException
SQLInputImpl
オブジェクト内の次の属性を java.sql.Timestamp
オブジェクトとして取得します。readTimestamp
、インタフェース: SQLInput
SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public Reader readCharacterStream() throws SQLException
SQLInputImpl
オブジェクト内の次の属性を Unicode 文字ストリームとして取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装のとおり、UDT マッピングに委譲されます。
readCharacterStream
、インタフェース: SQLInput
SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public InputStream readAsciiStream() throws SQLException
SQLInputImpl
オブジェクト内の次の属性を ASCII 文字ストリームとして取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装のとおり、UDT マッピングに委譲されます。
readAsciiStream
、インタフェース: SQLInput
SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public InputStream readBinaryStream() throws SQLException
SQLInputImpl
オブジェクト内の次の属性を未解釈のバイトストリームとして取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装のとおり、UDT マッピングに委譲されます。
readBinaryStream
、インタフェース: SQLInput
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
メソッドが呼び出され、ストリームから属性値が取り出されます。
readObject
、インタフェース: SQLInput
Object
としての値。値が SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public Ref readRef() throws SQLException
SQLInputImpl
オブジェクトの先頭の値を Java プログラミング言語の Ref
オブジェクトとして取得します。readRef
、インタフェース: SQLInput
REF
値を表す Ref
オブジェクト。値が SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public Blob readBlob() throws SQLException
SQLInputImpl
オブジェクトの先頭の BLOB
値を Java プログラミング言語の Blob
オブジェクトとして取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装のとおり、UDT マッピングに委譲されます。
readBlob
、インタフェース: SQLInput
BLOB
値を表す Blob
オブジェクト。値が SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public Clob readClob() throws SQLException
SQLInputImpl
オブジェクトの先頭の CLOB
値を Java プログラミング言語の Clob
オブジェクトとして取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装のとおり、UDT マッピングに委譲されます。
readClob
、インタフェース: SQLInput
CLOB
値を表す Clob
オブジェクト。値が SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public Array readArray() throws SQLException
ARRAY
値を読み込み、その値を Java プログラミング言語の Array
オブジェクトとして返します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装のとおり、UDT マッピングに委譲されます。
readArray
、インタフェース: SQLInput
ARRAY
値を表す Array
オブジェクト。* 値が SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public boolean wasNull() throws SQLException
SQLInputImpl
オブジェクトから最後に読み込まれた値が null
かどうかを確認します。wasNull
、インタフェース: SQLInput
null
の場合は true
、そうでない場合は false
。デフォルトの戻り値は falseSQLException
- 最後に読み込まれた値が null
かどうかを確認中にエラーが発生した場合public URL readURL() throws SQLException
DATALINK
値を読み込み、その値を Java プログラミング言語の URL
オブジェクトとして返します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証 (type-safe) されたチェックを行いません。このチェックは、SQLData
実装のとおり、UDT マッピングに委譲されます。
readURL
、インタフェース: SQLInput
DATALINK
値を表す URL
オブジェクト。* 値が SQL NULL
の場合は null
SQLException
- 読み取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public NClob readNClob() throws SQLException
NCLOB
値を読み込み、その値を Java プログラミング言語の Clob
オブジェクトとして返します。readNClob
、インタフェース: SQLInput
NCLOB
値のデータを表す NClob
オブジェクト。読み込まれた値が SQL NULL
の場合は null
SQLException
- データベースアクセスエラーが発生した場合public String readNString() throws SQLException
String
として返します。NCHAR
、NVARCHAR
、および LONGNVARCHAR
列にアクセスするときに使用します。readNString
、インタフェース: SQLInput
NULL
の場合は null
を返すSQLException
- データベースアクセスエラーが発生した場合public SQLXML readSQLXML() throws SQLException
XML
値を読み込み、その値を Java プログラミング言語の SQLXML
オブジェクトとして返します。readSQLXML
、インタフェース: SQLInput
XML
値のデータを表す SQLXML
オブジェクト。読み込まれた値が SQL NULL
の場合は null
SQLException
- データベースアクセスエラーが発生した場合public RowId readRowId() throws SQLException
ROWID
値を読み込み、その値を Java プログラミング言語の RowId
オブジェクトとして返します。readRowId
、インタフェース: SQLInput
ROWID
値のデータを表す RowId
オブジェクト。読み込まれた値が SQL NULL
の場合は null
SQLException
- データベースアクセスエラーが発生した場合 バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.