ヘッダーをスキップ

Oracle Containers for J2EE サーブレット開発者ガイド
10g(10.1.3.1.0)

B31859-01
目次
目次
索引
索引

戻る 次へ

A Webモジュールの管理

この付録では、Oracle Enterprise Manager 10g Application Server Controlを使用してWebモジュールを管理するためのOC4J機能の参照ドキュメントを提供します。

Application Server Controlコンソール トップレベルの「Webモジュール」ページ

Application Server Controlコンソールは、アプリケーションをデプロイ、構成および監視できるだけでなく、アプリケーションによって使用されるOC4JインスタンスおよびWebサービスを管理することもできるWebベースのユーザー・インタフェースを提供します。このユーザー・インタフェースは、OC4Jソフトウェアを(スタンドアロン環境またはOracle Application Server環境に)インストールすると自動的にインストールおよび事前構成され、起動されます。また、OC4Jインスタンスが使用するポートにバインドされます。スタンドアロン環境では、通常、このポートは8888です。Oracle Application Server環境では、通常、7777です。

たとえば、スタンドアロンOC4J環境では、適切なホストの8888ポートを使用してコンソールにアクセスできます。

http://host:1888

このインタフェースの使用方法の詳細は、Application Server Controlコンソールのオンライン・ヘルプを参照してください。

コンソールは、アプリケーション、管理、パフォーマンスおよびWebサービスの機能エリアに編成されています。Webモジュールは、アプリケーション・エリアを使用して管理できます。

Webモジュールの構成は、Application Server Controlコンソールの該当する「Webモジュール」ホームページから開始します。このページには、「一般」タブ、「パフォーマンス」タブおよび「管理」タブがあります。

この項の後半では、次の項目について説明します。

「Webモジュール」ホームページへのアクセス方法

OC4Jホームページから「Webモジュール」ホームページにアクセスするには、「アプリケーション」タブを選択します。このタブから、次のいずれかの方法で、「Webモジュール」ホームページにアクセスすることができます。

  1. 「表示」ドロップダウン・メニューの「アプリケーション」を選択して、アプリケーションを表示します。

  2. 目的のアプリケーションを選択します。

  3. 「アプリケーション」ホームページが表示されたら、目的のモジュールを選択します。

または

  1. 「表示」ドロップダウン・メニューの「モジュール」を選択して、すべてのアプリケーションのモジュールを表示します。

  2. 目的のモジュールを選択します。

トップレベルの「Webモジュール」ページのサマリー

「Webモジュール」ホームページから、次のタブにアクセスできます。

前述のページの詳細は、Application Server Controlのオンライン・ヘルプで、状況依存トピックの「「Webモジュール」ホームページ」、「Webモジュールの「パフォーマンス」ページ」および「Webモジュールの「管理」ページ」を参照してください。OC4Jパフォーマンス・メトリックの詳細は、オンライン・ヘルプの「OC4Jパフォーマンス・メトリックのサマリー」を参照してください。

Application Server Control Webモジュールの構成ページ

Webモジュールの「管理」ページから、「タスクに移動」を選択して、Webモジュールの構成に関連するいくつかの表示および編集機能を使用することができます。これらについて、次の項で説明します。

「構成プロパティ」ページ

表A-1には、Application Server Controlコンソールの「構成プロパティ」ページを使用して構成できるWebモジュール・プロパティが示されています。このページは、Webモジュールの「管理」ページからアクセスできます。プロパティに関する追加情報は、「orion-web.xmlおよびglobal-web-application.xmlの要素と属性」に示されている該当する要素を参照してください。

「構成プロパティ」ページには、Webモジュール名とアプリケーション名も表示されます。

Application Server Controlのオンライン・ヘルプで、状況依存トピックの「Webモジュールの「構成プロパティ」ページ」も参照してください。

表A-1    「構成プロパティ」ページのプロパティ 
Application Server Controlのプロパティ  対応するXMLエントリ  説明 

表示名 

<web-app><display-name>要素 

ツールに表示されるWebモジュールの短縮名です。

注意: これはApplication Server Controlによる読取り専用です。 

説明 

<web-app><description>要素 

Webモジュールの説明(オプション)です。

注意: これはApplication Server Controlによる読取り専用です。 

分散可能 

<web-app><distributable>要素 

サーブレット仕様に規定されているように、アプリケーションが分散可能かどうかを示します。このプロパティは、このページで編集できません。

