Interstage Application Server/Interstage Web Server J2EE ユーザーズガイド
目次 索引 前ページ次ページ

第3部 EJB編> 第13章 Entity Beanの実装

13.3 LocalHomeインタフェースの作成

 LocalHomeインタフェースには、Entity Beanの生成および検索を行うためのメソッドを定義します。

 LocalHomeインタフェースは、Java VM内で呼ばれるインタフェースであるためRMIの形で記述する必要はありません。
 また、EJB2.0規約以降に準拠したEJBアプリケーションでは、BMPとCMP2.0においてejbHomeメソッドと呼ばれるビジネスメソッドをLocalHomeインタフェースに記述できます。LocalHomeインタフェースには、“create”、“find”、“remove”以外で始まる任意の名前を記述できます。

 例えば、データベースのレコード件数を取得するビジネスメソッドなどが記述できるため、データベース操作をより自由にできます。

 以下に、LocalHomeインタフェースの記述形式を示します。

■ 記述形式

      public interface LocalHomeインタフェース名 extends javax.ejb.EJBLocalHome
      {
          public Remoteインタフェースタイプ create(任意の引数)
                      throws javax.ejb.CreateException; 

          public Remoteインタフェースタイプ create<METHOD>(任意の引数)
                      throws javax.ejb.CreateException; 

          public Remoteインタフェースタイプ findByPrimaryKey(primary key)
                      throws javax.ejb.FinderException; 

          public Remoteインタフェースタイプ find<METHOD>(任意の引数)
                      throws javax.ejb.FinderException; 

          public java.util.Enumeration find<METHOD>(任意の引数)
                      throws javax.ejb.FinderException; 

          public java.util.Collection find<METHOD>(任意の引数)
                      throws javax.ejb.FinderException; 

          public 返却値 ビジネスメソッド(任意の引数) ; 

      }

■ 規約

 LocalHomeインタフェースは以下の規約を満たしていなければなりません。

◆ createメソッドの規約

 createメソッドは、インスタンスを生成するためのメソッドです。createメソッドが呼び出されることによって、INSERT文が実行され、データベースに新しい行が追加されます。

 なお、EJB2.0規約以降に準拠したEJBアプリケーションでは、BMPだけcreateで始まる任意の名前を記述できます。これにより、createメソッド名に意味のある名前を記述できるため、EJBアプリケーションをわかりやすく作成できます。

 createメソッドは以下の規約を満たしていなければなりません。

◆ finderメソッドの規約

 finderメソッドは、特定のインスタンス、またはインスタンスの集合を検索するためのメソッドです。finderメソッドに指定した引数を検索条件にしたSELECT文が実行されます。

 finderメソッドは以下の規約を満たしていなければなりません。


下へ13.3.1 記述例
下へ13.3.2 使用できるメソッド

目次 索引 前ページ次ページ

Copyright 2008 FUJITSU LIMITED