EJB 3.0およびJDK 1.4を使用したステートレスSession EJBの開発方法

このサンプル・アプリケーションでは、JDK 1.4環境でのEJB 3.0仕様に対するオラクルのサポートについて説明します。 アノテーションはJDK 1.5のみで使用可能なため、xmlのみでデプロイするさまざまな機能の構成方法について説明します。 ここでは、次の事項について紹介します。

• スパースなejb-jar.xmlファイル
• EJB参照のフィールドおよびプロパティの注入方法
• 環境エントリのフィールドおよびプロパティの注入方法
• ライフ・サイクル・コールバックの宣言方法

このデモンストレーションではWeatherReport Beanを例に、EJB 3.0およびJDK 1.4を使用した簡単なステートレスEJBについて説明します。

WeatherReportEJBのリモート・インタフェースを次に示します。

package oracle.ejb30;
public interface WeatherReport {
    public String getTemperatorFor(String cityName);
    public String getTemperatorFor(String cityName, boolean celcius);
}

Beanクラスは、ビジネス・インタフェースを実装する簡単なJavaクラスです。

package oracle.ejb30;
public class WeatherReportBean implements WeatherReport {
    protected Map weatherMap;
    // both Strings are configured for injection in the ejb-jar.xml file
    private String celciusString;
    private String fahrenheitString;
    private TemperatureConverter temperatureConverter;

    . . .

    public String getTemperatureFor(String cityName) {
        return getTemperatureFor(cityName, false);
    }

    public String getTemperatureFor(String cityName, boolean celcius) {
        . . .
    }

    // this setter is configured for injection in the ejb-jar.xml file
    public void setTemperatureConverter(TemperatureConverter converter) {
        this.temperatureConverter = converter;
    }
}

WeatherReportEJBのコールバック・リスナー・クラスを次に示します。

package oracle.ejb30;
public interface LifecycleListener {
    public void initializeWeatherData(Object obj) {
        . . .
    }
}

このクラスはアノテーションを使用せず、かわりに簡単なデプロイメント・ディスクリプタを使用します。

次に、簡素化されたデプロイメント・ディスクリプタの内容を示します。 これには、EJB名、Beanクラス、リモート/ローカル・インタフェース、セッションの種類、注入された参照およびコールバック・リスナーが含まれます。 残りはデフォルトです。

<ejb-jar>
  <enterprise-beans>
    <session>
      <ejb-name>WeatherReport</ejb-name>
      <remote>oracle.ejb30.WeatherReport</remote>
      <ejb-class>oracle.ejb30.WeatherReportBean</ejb-class>
      <session-type>Stateless</session-type>
      <ejb-local-ref>
        <ejb-ref-name>ejb/TemperatureConverter</ejb-ref-name>
        <local>oracle.ejb30.TemperatureConverter</local>
        <property>temperatureConverter</property>
      </ejb-local-ref>
      <env-entry>
        <env-entry-name>CelsiusString</env-entry-name>
        <env-entry-type>java.lang.String</env-entry-type>
        <env-entry-value>degrees Celsius</env-entry-value>
         <field>celciusString</field>
      </env-entry>
      <env-entry>
        <env-entry-name>FahrenheitString</env-entry-name>
        <env-entry-type>java.lang.String</env-entry-type>
        <env-entry-value>degrees Fahrenheit</env-entry-value>
         <field>fahrenheitString</field>
      </env-entry>
       <lifecycle-callbacks>
        <callback-listener>oracle.ejb30.LifecycleListener</callback-listener>
        <post-construct>initializeWeatherData</post-construct>
      </lifecycle-callbacks>
    </session>
    <session>
      <ejb-name>TemperatureConverter</ejb-name>
      <local>oracle.ejb30.TemperatureConverter</local>
      <ejb-class>oracle.ejb30.TemperatureConverterBean</ejb-class>
      <session-type>Stateless</session-type>
    </session>
  </enterprise-beans>
</ejb-jar>

以下の点に注意してください。

• 参照注入の <field>タグおよび <property>タグは、仕様で正式に定義されておらず、変更される可能性があります。
• <field>タグおよび <property>タグの値は、注入されるBeanのフィールドおよびセッターに対応します。
• <lifecycle-callbacks>タグおよびサブタグは、仕様で正式に定義されておらず、変更される可能性があります。
• Bean自体のライフ・サイクル・コールバックを宣言する場合は、 <callback-listener>タグを省略してください。
• サポートされているライフ・サイクル・タグは、 <post-construct>、 <pre-destroy>、 <post-activate>、 <pre-passivate>で、使用されるタグは各Beanに1つの<lifecycle-callbacks>のサブタグとして表示されます。
• xmlでのインターセプタの構成例は、インターセプタのHow-Toで参照できます。
• TemperatureConverterは、ステートレスSession Beanのデプロイに最低限必要なxmlを示します。

EJBホームのインタフェースが不要になり、Beanインスタンスはcreate()メソッドを起動して作成されません。 かわりに、次のクライアント・アクセッサに示すように、EJBでメソッドを直接起動できます。

Context context = new InitialContext();
System.out.println("Looking up WeatherReport");
WeatherReport report = (WeatherReport)context.lookup("java:comp/env/ejb/WeatherReport");
System.out.println(weatherReport.getTemperatureFor("Las Vegas"));
System.out.println(weatherReport.getTemperatureFor("Ottawa", true));

• EJB 3.0

EJB 3.0の詳細は、OTNの次のドキュメントを参照してください。

このデモンストレーションでは、次のソフトウェア・コンポーネントがインストールされ、正しく構成されている必要があります。

• %ORACLE_HOME% - Oracle Application Server EJB 3.0 Previewをインストールしたディレクトリ
• %JAVA_HOME% - 使用するJDKがインストールされているディレクトリ
• %HOWTO_HOME% - デモンストレーションを解凍したディレクトリ

構成ファイルは %HOWTO_HOME%/etcディレクトリにあり、application.xmlなどのデプロイメント・ディスクリプタ・ファイルが含まれます。

Oracle Application Server EJB 3.0 Previewのスタンドアロンのインスタンスでアプリケーションのサンプルを実行するには、次の手順に従ってください。

• build - ビルド時に作成される一時ディレクトリ
• log - ビルド/デプロイのログを保持する一時ディレクトリ
• etc - アプリケーションのパッケージ化に必要なすべてのファイル
• lib - デプロイ可能なアプリケーション・アーカイブを保持
• doc - How-ToドキュメントとJavadoc
  • javadoc - 異なるソース・ファイルのJavadoc
  • how-to-ejb30-jdk14.html - このWebサイト
• src - デモンストレーションのソース
  • ejb - ステートレスBeanのサンプル・コードの格納先
  • client - アプリケーションのクライアント・コードの格納先

次の環境変数が定義されていることを確認してください。

• %ORACLE_HOME% - Oracle Containers for J2EE（OC4J）がインストールされているディレクトリ
• %JAVA_HOME% - JDKがインストールされているディレクトリ

Oracle Application Server EJB 3.0 Previewコンテナが実行中である必要があります。 次のコマンドを使用して起動します。

Ant 1.6.2以上がマシンにインストールされ、正しく構成されていることを確認します。 オペレーティング・システムによっては、現在はAntが環境変数をサポートしていないものがあります。 該当するオペレーティング・システムの場合は、%HOWTO_HOME%ディレクトリにあるcommon.xmlファイルを修正してください。

demo directoryのant-oracle.propertiesを編集し、次に示すとおりに、プロパティに正しい値が設定されていることを確認してください。