How-To： WebモジュールからのEJB 3.0 EntityManager APIの使用

このサンプル・アプリケーションでは、エンティティを使用したEJB 3.0 JPA仕様に対するオラクルのサポートと、Webコンテナからコンテナ管理のEntityManager APIを使用する方法について説明します。 サンプルでは、Webアプリケーションから新しいEJB 3.0エンティティの使用例を提供します。 サンプルでは、Webモジュールのエンティティを、WEB-INF/libディレクトリのjarファイルにパッケージ化します。

EJB 3.0では、次の仕様により、開発が大幅に簡素化されています。

• 簡単なJavaクラス（POJO）をBeanクラスに使用可能であること
• Entity Beanへのインタフェースが不要であること
• O-Rマッピングにアノテーションを使用していること

このデモンストレーションでは、 Employeeエンティティを例に、EJB 3.0によるEntity Beanについて説明します。

Beanクラスは、エンティティであることを示す@Entityで注釈される簡単なJavaクラスです。

@Entity
@Table(name = "EMP")
public class Employee implements java.io.Serializable
{
  private int empNo;
  private String eName;
  private double sal;

  @Id
  @Column(name="EMPNO")
  public int getEmpNo()
  {
    return empNo;
  }

..

}

@Table注釈は、このEntity Beanで使用する表の名前を特定する場合に使用します。

@Id注釈は、empNoフィールドをEntity Beanの主キーとして示す場合に使用します。

@Column注釈は、empNoフィールドが表内のEMPNO列にマッピングされたことを指定する場合に使用します。

javax.persistence.EntityManager API は、Entity Beanインスタンスの作成、検索、および更新で使用します。 Oracle Application Server 10g 10.1.3.1では、次の3つの方法でWebモジュールからEntityManagerのインスタンスを取得できます。

• コンテナ管理の PersistenceContextを使用した依存性の注入。 EntityManagerは事実上スレッドセーフが保証されていないため、これは推奨されません。 ただし、オラクルの EntityManagerの実装は、事実上スレッドセーフです。
• JNDIルックアップを使用したコンテナ管理の EntityManager 。 PersistenceContextアノテーションまたはweb.xmlのpersistence-context-refのいずれかを使用して、永続性コンテキストに参照を定義します。
• PersistenceUnitのインスタンスを注入し、 createEntityManager()メソッドを使用して EntityManagerを作成する、アプリケーション管理のエンティティ・マネージャ。

EntityManager APIはトランザクション内での使用が必要なため、WebモジュールではUserTransaction APIを使用して、手動でトランザクションの境界を設定する必要があります。

ここでは、 InsertServletがEntityManagerインスタンスを検索してから、次のようにエンティティ・インスタンスを維持する例を示します。

@PersistenceContext(name="howto/EntityManager",unitName="howto")
public class InsertServlet extends HttpServlet {

..
ut = (UserTransaction)initCtx.lookup("java:comp/UserTransaction");
ut.begin();
Context context = new InitialContext();
Employee employee = new Employee();
employee.setEmpNo(empId);
employee.setEname(name);
employee.setSal(sal);
EntityManager em = (EntityManager)context.lookup("java:comp/howto/EntityManager");
em.persist(employee);
ut.commit();

..}