Oracle® Fusion Middleware Oracle WebLogic Server Enterprise JavaBeansのプログラミング 11gリリース1(10.3.6) B61624-05 |
|
![]() 前 |
![]() 次 |
ここでは、EJBコードのコンパイル、検証、生成に使用するWebLogic Server appc
ツールの詳細なリファレンスを提供します。
appc
コンパイラは、EJBおよびJSPをWebLogic Serverにデプロイするのに必要なクラスを生成し、コンパイルします。また、個別のモジュール・レベルとアプリケーション・レベルの両方で、現在の仕様に準拠しているかどうかデプロイメント記述子を検証します。アプリケーション・レベルのチェックでは、個別のモジュールに対するアプリケーション・レベルのデプロイメント記述子のチェックと、モジュール全体の検証チェックが行われます。
Kodo永続性ユニットを含むアプリケーションをコンパイルしている場合、appc
コンパイラはKodoエンハンサも実行します。Kodoエンハンサは、Javaコンパイラが生成したバイトコードを後処理して、必要な永続機能の実装に必要なフィールドとメソッドを追加します。このバイトコードの変更では、スタック・トレースの行番号は完全に維持され、Javaデバッガとの互換性を維持します。Kodoの使い方については、『Oracle WebLogic Server Enterprise JavaBeansバージョン3.0のプログラミング』の「WebLogic ServerでのOracle Kodoの使い方」を参照してください。
注意: Kodoの管理による永続性ユニットとKodo以外の管理による永続性ユニットの両方を含むアプリケーションに対してappc を実行する場合、kodc はKodoの管理による永続性ユニットだけを実行します。 |
appc
ツールの利点は以下のとおりです。
個々のモジュールを別々にコンパイルして、事後にEARとして結合するのではなく、アプリケーション全体をコンパイルできる柔軟性。
EARコンパイル中にWebLogic Serverがすべてのモジュールにアクセスできることによる、すべてのモジュールにわたる検証チェック、および様々なモジュールに対するアプリケーション・レベルのデプロイメント記述子検証。
appcがなかったときは、EARファイル内のすべてのモジュールをコンパイルする場合、ユーザーはEARの個々のコンポーネントを抽出し、適切なコンパイラ(jspc
またはejbc
)を手動で実行して、デプロイメント用モジュールを準備しなければなりませんでした。appc
はこのプロセスを自動化し、従来はできなかった追加の検証チェックをデプロイメント前に実行します。
appc
のエラーを簡単に特定して修正できます。
コマンド・ラインでappc
を実行中にエラーが発生すると、エラー・メッセージが表示され、appc
が終了します。
それに対して、コンパイルをデプロイメント時に行うことにした場合、コンパイル・エラーが発生すると、サーバーはデプロイメントが失敗しても作業を続けます。デプロイメントの失敗の原因を特定するには、サーバー出力を調べ、問題を修正し、再デプロイする必要があります。
デプロイメントの前にappc
を実行すると、Beanのコンパイル時間を短縮できます。
たとえば、JARファイルを3つのサーバーのクラスタにデプロイする場合、JARファイルが各サーバーにコピーされてデプロイされます。JARファイルがコンパイルされていない場合、各サーバーは、デプロイメント時にファイルをコンパイルする必要があります。
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
)のフルパスとファイル名を指定できます。
表D-1は、appc
のコマンド・ライン・オプションのリストです。
表D-1 appcのコマンド・ライン・オプション
オプション | 説明 |
---|---|
|
高度な使用オプションを出力します。 |
|
代替Java EEアプリケーション・デプロイメント記述子を指定します。 |
|
代替WebLogic Serverアプリケーション・デプロイメント記述子を指定します。 |
|
EJB用に生成されたクライアントJARのデプロイメント記述子を含みません。 |
|
コンパイル中に使用するクラスパスを選択します。 |
|
生成されたクライアントjarファイルを配置するディレクトリを指定します。これが設定されていないと、生成されたjarファイルはJVMが実行しているディレクトリと同じ場所に配置されます。 |
|
使用するJavaコンパイラを選択します。 |
|
非推奨となった呼出しについて警告します。 |
|
EJBおよびJSPクラスを強制的に生成します。このフラグがないと、チェックサムでその必要性が示されない限りクラスは再生成されません。 |
|
デバッグ情報をクラス・ファイルにコンパイルします。 |
|
標準の使い方メッセージを出力します。 |
|
EJBリモート・インタフェース用のIDLを生成します。 |
|
IDLファイルを作成するディレクトリを指定します(デフォルトでは、ターゲット・ディレクトリまたはJAR)。 |
|
値タイプ用にファクトリ・メソッドを生成します。 |
|
IDLコードを生成するトリガーとして使用されるメソッド・シグネチャを指定します。 |
|
抽象インタフェース、およびそれを含むメソッドと属性を生成しません。 |
|
値タイプ、およびそれを含むメソッドと属性を生成しません。 |
|
Orbix 2000 2.0 C++と多少の互換性を持つIDLを生成します。 |
|
常に既存のIDLファイルを上書きします。 |
|
IDL生成についての詳細な情報を表示します。 |
|
Visibroker 4.5 C++と多少の互換性を持つIDLを生成します。 |
|
EJB用にCORBAのスタブを生成します。 |
|
IIOPのスタブ・ファイルを記述するディレクトリを指定します(デフォルトでは、ターゲット・ディレクトリまたはJAR)。 |
|
Java実行時にフラグを渡します。 |
|
生成された |
|
ライブラリのカンマ区切りのリスト。各ライブラリは、マニフェストで設定されていない場合、その名前とバージョンを次の構文で設定できます。
|
|
指定したディレクトリ内のすべてのファイルをライブラリとして登録します。 |
|
生成されたクラス・ファイルに行番号を追加し、デバッグを支援します。 |
|
Symantecのsjにフラグを渡します。 |
|
警告なしでコンパイルします。 |
|
最適化を有効にしてコンパイルします。 |
|
代替的な出力アーカイブまたはディレクトリを指定します。これが設定されていないと、出力はソース・アーカイブまたはディレクトリに置かれます。 |
|
デプロイメント・プラン(オプション)を指定します。 |
|
冗長情報を出力してコンパイルします。 |
|
|
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
など)を指定します。Oracle WebLogic Server管理コンソール・オンライン・ヘルプのコンパイラ・オプションの構成に関する項を参照してください。
weblogic-ejb-jar.xml
のパブリック・バージョンの場所については、付録B「weblogic-ejb-jar.xmlデプロイメント記述子のリファレンス」を参照してください。weblogic-cmp-jar.xml
のパブリック・バージョンの場所については、付録C「weblogic-cmp-jar.xmlデプロイメント記述子のリファレンス」を参照してください。