SQLOutput (Java Platform SE 7)

既知のすべての実装クラス:

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)` 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.writeSQ メソッドの実装は、オブジェクトの各属性を正しい順序で書き込むための適切な 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 - SQLARRAY 型のデータを表す 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 としてストリームに書き込みます。ストリームに送るときに、ドライバはこれを NCHAR、NVARCHAR、または 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 - データベースアクセスエラーが発生した場合、SQLXML オブジェクト用の java.xml.transform.Result、Writer、または OutputStream がクローズされていない場合、あるいは XML 値の処理中にエラーが発生した場合。この例外の getCause メソッドにより、より詳細な例外が提供されることがある (たとえばストリームに有効な XML が含まれていない場合)
    
    SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
    導入されたバージョン:
    
    1.6

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

インタフェース SQLOutput

メソッドのサマリー

メソッドの詳細

writeString

writeBoolean

writeByte

writeShort

writeInt

writeLong

writeFloat

writeDouble

writeBigDecimal

writeBytes

writeDate

writeTime

writeTimestamp

writeCharacterStream

writeAsciiStream

writeBinaryStream

writeObject

writeRef

writeBlob

writeClob

writeStruct

writeArray

writeURL

writeNString

writeNClob

writeRowId

writeSQLXML