Apache Ant EJBタスク ユーザマニュアル

作成者

• Paul Austin (p_d_austin@yahoo.com)
• Holger Engels (hengels@innovidata.com)
• Tim Fennell (tfenne@rcn.com)
• Martin Gee (martin.gee@icsynergy.com)
• Conor MacNeill
• Cyrille Morvan (cmorvan@ingenosya.com)
• Greg Nelson (gn@sun.com)
• Rob van Oostrum (rob@springwellfarms.ca)

目次

• はじめに
• EJBタスク

はじめに

Antは、1.xおよび2.xのEnterprise Java Beans (EJB)を開発するための多くのオプションタスクを提供します。一般に、これらのタスクは特定のベンダーのEJBサーバーに固有です。

これらのタスクは以下をサポートしています。

• BorlandApplication Server 4.5
• iPlanet Application Server 6.0
• JBoss 2.1以降のEJBサーバー
• Orion Application Server 2.0 (Ant 1.10.2以降)
• WebLogic 4.5.1から7.0までのEJBサーバー
• JOnAS 2.4.xおよび2.5オープンソースEJBサーバー
• IBM WebSphere 4.0

BEAやIBMなどのベンダーは、特定の製品で動作するためのカスタムAntタスクを提供するようになりました。さらに重要なこととして、EJB 3.0によってこのプロセス全体が時代遅れになります。したがって、これらのタスクの開発は事実上凍結されています。バグレポート、特にパッチは大歓迎ですが、新しいアプリケーションサーバーのサポートを追加する必要性は強くありません。誰も新しいEJB 2.xアプリケーションを書くべきではなく、ましてや新しいEJB 2.xサーバーを書くべきではありません。

EJBタスク

ddcreator

説明

ddcreatorは、WebLogicのテキストベースのデプロイメント記述子のセットを、シリアライズされたEJBデプロイメント記述子にコンパイルします。コンパイルするテキストベースの記述子の選択は、標準のAntのincludeおよびexclude選択メカニズムに基づいています。

パラメータ

例

<ddcreator descriptors="${dd.dir}"
           dest="${gen.classes}"
           classpath="${descriptorbuild.classpath}">
  <include name="*.txt"/>
</ddcreator>

ejbc

説明

ejbcタスクは、WebLogicのejbcツールを実行します。このツールは、シリアライズされたデプロイメント記述子を受け取り、さまざまなEJBインターフェースとBeanクラスを調べ、WebLogic EJBコンテナにBeanをデプロイするために必要なサポートクラスを生成します。これには、RMIスタブとスケルトン、およびBeanのホームインターフェースとリモートインターフェースを実装するクラスが含まれます。

このツールを実行するAntタスクは、1回の操作で複数のBeanをコンパイルできます。コンパイルするBeanは、シリアライズされたデプロイメント記述子を含めることで選択されます。標準のAntのincludeおよびexclude構成を使用して、含めるデプロイメント記述子を選択できます。

各記述子を調べて、生成されたクラスが古くなっていて再生成が必要かどうかを判断します。デプロイメント記述子は、ホームクラス、リモートクラス、および実装クラスを検出するために非シリアライズ化されます。対応するソースファイルが決定され、それらの変更時刻が確認されます。これらの時刻と、シリアライズされた記述子自体の変更時刻が、生成されたクラスの変更時刻と比較されます。生成されたクラスが存在しない場合、または古い場合は、ejbcツールを実行して新しいバージョンを生成します。

パラメータ

例

<ejbc descriptors="${gen.classes}"
           src="${src.dir}"
           dest="${gen.classes}"
           manifest="${build.manifest}"
           classpath="${descriptorbuild.classpath}">
  <include name="*.ser"/>
</ejbc>

iplanet-ejbc

説明

iPlanet Application Server 6.0用のEJBスタブとスケルトンをコンパイルするタスク。標準のEJB 1.1 XML記述子とiAS固有のEJB記述子を指定すると、このタスクはEJBをiASにデプロイするために必要なスタブとスケルトンを生成します。XML記述子には複数のEJBを含めることができるため、これは単一のAntタスクで多数のEJBを指定する便利な方法です。