注意: これはApplication Server Controlによる読取り専用です。 

クラスパス 

<orion-web-app><classpath>サブ要素 

Webアプリケーションのクラスのロードに対する追加コードの場所(ライブラリ・ファイルまたは個別のクラス・ファイルの場所のいずれか)をOC4Jに通知します。 

永続性パス 

<orion-web-app>persistence-path属性 

サーバーの再起動またはアプリケーションの再デプロイ中に、サーブレットのHttpSessionオブジェクトが永続的に保存される場所を示します。相対パスを指定します。これは、application-deploymentsディレクトリの下にあるOC4Jの一時記憶領域からの相対パスです。値が指定されていない場合、再起動または再デプロイ中にセッション・オブジェクトの永続性は失われます。

注意: OC4Jクラスタリングが有効になっている場合、この属性は無視されます。 

一時ディレクトリ 

<orion-web-app>temporary-directory属性 

サーブレットおよびJSPページによりスクラッチ・ファイル用に使用される一時ディレクトリのパスです。パスは、絶対パスまたはデプロイメント・ディレクトリからの相対パスのいずれかにできます。  

ファイル変更チェック間隔 

<orion-web-app>file-modification-check-interval属性 

静的ファイル(HTMLファイルなど)について、タイムスタンプが変化しているかどうか、また、そのためにファイル・システムからリロードする必要があるかどうかをチェックするタイミングを、ミリ秒単位で決定します。デフォルトは、1000です。パフォーマンス上の理由から、本番環境では非常に大きな値(たとえば、1000000)を指定することをお薦めします。 

セッション・タイムアウト 

<web-app><session-config>要素の<session-timeout>サブ要素 

Webアプリケーションで作成されるすべてのセッションのデフォルト・セッション・タイムアウトを定義します。値が0以下の場合、タイムアウトは発生しません。 

デフォルト・バッファ・サイズ 

<orion-web-app>default-buffer-size属性 

サーブレットのレスポンスに関する出力バッファのデフォルトのサイズを、バイト単位で指定します。指定のない場合、デフォルトは、2048です。 

ディレクトリ参照を許可 

<orion-web-app>directory-browsing属性 

/」で終わるURLのディレクトリ参照の許可を指定します。サポートされている値は、allowおよびdeny(デフォルト)です。 ディレクトリ参照に関する追加情報は、「<orion-web-app>」を参照してください。 

デプロイメント・ディスクリプタの表示ページ

web.xmlファイルとorion-web.xml ファイルは、それぞれ、Application Server Controlコンソールの「デプロイメント・ディスクリプタの表示」ページと「固有デプロイメント・ディスクリプタの表示」ページを使用して表示できますが、編集はできません。

「サーブレット・マッピング」ページ

Application Server Controlコンソールの「サーブレット・マッピング」ページでは、サーブレット名とURLパターンの間のマッピングを表示できますが、編集はできません。表A-2で、これらのマッピングについて説明します。

Application Server Controlのオンライン・ヘルプで、状況依存トピックの「Webモジュールの「サーブレット・マッピング」ページ」も参照してください。

表A-2    「サーブレット・マッピング」ページのプロパティ 
Application Server Controlのプロパティ  対応するXMLエントリ  説明 

サーブレット名 

<web-app><servlet-mapping>要素の<servlet-name>サブ要素 

<web-app>の対応する<servlet>要素の<servlet-name>サブ要素で定義される、サーブレットの希望名への参照です。 

URLパターン 

<web-app><servlet-mapping>要素の<url-pattern>サブ要素 

対応するサーブレット名にマップするために必要な、サーブレットのURLパターン(サーブレット・パス)です。サーブレットを起動するURLには、このパターンが含まれます。 

「フィルタ・マッピング」ページ

表A-3には、「フィルタ・マッピング」ページを使用してサーブレット・フィルタについて構成できるプロパティが示されています。

Application Server Controlのオンライン・ヘルプで、状況依存トピックの「Webモジュールの「フィルタ・マッピング」ページ」も参照してください。

表A-3    「フィルタ・マッピング」ページの構成可能なプロパティ 
Application Server Controlのプロパティ  対応するXMLエントリ  説明 

フィルタ名 

<web-app><filter-mapping>要素の<filter-name>サブ要素 

<web-app>の対応する<filter>要素の<filter-name>サブ要素で定義される、フィルタの希望名への参照です。 

URLパターンまたはサーブレット名 

