8.3 UDDIクライアント実行時の環境設定

UDDIクライアントを実行するには,事前に環境設定が必要になります。ここでは,設定が必要なJARファイルや接続プロパティについて説明します。また,UDDIクライアント実行時のトレースプロパティの設定や,動作定義ファイルの設定についても説明します。

<この節の構成>
(1) クラスパスに追加するJARファイル
(2) 接続プロパティの設定
(3) トレースプロパティの設定
(4)  SOAPアプリケーションの動作定義ファイルの設定

(1) クラスパスに追加するJARファイル

UDDIクライアントを実行する場合に,クラスパスに追加するJARファイルを示します。追加する方法については,「8.4 UDDIクライアントの実行」を参照してください。

注※
クラスパスの指定内容を示します。
Windowsの場合:
<HNTRLib2インストールディレクトリ>¥classes¥hntrlib2j.jar
<HNTRLib2インストールディレクトリ>の部分は,次に示すコマンドの実行結果を指定します。

> "%COSMINEXUS_HOME%¥common¥bin¥gethntr2conf.exe" HNTR2INSTDIR

Windows以外(IPFを除く)の場合:
/opt/hitachi/HNTRLib2/classes/hntrlib2j.jar
Windows以外(IPF)の場合:
/opt/hitachi/HNTRLib2/classes/hntrlib2j64.jar

また,必要に応じて次のシステムプロパティを追加する必要があります。

  1. 接続プロパティ
  2. トレースプロパティ

具体的な追加方法については,「8.4 UDDIクライアントの実行」を参照してください。

(2) 接続プロパティの設定

レジストリへの接続に関するプロパティをシステムプロパティで指定できます。

接続プロパティはJAXR APIのConnectionFactory#setProperties(Properties)メソッドを使用して,UDDIクライアントのプログラム内から動的に変更することもできます。この場合,setPropertiesメソッドで設定される値がシステムプロパティで指定した値よりも優先されます。

次に接続プロパティに関するシステムプロパティの一覧を示します。

表8-1 接続プロパティ一覧

プロパティ名称指定値デフォルト値
javax.xml.registry.queryManagerURLアクセスする先のUDDIレジストリサーバの問い合わせURLを指定します。URL形式として正しく指定する必要があります。※1
このプロパティは必ず指定してください。
javax.xml.registry.lifeCycleManagerURLアクセスする先のUDDIレジストリサーバの発行URLを指定します。URL形式として正しく指定する必要があります。※1
このプロパティを指定しない場合,queryManagerURLプロパティの値が使用されます。
javax.xml.registry.semanticEquivalences同じ意味を持つConceptのIDの組を次の形式で指定します。
<id1>,<id2>|<id3>,<id4>|…
ここで,<id1>と<id2>および<id3>と<id4>が同じ意味を持つIDの組です。主にUDDIにユーザ定義の郵便住所体系を持つ場合に使用します。
javax.xml.registry.postalAddressScheme郵便住所体系を示すClassificationSchemeオブジェクトのIDを指定します。
javax.xml.registry.security.authenticationMethodレジストリサーバとの認証で使用する認証方法を指定します。
"UDDI_GET_AUTHTOKEN"は固定です。これ以外の認証方法はサポートされません。
"UDDI_GET_AUTHTOKEN"
javax.xml.registry.uddi.maxRowsUDDI APIのfind操作で返却される最大エントリ数を0以上の整数値で指定します。
指定しない場合,最大エントリ数はレジストリサーバのデフォルト値に従います。※2
(凡例)
-:デフォルト値がないことを示します。
注※1
uCosminexus UDDI Registryの場合,問い合わせ,発行URLともに次のとおりです。
http://<レジストリのホスト名またはIPアドレス(ポート番号)>/uddi/services/UDDIService
注※2
このプロパティはUDDI APIのmaxRows属性を指定するプロパティです。したがって,JAXRのfind系APIの最大取得件数を指定する値ではありません。特にfindConceptsやfindClassificationSchemesメソッドでは指定したエントリ数より少なくなる場合があります。

(3) トレースプロパティの設定

トレース出力に関するプロパティをシステムプロパティに設定できます。

注意事項
トレースプロパティが設定されない場合や,指定した値が有効でない場合には,トレースファイルに警告メッセージが記録され,そのプロパティのデフォルト値で処理が続行されます。

次にトレースプロパティに関するシステムプロパティの一覧を示します。

表8-2 トレースプロパティ一覧

プロパティ名称指定値デフォルト値
com.cosminexus.xml.registry.trace.trace_levelトレースレベルをERROR,WARN,INFO,DEBUGのどれかを指定します。トレースレベルについては「14.4.3 トレースファイル出力の重要度」を参照してください。WARN
com.cosminexus.xml.registry.trace.file_pathトレースメッセージを記録するため作成されるログファイルのパスと名前を文字列で指定します。<Cosminexusのインストールフォルダ>/c4web/logs/
JAXRAPITrace
com.cosminexus.xml.registry.trace.file_numトレースファイルの面数を1~16の数値で指定します。2
com.cosminexus.xml.registry.trace.file_size一つのトレースファイルの最大サイズをバイト単位で指定します。4,096~2,147,483,647の数値を設定します。2,097,152

(4)  SOAPアプリケーションの動作定義ファイルの設定

UDDIクライアントはSOAPクライアントとして動作するため,必要に応じてSOAPアプリケーションのクライアント定義ファイル,共通定義ファイルを設定します。

特に,HTTPプロキシサーバ経由でレジストリサーバにアクセスする場合,クライアント定義ファイルに次のキーを設定する必要があります。

SOAPアプリケーションの動作定義ファイルの設定については,「10. 動作定義ファイルおよび実行時オプションの設定項目」を参照してください。