B プロファイルサービスプロバイダコンフィグレーションリファレンス (profile.xml)

この章では、プロファイルプロバイダのコンフィグレーションファイルである profile.xml の詳細なリファレンスを提供します。以下の節で構成されています。

節 B.1「profile.xml の概要」
節 B.2「グラフィカルな表示」
節 B.3「profile.xml の編集」
節 B.4「XML スキーマ」
節 B.5「profile.xml ファイルのサンプル」
節 B.6「XML 要素の説明」

B.1 profile.xml の概要

diameter.xml ファイルには、以下のプロファイルサービスプロバイダ属性が定義されています。

プロバイダの名前
実装プロバイダのクラス名
プロバイダに渡した任意の引数
プロバイダを使用するためのマッピングルール。

profile.xml は、DOMAIN_DIR/config/custom サブディレクトリに格納されます。DOMAIN_DIR は OWLCS ドメインのルートディレクトリです。

B.2 グラフィカルな表示

図 B-1 では、profile.xml ファイルの要素階層を表示します。

図 B-1 profile.xml の要素階層

「図 B-1 profile.xml の要素階層」の説明

B.3 profile.xml の編集

profile.xml ファイルに変更を加えるときは、直接編集せずに、Administration Console プロファイルサービス拡張を使って間接的に行うようお勧めします。Administration Console を使用すれば、profile.xml が確実に有効な XML になります。OWLCS アプリケーション開発の「Administration Console を使用したプロファイルプロバイダのコンフィグレーション」を参照してください。

しかし場合によっては、問題のあるコンフィグレーションを修正したり、壊れたファイルを修復したり、OWLCS のアップグレード時にカスタムプロファイルプロバイダコンフィグレーションを多数のマシンに展開したりするために、profile.xml を手動で表示したり編集する可能性もあります。profile.xml を手動で編集したときは、変更内容を適用するためにサーバを再起動する必要があります。

B.3.1 profile.xml の編集の手順

プロダクションシステムの profile.xml に変更を加える必要がある場合は、以下の手順に従ってください。

テキストエディタで DOMAIN_DIR/config/custom/profile.xml ファイルを開きます。ただし、DOMAIN_DIR は OWLCS ドメインのルートディレクトリを表します。
profile.xml ファイルに対して必要に応じて変更します。XML 要素の詳細については、「XML 要素の説明」を参照してください。
変更を保存し、テキストエディタを終了します。
サーバを再起動して、変更内容を有効にします。
更新後のシステムをテストして、コンフィグレーションを検証します。

B.4 XML スキーマ

WLSS_HOME/server/lib/wlss ディレクトリにインストールされた profile-service-descriptor-binding.jar ライブラリ内に profile.xml ファイルのすべてのスキーマがバンドルされています。

B.5 profile.xml ファイルのサンプル

コンフィグレーションファイル profile.xml のコードリストについては、『SIP アプリケーションの開発』の「カスタムプロファイルプロバイダの開発」を参照してください。

B.6 XML 要素の説明

以下の節では、profile.xml の各 XML 要素について説明します。

B.6.1 profile-service

最上位レベルの profile-service 要素には、全体のプロファイルサービスコンフィグレーションが含まれます。

B.6.2 mapping

プロファイルデータに対するリクエストをプロファイルプロバイダ実装にマッピングする方法を指定します。

B.6.2.1 map-by

ドキュメントをプロバイダにマッピングするための手法を指定します。

プロバイダを判定するために router は map-by-router に指定された、カスタムルータクラスを使用します。
ドキュメントをプロバイダにマップするために prefix は指定された、map-by-prefix エントリを使用します。
プロバイダにドキュメントをマップするために provider-name は provider エントリに指定された、name 要素を使用します。

B.6.2.2 map-by-prefix

プリフェクスによるマッピング時にドキュメントをプロファイルプロバイダにマップするために使用するプリフィクスを指定します。

B.6.2.3 map-by-router

ルータベースマッピングでドキュメントをプロファイルにマップするために使用する (com.bea.wcp.profile.ProfileIRouter を実装) ルータクラスを指定します。

B.6.3 provider

プロファイルプロバイダ実装と起動オプションをコンフィグレーションします。

B.6.3.1 name

プロバイダコンフィグレーションの名前を指定します。provider-name マッピング手法を指定する場合、name 要素はプドキュメントをプロバイダにマッピングするためにも使用されます。

B.6.3.2 provider-class

(com.bea.wcp.profile.ProfileServiceSpi の実装) プロファイルプロバイダクラスを指定します。

B.6.3.3 param

プロバイダ実装に任意パラメータを指定するために name と value 要素を使用します。

B プロファイル サービス プロバイダ コンフィグレーション リファレンス (profile.xml)