<web-app><filter-mapping>要素の<url-pattern>または<servlet-name>サブ要素 

URLパターンまたはサーブレット名の(両方ではなく)いずれかを対応するフィルタ名にマップします。 

フォワードに適用 

<web-app><filter-mapping>要素の<dispatcher>サブ要素と、FORWARDという値 

この値は、サーブレット名またはURLパターンに合致する転送ターゲットのすべてに適用されるフィルタに対して使用します。 

リクエストに適用 

<web-app><filter-mapping>要素の<dispatcher>サブ要素と、REQUESTという値 

この値は、サーブレット名またはURLパターンに合致する直接リクエスト・ターゲットにも適用されるフィルタに対して、「フォワードに適用」または「インクルードに適用」設定に加えて使用します。 

インクルードに適用 

<web-app><filter-mapping>要素の<dispatcher>サブ要素と、INCLUDEという値 

この値は、サーブレット名またはURLパターンに合致するインクルード・ターゲットのすべてに適用されるフィルタに対して使用します。 

エラーに適用 

<web-app><filter-mapping>要素の<dispatcher>サブ要素と、ERRORという値 

この値は、エラー・ページ・メカニズムで適用されるフィルタに対して使用します。 

表A-4には、「フィルタ・マッピング」ページで参照用に表示される追加のサーブレット・フィルタ・プロパティが示されています。

表A-4    「フィルタ・マッピング」ページの参照プロパティ 
Application Server Controlのプロパティ  対応するXMLエントリ  説明 

名前 

<web-app><filter>要素の<filter-name>サブ要素 

フィルタの希望名です。 

クラス 

<web-app><filter>要素の<filter-class>サブ要素 

フィルタ・コードを含むクラスの完全修飾名です。 

説明 

<web-app><filter>要素の<description>サブ要素 

フィルタの説明(オプション)です。 


注意

関連情報については、第4章「サーブレット・フィルタの理解および使用方法」を参照してください。 


「リソース参照マッピング」ページ

「リソース参照マッピング」ページは、リソース(データソース、JMSキュー、メール・セッションなど)のJNDIの場所を指定するために使用します。表A-5に、このページで構成できるプロパティを示します。

Application Server Controlのオンライン・ヘルプで、状況依存トピックの「Webモジュールのリソース参照マッピング」も参照してください。

「リソース参照マッピング」ページからは、「リソース参照の参照コンテキスト」ページ(「「リソース参照の参照コンテキスト」ページ」を参照)に移動して、JNDIの参照コンテキストを編集することもできます。

表A-5    「リソース参照マッピング」ページのプロパティ 
Application Server Controlのプロパティ  対応するXMLエントリ  説明 

名前 

<orion-web-app><resource-ref-mapping>サブ要素のname属性 

<web-app><resource-ref><res-ref-name>サブ要素の値を参照するリソースの名前です。より具体的には、リソース・マネージャのコネクション・ファクトリの参照の名前です。 

タイプ 

<web-app><resource-ref><res-type>サブ要素 

データソースまたはその他のリソースのタイプです。これは、リソースによって実装される完全修飾Javaタイプです。 

認可 

<web-app><resource-ref><res-auth>サブ要素 

リソース・マネージャへのサインオンがアプリケーション・コンポーネントでプログラム化されている(認可値はApplication)かOC4Jコンテナによって管理されている(認可値はContainer)かを示します。 

JNDIロケーション 

<orion-web-app><resource-ref-mapping>要素のlocation属性 

リソースのルックアップを行う希望のJNDIの場所です。  

参照コンテキスト 

<orion-web-app><resource-ref-mapping>要素の<lookup-context>サブ要素のlocation属性 

リソースのルックアップでデフォルトのコンテキストのかわりに使用されるオプションのJNDIコンテキストを指定します。  

「EJB参照マッピング」ページ

「EJB参照マッピング」ページは、EJBのJNDIの場所を指定するために使用します。表A-6に、このページのプロパティを示します。

Application Server Controlのオンライン・ヘルプで、状況依存トピックの「Webモジュールの「EJB参照マッピング」ページ」も参照してください。

表A-6    「EJB参照マッピング」ページのプロパティ 
Application Server Controlのプロパティ  対応するXMLエントリ  説明 

名前 

<orion-web-app><ejb-ref-mapping>サブ要素のname属性 

<web-app><ejb-ref><ejb-ref-name>サブ要素の値を参照するEJBの名前です。 

