JavaTM Platform
Standard Ed. 6

java.sql
インタフェース SQLOutput

既知の実装クラスの一覧:
SQLOutputImpl

public interface SQLOutput

ユーザー定義型の属性をデータベースに書き戻すための出力ストリームです。カスタムマッピングにだけ使用されるこのインタフェースはドライバによって使用され、そのメソッドをプログラマが直接呼び出すことはできません。 

SQLData インタフェースを実装するクラスのオブジェクトが引数として SQL 文に渡されると、JDBC ドライバはデータベースに渡される SQL データの種類を判定するために SQLData.getSQLType を呼び出します。次に、ドライバは SQLOutput のインスタンスを生成し、それを SQLData.writeSQL メソッドに渡します。writeSQL メソッドは、SQLData オブジェクトから SQLOutput 出力ストリームにデータを SQL ユーザー定義型の表現として書き込むための適切な SQLOutput writer メソッド (writeBooleanwriteCharacterStream など) を呼び出します。

導入されたバージョン:
1.2

メソッドの概要
 void writeArray(Array x)
          SQL ARRAY 値をストリームに書き込みます。
 void writeAsciiStream(InputStream x)
          次の属性を ASCII 文字のストリームとしてストリームに書き込みます。
 void writeBigDecimal(BigDecimal x)
          次の属性を java.math.BigDecimal オブジェクトとしてストリームに書き込みます。
 void writeBinaryStream(InputStream x)
          次の属性を未解釈のバイトストリームとしてストリームに書き込みます。
 void writeBlob(Blob x)
          SQL BLOB 値をストリームに書き込みます。
 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)
          SQL CLOB 値をストリームに書き込みます。
 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)
          SQL NCLOB 値をストリームに書き込みます。
 void writeNString(String x)
          次の属性を Java プログラミング言語の String としてストリームに書き込みます。
 void writeObject(SQLData x)
          指定された SQLData オブジェクトに格納されたデータを、ストリームに書き込みます。
 void writeRef(Ref x)
          SQL REF 値をストリームに書き込みます。
 void writeRowId(RowId x)
          SQL ROWID 値をストリームに書き込みます。
 void writeShort(short x)
          次の属性を Java の short 型としてストリームに書き込みます。
 void writeSQLXML(SQLXML x)
          SQL XML 値をストリームに書き込みます。
 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)
          SQL DATALINK 値をストリームに書き込みます。
 

メソッドの詳細

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 の場合、ストリームに SQL NULL を書き込みます。そうでない場合は、指定されたオブジェクトの SQLData.writeSQL メソッドを呼び出します。すると、呼び出されたメソッドによって、オブジェクトの属性がストリームに書き込まれます。SQLData.writeSQL メソッドの実装は、オブジェクトの各属性を正しい順序で書き込むための適切な SQLOutput writer メソッド (複数可) を呼び出します。属性は、SQLInput 入力ストリームから読み込まれ、ユーザー定義型の SQL 定義にリストされたときと同じ順序で SQLOutput 出力ストリームに書き込まれる必要があります。

パラメータ:
x - SQL 構造化型または個別の型のデータを表すオブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.2

writeRef

void writeRef(Ref x)
              throws SQLException
SQL REF 値をストリームに書き込みます。

パラメータ:
x - SQL REF 値のデータを表す Ref オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.2

writeBlob

void writeBlob(Blob x)
               throws SQLException
SQL BLOB 値をストリームに書き込みます。

パラメータ:
x - SQL BLOB 値のデータを表す Blob オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.2

writeClob

void writeClob(Clob x)
               throws SQLException
SQL CLOB 値をストリームに書き込みます。

パラメータ:
x - SQL CLOB 値のデータを表す 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
SQL ARRAY 値をストリームに書き込みます。

パラメータ:
x - SQL ARRAY 型のデータを表す Array オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.2

writeURL

void writeURL(URL x)
              throws SQLException
SQL DATALINK 値をストリームに書き込みます。

パラメータ:
x - SQL DATALINK 型のデータを表す java.net.URL オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4

writeNString

void writeNString(String x)
                  throws SQLException
次の属性を Java プログラミング言語の String としてストリームに書き込みます。ストリームに送るときに、ドライバはこれを SQL NCHARNVARCHAR、または LONGNVARCHAR 値 (ドライバの NVARCHAR 値に関する制限に関する引数のサイズに依存) に変換します。

パラメータ:
x - データベースに渡す値
例外:
SQLException - データベースアクセスエラーが発生した場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

writeNClob

void writeNClob(NClob x)
                throws SQLException
SQL NCLOB 値をストリームに書き込みます。

パラメータ:
x - SQL NCLOB 値のデータを表す NClob オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

writeRowId

void writeRowId(RowId x)
                throws SQLException
SQL ROWID 値をストリームに書き込みます。

パラメータ:
x - SQL ROWID 値のデータを表す RowId オブジェクト。
例外:
SQLException - データベースアクセスエラーが発生した場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

writeSQLXML

void writeSQLXML(SQLXML x)
                 throws SQLException
SQL XML 値をストリームに書き込みます。

パラメータ:
x - SQL XML 値のデータを表す SQLXML オブジェクト。
例外:
SQLException - データベースアクセスエラーが発生した場合、java.xml.transform.ResultWriter、または OutputStreamSQLXML オブジェクトに対してクローズされていない場合、または XML 値の処理中にエラーが発生した場合。この例外の getCause メソッドにより、より詳細な例外が提供されることがある (たとえばストリームに有効な XML が含まれていない場合)
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。