指定された各EJBについて、タスクは宛先ディレクトリ内のEJBを構成する3つのクラスを検索します。これらのクラスファイルが宛先ディレクトリに見つからない場合、タスクは失敗します。タスクは、このディレクトリ内のEJBスタブとスケルトンも検索しようとします。見つかった場合、スタブとスケルトンのタイムスタンプが最新であることを確認するためにチェックされます。これらのファイルが見つからない場合、または古い場合にのみ、iAS ejbcユーティリティが呼び出されて新しいスタブとスケルトンが生成されます。

パラメータ

例

<iplanet-ejbc ejbdescriptor="ejb-jar.xml"
              iasdescriptor="ias-ejb-jar.xml"
              dest="${build.classesdir}"
              classpath="${ias.ejbc.cpath}"/>


<iplanet-ejbc ejbdescriptor="ejb-jar.xml"
              iasdescriptor="ias-ejb-jar.xml"
              dest="${build.classesdir}"
              keepgenerated="yes"
              debug="yes"
              iashome="${ias.home}">
              <classpath>
                  <pathelement path="."/>
                  <pathelement path="${build.classpath}"/>
              </classpath>
</iplanet-ejbc>

wlrun

説明

wlrunタスクは、WebLogicサーバーを起動するために使用されます。このタスクは、別のJVMでWebLogicインスタンスを実行します。WebLogicインスタンスの動作を制御するために、いくつかのパラメータが使用されます。タスク（したがってAnt）は、WebLogicインスタンスが停止するまで完了しないことに注意してください。

パラメータ

ネストされた要素として指定されたパラメータ

wlrunタスクは、それぞれのクラスパスを設定するためにネストされた<classpath>および<wlclasspath>要素をサポートします。

例

この例は、WebLogic 5.1でサーバーを実行するためのwlrunの使用方法を示しています

    <wlrun taskname="myserver"
           classpath="${weblogic.boot.classpath}"
           wlclasspath="${weblogic.classes}:${code.jars}"
           name="myserver"
           home="${weblogic.home}"
           properties="myserver/myserver.properties"/>

この例は、WebLogic 6.0でpetstoreサーバーを実行するためにwlrunが使用される方法を示しています

<wlrun taskname="petstore"
       classpath="${weblogic.classes}"
       name="petstoreServer"
       domain="petstore"
       home="${weblogic.home}"
       password="petstorePassword"
       beahome="${bea.home}"/>

wlstop

説明

wlstopタスクは、現在実行中のWebLogicインスタンスを停止するために使用されます。インスタンスをシャットダウンするには、ユーザー名とパスワードの両方を指定する必要があります。これらは、インスタンスの停止に使用されるビルドスクリプトにクリアテキストで保存されます。セキュリティ上の理由から、このタスクは開発環境でのみ適切です。

このタスクは、6.0を含むほとんどのバージョンのWebLogicで機能します。6.0でこのタスクを正しく機能させるには、BEAHomeを指定する必要があります

パラメータ

ネストされた要素として指定されたパラメータ

wlstopタスクのクラスパスは、ネストされた<classpath>要素で設定できます。

例

この例は、WebLogic 6.0サーバーのシャットダウンを示しています

<wlstop classpath="${weblogic.classes}"
        user="system"
        url="t3://localhost:7001"
        password="foobar"
        beahome="${bea.home}"/>

ejbjar

説明

このタスクは、EJB jarファイル（EJB 1.1 & 2.0）の作成をサポートするように設計されています。現在、サポートされているのは「バニラ」EJB jarファイルです。つまり、ユーザーが生成したクラスファイルと標準のデプロイメント記述子のみを含むものです。ネストされた要素は、ベンダー固有のデプロイメントツールをサポートします。これには現在、以下が含まれます。

• Borland Application Server 4.5
• iPlanet Application Server 6.0
• JBoss 2.1以降
• weblogic.ejbcツールを使用するWebLogic 5.1/6.0セッション/エンティティBean
• IBM WebSphere 4.0
• WebLogic 2.5.1対応エンティティBean用TOPLink
• JOnAS 2.4.xおよび2.5オープンソースEJBサーバー
• IronFlare Orion Application Server 2.0

このタスクは、ディレクトリのスキャンタスクとして機能し、見つかったデプロイメント記述子ごとにアクションを実行します。したがって、includesおよびexcludesを設定して、必要なすべてのEJB記述子が見つかり、アプリケーションサーバー記述子が見つからないようにする必要があります。見つかった各記述子について、ejbjarはデプロイメント記述子を解析して、Beanを実装する必要なクラスファイルを決定します。これらのファイルは、デプロイメント記述子とともに、適切に形成されたEJB jarファイルにまとめられます。生成されたjarに含める必要があるサポートファイルは、<support>ネスト要素で追加できます。jarに含まれる各クラスについて、ejbjarはスーパークラスまたはスーパーインターフェイスをスキャンします。これらは生成されたjarに追加されます。

ネストされたベンダー固有のデプロイメント要素が存在しない場合、タスクは単に一般的なEJB jarを生成します。このようなjarは、通常、ベンダー固有のデプロイメントツールの入力として使用されます。ネストされたデプロイメント要素ごとに、ベンダー固有のデプロイメントツールが実行され、そのベンダーのEJBコンテナへのデプロイ準備ができたjarファイルが生成されます。

jarファイルは、古くなっている場合にのみビルドされます。各デプロイメントツール要素は、ターゲットのjarファイルを調べて、Beanを構成するクラスファイルとデプロイメント記述子に関して古くなっているかどうかを判断します。これらのファイルのいずれかがjarファイルよりも新しい場合、jarは再構築されます。それ以外の場合は、jarファイルが最新であるというメッセージがログに記録されます。

このタスクは、すべての依存クラスを抽出するために、BCEL ライブラリを使用します。これは、デプロイメント記述子に記載されているクラスに加えて、それらが依存するすべてのクラスも自動的にjarファイルに含まれることを意味します。

命名規則

descriptor

これは、デフォルトの命名スキームです。生成されたBeanの名前は、デプロイメント記述子の名前から派生します。たとえば、Account Beanの場合、デプロイメント記述子の名前はAccount-ejb-jar.xmlになります。ベンダー固有の記述子は、同じ命名規則を使用して配置されます。たとえば、WebLogic Beanの名前はAccount-weblogic-ejb-jar.xmlになります。この構成では、デプロイメント記述子をBeanを実装するコードから分離できます。これは、同じBeanコードが別々のBeanにデプロイされる場合に役立ちます。

このスキームは、EJB jarごとに1つのBeanを使用しており、異なるデプロイメント特性を持つ異なるBeanに同じBeanクラスをデプロイする可能性がある場合に役立ちます。

ejb-name

この命名スキームでは、デプロイメント記述子から<ejb-name>要素を使用して、Bean名を決定します。この状況では、記述子は通常、ejb-jar.xmlなどの一般的な記述子名と、関連するベンダー固有の記述子名を使用します。たとえば、<ejb-name>の値がデプロイメント記述子に次のように記述されている場合

<ejb-jar>
    <enterprise-beans>
        <entity>
            <ejb-name>Sample</ejb-name>
            <home>org.apache.ant.ejbsample.SampleHome</home>

生成されたBeanの名前はSample.jarになります。

このスキームは、他のEJBツールとの互換性が高い可能性がある標準のデプロイメント記述子名を使用する場合に役立ちます。このスキームでは、jarごとに1つのBeanが必要です。

directory

このモードでは、生成されたBean jarの名前は、デプロイメント記述子を含むディレクトリから派生します。ここでも、デプロイメント記述子は通常、標準のファイル名を使用します。たとえば、デプロイメント記述子へのパスが/home/user/dev/appserver/dd/sampleの場合、生成されたBeanの名前はsample.jarになります。

このスキームは、標準スタイルの記述子名を使用する場合にも役立ちます。記述子がBeanソースコードと同じディレクトリにある場合によく使用されますが、必須ではありません。このスキームでは、jarごとに複数のBeanを処理できます。

basejarname

<ejbjar>タスクでサポートされている最後のスキームは、生成されたBean jar名を直接指定する場合に使用されます。この場合、生成されたjarの名前はbasejarname属性で指定されます。生成されたすべてのBeanの名前が同じになるため、このタスクは各記述子が独自のディレクトリにある場合にのみ使用する必要があります。

このスキームは、jarごとに複数のBeanを使用しており、1つのデプロイメント記述子のみを処理する場合に最適です。通常、jarの名前を指定し、jar内のBeanから派生させたくないでしょう。

依存関係

Beanクラスに加えて、ejbjarは、生成されたEJB jarに追加のクラスを追加できます。これらのクラスは、通常、Beanのクラスで使用されるサポートクラス、またはBeanのメソッドのパラメーターとして使用されます。

