Cosminexus 機能解説

[目次][用語][索引][前へ][次へ]

7.3.2 アプリケーションディレクトリの構成

アプリケーションディレクトリは,展開ディレクトリ形式のJ2EEアプリケーションのルートディレクトリです。展開ディレクトリ形式のJ2EEアプリケーションを作成する場合には,アプリケーションディレクトリを作成し,アプリケーションディレクトリ下に,EJB-JAR,Webアプリケーションなどの構成要素を格納します。アプリケーションディレクトリの構成を次の表に示します。

表7-1 アプリケーションディレクトリの構成

ディレクトリ ディレクトリの説明
<アプリケーションディレクトリ> 展開ディレクトリ形式のJ2EEアプリケーションのルートディレクトリです。アプリケーションディレクトリの名称は任意です。
  META-INF J2EEアプリケーションのDDの格納ディレクトリです。このディレクトリの直下に,application.xmlが格納されます。
<EJB-JARディレクトリ> EJBアプリケーションのルートディレクトリです。
  META-INF EJB-JARのDDの格納ディレクトリです。このディレクトリの直下に,ejb-jar.xmlが格納されます。
<パッケージ名> EJB-JARのクラスファイルやプロパティファイルを格納するディレクトリです。

(例)
MyEJB.class
MyEJBHome.class
MyEJBRemote.class
MyResource.properties
<WARディレクトリ> Webアプリケーションのルートディレクトリです。
なお,このディレクトリの直下に,JSPファイルが格納されます。

(例)
index.jsp
  WEB-INF WebアプリケーションのDDの格納ディレクトリです。このディレクトリの直下に,web.xmlが格納されます。
  classes サーブレットクラスファイルやプロパティファイルを格納するディレクトリです。

(例)
MyServlet.class
lib タグライブラリなどのJARファイルを格納するディレクトリです。

(例)
MyTagLibrary.jar
RARファイル J2EEアプリケーションで使用するリソースアダプタです。

注※ リソースアダプタ(RARファイル)をJ2EEアプリケーションに含めて使用する場合に配置します。RARファイルは,アーカイブファイルのまま格納します。リソースアダプタをJ2EEリソースアダプタとしてデプロイする場合は,アプリケーションディレクトリにリソースアダプタを格納する必要はありません。


アプリケーションディレクトリの留意事項を次に示します。

<この項の構成>
(1) アプリケーションディレクトリの作成例
(2) アプリケーションディレクトリの変更

(1) アプリケーションディレクトリの作成例

アプリケーションディレクトリの作成例を次に示します。

ここでは,EJB-JARディレクトリが「subdir/converter」,WARディレクトリが「MyWebApp」,RARファイルが「rardir/DBConnector_DABJ_CP.rar」の場合のアプリケーションディレクトリの構成例,application.xmlの記述例を示します。

(2) アプリケーションディレクトリの変更

アプリケーションディレクトリを変更する場合,変更の対象となるディレクトリやファイルの種類と操作の内容によって,変更できなかったり,変更後にアプリケーションの再インポートが必要になったりします。

(例)
  • ディレクトリの削除/名称変更
    アプリケーションディレクトリ,EJB-JARディレクトリ,およびWARディレクトリは削除できません。また,ディレクトリ名は変更できません。削除した場合や名称を変更した場合には,アプリケーションを再インポートする必要があります。
  • JARファイルの追加/変更/削除
    ライブラリJARの追加,削除,およびファイル名の変更はできません。ライブラリJAR(application.xmlで宣言していないJARファイル)を追加しても,そのJARファイルは読み込まれません。アプリケーションのインポート時に存在したライブラリJARのファイル名を変更した場合や,ライブラリJARを削除した場合には,アプリケーションを再インポートする必要があります。
    なお,WARディレクトリ/WEB-INF/libディレクトリでは,JARファイルの追加/変更/削除はできます。
  • DDの変更
    ユーザがアプリケーションディレクトリに存在するDDを変更しても,J2EEサーバは更新を検知しません。DDに記述された定義の更新にはサーバ管理コマンドを使用してください。ただし,クラスファイルに記述されたアノテーションは,次回J2EEアプリケーションを開始したときのクラスファイルの再読み込みで,更新を反映させることができます。
    なお,サーバ管理コマンド実行時にアプリケーションディレクトリの構成がチェックされます。

アプリケーションディレクトリの変更可否を次の表に示します。

表7-2 アプリケーションディレクトリの変更可否

対象 ディレクトリおよびファイル ディレクトリおよびファイルへの操作 アプリケーションの状態 説明
停止 開始
J2EEアプリケーション アプリケーションディレクトリ 追加
内容変更
名称変更 × アプリケーションの構成変更はできない。
削除 × アプリケーションの構成変更はできない。
application.xml 追加
内容変更 × DDの直接編集はできない。DDの定義の更新にはサーバ管理コマンドを使用する。※1
名称変更 ※1
削除 × ※1
EJBアプリケーション EJB-JARディレクトリ 追加
内容変更
名称変更 × アプリケーションの構成変更はできない。
削除 × アプリケーションの構成変更はできない。
EJBを構成するクラスファイル 追加 × クラスを追加したあとで,サーバ管理コマンド(またはServer Plug-in)で属性を編集する必要がある。
内容変更 × DDにメソッド情報(container-transactionやmethod-permission)が記述されている場合には,DDの情報と同期を取って修正する必要がある。
名称変更 × クラスファイルの内容を変更しないでクラスファイル名を変更しようとした場合,次回クラスローダ時にエラーになる。
削除 × クラスを削除したあとで,サーバ管理コマンド(またはServer Plug-in)で属性を編集する必要がある。
ほかのクラスファイル 追加 ×
内容変更 ×
名称変更 × クラスファイルの内容を変更しないでクラスファイル名を変更しようとした場合,次回クラスローダ時にエラーになる。
削除 ×
ejb-jar.xml 追加
内容変更 × DDの直接編集はできない。DDの定義の更新にはサーバ管理コマンドを使用する。※1
名称変更 ※1
削除 × ※1
Webアプリケーション WARディレクトリ 追加
内容変更
名称変更 × アプリケーションの構成変更はできない。
削除 × アプリケーションの構成変更はできない。
WEB-INF/classes下のクラスファイルやプロパティファイル 追加 ×
内容変更 ×
名称変更 クラスファイルの内容を変更しないでクラスファイル名を変更しようとした場合,次回クラスローダ時にエラーになる。
削除 ×
WEB-INF/lib下のJARファイル 追加 ×
内容変更 ×
名称変更 ×
削除 ×
web.xml 追加
内容変更 × DDの直接編集はできない。DDの定義の更新にはサーバ管理コマンドを使用する。※1
名称変更 ※1
削除 × ※1
JSPファイル,
タグファイル,
静的コンテンツ(HTMLやJavaScriptなど),
JSPファイルまたはタグファイルが依存するファイル※2
JSPコンパイル結果
追加 ×
内容変更 ×
名称変更
削除 ×
ライブラリ ライブラリJAR 追加 × アプリケーションの構成変更はできない。
ライブラリJARを追加しても無視される。
内容変更 ×
名称変更 × アプリケーションの構成変更はできない。
削除 × アプリケーションの構成変更はできない。
参照ライブラリ 追加 × サーバ管理コマンド(cjsetappprop)で定義を変更する。
内容変更 ×
名称変更 サーバ管理コマンド(cjsetappprop)で定義を変更する。開始状態では変更できない。
削除 × サーバ管理コマンド(cjsetappprop)で定義を変更する。開始状態では削除できない。
参照ライブラリのディレクトリ 追加 ×
内容変更 ×
名称変更 ×
削除 ×
リソースアダプタ RARファイル 追加 ×
内容変更 × RARファイルを直接変更できない。サーバ管理コマンドを使用してプロパティを変更する。
名称変更 ×
削除 ×

(凡例)

「アプリケーションの状態」が「停止」の場合
アプリケーションが停止状態の場合,ディレクトリおよびファイルの種類や操作の内容によって,アプリケーションの再インポートの要否が異なります。
◎:再インポートは不要(次回アプリケーション開始時に操作が反映される)。
○:条件を満たす場合には,再インポートは不要。条件は「説明」を参照。
△:再インポートが必要。
−:該当しない。

「アプリケーションの状態」が「開始」の場合
アプリケーションが開始状態でリロード機能が無効の場合,ディレクトリおよびファイルの種類や操作の内容によって,操作を許可するかどうかが異なります。
×:操作できない。
−:該当しない。

注※1
DDを変更してもJ2EEサーバは更新を検知しないで,操作は無視されます。
次に示すコマンドを次回,実行したときに上書きされます。
cjsetappprop
cjaddapp(-type filterオプション指定時)
cjdeleteapp(-type filterオプション指定時)
cjrenameapp
cjstartapp

注※2
依存するファイルは,JSPファイルまたはタグファイルのincludeディレクティブでインクルードされるファイルや,web.xmlの<include-prelude>または<include-coda>でインクルードされるファイルのことです。