JDBC および SQLJ アプリケーション内の XML データ・エンコード

Java アプリケーションの場合、アプリケーション・コード・ページが常に Unicode であるため、XML エンコード方式に関する問題は、一般的に、Db2® ODBC や組み込み SQL アプリケーションの場合より少なくなります。

内部的にエンコードされた XML データのエンコード方式に関する考慮事項は、 すべてのアプリケーションについて同じですが、Java アプリケーションにおいて外部的にエンコードされたデータの場合はより単純です。

Java アプリケーション中の XML データの入力に関する一般的な推奨事項

  • 入力データがファイル内にある場合は、データをバイナリー・ストリームとして読み取り (setBinaryStream)、データベース・マネージャーがそのデータを内部的にエンコードされたデータとして処理できるようにします。
  • 入力データが Java アプリケーション変数内にある場合は、 アプリケーション変数タイプの選択によって、Db2 データベース・マネージャーが内部エンコード方式を使用するかどうかが決まります。データを文字タイプとして入力する場合 (setString など)、データベース・マネージャーは、 データを解析して保管する前に UTF-16 (アプリケーション・コード・ページ) から UTF-8 に変換します。

Java アプリケーション中の XML データの出力に関する一般的な推奨事項

  • XML データを非バイナリー・データとしてファイルに出力する場合は、XML 内部エンコード方式を出力データに追加する必要があります。

    ファイル・システムのエンコード方式は Unicode でない可能性もあるので、ストリング・データはファイル中に保管される際に変換される可能性があります。データをバイナリー・データとしてファイルに書き込む場合には、変換は起こりません。

    Java アプリケーションの場合、データベース・サーバーは、暗黙的な XML シリアライズ操作に関する明示宣言を追加しません。 出力データを com.ibm.db2.jcc.DB2Xml タイプとしてキャストし、getDB2Xmlxxx メソッドの 1 つを呼び出す場合は、以下の表のように、JDBC ドライバーはエンコード方式の宣言を追加します。

    getDB2Xmlxxx 宣言内のエンコード指定
    getDB2XmlString ISO-10646-UCS-2
    getDB2XmlBytes(String targetEncoding) targetEncoding によって指定されるエンコード方式
    getDB2XmlAsciiStream US-ASCII
    getDB2XmlCharacterStream ISO-10646-UCS-2
    getDB2XmlBinaryStream(String targetEncoding) targetEncoding によって指定されるエンコード方式

    INCLUDING XMLDECLARATION を指定した明示的 XMLSERIALIZE 関数の場合、データベース・サーバーはエンコード方式を追加し、JDBC ドライバーはそのエンコード方式を変更しません。データベース・サーバーが追加する明示エンコード方式は UTF-8 エンコード方式です。アプリケーションが値を取り出す方法によっては、 データの実際のエンコード方式が明示的な内部エンコード方式と一致しない場合があります。

  • アプリケーションが出力データを XML パーサーに送信する場合は、UTF-8、UCS-2、または UTF-16 エンコード方式で、バイナリー・アプリケーション変数中のデータを取り出す必要があります。