Antの1.5より前のバージョンでは、ejbjarはリフレクションを使用して、Beanクラスのスーパークラスとスーパーインターフェイスを追加しようとしました。この手法が機能するためには、BeanクラスをAntのJVMにロードする必要がありました。これは、クラスの依存関係のために、常に可能とは限りませんでした。

Ant 1.5以降、タスクはBCELライブラリを使用して、BeanのクラスファイルをJVMにロードするのではなく、直接分析します。これにより、ejbjarはスーパークラスだけでなく、Beanに必要なすべてのサポートクラスを追加することもできます。

Ant 1.5以降、dependency属性を使用すると、ビルドファイルで生成されたjarに追加される追加のクラスを制御できます。次の3つの可能な値を取ります。

• none—Beanの記述子に記述されているBeanクラスとインターフェイスのみがjarに追加されます。
• super—これはデフォルト値であり、スーパークラスとスーパーインターフェイスがjarに追加される元のejbjarの動作を複製します。
• full—このモードでは、Beanのクラスとインターフェイスで使用されるすべてのクラスがjarに追加されます。

superおよびfullの値では、BCELライブラリが利用可能である必要があります。そうでない場合、ejbjarは値noneに対応する動作に戻ります。

パラメータ

ネストされた要素として指定されたパラメータ

ベンダー固有のネストされた要素に加えて、ejbjarタスクは3つのネストされた要素を提供します。

classpath

<classpath>ネストされた要素を使用すると、クラスパスを設定できます。参照パスからクラスパスを設定する場合に便利です。その他すべての点において、動作はclasspath属性と同じです。

dtd

<dtd>要素は、EJBデプロイメント記述子を解析するときに使用されるDTDのローカルな場所を指定するために使用されます。ローカルのDTDを使用する方が、ネットワーク経由でDTDをロードするよりもはるかに高速です。ファイアウォールの内側でejbjarを実行している場合は、リモートのDTDにアクセスすることさえできない場合があります。サポートされているベンダー固有のネストされた要素は、ベンダーのクラス階層内の必要なDTDの場所を知っており、一般に、これは<dtd>要素が必要ないことを意味します。ただし、これは、Antを起動するときにベンダーのクラス階層がクラスパスで利用可能である必要があることを意味します。クラスパスにベンダーのクラスを必要とせずにAntを実行する場合は、<dtd>要素を使用する必要があります。

support

<support>ネストされた要素は、生成されたjarに含める追加のクラス（ファイル）を提供するために使用されます。<support>要素はFileSetであるため、他の場所で宣言されたfilesetを参照することも、適切な<include>および<exclude>ネスト要素を使用してインプレースで定義することもできます。サポートfileset内のファイルは、サポートfileset内の場所と同じ相対的な場所で、生成されたEJB jarに追加されます。ejbjarが複数のjarファイルを生成する場合、サポートファイルはそれぞれに追加されることに注意してください。

ベンダー固有のデプロイメント要素

ベンダー固有のネストされた各要素は、そのベンダーのEJBコンテナに固有のデプロイ可能なjarの生成を制御します。サポートされている各デプロイメント要素のパラメーターは、ここに詳しく説明されています。

Jboss要素

jboss要素は、JBoss固有のデプロイメント記述子を検索し、それらを最終的なEJB jarファイルに追加します。JBossには、2つのデプロイメント記述子があります。

• jboss.xml
• コンテナマネージャーの永続性の場合

  CMPバージョン	ファイル名
  CMP 1.0	jaws.xml
  CMP 2.0	jbosscmp-jdbc.xml

JBossサーバーはホットデプロイメントを使用し、追加のスタブとスケルトンのコンパイルを必要としません。

WebLogic要素

weblogic要素は、WebLogic EJB jarを生成するためのweblogic.ejbcコンパイラを制御するために使用されます。Ant 1.3より前では、CMP記述子を特定する方法は、ejbjarという命名規則を使用することでした。したがって、EJB jarがCustomer-ejb-jar.xmlという名前の場合、WebLogic記述子はCustomer-weblogic-ejb-jar.xmlという名前になり、CMP記述子はCustomer-weblogic-cmp-rdbms-jar.xmlという名前である必要がありました。さらに、WebLogic記述子の<type-storage>要素は、生成されたjar内でCMP記述子がマップされる場所である標準名META-INF/weblogic-cmp-rdbms-jar.xmlに設定する必要がありました。

