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

WebLogic Server の EJB ツール

BEA では、EJB の作成とコンフィグレーションを支援するツールを提供しています。それぞれについて以下の節で説明します。

• 「EJBGen」
• 「Ant タスク」
• 「appc」 (weblogic.appc)
• 「Builder」
• 「DDConverter」 (weblogic.ejb.utils.DDConverter)
• 「Deployer」 (weblogic.Deployer)
• 「ejbc」(weblogic.ejbc)

EJBGen

EJBGen は、エンタープライズ JavaBean 2.0 のコード ジェネレータです。Bean クラスファイルに javadoc タグで注釈を付けた後、EJBGen を使用して EJB アプリケーションのリモートクラス、ホーム クラス、および、デプロイメント記述子ファイルを生成することができるので、編集および管理すべき EJB ファイルの数を 1 つに減らせます。

デプロイメント記述子の生成には、EJBGen の使用をお勧めします。これは、EJB の維持を容易化および簡略化できる、BEA のベスト プラクティスです。EJBGen を使用する場合、記述して注釈を付ける必要がある Bean クラスは 1 つだけです。そのため、記述、デバッグ、および維持が簡略化されます。さらに、開発環境として WebLogic Workshop を使用すると、EJBGen タグが自動挿入されます。

BEA WebLogic 8.1 のサンプルをインストール済みであれば、WL_HOME¥samples¥server¥examples¥src¥examples¥ejb20¥ejbgen の場所にEJBGen を使用した「Bands」という名前のサンプル アプリケーションがあります。

EJBGen 構文

javadoc -docletpath weblogic.jar -doclet weblogic.tools.ejbgen.EJBGen (YourBean).java

クラスパス内に weblogic.jar がない場合は、次のように weblogic.jar にパスを追加します。

javadoc -docletpath <path_to_weblogic.jar> weblogic.jar -doclet weblogic.tools.ejbgen.EJBGen (YourBean).java

他の EJB との関係がある EJB に対して EJBGen を呼び出す場合は、次のように EJB の後に、関係する EJB を指定してその EJB を呼び出します。

 javadoc -docletpath weblogic.jar -doclet weblogic.tools.ejbgen.EJBGen (YourBean).java (RelatedBean).java

EJBGen では次のオプションを使用します。

EJBGen の例

注釈を付けた Bean ファイルを次に示しますが、これを基に EJBGen はリモート インタフェース、ホーム インタフェース、デプロイメント記述子ファイルを生成します。AccountBean.java がメインの Bean クラスです。これはCMP EJB 2.0 エンティティ Bean です。

/**

 * @ejbgen:entity
*   ejb-name = AccountEJB-OneToMany
*   data-source-name = examples-dataSource-demoPool
*   table-name = Accounts
*   prim-key-class = java.lang.String

 *

 * @ejbgen:jndi-name

 *   local = one2many.AccountHome

 * @ejbgen:finder

 *   signature = "Account findAccount(double balanceEqual)"
*   ejb-ql = "WHERE balance = ?1"

 *

 * @ejbgen:finder

 *   signature = "Collection findBigAccounts(double balanceGreaterThan)"

 *   ejb-ql = "WHERE balance > ?1"

 *

 * @ejbgen:relation

 *   name = Customer-Account
*   target-ejb = CustomerEJB-OneToMany
*   multiplicity = many
*   cmr-field = customer

 *

 */

abstract public class AccountBean implements EntityBean {

  /**

   * @ejbgen:cmp-field column = acct_id

   * @ejbgen:primkey-field

   * @ejbgen:remote-method transaction-attribute = Required

   */

  abstract public String getAccountId();

  abstract public void setAccountId(String val);

  // ....

}

この例でも見られるように、タグには、それが使用できる場所に応じてクラス タグとメソッド タグの 2 種類があります。

ファイルの編集を終えたら、次の Javadoc コマンドを通して EJBGen を起動します。

