Oracle® Fusion Middleware Oracle WebLogic Administration Console の拡張 11g リリース 1 (10.3.1) B55554-01 |
|
戻る |
次へ |
Oracle では、コンソール拡張を開発するのに必要な JSP タグ ライブラリ、スキーマ、および基本 Java クラスをすべて提供しています。Administration Console の拡張は XML ファイル、Java クラス、JSP、およびその他の標準の Web 関連リソースの集合であるため、拡張の開発には任意のテキスト エディタまたは統合開発環境を使用できます。
以下の節では、Administration Console の拡張を開発する環境の設定方法について説明します。
拡張用に Apache Struts クラスまたは Beehive ページ フロー クラスを作成している場合は、Apache クラスのセットをクラスパスに入れる必要があります。NavTreePortlet にノードを追加している場合は、Oracle クラスのセットが必要です。
これらのクラスをクラスパスに追加するには、次のスクリプトを実行します。
WL_HOME
\server\bin\setWLSEnv.cmd
または
WL_HOME
\server\bin\setWLSEnv.sh
WL_HOME
WebLogic Server をインストールしたディレクトリです。
Oracle のスクリプトを使用する代わりに、ご使用の環境のクラスパスに WL_HOME
/server/lib/consoleapp/webapp/WEB-INF/lib
ディレクトリにあるすべての JAR ファイルを追加できます。
Oracle の JSP テンプレートを使用して拡張内の JSP を作成する場合は、JSP Standard Tag Library (JSTL)、Oracle Administration Console 拡張タグ ライブラリ、および Apache Beehive ページ フロー タグ ライブラリの JSP タグを使用する必要があります。
WebLogic Server ではこれらのタグ ライブラリがインストールされ、IDE に利用することができます。代わりに、これらの標準のタグ ライブラリを独自にダウンロードすることもできます。詳細については、「JSP テンプレートとタグ ライブラリ」を参照してください。
Administration Console の拡張は Web アプリケーションの一部であり、そのリソースは標準の Java EE Web アプリケーションの要件を満たすディレクトリ構造にまとめる必要があります。また、WebLogic Portal フレームワーク、Apache Struts、および Apache Beehive では、特定の場所にコンフィグレーション ファイルを置く必要があります。
Administration Console の拡張の作業を開始するには、表 3-1 の基本的な構造に合わせたディレクトリ ツリーを作成します。
表 3-1 Administration Console 拡張のディレクトリ ツリー
ディレクトリ | 説明 |
---|---|
root-dir
|
拡張のルート ディレクトリ。このディレクトリにはファイルを作成しないことを推奨。 ディレクトリの名前はプログラム的に重要ではない。分かりやすい名前を選ぶこと。 拡張で URI を指定する場合、「 |
root-dir/WEB-INF
|
このディレクトリには、 Apache Struts を使用する場合は、このディレクトリに Struts コンフィグレーション ファイルを置く必要がある。 |
root-dir/WEB-INF/classes
|
拡張でメッセージ バンドルを使用する場合は、このディレクトリにプロパティ ファイルを入れる必要がある。 拡張でカスタム クラスを使用する場合、そのパッケージ構造はこのディレクトリから始まる必要がある。たとえば、クラス ファイルを |
(省略可能) root-dir/WEB-INF/src
|
拡張でカスタム クラスを使用する場合は、コンパイル前の Java ソース ファイルをこのディレクトリで始まるパッケージ構造に保存しておくことを推奨。 拡張をアーカイブするときは、この |
(推奨) root-dir/ext_jsp
|
拡張のすべての JSP ファイルを JSP 用に個別のディレクトリを作成しておくと、コンテンツ開発者は他のサポート ファイル (ポータル フレームワーク XML ファイルなど) について知る必要がなくなる。 拡張に多数の JSP が含まれている場合は、 この推奨事項に従う場合、JSP の URI は
|
(推奨) root-dir/controls
|
拡張のすべてのポータル ブック ファイル ( 拡張に多数のブックやページが含まれている場合は、 この推奨事項に従う場合、ブックまたはページの URI は |
(推奨) root-dir/portlets
|
拡張のすべてのポートレット ファイル ( 拡張に多数のポートレットが含まれている場合は、 この推奨事項に従う場合、ポートレットの URI は |
Administration Console のルック アンド フィールを拡張する場合、ルート ディレクトリには追加のサブディレクトリが含まれます。「Administration Console の外観の変更」を参照してください。
WebLogic Server には、Administration Console の拡張ポイントのラベルを表示するためのコンフィグレーション オプションが用意されています。これらのラベルを使用して、拡張を表示する場所を指定できます。これらのラベルを表示するには、次の手順に従います。
Administration Console のツールバーで [環境設定] をクリックします。
[拡張] タブを選択します。
[定義ラベルの表示] を選択します。
[保存] をクリックします。
ページ内に配置されたラベル付きの各コントロール上にフィールドが表示されます。フィールドには、コントロールの definitionLabel
の値が表示され、その値には、ブックまたはラベルを示す「Book:
」または「Label:
」というプレフィックスが付いています。図 3-1 を参照してください。
図 3-1 Administration Console のユーザ インタフェースに表示されるコントロール ラベル