この方式にはいくつかの問題があります。1つのjar内で複数のCMP記述子を定義することができず、一部のツールによって生成されたデプロイメント記述子と互換性がありません。

Ant 1.3では、ejbjarはWebLogicデプロイメント記述子を解析してCMP記述子を検出し、それらが自動的に含まれます。この動作は、newCMP属性によって制御されます。CMP記述子を特定する新しい方法に移行する場合は、WebLogicデプロイメント記述子の<type-storage>要素を更新する必要があることに注意してください。上記の例では、これをMETA-INF/Customer-weblogic-cmp-rdbms-jar.xmlとして定義します。

weblogicネスト要素は、3つのネスト要素をサポートします。最初の2つ、<classpath>と<wlclasspath>は、それぞれのクラスパスを設定するために使用されます。これらのネスト要素は、参照IDを使用してクラスパスを設定する場合に役立ちます。最後の<sysproperty>を使用すると、コンパイラ実行中にJavaシステムプロパティを設定できます。これは、すべての環境でCMP EJBコンパイルをサポートするために必要になることがわかります。

WebLogic用TOPLink要素

非推奨

toplink要素は不要になりました。TOPLink Beanは、newCMP属性がtrueに設定されている限り、標準のweblogic要素で構築できるようになりました。

TopLink要素は、CMP操作にTOPLinkを使用するBeanを処理するために使用されます。標準のweblogic要素から派生しているため、同じ属性セットと、これらの追加属性をサポートしています。

例

この例は、WebLogic EJBコンテナを使用してデプロイメントjarを生成するためにejbjarを使用する方法を示しています。この例では、デプロイメント記述子に使用する命名規則が必要です。この形式を使用すると、デプロイメント記述子ディレクトリにある*-ejb-jar.xmlのバリエーションごとにEJB jarファイルが作成されます。

<ejbjar srcdir="${build.classes}"
        descriptordir="${descriptor.dir}">
  <weblogic destdir="${deploymentjars.dir}"
            classpath="${descriptorbuild.classpath}"/>
  <include name="**/*-ejb-jar.xml"/>
  <exclude name="**/*weblogic*.xml"/>
</ejbjar>

WebLogicがAntクラスパスにない場合、次の例は、WebLogic DTDの場所を指定する方法を示しています。この例では、ネストされたclasspath要素の使用法も示しています。

<ejbjar descriptordir="${src.dir}" srcdir="${build.classes}">
   <weblogic destdir="${deployment.webshop.dir}"
             keepgeneric="true"
             args="-g -keepgenerated ${ejbc.compiler}"
             suffix=".jar"
             oldCMP="false">
     <classpath>
       <pathelement path="${descriptorbuild.classpath}"/>
     </classpath>
   </weblogic>
   <include name="**/*-ejb-jar.xml"/>
   <exclude name="**/*-weblogic-ejb-jar.xml"/>
   <dtd publicId="-//Sun Microsystems, Inc.//DTD Enterprise JavaBeans 1.1//EN"
        location="${weblogic.home}/classes/weblogic/ejb/deployment/xml/ejb-jar.dtd"/>
   <dtd publicId="-//BEA Systems, Inc.//DTD WebLogic 5.1.0 EJB//EN"
        location="${weblogic.home}/classes/weblogic/ejb/deployment/xml/weblogic-ejb-jar.dtd"/>
</ejbjar>

この例は、WebLogic EJBコンテナを使用して単一のデプロイメントjarを生成するためにejbjarを使用する方法を示しています。この例では、デプロイメント記述子が命名規則を使用する必要はありません。これにより、EJB jarファイルは1つだけ（TheEJBJar.jar）作成されます。

<ejbjar srcdir="${build.classes}"
        descriptordir="${descriptor.dir}"
        basejarname="TheEJBJar">
  <weblogic destdir="${deploymentjars.dir}"
            classpath="${descriptorbuild.classpath}"/>
  <include name="**/ejb-jar.xml"/>
  <exclude name="**/weblogic*.xml"/>
</ejbjar>

