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