5.6.2　アプリケーションからEntityManagerをルックアップする方法

(a)　name属性

name属性には，アプリケーションのコードがEntityManagerをルックアップするときのルックアップ名を指定します。指定するルックアップ名は，java:comp/envからの相対パスです。EntityManagerのルックアップ名は，必須ではありませんが，JPA仕様では，java:comp/env/persistence以下にすることが推奨されています。

@PersistenceContextのそのほかの属性については，「5.6.1　アプリケーションにEntityManagerをインジェクトする方法」と同じです。なお，拡張スコープのEntityManagerのルックアップは，Stateful Session Beanだけできます。また，一つのクラスに複数の@PersistenceContextを付加する場合には，クラスに@PersistenceContextsを付加し，そのvalue属性として@PersistenceContextの配列を指定してください。次に，@PersistenceContextを使用してSessionContextからEntityManagerをルックアップする例を示します。

@Stateless
@PersistenceContext(name="persistence/OrderEM")
public class MySessionBean implements MyInterface {
  @Resource SessionContext ctx;
  public void doSomething() {
    ・・・
    EntityManager em = (EntityManager)ctx.lookup("persistence/OrderEM");
    ・・・
  }
}

次に，@PersistenceContextを使用してInitialContextからEntityManagerをルックアップする例を示します。

@Stateless
@PersistenceContext(name="persistence/InventoryAppMgr")
public class InventoryManagerBean implements InventoryManager {
  public void updateInventory(...) {
    ・・・
    Context initCtx = new InitialContext();
    EntityManager em = (EntityManager)
      initCtx.lookup("java:comp/env/persistence/InventoryAppMgr");
    ・・・
  }
}

(a)　<persistence-context-ref-name>タグ

<persistence-context-ref-name>タグには，アプリケーションのコードがEntityManager をルックアップするときのルックアップ名を指定します。指定するルックアップ名は，java:comp/envからの相対パスです。EntityManagerのルックアップ名は，必須ではありませんが，JPA仕様ではjava:comp/env/persistence以下にすることが推奨されています。

<persistence-context-ref>タグのそのほかのタグについては，「5.6.1　アプリケーションにEntityManagerをインジェクトする方法」と同じです。ただし，JNDIルックアップでEntityManager を取得する場合，<injection-target>は指定しません。なお，拡張スコープのEntityManagerのルックアップは，Stateful Session Beanからできます。

次に，web.xmlに<persistence-context-ref>を定義する例を示します。

...
<web-app>
  ...
  <servlet>
    <display-name>InventoryManagerServlet</display-name>
    <servlet-name>InventoryManagerServlet</servlet-name>
    <servlet-class>com.hitachi.InventoryManagerServlet</servlet-class>
  </servlet>
  ...
  <persistence-context-ref>
    <description>
      Persistence context for the inventory management application.
    </description>
    <persistence-context-ref-name>
      persistence/InventoryAppMgr
    </persistence-context-ref-name>
    <persistence-unit-name>InventoryManagement</persistence-unit-name>
    <persistence-context-type>Transaction</persistence-context-type>
  </persistence-context-ref>
  ...
</web-app>
...