この例は、WebLogic EJBコンテナを使用してTOPLink対応のエンティティBeanのデプロイメントjarを生成するためにejbjarを使用する方法を示しています。この例では、デプロイメント記述子が命名規則を使用する必要はありません。これにより、TOPLink対応のEJB jarファイルは1つだけ（Address.jar）作成されます。

<ejbjar srcdir="${build.dir}"
        destdir="${solant.ejb.dir}"
        descriptordir="${descriptor.dir}"
        basejarname="Address">
        <weblogictoplink destdir="${solant.ejb.dir}"
                classpath="${java.class.path}"
                keepgeneric="false"
                toplinkdescriptor="Address.xml"
                toplinkdtd="file:///dtdfiles/toplink-cmp_2_5_1.dtd"
                suffix=".jar"/>
        <include name="**/ejb-jar.xml"/>
        <exclude name="**/weblogic-ejb-jar.xml"/>
</ejbjar>

最後の例は、WebLogic 6.0でejbjarを設定する方法を示しています。また、<support>要素を使用してサポートファイルを追加する方法も示しています。

<ejbjar descriptordir="${dd.dir}" srcdir="${build.classes.server}">
   <include name="**/*-ejb-jar.xml"/>
   <exclude name="**/*-weblogic-ejb-jar.xml"/>
   <support dir="${build.classes.server}">
        <include name="**/*.class"/>
   </support>
   <weblogic destdir="${deployment.dir}"
             keepgeneric="true"
             suffix=".jar"
             rebuild="false">
     <classpath>
        <pathelement path="${build.classes.server}"/>
     </classpath>
     <wlclasspath>
        <pathelement path="${weblogic.classes}"/>
     </wlclasspath>
   </weblogic>
</ejbjar>

WebSphere要素

websphere要素は、WebSphere固有のデプロイメント記述子を検索し、それらを最終的なEJB jarファイルに追加します。WebSphereには、セッションBean用に2つの特定の記述子があります。

• ibm-ejb-jar-bnd.xmi
• ibm-ejb-jar-ext.xmi

コンテナ管理エンティティBean用にさらに2つ。

• Map.mapxmi
• Schema.dbxmi

WebSphereの観点から見ると、コンテナコードとスタブの生成はデプロイメントと呼ばれます。このステップは、jar生成プロセスの一部としてwebsphere要素で実行できます。スイッチejbdeployがオンの場合、WebSphereツールセットのejbdeployツールがすべてのEJB jarに対して呼び出されます。残念ながら、このステップは、IBM JDKを使用する場合にのみ機能します。それ以外の場合、rmic（ejbdeployによって呼び出される）はClassFormatErrorをスローします。AntがOracle JDKまたはOpenJDKで実行される場合は、必ずejbdeployをオフにしてください。

websphere要素を機能させるには、Beanクラスを反映するために必要なすべてのクラスを含む完全なクラスパスを提供する必要があります。ejbdeployを機能させるには、ejbdeployツールのクラスパスも提供し、websphere.homeプロパティを設定する必要があります（以下の例を参照）。

<WAS_HOME>/bin/EJBDeploy.[sh/bat] -help

この例は、descriptordir内のすべてのデプロイメント記述子に対してデプロイメントjarを生成するためにejbjarを使用する方法を示しています。

<property name="websphere.home" value="${was4.home}"/>
<ejbjar srcdir="${build.class}" descriptordir="etc/ejb">
  <include name="*-ejb-jar.xml"/>
  <websphere dbvendor="DB2UDBOS390_V6"
             ejbdeploy="true"
             oldCMP="false"
             tempdir="/tmp"
             destdir="${dist.server}">
    <wasclasspath>
      <pathelement location="${was4.home}/deploytool/itp/plugins/org.eclipse.core.boot/boot.jar"/>
      <pathelement location="${was4.home}/deploytool/itp/plugins/com.ibm.etools.ejbdeploy/runtime/batch.jar"/>
      <pathelement location="${was4.home}/lib/xerces.jar"/>
      <pathelement location="${was4.home}/lib/ivjejb35.jar"/>
      <pathelement location="${was4.home}/lib/j2ee.jar"/>
      <pathelement location="${was4.home}/lib/vaprt.jar"/>
    </wasclasspath>
    <classpath>
      <path refid="build.classpath"/>
    </classpath>
  </websphere>
  <dtd publicId="-//Sun Microsystems, Inc.//DTD Enterprise JavaBeans 1.1//EN"
       location="${lib}/dtd/ejb-jar_1_1.dtd"/>
