BEA ホーム | 製品 | デベロッパ・センタ | support | askBEA |
![]() |
![]() |
|
![]() |
e-docs > WebLogic Server > WebLogic XML プログラマーズ ガイド > WebLogic Server XML の管理 |
WebLogic XML プログラマーズ ガイド
|
WebLogic Server XML の管理
以下の節では、WebLogic Server での XML の管理について説明します。
Administration Console から XML レジストリにアクセスし、XML レジストリで WebLogic Server を XML アプリケーション用にコンフィグレーションします。
ブラウザで Administration Console を起動するには、次の URL を入力します。
http://host:port/console
各要素の説明は次のとおりです。
XML レジストリの作成、コンフィグレーション、使用は、Administration Console を通じて行います。Administration Console XML レジストリの使用には、次のメリットがあります。
XML レジストリを使用すると、以下の指定が可能になります。
これらの機能は、サーバサイドだけで使用できます。
XML レジストリは必要な数だけ作成できますが、WebLogic Server の特定のインスタンスに関連付けることができる XML レジストリの数は 1 つだけです。
WebLogic Server のインスタンスに関連付けられている XML レジストリがない場合、ドキュメントの解析および変換に組み込みパーサおよびトランスフォーマが使用されます。
XML レジストリを WebLogic Server のインスタンスに関連付けると、すべての XML コンフィグレーション オプションが、そのサーバを使用している XML アプリケーションで利用可能になります。
XML レジストリに対しては、以下のタイプのエントリを作成できます。
注意: XML レジストリでは、大文字と小文字が区別されます。たとえば、ルート要素が <CAR> の XML ドキュメント タイプのパーサをコンフィグレーションしている場合、[ルート要素タグ] フィールドには、「car」または「Car」ではなく「CAR」と入力する必要があります。
JAXP で XML アプリケーションを記述する場合は、常に XML レジストリに自動的にアクセスします。WebLogic Server は、以下のようなルックアップ順序に従って、ロードするパーサのクラスを決定します。
特定のドキュメント タイプに対応するトランスフォーマを定義することはできないので最初の手順は除きますが、それ以外ではこのプロセスはトランスフォーマにも当てはまります。
さらに、WebLogic Server の起動時に、SAX エンティティ リゾルバは、レジストリで宣言されたエンティティを解決するように自動的に設定されます。したがって、使用するパーサを制御したり、外部エンティティのローカル コピーの場所を設定したりするために、XML アプリケーション コードを変更する必要はありません。使用するパーサ、および外部エンティティの位置は、XML レジストリで制御します。
注意: パーサによって JAXP の代わりに提供された API を使用する場合、XML レジストリは XML ドキュメントの処理に影響を与えません。このため、XML アプリケーションではなるべく JAXP を使用してください。
XML パーサおよびトランスフォーマのコンフィグレーション タスク
デフォルトでは、WebLogic Server は、組み込みパーサとトランスフォーマで XML ドキュメントを解析および変換するようにコンフィグレーションされています。リリース 7.0 では、組み込み XML パーサは Apache Xereces、組み込みトランスフォーマは Apache Xalan です。デフォルト コンフィグレーションを使用する場合、XML アプリケーション用のコンフィグレーション タスクは不要です。組み込み以外のパーサまたはトランスフォーマを使用する場合は、以下の節で説明するように XML レジストリでパーサおよびトランスフォーマをコンフィグレーションする必要があります。
組み込み以外のパーサまたはトランスフォーマのコンフィグレーション
以下の手順ではまず、SAX および DOM パーサおよびトランスフォーマを定義する XML レジストリの作成方法を説明します。次に、サーバが新しいパーサとトランスフォーマを使用するために、新しい XML レジストリを WebLogic Server のインスタンスに関連付ける方法を説明します。
警告: WebLogic Server バージョン 7.0 では、Apache Xerces パーサの次のバージョンのみをプラグインできます。
また、Apache Xerces パーサの以前のバージョン対応の Apache Xalan トランスフォーマ のバージョンのみをプラグインできます。
図7-1 Administration Console のメイン XML レジストリ ウィンドウ
[名前] : WebLogic FastParser
[Document Builder ファクトリ] :
[SAX パーサ ファクトリ] : weblogic.xml.babel.jaxp.SAXParserFactoryImpl
[Transformer ファクトリ] :
上の例では、[Document Builder ファクトリ] および [Transformer ファクトリ] は空白のまま残されています。これは、DOM 解析および変換では、それぞれ組み込みパーサおよびトランスフォーマが使用されることを意味します。WebLogic FastParser は、SAX 解析でのみ使用されます。
Apache Xerces パーサおよび Xalan トランスフォーマを直接指定する場合、以下の情報のいずれかを指定します。
[名前] : Apache Xerces/Xalan Registry
[Document Builder ファクトリ] : org.apache.xerces.jaxp.DocumentBuilderFactoryImpl
[SAX パーサ ファクトリ] : org.apache.xerces.jaxp.SAXParserFactoryImpl
[Transformer ファクトリ] : org.apache.xalan.processor.TransformerFactoryImpl
図7-2 Administration Console の XML プロパティ コンフィグレーション用ウィンドウ
特定のドキュメント タイプに対応したパーサのコンフィグレーション
特定のドキュメント タイプに対応したパーサをコンフィグレーションする場合、ドキュメントのシステム ID、パブリック ID、ルート要素タグを使用して、ドキュメント タイプを識別できます。
警告: WebLogic Server では、XML ドキュメントのタイプを識別する際、ドキュメントの先頭から 1000 バイトのみをサーチします。この先頭 1000 バイトで DOCTYPE ID が見つからない場合、ドキュメントのサーチは停止され、WebLogic Server インスタンス用にコンフィグレーションされたパーサを使用してドキュメントの解析が行われます。
注意: 次の手順では、これから新しい XML レジストリを作成して、必要なパーサ レジストリ エントリを追加し、サーバに関連付けることを前提としています。既存の XML レジストリを既にサーバに関連付けている場合は、手順 5. にスキップしてください。
特定のドキュメント タイプに対応したパーサをコンフィグレーションするには、以下の手順を実行します。
図7-3 Administration Console による XML パーサのコンフィグレーション
コード リスト 7-1 car.xml ファイル
<?xml version="1.0"?>
<!-- 以下の XML ドキュメントでは自動車を説明 -->
<!DOCTYPE CAR PUBLIC "-//BEA Systems, Inc.//DTD for cars//EN"
"http//www.beasys.co.jp/index.html">
<CAR>
<MAKE>Toyota</MAKE>
<MODEL>Corrolla</MODEL>
<YEAR>1998</YEAR>
<ENGINE>1.5L</ENGINE>
<HP>149</HP>
</CAR>
XML レジストリを使用すると、外部エンティティ解決をコンフィグレーションし、外部エンティティ キャッシュをコンフィグレーションおよびモニタできます。
WebLogic Server では、以下のいずれかの方法で外部エンティティの解決をコンフィグレーションできます。
外部エンティティを管理対象の Server にキャッシュすると、アクセス時間を節約できるだけでなく、ネットワークまたは管理サーバのダウンにより XML ドキュメントの解析中に管理サーバにアクセスできなくなった場合には、ローカル バックアップを利用できます。
キャッシュされたエンティティに対して、WebLogic Server が URL または管理サーバからエンティティを再取得して再キャッシュするまでの間隔(有効期限)をコンフィグレーションできます。
注意: 次の手順では、これから新しい XML レジストリを作成して、必要な外部エンティティ解決のエントリを追加し、サーバに関連付けることを前提としています。既存の XML レジストリを既にサーバに関連付けている場合は、手順 5. にスキップしてください。
外部エンティティの解決をコンフィグレーションするには、以下の手順を実行します。
図7-4 Administration Console による外部エンティティのコンフィグレーション
コード リスト 7-2 car.xml ファイル
<?xml version="1.0"?>
<!-- 以下の XML ドキュメントでは自動車を説明 -->
<!DOCTYPE CAR PUBLIC "-//BEA Systems, Inc.//DTD for cars//EN"
"http//www.beasys.co.jp/index.html">
<CAR>
<MAKE>Toyota</MAKE>
<MODEL>Corrolla</MODEL>
<YEAR>1998</YEAR>
<ENGINE>1.5L</ENGINE>
<HP>149</HP>
</CAR>
外部エンティティ キャッシュの以下のプロパティをコンフィグレーションできます。
外部エンティティ キャッシュをコンフィグレーションするには、次の手順に従います。
外部エンティティ キャッシュを説明する一連の統計情報を使用して、キャッシュの効果をモニタできます。統計では、以下の情報を示します。
外部エンティティ キャッシュをモニタするには、次の手順に従います。
以下の表で、外部エンティティ キャッシュの現在の状態を表示する場合のフィールドについて説明します。
以下の表で、外部エンティティ キャッシュの累積アクティビティを表示する場合のフィールドについて説明します。
![]() |
![]() |
![]() |
![]() |
||
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |