JBoss での開発環境の準備

JBoss で開発環境を準備する場合は、アプリケーションをエクスプロード・モードで実行します。

このタスクについて

このセクションでは、JBoss の使用時に行われた変更をテストする方法について説明します。

注: IBM® では、解凍された EAR のすべての jar ファイルを WEB-INF/lib ディレクトリーに直接コピーすることをお勧めします。これにより、これらの jar ファイルが JBoss にアクセスできるようになり、これらの jar ファイルを JBoss CLASSPATH に組み込む必要がなくなります。

JBoss を構成して、エクスプロード・モードでアプリケーションを実行するには、以下の手順を実行します。

手順

Windows 用の < JBOSS_DOMAIN>/bin/run.cmd スクリプト (UNIX の場合はrun.sh ) を編集し、「Java としてオプション」™ パラメーターで以下の引数を設定します。
```
-Dsci.opsproxy.disable=Y -Dvendor=shell
-DvendorFile=/servers.properties
```
インストール・プロセス中に実行したように、EAR ファイルを再ビルドします。

注: アプリケーションは、エクスプロード・モードのコンテキスト・ヘルプのドキュメンテーション拡張をサポートしていません。ただし、文書 EAR をアプリケーション EAR と一緒にビルドすることができます。 DOC EAR は、コンテキスト・ヘルプ・ファイルなどのエンド・ユーザー文書を含みません。これには、実動サーバーにデプロイしてはならない開発関連の資料 (API Javadoc、ERD、XSD など) のみが含まれています。
文書 EAR smcfsdocs.ear をアプリケーション EAR と共にビルドするには、ビルダー・コマンドを実行する前に、 BUILD_DOC_EAR プロパティーを追加して、<INSTALL_DIR>/properties/sandbox.cfg ファイル内で値を「true」に設定し、setupfiles スクリプトを実行します。
注: デフォルトでは、文書 EAR はアプリケーション EAR とともにビルドおよびデプロイされません。

注: -Dnodocear パラメーターは、BUILD_DOC_EAR プロパティーよりも優先されます。例えば、BUILD_DOC_EAR プロパティーが「true」に設定されていても -Dnodocear パラメーターが create-ear スクリプトと一緒に使用されている場合は、文書 EAR はビルドされません。
アプリケーション・サーバーを停止し、以下のステップを実行します。

例えば、カタログ・モジュールにいくつかのカスタマイズがある場合は、 < JBOSS_HOME>/server/< SERVER_NAME>/deploy/smcfs.ear/smcfs.war/ycm ディレクトリーにファイルを追加します。

新規ディレクトリーを作成し、それに smcfs.ear という名前を付けます。
EAR を、作成した smcfs.ear ディレクトリーに解凍します。
smcfs.ear ディレクトリーには、 smcfs.war ファイルが存在します。この .war ファイルをリネームするか、または別のディレクトリーにコピーしてください。
smcfs.ear ディレクトリー内に新しいサブディレクトリーを作成し、それに smcfs.war という名前を付けます。
smcfs.war ファイルからすべてのファイルを抽出し、 smcfs.ear/smcfs.war サブディレクトリーに解凍します。
ステップ 5 で名前変更またはコピーした smcfs.war ファイルを削除します。
拡張機能のビルドおよびデプロイの一部として作成された jar をコピーし、 < JBOSS_HOME>/server/< SERVER_NAME>/deploy/smcfs.ear ディレクトリー内の jar を上書きします。
例：
- データベースを拡張する場合は、 entities.jar をビルドしてデプロイし、jar を < JBOSS_HOME>/server/< SERVER_NAME>/deploy/smcfs.ear ディレクトリーにコピーします。
- UI リソースを拡張する場合は、 resources.jarをビルドしてデプロイし、jar を < JBOSS_HOME>/server/< SERVER_NAME>/deploy/smcfs.ear ディレクトリーにコピーします。
カスタマイズしたファイル (例えば、ローカリゼーション・リテラル・ファイル、JSP) を適切な < JBOSS_HOME>/server/< SERVER_NAME>/deploy/smcfs.ear/smcfs.war ディレクトリーにコピーします。
アプリケーション・サーバーを再始動します。
デプロイ後に、 < JBOSS_HOME>/server/< SERVER_NAME>/deploy ディレクトリーにコピーされたファイルを変更できます。例えば、データベース拡張性の一部として作成されたカスタム・コードを拡張する場合、拡張カスタム・コードを、テストのために < JBOSS_HOME>/server/< SERVER_NAME>/deploy ディレクトリーの下の適切なディレクトリーに直接移動することができます。 JBoss は変更内容を識別し、アプリケーションを再デプロイします (ホット・デプロイメント)。

以下のテーブルに記述された JBoss ホット・デプロイメントのテスト・モード標準を使用して、カスタマイズのテストを行います。

変更の対象	変更を行うファイル	アクション
始動パラメーター	プロパティー	JBoss を再始動する。
UI 拡張性	JSP、 JavaScript、CSS、テーマ XML	動的にロードする。
ローカライズ・リテラル	alertmessages ファイルおよびローカライズ・バンドル・ファイル	JBoss を再始動する。
データベース拡張	エンティティー XML	entities.jar ファイルを再ビルドし、その jar を `JBOSS_HOME`/server/`SERVER_NAME`/deploysmcfs.ear ディレクトリーに組み込んでから、JBoss を再始動します。
API およびその他のテンプレート・ファイル	テンプレート XML	resources.jar ファイルを再ビルドし、その jar を `JBOSS_HOME`/server/`SERVER_NAME`/deploy/smcfs.ear ディレクトリーに組み込んでから、JBoss を再始動します。
アプリケーション構成ファイル	web.xml、application.xml、プロパティー・ファイル	JBoss を再始動する。