</ejbjar>

iPlanet Application Server（iAS）要素

<iplanet>ネスト要素は、iAS固有のスタブとスケルトンを構築し、iPlanet Application Server 6.0にデプロイ可能なJARファイルを構築するために使用されます。ビルドプロセスでは常に、EJBスタブ/スケルトンとEJB jarファイルが最新であるかどうかを判断し、必要な最小限の作業を行います。

weblogic要素と同様に、EJB記述子の命名規則は、完成したJARファイルの名前を指定するために最も一般的に使用されます。たとえば、EJB記述子ejb/Account-ejb-jar.xmlが記述子ディレクトリにある場合、iplanet要素は、ejb/Account-ias-ejb-jar.xmlという名前のiAS固有のEJB記述子ファイルを検索します（見つからない場合は、タスクは失敗します）。そして、ejb/Account.jarという名前のJARファイルが宛先ディレクトリに書き込まれます。EJB記述子がJARファイルに追加されると、自動的にMETA-INF/ejb-jar.xmlおよびMETA-INF/ias-ejb-jar.xmlに名前が変更されることに注意してください。

もちろん、この命名動作は、ejbjarタスク（たとえば、basejarname、basenameterminator、およびflatdestdir）と、iplanet要素（たとえば、suffix）で属性を指定することで変更できます。詳細については、適切なドキュメントを参照してください。

パラメータ

上記のように、iplanet要素は追加の<classpath>ネスト要素をサポートしています。

例

この例は、<iplanet>ネスト要素の一般的な使用法を示しています。各EJB jarの名前は、標準のEJB記述子の先頭に追加された「ベース名」を使用して付けられます。たとえば、Account-ejb-jar.xmlという名前の記述子が処理された場合、EJB-JARの名前はAccount.jarになります。

<ejbjar srcdir="${build.classesdir}"
        descriptordir="${src}">

    <iplanet destdir="${assemble.ejbjar}"
             classpath="${ias.ejbc.cpath}"/>
    <include name="**/*-ejb-jar.xml"/>
    <exclude name="**/*ias-*.xml"/>
</ejbjar>

この例は、ネストされたclasspath要素と、他のオプションの属性の使用法を示しています。

<ejbjar srcdir="${build.classesdir}"
        descriptordir="${src}">

    <iplanet destdir="${assemble.ejbjar}"
             iashome="${ias.home}"
             debug="yes"
             keepgenerated="yes">
        <classpath>
            <pathelement path="."/>
            <pathelement path="${build.classpath}"/>
        </classpath>
    </iplanet>
    <include name="**/*-ejb-jar.xml"/>
    <exclude name="**/*ias-*.xml"/>
</ejbjar>

この例は、basejarname属性の使用法を示しています。この場合、完成したEJB jarの名前はHelloWorld.jarになります。複数のEJB記述子が見つかる可能性がある場合は、完成したJARファイルが相互に上書きしないように注意する必要があります。

<ejbjar srcdir="${build.classesdir}"
        descriptordir="${src}"
        basejarname="HelloWorld">

    <iplanet destdir="${assemble.ejbjar}"
             classpath="${ias.ejbc.cpath}"/>
    <include name="**/*-ejb-jar.xml"/>
    <exclude name="**/*ias-*.xml"/>
</ejbjar>

この例は、dtdネスト要素の使用法を示しています。DTDのローカルコピーがクラスパスに含まれている場合、ネストされた要素なしで自動的に参照されます。iAS 6.0 SP2では、これらのローカルDTDは[iAS-インストールディレクトリ]/APPSディレクトリにあります。iAS 6.0 SP3では、これらのローカルDTDは[iAS-インストールディレクトリ]/dtdディレクトリにあります。

<ejbjar srcdir="${build.classesdir}"
        descriptordir="${src}">
    <iplanet destdir="${assemble.ejbjar}">
             classpath="${ias.ejbc.cpath}"/>
    <include name="**/*-ejb-jar.xml"/>
    <exclude name="**/*ias-*.xml"/>

    <dtd publicId="-//Sun Microsystems, Inc.//DTD Enterprise JavaBeans 1.1//EN"
         location="${ias.home}/APPS/ejb-jar_1_1.dtd"/>
    <dtd publicId="-//Sun Microsystems, Inc.//DTD iAS Enterprise JavaBeans 1.0//EN"
         location="${ias.home}/APPS/IASEjb_jar_1_0.dtd"/>
