WebLogic エンタープライズ JavaBeans (EJB) プログラマーズガイド

appc リファレンス

appc

appc コンパイラは、EJB および JSP を WebLogic Server にデプロイするのに必要なクラスを生成し、コンパイルします。また、個別のモジュールレベルとアプリケーションレベルの両方で、現在の仕様に準拠しているかどうかデプロイメント記述子を検証します。アプリケーションレベルのチェックでは、個別のモジュールに対するアプリケーションレベルのデプロイメント記述子のチェックと、モジュール全体の検証チェックが行われます。

appc の利点

appc ツールの利点は以下のとおりです。

個々のモジュールを別々にコンパイルして、事後に EAR として結合するのではなく、アプリケーション全体をコンパイルできる柔軟性。
EAR コンパイル中に WebLogic Server がすべてのモジュールにアクセスできることによる、すべてのモジュールにわたる検証チェック、およびさまざまなモジュールに対するアプリケーションレベルのデプロイメント記述子検証。

appc がなかったときは、ear ファイル内のすべてのモジュールをコンパイルする場合、ユーザは EAR の個々のコンポーネントを抽出し、適切なコンパイラ (jspc または ejbc) を手動で実行して、デプロイメント用モジュールを準備しなければなりませんでした。appc はこのプロセスを自動化し、従来はできなかった追加の検証チェックをデプロイメント前に実行します。

appc のエラーを簡単に特定して修正できる。

コマンドラインで appc を実行中にエラーが発生すると、エラーメッセージが表示され、appc が終了します。
それに対して、コンパイルをデプロイメント時に行うことにした場合、コンパイルエラーが発生すると、サーバはデプロイメントが失敗しても作業を続けます。デプロイメントの失敗の原因を特定するには、サーバ出力を調べ、問題を修正し、再デプロイする必要があります。

デプロイメントの前に appc を実行すると、Bean のコンパイル時間を短縮できる。

たとえば、JAR ファイルを 3 つのサーバのクラスタにデプロイする場合、JAR ファイルが各サーバにコピーされてデプロイされます。JAR ファイルがコンパイルされていない場合、各サーバは、デプロイメント時にファイルをコンパイルする必要があります。

appc の構文

appc の実行には、次の構文を使用します。

prompt>java weblogic.appc [options] <ear, jar, or war file or directory>

代替デプロイメント記述子の指定

J2EE では、application.xml の <module> 要素の <alt-dd> 要素を使用して、EJB または Web アプリケーションモジュールの代替 J2EE デプロイメント記述子を指定できます。

<alt-dd> を使用することで、J2EE デプロイメント記述子 web.xml および ejb-jar.xml についてのみ代替デプロイメント記述子を指定できます。WebLogic Server 8.1 SP01 からは、alt-dd でモジュールの代替デプロイメント記述子を指定すると、appc はその代替記述子ファイルを使用して EJB をコンパイルします。

<alt-dd> 要素の詳細については、『WebLogic Server アプリケーションの開発』の「module」を参照してください。

WebLogic Server 8.1 SP01 以降では、以下のように appc のコマンドラインオプションを使用して、アプリケーションの代替 J2EE および WebLogic Server デプロイメント記述子を指定できます。

-altappdd <file> - このオプションを使用すると、代替 J2EE デプロイメント記述子ファイル (application.xml) の絶対パスとファイル名を指定できます。
-altwlsappdd <file> - このオプションを使用すると、代替 WebLogic アプリケーションデプロイメント記述子ファイル (weblogic-application.xml) の絶対パスとファイル名を指定できます。

appc のオプション

表 D-1 は、appc のコマンドラインオプションのリストです。

表 D-1 appc のコマンドラインオプション