javadoc -docletpath weblogic.jar -doclet weblogic.tools.ejbgen.EJBGen AccountBean.java

Javadoc コマンドは、次のファイルを生成します。

• Account.java
• AccountHome.java
• ejb-jar.xml
• weblogic-ejb-jar.xml
• weblog-cmp-rdbms-jar.xml

EJBGen タグ

次のタグを使って Bean クラス ファイルに注釈を付けます。

@ejbgen:automatic-key-generation

使用場所 :クラス

適用対象 :エンティティ Bean

@ejbgen:cmp-field

使用場所 : メソッド

適用対象 :エンティティ Bean

@ejbgen:cmr-field

使用場所 : メソッド

適用対象 :エンティティ Bean

@ejbgen:create-default-rdbms-tables

使用場所 :クラス

適用対象 :エンティティ Bean

@ejbgen:ejb-client-jar

使用場所 :クラス

適用対象 :すべての Bean タイプ

@ejbgen:ejb-local-ref

使用場所 :クラス

適用対象 :セッションおよびエンティティ Bean

@ejbgen:ejb-ref

使用場所 :クラス

適用対象 :すべての Bean タイプ

@ejbgen:entity

使用場所 :クラス

適用対象 :エンティティ Bean

@ejbgen:entity-cache-ref

使用場所 :クラス

適用対象 :エンティティ Bean

@ejbgen:env-entry

使用場所 : クラス

適用対象 :すべての Bean タイプ

@ejbgen:file-generation

使用場所 : クラス

適用対象 :すべての Bean タイプ

@ejbgen:finder

使用場所 :クラス

適用対象 :エンティティ Bean

@ejbgen:foreign-jms-provider

使用場所 : クラス

適用対象 : メッセージ駆動型 Bean

@ejbgen:jndi-name

使用場所 :クラス

適用対象 :すべての Bean タイプ

@ejbgen:local-home-method

使用場所 :メソッド

適用対象 :エンティティ Bean、セッション Bean

@ejbgen:local-method

使用場所 :メソッド

適用対象 :エンティティ Bean、セッション Bean

@ejbgen:message-driven

使用場所 :クラス

適用対象 :メッセージ駆動型 Bean

@ejbgen:method-isolation-level-pattern

使用場所 :クラス

適用対象 :すべての Bean

@ejbgen:method-permission-pattern

使用場所 :クラス

適用対象 :すべての Bean

@ejbgen:relation

使用場所 :クラス

適用対象 :エンティティ Bean

@ejbgen:relationship-caching-element

使用場所 :メソッド

適用対象 :エンティティ Bean

@ejbgen:remote-home-method

使用場所 :メソッド

適用対象 :エンティティ Bean、セッション Bean

@ejbgen:remote-method

使用場所 :メソッド

適用対象 :エンティティ Bean、セッション Bean

@ejbgen:resource-env-ref

使用場所 :クラス

適用対象 :すべての Bean タイプ

@ejbgen:resource-ref

使用場所 :クラス

適用対象 :すべての Bean タイプ

l

@ejbgen:role-mapping

使用場所 :クラス

適用対象 :すべての Bean タイプ

@ejbgen:security-role-ref

使用場所 :メソッド

適用対象 :エンティティ Bean、セッション Bean

@ejbgen:select

使用場所 :メソッド

適用対象 :エンティティ Bean

@ejbgen:session

使用場所 :クラス

適用対象 : セッション Bean

@ejbgen:value-object

使用場所 :クラス

適用対象 :すべての Bean タイプ

ファイル生成の制御

デフォルトでは、EJBGen は次のファイルを生成します。

• リモート Bean およびホーム インタフェース (@ejbgen:jndi-name が「remote」で指定された場合)
• ローカル Bean およびホーム インタフェース (@ejbgen:jndi-name が「local」で指定された場合)
• 値オブジェクト クラス
• 主キー クラス (該当する場合)

