2.3.9　J2EEサーバ用ユーザプロパティファイル（usrconf.properties）を設定する

(1)　コード変換テーブルのパスを設定する

文字コード変換UOCでコード変換のAPIを使用する場合，Code Converterで使用するコード変換テーブルのパスを設定する必要があります。

usrconf.propertiesへの記述形式

csc.dt.codetablepath=<コード変換テーブル格納パスディレクトリ>/table

設定方法については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「2.7.1　Code Converterによる拡張」のcsc.dt.codetablepathの記載個所を参照してください。

ページの先頭へ

(2)　文字コード変換UOCのクラスを登録する

開発環境で作成した文字コード変換UOCを実行環境で使用するには，クラス名を完全修飾名で登録する必要があります。

usrconf.propertiesへの記述形式

csc.dt.ownCodeConverter.className=<文字コード変換UOCのクラス名>

設定方法については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「付録H.2　文字コード変換UOCを使用するための設定」を参照してください。

ページの先頭へ

(3)　カスタムファンクションで使用するjarファイルの格納先を変更する

カスタムファンクションで使用するjarファイルの格納先を変更する場合，変更するファイルパスを設定します。デフォルトの格納先を次に示します。

jarファイルの格納先

<サービスプラットフォームのインストールディレクトリ>\CSC\userlib\customfunc

jarファイルの格納先を変更したい場合の記述方法を次に示します。

usrconf.propertiesへの記述形式

csc.dt.customFuncDir=<変更先ディレクトリのパス>

注意事項

jarファイルの格納先としてサービスプラットフォームのインストールディレクトリ配下を指定すると，アンインストール時に削除されるおそれがあるため，インストールディレクトリ配下以外の場所を設定してください。

usrconf.propertiesへの記述例

カスタムファンクションで使用するjarファイルの格納先を「C:\\USER\\FUNC」に変更する場合の記述例を次に示します。

csc.dt.customFuncDir=C:\\USER\\FUNC

ページの先頭へ

(4)　値置換えファンクションで使用する変換テーブルを登録する

開発環境で作成したデータ変換定義に値置換えファンクションが含まれる場合，値置換えファンクションで利用する変換テーブルを登録します。

変換テーブルの格納先と文字コードの情報を一組として記述します。複数の変換テーブルについて記述できます。

usrconf.propertiesに記述する内容と形式を次に示します。

　　　:
csc.dt.valueTable.<変換テーブルID>=<変換テーブルのファイルパス>
csc.dt.valueTableSize=<変換テーブルの合計ファイルサイズ>
csc.dt.encodeType.<変換テーブルID>=［MS932|UTF8|UTF16_BIG|UTF16_LITTLE］
　　　:

<変換テーブルID>

変換テーブルIDとして任意の名称を指定します。変換テーブルIDは，開発環境の値置換えダイアログで値置換えファンクションを定義する際，使用する変換テーブルの指定に使用します。

csc.dt.valueTable.<変換テーブルID>=<変換テーブルのファイルパス>

変換テーブルのファイルパスを絶対パスで指定します。

csc.dt.valueTableSize=<変換テーブルの合計ファイルサイズ><<10>>

変換テーブルの合計ファイルサイズ（単位：キロバイト）の上限値を正の整数で指定します。指定範囲は1〜2097151です。指定を省略した場合は，10が仮定されます。

上限値を超えるサイズの変換テーブルを読み込むと，KDEC40730-EをJ2EEサーバのログファイルに出力し，HCSCサーバの起動を中断します。

csc.dt.encodeType.<変換テーブルID>=［MS932|UTF8|UTF16_BIG|UTF16_LITTLE］

変換テーブルに使用している文字コードを指定します。

変換テーブルのファイルに関する注意事項

BOM付きのファイルは使用できません。

ページの先頭へ

(5)　XMLパーサプール機能オプションを使用する

XMLパーサプール機能を使用する場合，必要に応じて初期割り当て数や最大プール数を指定します。

