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かどうかを確認します。 |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitreadObjectpublic 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, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。