D appcリファレンス

この付録では、EJBコードをコンパイル、検証および生成するためのWebLogic Server appcツールの詳細なリファレンスを提供します。

この付録の内容は次のとおりです。

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>

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

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

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

<alt-dd要素の詳細は、『Oracle WebLogic Serverへのアプリケーションのデプロイ』のエンタープライズ・アプリケーションのデプロイメント記述子の要素に関する項を参照してください。

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

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

appcのオプション

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

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

オプション	説明
`-advanced`	高度な使用オプションを出力します。
`-altappdd`	代替Java EEアプリケーション・デプロイメント記述子を指定します。
`-altwlsappdd`	代替WebLogic Serverアプリケーション・デプロイメント記述子を指定します。
`-basicClientJar`	EJB用に生成されたクライアントJARのデプロイメント記述子を含みません。
`-classpath <path>`	コンパイル中に使用するクラスパスを選択します。
`-clientJarOutputDir <dir>`	生成されたクライアントjarファイルを配置するディレクトリを指定します。これが設定されていないと、生成されたjarファイルはJVMが実行しているディレクトリと同じ場所に配置されます。
`-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フラグを使用して別のコンパイラ(Symantecのsjなど)を指定します。

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