タイプ 

<web-app><ejb-ref>要素の<ejb-ref-type>サブ要素 

EJBのタイプ(EntityまたはSession)です。 

ホーム・インタフェース 

<web-app><ejb-ref>要素の<home>サブ要素 

EJBのホーム・インタフェースの完全修飾名です。 

リモート・インタフェース 

<web-app><ejb-ref>要素の<remote>サブ要素 

EJBのリモート・インタフェースの完全修飾名です。 

JNDIロケーション 

<orion-web-app><ejb-ref-mapping>サブ要素のlocation属性 

EJBのルックアップを行う希望のJNDIの場所です。  


注意

 

「環境エントリ・マッピング」ページ

「環境エントリ・マッピング」ページは、環境エントリの新しい値を設定するために使用します。表A-7に、このページのプロパティを示します。

Application Server Controlのオンライン・ヘルプで、状況依存トピックの「Webモジュールの「環境エントリ・マッピング」ページ」も参照してください。

表A-7    「環境エントリ・マッピング」ページのプロパティ 
Application Server Controlのプロパティ  対応するXMLエントリ  説明 

名前 

<orion-web-app><env-entry-mapping>サブ要素のname属性 

環境エントリの名前です。<web-app><env-entry>要素の<env-entry-name>サブ要素の値を参照します。 

タイプ 

<web-app><env-entry>要素の<env-entry-type>サブ要素 

環境エントリのJavaタイプです。 

説明 

<web-app><env-entry>要素の<description>サブ要素 

環境エントリの説明(オプション)です。 

値 

<web-app><env-entry>要素の<env-entry-value>サブ要素 

環境エントリのアセンブルされた値(通常、web.xmlファイルから)です。 

デプロイ済の値 

<orion-web-app><env-entry-mapping>サブ要素 

アセンブルされた値をオーバーライドするための、環境エントリの希望のデプロイ値です。<env-entry-mapping>要素の値は、<env-entry-value>要素の値をオーバーライドします。 

「リソース参照の参照コンテキスト」ページ

このページは、「リソース参照マッピング」ページ(「「リソース参照マッピング」ページ」を参照)からリンクされており、リソースのルックアップを行う新しいコンテキストを指定することができます。コンテキスト属性を編集することもできます。

Application Server Controlのオンライン・ヘルプで、状況依存トピックの「「リソース参照の参照コンテキスト」ページ」も参照してください。

表A-8    「リソース参照の参照コンテキスト」ページのプロパティ 
Application Server Controlのプロパティ  対応するXMLエントリ  説明 

リソース参照名 

<orion-web-app><resource-ref-mapping>サブ要素のname属性 

<web-app><resource-ref><res-ref-name>サブ要素の値を参照するリソースの名前です。より具体的には、リソース・マネージャのコネクション・ファクトリの参照の名前です。 

参照コンテキストの場所 

<orion-web-app><resource-ref-mapping>要素の<lookup-context>サブ要素のlocation属性 

リソースのルックアップでデフォルトのコンテキストのかわりに使用されるオプションのJNDIコンテキストを指定します。  

名前(コンテキスト属性の) 

<lookup-context><context-attribute>サブ要素のname属性 

対応する参照コンテキストとして指定されているデフォルト以外(サード・パーティなど)のJNDIコンテキストに送信するための属性の名前です。  

値(コンテキスト属性の) 

<lookup-context><context-attribute>サブ要素のvalue属性 

属性の希望の値です。 

WebモジュールのMBeanおよび管理のサマリー

標準準拠のMBeanは、OC4Jのランタイム構成で使用できます。次の項で、概要を説明します。

OC4JのMBean管理の一般的な概要

OC4JではJMX仕様がサポートされているので、J2EE環境でリソース(リソース・アダプタ関連のリソースなど)を動的に管理するための標準インタフェースを作成することができます。OC4JのJMX実装は、JMXクライアントのシステムMBeanブラウザを提供します。これにより、OC4Jに付属のMBeanを使用してOC4Jインスタンスを管理することができます。

MBeanは、JMXの管理可能なリソースを表すJavaオブジェクトです。OC4J内の各管理可能リソース(アプリケーション、リソース・アダプタなど)は、適切なMBeanのインスタンスによって管理されます。OC4Jに付属の各MBeanは、Application Server ControlコンソールのシステムMBeanブラウザからアクセス可能な管理インタフェースを公開します。MBean属性の設定、MBeanでメソッドをコールする操作の実行、エラーまたは特定のイベントの通知のサブスクライブ、および実行統計の表示を行うことができます。