オプション	説明
`-advanced`	高度な使用オプションを出力する。
`-altappdd`	代替 J2EE アプリケーションデプロイメント記述子を指定する。
`-altwlsappdd`	代替 WebLogic Server アプリケーションデプロイメント記述子を指定する。
`-basicClientJar`	EJB 用に生成されたクライアント JAR のデプロイメント記述子を含まない。
`-classpath <path>`	コンパイル中に使用するクラスパスを選択する。
`-compiler <javac>`	使用する Java コンパイラを選択する。
`-deprecation`	非推奨となった呼び出しについて警告する。
`-forceGeneration`	EJB および JSP クラスを強制的に生成する。このフラグがないと、チェックサムでその必要性が示されない限りクラスは再生成されない。
`-g`	デバッグ情報をクラスファイルにコンパイルする。
`-help`	標準の使い方メッセージを出力する。
`-idl`	EJB リモートインタフェース用の IDL を生成する。
`-idlDirectory <dir>`	IDL ファイルを作成するディレクトリを指定する (デフォルトでは、対象ディレクトリまたは JAR)。
`-idlFactories`	値タイプ用にファクトリメソッドを生成する。
`-idlMethodSignatures <>`	IDL コードを生成するトリガとして使用されるメソッドシグネチャを指定する。
`-idlNoAbstractInterfaces`	抽象インタフェース、およびそれを含むメソッドと属性を生成しない。
`-idlNoValueTypes`	値タイプ、およびそれを含むメソッドと属性を生成しない。
`-idlOrbix`	Orbix 2000 2.0 C++ と多少の互換性を持つ IDL を生成する。
`-idlOverwrite`	常に既存の IDL ファイルを上書きする。
`-idlVerbose`	IDL 生成についての詳細な情報を表示する。
`-idlVisibroker`	Visibroker 4.5 C++ と多少の互換性を持つ IDL を生成する。
`-iiop`	EJB 用に CORBA のスタブを生成する。
`-iiopDirectory <dir>`	IIOP のスタブファイルを記述するディレクトリを指定する (デフォルトでは、対象ディレクトリまたは JAR)。
`-J<option>`	Java 実行時にフラグを渡す。
`-keepgenerated`	生成された `.java` ファイルを保持する。
-library <file>	ライブラリのカンマ区切りのリスト。各ライブラリは、マニフェストで設定されていない場合、その名前とバージョンを次の構文で設定できる。 `<file>[@name=<string>@libspecver=<version>` `@libimplver=<version\|string>]`
-librarydir <dir>	指定したディレクトリ内のすべてのファイルをライブラリとして登録する。
`-lineNumbers`	生成されたクラスファイルに行番号を追加し、デバッグを支援する。
`-normi`	Symantec の sj にフラグを渡す。
`-nowarn`	警告なしでコンパイルする。
`-O`	最適化を有効にしてコンパイルする。
`-output <file>`	代替的な出力アーカイブまたはディレクトリを指定する。これが設定されていないと、出力はソースアーカイブまたはディレクトリに置かれる。
-plan <file>	デプロイメントプラン (省略可能) を指定する。
`-verbose`	冗長情報を出力してコンパイルする。
`-version`	`appc` のバージョン情報を出力する。

appc および EJB

weblogic.appc は、以下の EJB 関連機能を実行します。

EJB 用の WebLogic Server コンテナクラスを生成します。
すべての EJB クラスおよびインタフェースが EJB 仕様に準拠しているかどうかをチェックします。
潜在的なコンフィグレーション上の問題がないかデプロイメント記述子をチェックします。たとえば、ejb-jar.xml で cmp フィールドが宣言されていれば、appc は、カラムが weblogic-cmp-jar.xml デプロイメント記述子にマップされているかどうかを検証します。
RMI コンパイラを使用して各 EJB コンテナクラスを実行し、スタブとスケルトンを動的に生成するのに必要な RMI 記述子を作成します。

appc は、デフォルトで javac をコンパイラとして使用します。パフォーマンスを向上させるには、コマンドライン -compiler フラグまたは Administration Console を使用して別のコンパイラ (Symantec の sj など) を指定します。「コンパイラオプションのコンフィグレーション」を参照してください。

weblogic-ejb-jar.xml のパブリックバージョンの場所については、「weblogic-ejb-jar.xml デプロイメント記述子のリファレンス」を参照してください。weblogic-cmp-jar.xml のパブリックバージョンの場所については、「weblogic-cmp-jar.xml デプロイメント記述子のリファレンス」を参照してください。