これらのファイルの生成は、@ejbgen:file-generation を使用して選択的に無効化できます。これは、Bean ごとに実行できます。次のコード サンプルでは、値クラスが生成されないようにしています。

/**

 * @ejbgen:file-generation

 *   value-class = False

 */

注意: コマンドライン オプション -noValueClasses、 -noRemoteInterfaces、または -noLocalInterfaces は、Bean で見つかったすべてのタグをオーバーライドします。

未コンパイルの値タイプ クラスによる Javadoc 警告

EJBGen クラスに、未コンパイルの Java クラスである値タイプ (パラメータ値、戻り値など) が含まれる場合、Javadoc は図 10-1 に示すように javac コンパイル エラーのようなものを出力します。

図10-1 値タイプ クラスが未コンパイルの場合の Javadoc 出力サンプル

[javadoc]
C:¥toddk¥dev¥issues¥cr100528¥src¥test¥po¥PurchaseOrderBean.java:29: cannot resolve symbol [javadoc] symbol : class PurchaseOrder [javadoc] location: class test.po.PurchaseOrderBean [javadoc] public boolean submitPO(PurchaseOrder po) throws SubmitException { 

[javadoc]
[javadoc] C:¥toddk¥dev¥issues¥cr100528¥src¥test¥po¥PurchaseOrderBean.java:29: cannot resolve symbol [javadoc] symbol : class SubmitException [javadoc] location: class test.po.PurchaseOrderBean [javadoc] public boolean submitPO(PurchaseOrder po) throws SubmitException { 

これらは、Javadoc 警告であって、エラーではありません。エラー メッセージと javac コンパイラ エラーが似通っているため、エラーとして誤って解釈しやすくなっています。Javadoc は、正常に実行されたことを示す終了ステータスと共に返るので、Ant EJBGen タスクが構築失敗の原因となることはありません。

複数テーブルへのエンティティ Bean のマッピング

デフォルトでは、エンティティ Bean はタグ @ejbgen:entity に属性 table-name を指定して 1 つのテーブルにマップされます。エンティティ Bean を複数のテーブルにマップする場合には、個々の @ejbgen:cmp-fields で table-name 属性を使用できます。table-name 属性のないコンテナ管理による永続性フィールドはすべて、@ejbgen:entity で指定したテーブルを使用します (したがって、これを「デフォルト」テーブルと考えることができます)。

エンティティ Bean を複数のテーブルにマップする場合、table-name 属性において (およびカラム上で) カンマ区切りのテーブル リストを指定する必要があります。次に例を示します。

テーブル数とカラム数が一致しており、カラムが対応するテーブル内に存在することを確認してください。

プロパティ ファイル

EJBGen は、この節で説明するように、プロパティ ファイルから生成のための情報を収集できます。

EJBGen にプロパティ ファイルの解析を指示するには、-propertyFile オプションを使用します。図 10-2 は、サンプルのプロパティ ファイルを示します。

図10-2 EJBGen プロパティ ファイルのサンプル

# property-file
#
remote-jndi-name = Account

-propertyFile オプションを指定して EJBGen を呼び出すには、次の構文を使用します。

javadoc -docletpath ejbgen.jar -doclet EJBGen -propertyFile property-file AccountBean.java

EJBGen は、プロパティ ファイル内にユーザ変数およびあらかじめ定義された変数という、2 種類の変数を認識します。

ユーザ変数

EJBGen タグでは、文字列の代わりに変数を使用できます。これらの変数は図 10-3 に示すように、"${" と "}" で囲む必要があります。

図10-3 文字列の代わりのユーザ変数

@ejbgen:jndi-name

remote = ${remote-jndi-name}

変数は、EJBGen タグの後であればどこででも使用できます。したがって、図 10-4 に示すようにタグ定義全体を含めることができます。

図10-4 タグ定義全体としてのユーザ変数

@ejbgen:jndi-name

  ${jndi-name-tag}

#
#
# property-file

#
jndi-name-tag = remote = RemoteAccount local = LocalAccount

あらかじめ定義された変数

EJBGen は、いくつかのあらかじめ定義された変数を認識します。これらの変数はタグでは使用しないことになっていますが、EJBGen ではロールに応じてさまざまな場所で使用します。以下に、認識される変数を示します。

• remote.baseClass

これを指定すると、この変数の値は生成されたすべてのリモート クラスの基本クラスとして使用されます。

• home.baseClass
  
  これを指定すると、この変数の値は生成されたすべてのリモート ホーム クラスの基本クラスとして使用されます。
• local.baseClass

これを指定すると、この変数の値は生成されたすべてのローカル クラスの基本クラスとして使用されます。

• localHome.baseClass

これを指定すると、この変数の値は生成されたすべてのローカル ホーム クラスの基本クラスとして使用されます。

• value.baseClass

これを指定すると、この変数の値は生成されたすべての値クラスの基本クラスとして使用されます。

• value.package

これを指定すると、この変数の値は生成されたすべての値クラスのパッケージとして使用されます。

• value.interfaces

これを指定すると、この変数の値は値クラスが実装すべきインタフェースとして使用されます。この変数は、カンマで区切ったインタフェースのリストにもできます。

これらの変数は、EJBName をプレフィックスとすることでより特定的にできます。たとえば、次のようなプロパティ ファイルの場合を考えます。

#

# property-file

#

Account.home.baseClass = BaseAccountHome

home.baseClass = BaseHome

value.package = value

containerManaged.value.package=valuePackageForContainerManaged

• EJBGen によって生成されたホームはすべて、クラス BaseHome を拡張します。ただし、EJB 「Account」 のホームは例外で、BaseAccountHome を拡張します。

リレーションシップ キャッシング

@ejbgen:relationship-caching タグを使用して、リレーションシップ キャッシング要素を指定できます。この XML 要素は、ネストできます (再帰的)。つまり、キャッシュしたいリレーションシップ要素をすべて表す、ツリーを指定できます。

このツリー構造をサポートするため、@ejbgen:relationship-caching には id および parent-id という 2 つの属性があります。これらの属性はどの XML にも対応しません。単に、これらを使うとツリー構造が指定できるというだけです。

たとえば、キャッシング要素 A に子要素 B および C が必要な場合、A のための id (たとえば「root0」) と、その名前に等しい B および C の parent-id を指定するだけですみます。

図 10-5 で、リレーションシップ キャッシングの指定を説明します。

図10-5 リレーションシップ キャッシングの指定

* @ejbgen:relationship-caching-element

 *   caching-name = cacheMoreBeans

 *   cmr-field = employee

 *   group-name = emp-group

 *   id = A

 * 

 * @ejbgen:relationship-caching-element

 *   caching-name = cacheMoreBeans

 *   cmr-field = employee_ssn

 *   group-name = emp-group

 *   parent-id = A

 * 

 * @ejbgen:relationship-caching-element

 *   caching-name = cacheMoreBeans

 *   cmr-field = employee_zip

 *   group-name = emp-group

 *   parent-id = A

関係

一方向の関係は、関係タグの最初の 2 つのパラメータのみ (CMR_field や joint table はなし) を指定することで実現します。

多対多の関係では、少なくとも 2 つのカラムを含む、追加のテーブル (パラメータ「joint table」) を指定する必要があります。これらのカラムの名前は、結合される 2 つの Bean の外部キーを含むカラムの名前に一致している必要があります。

ローカル インタフェースを使用するように関係を更新する

PFD2 より前に公開された EJB 2.0 仕様のバージョンに基づく EJB を使用している場合は、更新が必要です。PFD2 では、関係はリモート インタフェースではなく、ローカル インタフェースに基づいている必要があります。EJB のアップグレードを行うために必要な手順は次のとおりです。

1. ローカル ホーム インタフェースの JNDI 名を追加します。

   @ejbgen:jndi-name

   remote = AccountHome

   local = AccountLocalHome

2. ローカル ホーム インタフェース上に置きたいすべてのメソッドに @ejbgen:local-method タグを追加します。1 つのメソッドが @ejbgen:local-method と @ejbgen:remote-method の両方を持つことが可能です。
3. コンテナ管理の関係 (CMR) アクセス メソッドの戻り値の型を、EJB オブジェクトの戻り値の型に変更します(複数の値を持つ CMR フィールドは集合なので、これは単一の値を持つ CMR フィールドのみに適用されます。これらの集合にローカル EJB オブジェクトが含まれることに留意してください)。

   /**

   * @ejbgen:cmr-field

   *

   * @ejbgen:remote-method

   * @ejbgen:local-method

   */

   abstract public LocalCustomer getCustomer();

タグの継承

EJBGen 2.0 の主要な機能の 1 つに、タグの継承があります。EJBGen の注釈は、Java での場合と同じようにして継承されます。たとえば、図 10-6 に示すように基本クラス BaseAccount の AccountEJB という名前が付けられた EJB があるとします。

図10-6 タグの継承

/**

 * @ejbgen:jndi-name

 *     remote="BaseRemote"

 */

public class BaseAccount implements EntityBean {

  // ...

}

ここで、EJB クラスを定義します。

/**

 * @ejbgen:entity

 *   ejb-name = containerManaged

 *   table-name = ejbAccounts

 *   data-source-name = examples-dataSource-demoPool

 *

 *  Note that we inherit the JNDI name defined in BaseAccount

 */

public class AccountEJB extends BaseAccount {

  // ...

属性の継承

属性も継承できます。これは、多くの用途が考えられる、極めて強力な機能です。たとえば、図 10-7 で示すように、すべての EJB に max-beans-in-cache などの共通の設定を定義できます。

図10-7 属性の継承

\

/**

 * @ejbgen:entity

 *    max-beans-in-cache = 300

 */

public class BaseAccount implements EntityBean {

  // ...

}

この後、次のようにエンティティ Bean を定義します。

/**

 * @ejbgen:entity

 *   ejb-name = containerManaged

 *   table-name = ejbAccounts

 *   data-source-name = examples-dataSource-demoPool

 *

 *   // 属性 max-beans-in-cache = 300 を自動的に継承

 */

public class AccountEJB extends BaseAccount {

  // ...

もちろん、継承した値を修正することも可能です。たとえば、特定の Bean について、max-beans-in-cache のデフォルト値を 300 から 400 に変更できます。

/**

 * @ejbgen:entity

 *   ejb-name = containerManaged

 *   table-name = ejbAccounts

 *   data-source-name = examples-dataSource-demoPool

 *   max-beans-in-cache = 400

 *

 *   // 上の設定で基本クラスの定義内容がオーバーライドされる

 */

public class AccountEJB extends BaseAccount {

  // ...

Ant タスク

スケルトン デプロイメント記述子を作成するときに、WebLogic Ant ユーティリティを使用できます。Ant ユーティリティは WebLogic Server 配布キットと共に出荷されている Java クラスです。Ant タスクによって、EJB を含むディレクトリが調べられ、そこに置かれているファイルを基にデプロイメント記述子が作成されます。Ant ユーティリティは、個別の EJB に必要なコンフィグレーションやマッピングに関する情報をすべて備えているわけではないので、Ant ユーティリティによって作成されるスケルトン デプロイメント記述子は不完全なものです。Ant ユーティリティでスケルトン デプロイメント記述子を作成した後で、テキスト エディタ、XML エディタ、または Administration Console を使ってデプロイメント記述子を編集し、EJB のコンフィグレーションを完全なものにしてください。

Ant ユーティリティを使用してのデプロイメント記述子の作成については、『WebLogic Server アプリケーションのデプロイメント』の「デプロイ用ツール」を参照してください。

appc

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

appc の構文

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

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

appc Options

利用できる appc オプションは次のとおりです。

wlappc Ant タスク

appc コンパイラの呼び出しには、次の Ant タスクを使用できます。

<taskdef name="wlappc" classname="weblogic.ant.taskdefs.j2ee.Appc"/>

appc および EJB

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

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

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

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

appc の利点

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

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

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

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

コマンド ラインで appc を実行中にエラーが発生すると、エラー メッセージが表示され、appc が終了します。

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

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

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

Builder

WebLogic Builder は、J2EE アプリケーション モジュールを作成し、そのデプロイメント記述子を作成および編集して、それを WebLogic Server インスタンスにデプロイするためのグラフィカル ツールです。

WebLogic Builder には、アプリケーションのデプロイメント記述子 XML ファイルを編集するためのビジュアル編集環境が用意されています。WebLogic Builder では、これらの XML ファイルをビジュアルに編集しながら参照できるので、テキストによる編集は必要ありません。

WebLogic Builder では、次の開発タスクを行うことができます。

• J2EE モジュール用のデプロイメント記述子ファイルの生成
• モジュールのデプロイメント記述子ファイルの編集
• デプロイメント記述子ファイルのコンパイルおよび検証
• J2EE モジュールのサーバへのデプロイ

WebLogic Builder は、WebLogic Builder のマニュアルで詳細に説明されています。特に「EJB の処理」という節が有用でしょう。

DDConverter

DDConverter は、以前のバージョンの EJB デプロイメント記述子を本バージョンの WebLogic Server に準拠した EJB デプロイメント記述子に変換するコマンド ライン ツールです。WebLogic Server EJB コンテナは、EJB 1.1 および EJB 2.0 文書型定義 (DTD) を含む EJB 1.1 および EJB 2.0 仕様をサポートしています。各 WebLogic Server EJB デプロイメントには、以下のファイルの標準デプロイメント記述子が含まれています。

• ejb-jar.xml

J2EE 固有のEJB デプロイメント記述子を含む XML ファイル。

• weblogic-ejb-jar-.xml

WebLogic 固有のEJB デプロイメント記述子を含む XML ファイル。

• weblogic-cmp-rdbms-jar.xml

WebLogic 固有のコンテナ管理による永続性 (CMP) デプロイメント記述子を含む XML ファイル。

DDConverter の変換オプション

DDConverter コマンドライン ツールには、次の変換オプションがあります。

• 以前のバージョンの WebLogic Server の Bean を変換します。
• 以前のバージョンの EJB 仕様の CMP および CMP 以外の Bean を変換します。

次の表は、DDconverter ツールの各種変換オプションのリストです。

注意: EJB 1.0 の非 CMP を EJB 1.1 の非 CMP に変換する必要はありません。 非CMP EJB 1.1 のデプロイメント記述子は、非 CMP EJB 2.0 のデプロイメント記述子と同じだからです。

DDConverter を使用した後は必ず Bean を再コンパイルします。weblogic.ejbc を使用し、改めて生成した JAR ファイルをデプロイすることをお勧めします。Bean を再コンパイルすることにより、そのコードが確実に EJB 仕様に準拠するようになり、また、サーバ起動時の再コンパイル処理を省略できるので時間を短縮できます。

• WebLogic Server 4.5 EJB 1.0 Bean を WebLogic Server 8.1 EJB 1.1 Bean に変換する場合、DDConverter への入力は WebLogic 4.5 デプロイメント記述子のテキストです。WebLogic 8.1 デプロイメント記述子だけを含む JAR ファイルが出力されます。weblogic-appc を起動してソースコードに何らかの変更を加える必要があるかどうかを確かめ、「DDConverter による EJB の変換」の手順に従います。DDConverter ツールの変換オプションの表の最初の行を参照してください。
• WebLogic Server 4.5 EJB 1.1 Bean を WebLogic Server 8.1 EJB 2.0 Bean に変換する場合、DDConverter への入力は WebLogic Server 4.5 デプロイメント記述子のテキストです。WebLogic 8.1 デプロイメント記述子だけを含む JAR ファイルが出力されます。weblogic-appc を起動してソースコードに何らかの変更を加える必要があるかどうかを確かめ、「DDConverter による EJB の変換」の手順に従います。DDConverter ツールの変換オプションの表の 2 行目を参照してください。
• WebLogic Server 8.1 の下位互換性により、ソースコードを変更することなく WebLogic Server 5.x EJB 1.1 Bean を WebLogic Server 8.1 にデプロイできます。WebLogic Server 8.1 は、以前のバージョンの WebLogic Server のBean を検出し、再コンパイルし、デプロイします。ただし、WebLogic Server 5.x EJB 1.1 Bean を WebLogic Server 8.1 EJB 2.0 Bean にアップグレードする場合は、DDConverter の使用をお勧めします。

WebLogic Server 5.x EJB 1.1 Bean を WebLogic Server 8.1 EJB 2.0 Bean に変換する場合、DDConverter への入力は WebLogic Server 5.1 JAR ファイルです。このファイルには、デプロイメント記述子ファイルとクラス ファイルが含まれます。ここでは、WebLogic 8.1 デプロイメント記述子ファイルと必要なクラス ファイルすべてが含まれた1 つの JAR ファイルに出力が格納されます。DDConverter ツールの変換オプションの表の 3 行目を参照してください。

ソースコードをほとんど、または、まったく変更せずに、CMP 以外の Bean を EJB 2.0 Bean に変換することができます。これを行うためには、output.jar ファイルに対し weblogic.appc を実行し、生成された JAR ファイルをデプロイします。CMP Bean の場合、「DDConverter による EJB の変換」の手順に従い、ソースコードに変更を加える必要があります。

DDConverter による EJB の変換

WebLogic Server で使用するために以前のバージョンの EJB を変換するには、次の手順に従います。

1. 「DDConverter の構文」に示したコマンド ライン形式に従って、EJB のデプロイメント記述子を DDConverter に入力します。

   JAR ファイルが出力されます。

2. その JAR ファイルから XML デプロイメント記述子を抽出します。
3. JavaSoft EJB 仕様に従って、ソースコードを変更します。
4. weblogic.appc を使用して JAR ファイルを作成し、抽出した XML デプロイメント記述子とともに変更済みの Java ファイルをコンパイルします。
5. JAR ファイルをデプロイします。

DDConverter の構文

prompt> java weblogic.ejb20.utils.DDConverter [options] file1 [file2...]

DDConverter の引数

DDConverter は、file1 [file2...] といった引数をとります。このファイルは次のどちらかになります。

• EJB 1.0 準拠のデプロイメント記述子を含むテキスト ファイル
• EJB 1.1 準拠のデプロイメント記述子を含む JAR ファイル

DDConverter は、テキスト デプロイメント記述子の EJB の beanHomeName プロパティを使用して、新規の ejb-name 要素を出力される ejb-jar.xml ファイルで定義します。

DDConverter のオプション

次の表は、DDConverter のコマンドライン オプションのリストです。

DDConverter の例

次の例では、WebLogic Server 5.x EJB 1.1 Bean を WebLogic Server 8.1 EJB 2.0 Bean に変換します。(サブディレクトリ destDir に JAR ファイルが作成されます)。

prompt> java weblogic.ejb20.utils.DDConverter -d destDir Employee.jar

ここでは、Employee Bean が WebLogic Server 5.x EJB 1.1 JAR ファイルです。

DDInit

DDInit は、ステージング ディレクトリのコンテンツをテストし、EJB クラスに基づいて標準 J2EE と WebLogic 固有のデプロイメント記述子を生成します。

DDInit Ant タスク

weblogic.ant.taskdefs.ejb20.DDInit は、エンタープライズ JavaBean 2.0 のデプロイメント記述子を作成します。

weblogic.ant.taskdefs.ejb.DDInit は、エンタープライズ JavaBean 1.1 のデプロイメント記述子を作成します。

Deployer

weblogic.Deployer コマンドライン ツールは、WebLogic Server デプロイメント API にコマンドライン インタフェースを提供する、Java ベースの開発ツールです。このツールは、コマンドライン、シェル スクリプト、または Java 以外の自動化された環境からデプロイメントを開始する必要がある管理者および開発者向けに開発されました。

weblogic.Deployer の使い方とコマンド リストについては、「Deploying Using weblogic.Deployer」を参照してください。

ejbc

注意: ejbc は非推奨です。代わりに appc を使用してください。「appc」を参照してください。

EJB コンテナ クラスの生成とコンパイルには、weblogic.ejbc ツールを使用します。EJB コンテナにデプロイするために JAR ファイルをコンパイルする場合は、weblogic.ejbc を使用して、コンテナ クラスを生成する必要があります。

weblogic.ejbc では次の処理を実行します。

• 指定した JAR ファイルに EJB クラス、インタフェース、および XML デプロイメント記述子を配置します。
• すべての EJB クラスおよびインタフェースが EJB 仕様に準拠しているかどうかをチェックします。
• EJB 用の WebLogic Server コンテナ クラスを生成します。
• RMI コンパイラを使用して各 EJB コンテナ クラスを実行して、クライアントサイドの動的プロキシとサーバサイド バイト コードを作成します。

注意: ejbc は、JAR ファイルおよび展開ディレクトリの両方を入力として受け付けます。

出力 JAR ファイルを指定すると、ejbc は、生成するファイルをすべて JAR ファイルに入れます。

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

WebLogic 固有の XML デプロイメント記述子ファイルの複数バージョンが Web サイト上で公開され利用可能ですが、weblogic.ejbc で使用される内部バージョンは製品に同梱されています。

weblogic-ejb-jar.xml および weblogic-cmp-rdbms-jar.xml のパブリック バージョンの場所については、「文書型定義および DOCTYPE ヘッダ情報」を参照してください。

ejbc の利点

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

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

コマンド ラインで ejbc を実行中にエラーが発生すると、エラー メッセージが表示され、ejbc が終了します。

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

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

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

ejbc の構文

prompt> java weblogic.ejbc [options] <source directory or jar file>

	<target directory or jar file>

注意: 出力先が JAR ファイルの場合、出力 JAR には入力 JAR と異なる名前を付けなければなりません。

ejbc の引数

ejbc のオプション

ejbc の例

次の例では、c:¥%SAMPLES_HOME%¥server¥examples¥src¥examples¥ejb20¥basic¥containerManaged¥build 内の入力 JAR ファイルに対して javac コンパイラを使用します。出力 JAR ファイルは、c:¥%SAMPLES_HOME%¥server¥config¥examples¥applications 内に置かれます。

prompt> java weblogic.ejbc -compiler javac c:¥%SAMPLES_HOME%¥server¥examples¥src¥examples¥ejb20¥basic¥containerManaged¥build¥ejb20_basic_containerManaged.jar c:%SAMPLES_HOME%¥server¥config¥examples¥ejb_basic_containerManaged.jar

次の例では、JAR ファイルが EJB 1.1 仕様に準拠しているかどうかをチェックして、WebLogic Server コンテナ クラスを生成しますが、RMI スタブは生成しません。

prompt> java weblogic.ejbc -normi c:%SAMPLES_HOME%¥server¥src¥examples¥ejb20¥basic¥containerManaged¥build¥ejb20_basic_containerManaged.jar

	Contact BEA     Site Map     Feedback     Privacy     Copyright © BEA Systems, Inc. All rights reserved.