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 エンコード方式で、バイナリー・アプリケーション変数中のデータを取り出す必要があります。