EJB 3.0を使用したステートフルSession EJBの開発方法

このデモ・アプリケーションでは、Oracle Application ServerのステートフルSession Beanに対するサポートと、EJB 3.0を使用したライフ・サイクル・イベントのコールバックについて説明します。 このデモ・アプリケーションでは、ステートフルEJBを使用して、EJB 3.0の新機能を紹介します。

EJB 3.0は、以前のバージョンで開発者が直面した様々な複雑性を排除することによって、EJBアプリケーションの開発を大幅に簡素化します。 EJB 2.1を使用して簡単なステートフルEJBを作成するには、Beanクラスと2つのインタフェース、デプロイメント・ディスクリプタが必要です。 コンポーネント・インタフェース（リモートまたはローカル、あるいは両方）およびホーム・インタフェースはそれぞれ javax.ejb.EJBObjectと javax.ejb.EJBHomeを拡張し、Beanクラスがは javax.ejb.SessionBeanインタフェースを実装する必要がありました。

EJB 3.0では、それら多くの要件が次のように緩和されています。

• 簡単なJavaクラス（POJO）をBeanクラスに使用可能
• Pure Javaインタフェース（POJI）をEJBインタフェースに使用可能
• EJBホーム・インタフェースは不要
• XMLデプロイメント・ディスクリプタのかわりにアノテーションを使用可能

基本的なショッピング・カートEJBを作成して、EJB 3.0を使用した簡単なステートフルEJBの例を示します。

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

これは、Pure Javaインタフェースで、 EJBObjectを拡張しません。

package oracle.ejb30;
                                    


import java.util.Collection;

import javax.ejb.Remote;

                                     
@Remote
public interface Cart {
    public void addItem(String item);
    public void removeItem(String item);
    public Collection getItems();
}
                                    
                                       
                                         
                                                                          
                                  

Here is the code for the bean class. The EJB is a plain Java class that implements its business interface.

package oracle.ejb30;

import java.util.ArrayList;
import java.util.Collection;

import javax.ejb.PostConstruct;
import javax.ejb.Stateful;
                                     


                                     
@Stateful
public class CartBean implements Cart {
    private ArrayList items;

  
                                    
   @PostConstruct
    public void initialize() {
        items = new ArrayList();
    }
    
    public void addItem(String item) {
        items.add(item);
    }

    public void removeItem(String item) {
        items.remove(item);
    }

    public Collection getItems() {
        return items;
    }
}
                                  

javax.ejb.Statefulアノテーションは、BeanをステートフルSession Beanとしてマークします。 Bean名は、デフォルトでCartBeanとなります。 このBeanは javax.ejb.SessionBeanを実装しないため、 javax.ejb.PostConstructアノテーションを使用して、initialize()メソッドにEJB 2.1 BeanのejbCreate()と同様のロールを割り当てます。

注：一部のEJB 3.0 APIは、EJB 3.0の最終仕様で変更される可能性があり、ご使用のアプリケーションをEJB 3.0最終仕様に適合させるための変更が必要な場合があります。 オラクルは、この仕様の最終版に適合する将来のバージョンのOracle Application Server Containers for J2EEについて、すべてのEJB 3.0機能の下位互換性を保証することはできません。

EJBクライアント・コードは、EJB 3.0で大幅に簡素化されています。 クライアントはJNDIからのEJBホーム・インタフェースの検索が不要になり、ホーム・インタフェースでcreateを起動して特別にBeanインスタンスを作成する必要がなくなりました。 クライアントは、依存性の注入を使用するだけで、EJBでメソッドを直接起動できます。

次に、EJBにアクセスするクライアント・コードのスニペットを示します。

public class CartClient {
 @EJB
                                    


       private static Cart cart;
                                    


    public static void main(String[] args) throws Exception {
        System.out.println("Adding items to cart");
        cart.addItem("Item1");
        cart.addItem("Item2");
        System.out.println("Listing cart contents");
        Collection items = cart.getItems();
        for (Iterator i = items.iterator(); i.hasNext();) {
            String item = (String) i.next();
            System.out.println("  " + item);
        }
    }
}
                                    
                                       
                                         
                                                                                                              
                                       
                                         
                                           
                                                                                                                    
                                    
                                       
                                    
                                  

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

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

重要な構成ファイルはすべて %HOWTO_HOME%/etcにあります。application.xmlなどのデプロイメント・ディスクリプタ・ファイルなどです。

次の手順に従って、Oracle Application Server 10g 10.1.3のスタンドアロン・インスタンスでデモンストレーションを実行します。

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

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

• %ORACLE_HOME% - Oracle Containers for J2EEをインストールしたディレクトリ
• %JAVA_HOME% - 使用するJDKがインストールされているディレクトリ
• %PATH% - %ORACLE_HOME% /ant/binを含む

以上を変更した後に、次のコマンドを使用してOracle Containers for J2EEをスタンドアロンで起動します。

>%ORACLE_HOME%/bin/oc4j -start

Oracle Application Server管理インストールを使用している場合、上記の変更後に次のコマンドを使用します。

> %ORACLE_HOME%/opmn/bin/opmnctl startall

Ant 1.6.2はOracle Containers for J2EEに同梱されており、 PATH環境変数を $ORACLE_HOME/ant/binに設定する必要があります。 オペレーティング・システムによっては、現在はAntが環境変数をサポートしていないものがあります。 該当するオペレーティング・システムの場合は、 %HOWTO_HOME% ディレクトリにあるant-oracle.xmlを修正してください。

demo directoryのant-oracle.propertiesを編集し、 次のOracle Containers for J2EEスタンドアロンで示されているとおりに、プロパティに正しい値が設定されていることを確認してください。