-
- 既知のすべての実装クラス:
SQLOutputImpl
public interface SQLOutput
ユーザー定義型の属性をデータベースに書き戻すための出力ストリームです。 カスタム・マッピングにだけ使用されるこのインタフェースはドライバによって使用され、そのメソッドをプログラマが直接呼び出すことはありません。SQLData
インタフェースを実装するクラスのオブジェクトが引数としてSQL文に渡されると、JDBCドライバはデータベースに渡されるSQLデータの種類を判定するためにSQLData.getSQLType
メソッドを呼び出します。 次に、ドライバはSQLOutput
のインスタンスを生成し、それをSQLData.writeSQL
メソッドに渡します。writeSQL
メソッドは、SQLData
オブジェクトからSQLOutput
出力ストリームにデータをSQLユーザー定義型の表現として書き込むための適切なSQLOutput
writerメソッド(writeBoolean
、writeCharacterStream
など)を呼び出します。- 導入されたバージョン:
- 1.2
-
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド デフォルト・メソッド 修飾子と型 メソッド 説明 void
writeArray(Array x)
SQLARRAY
値をストリームに書き込みます。void
writeAsciiStream(InputStream x)
次の属性をASCII文字のストリームとしてストリームに書き込みます。void
writeBigDecimal(BigDecimal x)
次の属性をjava.math.BigDecimalオブジェクトとしてストリームに書き込みます。void
writeBinaryStream(InputStream x)
次の属性を未解釈のバイト・ストリームとしてストリームに書き込みます。void
writeBlob(Blob x)
SQLBLOB
値をストリームに書き込みます。void
writeBoolean(boolean x)
次の属性をJavaのboolean型としてストリームに書き込みます。void
writeByte(byte x)
次の属性をJavaのbyte型としてストリームに書き込みます。void
writeBytes(byte[] x)
次の属性をbyte型の配列としてストリームに書き込みます。void
writeCharacterStream(Reader x)
次の属性をUnicode文字のストリームとしてストリームに書き込みます。void
writeClob(Clob x)
SQLCLOB
値をストリームに書き込みます。void
writeDate(Date x)
次の属性をjava.sql.Dateオブジェクトとしてストリームに書き込みます。void
writeDouble(double x)
次の属性をJavaのdouble型としてストリームに書き込みます。void
writeFloat(float x)
次の属性をJavaのfloat型としてストリームに書き込みます。void
writeInt(int x)
次の属性をJavaのint型としてストリームに書き込みます。void
writeLong(long x)
次の属性をJavaのlong型としてストリームに書き込みます。void
writeNClob(NClob x)
SQLNCLOB
値をストリームに書き込みます。void
writeNString(String x)
次の属性をJavaプログラミング言語のString
としてストリームに書き込みます。default void
writeObject(Object x, SQLType targetSqlType)
指定されたオブジェクトに格納されたデータをストリームに書き込みます。void
writeObject(SQLData x)
指定されたSQLData
オブジェクトに格納されたデータをストリームに書き込みます。void
writeRef(Ref x)
SQLREF
値をストリームに書き込みます。void
writeRowId(RowId x)
SQLROWID
値をストリームに書き込みます。void
writeShort(short x)
次の属性をJavaのshort型としてストリームに書き込みます。void
writeSQLXML(SQLXML x)
SQLXML
値をストリームに書き込みます。void
writeString(String x)
次の属性をJavaプログラミング言語のString
としてストリームに書き込みます。void
writeStruct(Struct x)
SQL構造化型値をストリームに書き込みます。void
writeTime(Time x)
次の属性をjava.sql.Timeオブジェクトとしてストリームに書き込みます。void
writeTimestamp(Timestamp x)
次の属性をjava.sql.Timestampオブジェクトとしてストリームに書き込みます。void
writeURL(URL x)
SQLDATALINK
値をストリームに書き込みます。
-
-
-
メソッドの詳細
-
writeString
void writeString(String x) throws SQLException
次の属性をJavaプログラミング言語のString
としてストリームに書き込みます。- パラメータ:
x
- データベースに渡す値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeBoolean
void writeBoolean(boolean x) throws SQLException
次の属性をJavaのboolean型としてストリームに書き込みます。 次の属性をJavaプログラミング言語のString
としてストリームに書き込みます。- パラメータ:
x
- データベースに渡す値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeByte
void writeByte(byte x) throws SQLException
次の属性をJavaのbyte型としてストリームに書き込みます。 次の属性をJavaプログラミング言語のString
としてストリームに書き込みます。- パラメータ:
x
- データベースに渡す値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeShort
void writeShort(short x) throws SQLException
次の属性をJavaのshort型としてストリームに書き込みます。 次の属性をJavaプログラミング言語のString
としてストリームに書き込みます。- パラメータ:
x
- データベースに渡す値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeInt
void writeInt(int x) throws SQLException
次の属性をJavaのint型としてストリームに書き込みます。 次の属性をJavaプログラミング言語のString
としてストリームに書き込みます。- パラメータ:
x
- データベースに渡す値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeLong
void writeLong(long x) throws SQLException
次の属性をJavaのlong型としてストリームに書き込みます。 次の属性をJavaプログラミング言語のString
としてストリームに書き込みます。- パラメータ:
x
- データベースに渡す値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeFloat
void writeFloat(float x) throws SQLException
次の属性をJavaのfloat型としてストリームに書き込みます。 次の属性をJavaプログラミング言語のString
としてストリームに書き込みます。- パラメータ:
x
- データベースに渡す値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeDouble
void writeDouble(double x) throws SQLException
次の属性をJavaのdouble型としてストリームに書き込みます。 次の属性をJavaプログラミング言語のString
としてストリームに書き込みます。- パラメータ:
x
- データベースに渡す値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeBigDecimal
void writeBigDecimal(BigDecimal x) throws SQLException
次の属性をjava.math.BigDecimalオブジェクトとしてストリームに書き込みます。 次の属性をJavaプログラミング言語のString
としてストリームに書き込みます。- パラメータ:
x
- データベースに渡す値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeBytes
void writeBytes(byte[] x) throws SQLException
次の属性をbyte型の配列としてストリームに書き込みます。 次の属性をJavaプログラミング言語のString
としてストリームに書き込みます。- パラメータ:
x
- データベースに渡す値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeDate
void writeDate(Date x) throws SQLException
次の属性をjava.sql.Dateオブジェクトとしてストリームに書き込みます。 次の属性をJavaプログラミング言語のjava.sql.Date
オブジェクトとしてストリームに書き込みます。- パラメータ:
x
- データベースに渡す値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeTime
void writeTime(Time x) throws SQLException
次の属性をjava.sql.Timeオブジェクトとしてストリームに書き込みます。 次の属性をJavaプログラミング言語のjava.sql.Date
オブジェクトとしてストリームに書き込みます。- パラメータ:
x
- データベースに渡す値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeTimestamp
void writeTimestamp(Timestamp x) throws SQLException
次の属性をjava.sql.Timestampオブジェクトとしてストリームに書き込みます。 次の属性をJavaプログラミング言語のjava.sql.Date
オブジェクトとしてストリームに書き込みます。- パラメータ:
x
- データベースに渡す値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeCharacterStream
void writeCharacterStream(Reader x) throws SQLException
次の属性をUnicode文字のストリームとしてストリームに書き込みます。- パラメータ:
x
- データベースに渡す値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeAsciiStream
void writeAsciiStream(InputStream x) throws SQLException
次の属性をASCII文字のストリームとしてストリームに書き込みます。- パラメータ:
x
- データベースに渡す値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeBinaryStream
void writeBinaryStream(InputStream x) throws SQLException
次の属性を未解釈のバイト・ストリームとしてストリームに書き込みます。- パラメータ:
x
- データベースに渡す値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeObject
void writeObject(SQLData x) throws SQLException
指定されたSQLData
オブジェクトに格納されたデータをストリームに書き込みます。SQLData
オブジェクトがnull
の場合、このメソッドはSQLNULL
をストリームに書き込みます。 そうでない場合は、指定されたオブジェクトのSQLData.writeSQL
メソッドを呼び出します。すると、呼び出されたメソッドによって、オブジェクトの属性がストリームに書き込まれます。SQLData.writeSQL
メソッドの実装は、オブジェクトの各属性を正しい順序で書き込むための適切なSQLOutput
writerメソッド(複数可)を呼び出します。 属性は、SQLInput
入力ストリームから読み込まれ、ユーザー定義型のSQL定義にリストされたときと同じ順序でSQLOutput
出力ストリームに書き込まれる必要があります。- パラメータ:
x
- SQL構造化型または個別の型のデータを表すオブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeRef
void writeRef(Ref x) throws SQLException
SQLREF
値をストリームに書き込みます。- パラメータ:
x
- SQLREF
値のデータを表すRef
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeBlob
void writeBlob(Blob x) throws SQLException
SQLBLOB
値をストリームに書き込みます。- パラメータ:
x
- SQLBLOB
値のデータを表すBlob
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeClob
void writeClob(Clob x) throws SQLException
SQLCLOB
値をストリームに書き込みます。- パラメータ:
x
- SQLCLOB
値のデータを表すClob
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeStruct
void writeStruct(Struct x) throws SQLException
SQL構造化型値をストリームに書き込みます。- パラメータ:
x
- SQL構造化型のデータを表すStruct
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeArray
void writeArray(Array x) throws SQLException
SQLARRAY
値をストリームに書き込みます。- パラメータ:
x
- SQLARRAY
型のデータを表すArray
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
writeURL
void writeURL(URL x) throws SQLException
SQLDATALINK
値をストリームに書き込みます。- パラメータ:
x
- SQL DATALINK型のデータを表すjava.net.URL
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
writeNString
void writeNString(String x) throws SQLException
次の属性をJavaプログラミング言語のString
としてストリームに書き込みます。 ストリームに送るときに、ドライバはこれをNCHAR
、NVARCHAR
、またはLONGNVARCHAR
値(ドライバのNVARCHAR
値に関する制限に関する引数のサイズに依存)に変換します。- パラメータ:
x
- データベースに渡す値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
writeNClob
void writeNClob(NClob x) throws SQLException
SQLNCLOB
値をストリームに書き込みます。- パラメータ:
x
- SQLNCLOB
値のデータを表すNClob
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
writeRowId
void writeRowId(RowId x) throws SQLException
SQLROWID
値をストリームに書き込みます。- パラメータ:
x
- SQLROWID
値のデータを表すRowId
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
writeSQLXML
void writeSQLXML(SQLXML x) throws SQLException
SQLXML
値をストリームに書き込みます。- パラメータ:
x
- SQLXML
値のデータを表すSQLXML
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、SQLXML
オブジェクト用のjava.xml.transform.Result
、Writer
、またはOutputStream
がクローズされていない場合、あるいはXML値の処理中にエラーが発生した場合。 この例外のgetCause
メソッドにより、より詳細な例外が提供されることがある(たとえばストリームに有効なXMLが含まれていない場合)SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
writeObject
default void writeObject(Object x, SQLType targetSqlType) throws SQLException
指定されたオブジェクトに格納されたデータをストリームに書き込みます。 このオブジェクトは、ストリームに送られる前に、指定されたtargetSqlTypeに変換されます。object
がnull
の場合、このメソッドはSQLNULL
をストリームに書き込みます。オブジェクトがカスタム・マッピングを持つ場合(オブジェクトがインタフェース
SQLData
を実装するクラスのインスタンスである場合)、JDBCドライバはSQLData.writeSQL
メソッドを呼び出して、そのオブジェクトをSQLデータ・ストリームへ書き込む必要があります。 また、オブジェクトがRef
、Blob
、Clob
、NClob
、Struct
、java.net.URL
、またはArray
を実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。デフォルト実装は
SQLFeatureNotSupportedException
をスローします- パラメータ:
x
- 入力パラメータ値を含むオブジェクトtargetSqlType
- データベースに送られるSQL型。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはxで指定されたJavaオブジェクトがInputStreamオブジェクトかReaderオブジェクトで、かつscaleパラメータの値が0より小さい場合SQLFeatureNotSupportedException
- JDBCドライバがこのデータ型をサポートしない場合- 導入されたバージョン:
- 1.8
- 関連項目:
JDBCType
,SQLType
-
-