注意

この情報は参照用に提供されますが、Webモジュールの主要な構成設定はApplication Server Controlコンソールの他の機能によってユーザーによりわかりやすい方法で公開されます。「Application Server Control Webモジュールの構成ページ」を参照してください。 


OC4Jホームページからブラウザにアクセスするには、「管理」タブを選択し、タスクのリストからJMXタスクの「システムMBeanブラウザ」を選択します。ブラウザでは、次のことを実行できます。

MBeanおよびその属性は場合によって変更が有効になる時点が異なることに注意してください。ランタイム・モデルでは、変更はただちに有効になります。構成モデルでは、一部の変更はリソースが再起動されると有効になり、一部の変更はアプリケーションが再起動されると有効になり、OC4Jが再起動されたときに有効になるものもあります。変更が維持されるかどうかも、場合によって異なります。

詳細は、『Oracle Containers for J2EE構成および管理ガイド』を参照してください。システムMBeanブラウザ自体も、MBeanに関する情報を提供します。

OC4JのWebモジュールのMBeansのサマリー

OC4Jは、アプリケーション実行時の管理を支援するために、各Webモジュール(OC4JのデフォルトWebアプリケーションなど)のMBeanセットをエクスポートします。J2EE管理仕様をサポートするにはいくつかのOC4J MBeanが必要ですが、それらによって拡張機能が提供される場合もあります。その他のOC4J MBeanは、そのモデルへのOracleの拡張機能です。

表A-9に、Webモジュールに関連し、JSR-77によってアプリケーション・サーバーに必要とされるMBeanのOC4J実装をまとめます。これらの実装は、oracle.oc4j.admin.management.mbeansパッケージに含まれています。


注意

  • MBeanは、システムMBeanブラウザで自動文書化され、MBean属性、操作および通知(該当する場合)に関するいくつかのドキュメントが提供されます。

  • ほとんど(すべてではない)のMBeanの統計プロパティは、DMS統計から得られます。 DMSの概要は、「Oracle Application Serverのダイナミック・モニタリング・サービス」を参照してください。

  • デフォルトのWebアプリケーションについて: OC4Jは、デフォルトのJ2EEアプリケーション(グローバル・アプリケーションとも呼ばれます)を含むデフォルト構成とともにインストールされます。デフォルトのアプリケーションは、OC4Jの他のすべてのJ2EEアプリケーション(Application Server Controlコンソールを除く)のデフォルトの親です。通常のOC4Jのインストールでは、デフォルトのアプリケーションにはデフォルトのWebアプリケーションが組み込まれています。デフォルトのWebアプリケーションの名前およびルート・ディレクトリ・パスは、OC4Jのグローバルapplication.xmlファイルで指定されます。スタンドアロンOC4Jでは、デフォルトのWebアプリケーションは、default-web-site.xmlファイルによってWebサイトにバインドされ、デフォルトのコンテキスト・パスは「/」です。

 

表A-9    Webモジュールの必須システムMBean 
MBean  説明 

Servlet 

web.xmlファイルの<servlet>要素に対応するプロパティによって、サーブレットのインスタンスを管理します。  

WebModule 

web.xmlファイルの<web-app>要素(<servlet>サブ要素の外)に対応するプロパティによって、Webモジュールの標準機能を管理します。

WebModule MbeanのloadAllServletMBeans()メソッドは、基礎となるサーブレットをロードせずにサーブレットMbeansを作成します。 OC4Jは、起動時または事前ロードがリクエストされた場合に、サーブレットをロードします。詳細は「サーブレットの事前ロード」を参照してください。 

表A-10に、Webモジュールに関連し、Oracleの拡張機能でもあるOC4J MBeanをまとめます。このMBean実装も、oracle.oc4j.admin.management.mbeansパッケージに含まれています。

表A-10    Webモジュールの追加システムMBean 
MBean  説明 

OC4JWebModule 

orion-web.xmlファイルの<orion-web-app>要素(<web-app>サブ要素の外)に対応するプロパティによって、WebモジュールのOC4J固有の機能を管理します。 

OC4JのWebモジュールのMBeansに関する注意

戻る 次へ
Oracle
Copyright © 2006 Oracle Corporation.

All Rights Reserved.
目次
目次
索引
索引