HCSCサーバでは，次に示すJavaのXMLパーサによってXMLを解析しています。

• DOMパーサ（javax.xml.DocumentBuilderクラス）

• SAXパーサ（org.xml.sax.XMLReaderクラス）

これらのXMLパーサのインスタンスは複数のスレッドで共有できないため，複数のスレッドで同時使用する場合は，スレッドごとにXMLパーサを生成しています。XMLパーサの生成処理は時間を要するため，解析ごとに生成すると性能が劣化します。

XMLパーサプール機能を使用すると，メモリ上に作成されたXMLパーサプールに生成したXMLパーサを保存しておくことができます。XMLパーサプールへ保存したXMLパーサは，システム全体で共有し，再利用できるため，処理の効率向上が図れます。

XMLパーサプール機能の各オプションについて次に説明します。

初期割り当て数 ≦ 最大プール数 ≦ リクエストの最大同時実行数

初期割り当て数 ≦ 最大プール数
　
・データ検証機能を使用する場合
　最大プール数 ≦ 各ビジネスプロセス・サービスアダプタの最大同時実行数（多重度）
　
・データ検証機能を使用しない場合
　最大プール数 ≦ 各ビジネスプロセスの検証アクティビティの最大同時実行数の総和

ページの先頭へ

(6)　サイズノードの機能を拡張する

サイズノードの拡張機能を使用するかどうかを指定します。

データ変換のサイズノードは，バイナリフォーマット定義の要素（単純内容要素または複合内容要素）のサイズをその前に存在するノードで指定できる機能です。通常のサイズノードは，指定元である要素のサイズだけが対象となります（サイズノード自身のサイズは含まない）。サイズノードの拡張機能を使用すると，指定元である要素のほかに，サイズノード自身のサイズも加算されます。

サイズノードの拡張機能については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「付録M　サイズノードの機能拡張」を参照してください。

なお，拡張機能が有効なのは，次の条件を満たすサイズノードだけです。

• サイズノード指定元要素が，サイズノード指定可能な単純内容要素または複合内容要素であること

• サイズノードのサイズが固定長であること

このプロパティの指定は，HCSCサーバ上のすべてのバイナリフォーマット定義のサイズノードのデフォルト動作に対して有効となります。

usrconf.propertiesに記述する内容と形式を次に示します。プロパティ値の大文字/小文字は区別されません。

　　　　　　　　　:
csc.dt.sizeNode.includeSelfSize={true｜false}
　　　　　　　　　:

csc.dt.sizeNode.includeSelfSize={true｜false}

サイズノードの拡張機能を使用するかどうかを指定します。

true

サイズノードの拡張機能を使用します。

false

サイズノードの拡張機能を使用しません。

ページの先頭へ

(7)　未定義コードを任意の文字へ置換する

バイナリデータとUnicode文字列との間で変換する場合，未定義の文字コードはデフォルトでは空白文字へ置換されますが，任意の文字へ置換することもできます。

任意の文字へ置換する場合は，事前に次に示す2つのファイル定義が必要です。

• HCSCサーバランタイム定義ファイルに，telegram-undefined-character-code=REPLACE（未定義部分の文字コードをスペースに置換する）を定義する

  HCSCサーバランタイム定義ファイルの定義方法については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

• J2EEサーバ用ユーザプロパティファイル（usrconf.properties）に，置換する任意の文字を指定する

  指定方法については，(a)以降を参照してください。

　　　:
<プロパティキー>=<置換文字コード>
　　　:

ページの先頭へ

(8)　データ変換APIの動作を指定する

データ変換APIの動作を指定できます。データ変換APIについては，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「12.1　データ変換APIを使用したデータ変換」を参照してください。

データ変換APIで指定できるシステムプロパティを次に示します。

デバッグ情報の出力ファイル名には，データ変換APIのインスタンス（グループ）の名称が付加されます。デバッグ情報の出力ファイル名を次に示します。

cscdebug_<グループ名>_<面数>.log

ページの先頭へ