</ejbjar>

JOnAS（Java Open Application Server）要素

<jonas>ネスト要素は、GenIC固有のツールのおかげでJOnAS固有のスタブとスケルトンを構築し、JOnASアプリケーションサーバーにデプロイ可能なJARファイルを構築するために使用されます。ビルドプロセスでは常に、EJBスタブ/スケルトンとEJB jarファイルが最新であるかどうかを判断し、必要な最小限の作業を行います。

WebLogic要素と同様に、EJB記述子の命名規則は、完成したJARファイルの名前を指定するために最も一般的に使用されます。たとえば、EJB記述子ejb/Account-ejb-jar.xmlが記述子ディレクトリにある場合、<jonas>要素は、ejb/Account-jonas-ejb-jar.xmlという名前のJOnAS固有のEJB記述子ファイルを検索し、ejb/Account.jarという名前のJARファイルが宛先ディレクトリに書き込まれます。ただし、<jonas>要素はJOnASの命名規則も使用できます。以下の例と同じように、EJB記述子は、記述子ディレクトリでejb/Account.xml（ここではベース名ターミネータなし）と名前を付けることもできます。次に、<jonas>要素は、ejb/jonas-Account.xmlという名前のJOnAS固有のEJB記述子ファイルを検索します。この規則は、EJB jarの命名規則の推奨事項に厳密には従いませんが、JOnASの以前のバージョンとの下位互換性のためにサポートされています。

EJB記述子がJARファイルに追加されると、自動的にMETA-INF/ejb-jar.xmlおよびMETA-INF/jonas-ejb-jar.xmlに名前が変更されることに注意してください。

もちろん、この命名動作は、ejbjarタスク（たとえば、basejarname、basenameterminator、およびflatdestdir）と、iplanet要素（たとえば、suffix）で属性を指定することで変更できます。詳細については、適切なドキュメントを参照してください。

このタスクは、一時ディレクトリ内にスクラッチデータ用のディレクトリを作成します。

パラメータ

上記のように、jonas要素は追加の<classpath>ネスト要素をサポートしています。

例

この例は、JOnAS EJBコンテナを使用してデプロイメントjarを生成するためにejbjarが使用されていることを示しています。この例では、デプロイメント記述子に命名標準を使用する必要があります。この形式を使用すると、デプロイメント記述子ディレクトリにある*-jar.xmlのバリエーションごとにEJB jarファイルが作成されます。

<ejbjar srcdir="${build.classes}"
        descriptordir="${descriptor.dir}">
  <jonas destdir="${deploymentjars.dir}"
       jonasroot="${jonas.root}"
       orb="RMI"/>
  <include name="**/*.xml"/>
  <exclude name="**/jonas-*.xml"/>
  <support dir="${build.classes}">
       <include name="**/*.class"/>
  </support>
</ejbjar>

この例は、JOnAS EJBコンテナを使用して単一のデプロイメントjarを生成するためにejbjarが使用されていることを示しています。この例では、デプロイメント記述子が命名標準を使用する必要があります。これにより、1つのEJB jarファイルTheEJBJar.jarのみが作成されます。

<ejbjar srcdir="${build.classes}"
        descriptordir="${descriptor.dir}"
        basejarname="TheEJBJar">
  <jonas destdir="${deploymentjars.dir}"
            jonasroot="${jonas.root}"
            suffix=".jar"
            classpath="${descriptorbuild.classpath}"/>
  <include name="**/ejb-jar.xml"/>
  <exclude name="**/jonas-ejb-jar.xml"/>
</ejbjar>

Orion要素

orion要素は、Orionアプリケーションサーバー固有のデプロイメント記述子を検索し、それらを最終的なEJB jarファイルに追加します。Orionには1つのデプロイメント記述子があります

• orion-ejb-jar.xml

例

<ejbjar srcdir="${build.classes}"
        descriptordir="${descriptor.dir}"
        basejarname="TheEJBJar"
        flatdestdir="true"
        dependency="super"
        genericjarsuffix=".jar">
  <include name="**/*-ejb-jar.xml"/>
  <orion destdir="${deploymentjars.dir}"\>
</ejbjar>