ナビゲーションをスキップ

eDocs ホーム > BEA WebLogic Server 9.1 ドキュメント > Administration Console の拡張 > 開発環境の設定

Administration Console の拡張

  前 次 前/次ボタンと目次ボタンとの区切り線 目次  

開発環境の設定

BEA では、コンソール拡張を開発するのに必要な JSP タグ ライブラリ、スキーマ、および基本 Java クラスをすべて提供しています。Administration Console の拡張は XML ファイル、Java クラス、JSP、およびその他の標準の Web 関連リソースの集合であるため、拡張の開発には任意のテキスト エディタまたは統合開発環境を使用できます。

以下の節では、Administration Console の拡張を開発する環境の設定方法について説明します。

 

クラスパスの設定 (省略可能)

拡張用に Apache Struts クラスまたは Beehive ページ フロー クラスを作成している場合は、Apache クラスのセットをクラスパスに入れる必要があります。NavTreePortlet にノードを追加している場合は、BEA クラスのセットが必要です。

これらのクラスをクラスパスに追加するには、次のスクリプトを実行します。
WL_HOME\server\bin\setWLSEnv.cmd (または setWLSEnv.sh)
WL_HOME は WebLogic Server をインストールしたディレクトリです。

BEA のスクリプトを使用する代わりに、ご使用の環境のクラスパスに以下の JAR ファイルを追加することもできます。以下のファイルはすべて WL_HOME/server/lib/consoleapp/webapp/WEB-INF/lib ディレクトリにあります。

 

タグ ライブラリの IDE へのインポート (省略可能)

BEA の JSP テンプレートを使用して拡張内の JSP を作成する場合は、JSP Standard Tag Library (JSTL)、BEA Administration Console 拡張タグ ライブラリ、および Apache Beehive ページ フロー タグ ライブラリの JSP タグを使用する必要があります。

WebLogic Server の実行時環境では、これらのタグ ライブラリがあらかじめ提供されています。これらを開発においてサポートするには、開発環境に以下のタグ ライブラリを追加します。
WL_HOME/server/lib/consoleapp/webapp/WEB-INF/beehive-netui-tags-html.tld
WL_HOME/server/lib/consoleapp/webapp/WEB-INF/fmt.tld
WL_HOME/server/lib/consoleapp/webapp/WEB-INF/console-html.tld

 

拡張のディレクトリ ツリーの作成

Administration Console の拡張は Web アプリケーションの一部であり、そのリソースは標準の J2EE Web アプリケーションの要件を満たすディレクトリ構造にまとめる必要があります。また、WebLogic Portal フレームワーク、Apache Struts、および Apache Beehive では、特定の場所にコンフィグレーション ファイルを置く必要があります。

Administration Console の拡張の作業を開始するには、表 3-1 の基本的な構造に合わせたディレクトリ ツリーを作成します。

表 3-1 Administration Console 拡張のディレクトリ ツリー

ディレクトリ

説明

root-dir

拡張のルート ディレクトリ。このディレクトリにはファイルを作成しないことを推奨。

ディレクトリの名前はプログラム的に重要ではない。分かりやすい名前を選ぶこと。

拡張で URI を指定する場合、「/」(スラッシュ) 文字自体がこのルート ディレクトリを表す。

root-dir/WEB-INF

このディレクトリには、netuix-extension.xml というファイルを格納する必要がある。この XML ファイルは拡張のデプロイメント記述子として機能する。

Apache Struts を使用する場合は、このディレクトリに Struts コンフィグレーション ファイルを置く必要がある。

root-dir/WEB-INF/classes

拡張でメッセージ バンドルを使用する場合は、このディレクトリにプロパティ ファイルを入れる必要がある。

拡張でカスタム クラスを使用する場合、そのパッケージ構造はこのディレクトリから始まる必要がある。たとえば、クラス ファイルを com.mycompany.extension というパッケージにパッケージ化した場合は、classes ディレクトリ内に com/mycompany/extension というディレクトリ構造を作成する。次に、コンパイル済みクラス ファイルをこの extension ディレクトリに保存する。

(省略可能) root-dir/WEB-INF/src

拡張でカスタム クラスを使用する場合は、コンパイル前の Java ソース ファイルをこのディレクトリで始まるパッケージ構造に保存しておくことを推奨。

拡張をアーカイブするときは、この src ディレクトリは含めないこと。

(推奨) root-dir/ext_jsp

拡張のすべての JSP ファイルを ext_jsp というディレクトリの下に保存することを推奨。

JSP 用に個別のディレクトリを作成しておくと、コンテンツ開発者は他のサポート ファイル (ポータル フレームワーク XML ファイルなど) について知る必要がなくなる。

拡張に多数の JSP が含まれている場合は、ext_jsp の下にサブディレクトリを作成することを検討する。

この推奨事項に従う場合、JSP の URI は /ext_jsp で始まる。例 : /ext_jsp/myContent.jsp

root-dir/jsp というディレクトリは予約されている。拡張のルート ディレクトリに jsp というディレクトリを含めることはできない。

(推奨) root-dir/controls

拡張のすべてのポータル インクルード ファイル (.pinc) を controls というディレクトリの下に保存することを推奨。

拡張に多数のブックやページが含まれている場合は、controls の下にサブディレクトリを作成することを検討する。

この推奨事項に従う場合、ブックまたはページの URI は /controls で始まる。例 : /controls/myBook.pinc

(推奨) root-dir/portlets

拡張のすべてのポートレット ファイル (.portlet) を portlets というディレクトリの下に保存することを推奨。

拡張に多数のポートレットが含まれている場合は、portlets の下にサブディレクトリを作成することを検討する。

この推奨事項に従う場合、ポートレットの URI は /portlets で始まる。例 : /portlets/myContent.portlet


 

Administration Console のルック アンド フィールを拡張する場合、ルート ディレクトリには追加のサブディレクトリが含まれます。「サンプル ルック アンド フィールのコピーと修正 : 主な手順」を参照してください。

 

UI コントロール ラベルを表示するための開発ルック アンド フィールのデプロイメント

WebLogic Server には、Administration Console の拡張ポイントのラベルを表示するためのルック アンド フィールが用意されています。これらのラベルを使用して、拡張を表示する場所を指定できます。

注意 : ルック アンド フィール拡張のみを作成する、またはポートレットをデスクトップに追加するだけの場合は、この開発ルック アンド フィールをデプロイする必要はありません。

このルック アンド フィールを使用するには、次の手順に従います。

  1. dev2dev Web サイトのコード サンプル セクションからルック アンド フィールのアーカイブをダウンロードします。

    2. アーカイブは「Console Extension Developer Look and Feel」(code-sample ID S118) というコード サンプル プロジェクトで配布されており、以下の URL で入手できます。

    https://codesamples.projects.dev2dev.bea.com/servlets/Scarab?id=S118

  2. ダウンロードしたアーカイブから、devlaf-1.0.jar ファイルを展開して domain-root/console-ext ディレクトリに保存します。
    domain-root は開発環境内の WebLogic Server ドメインのルート ディレクトリです。
  3. ドメインの管理サーバを再起動します。
  4. Administration Console にログインします。

各ラベル付きコントロールのタイトルの横に、definitionLabel の値が角括弧 ([ ]) に囲まれて表示されます。別の角括弧の中には、そのコントロールがブックであるかページであるかが表示されます。図 3-1 を参照してください。

図 3-1 Administration Console のユーザ インタフェースに表示されるコントロール ラベル

Administration Console のユーザ インタフェースに表示されるコントロール ラベル


 

 

フッタのナビゲーションのスキップ  ページの先頭 前 次