Interstage Application Server/Interstage Web Server J2EE ユーザーズガイド

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

　LocalHomeインタフェースは、Java VM内で呼ばれるインタフェースであるためRMIの形で記述する必要はありません。

　LocalHomeインタフェースには、クライアントよりEJB local objectをcreateするためのメソッドを定義します。
　ビジネスメソッドで利用する固有の型も定義できます。

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

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

■ 記述形式

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

■ 規約

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

• LocalHomeインタフェースはjavax.ejb.EJBLocalHomeインタフェースを継承しなければなりません。
• Localインタフェースに定義されたメソッドのthrows句にはjava.rmi.RemoteExceptionを定義してはなりません。
• Localインタフェースは、スーパーインタフェースを持つことができます。
• LocalHomeインタフェースは、1つ以上のcreateメソッドを定義します。
  各createメソッドは、createで始まる任意の名前でなければなりません。
  また、Enterprise Beanクラスに定義されたejbCreateメソッドの1つに一致しなくてはなりません。
  一致するejbCreateメソッドは引数の数と型が同じでなければなりません(返却値は違っていてもかまいません)。
• createメソッドの返却値のタイプは、Enterprise BeanのLocalインタフェースタイプでなければなりません(Enterprise BeanクラスのejbCreateメソッドの返却値はvoid固定です)。
• Enterprise BeanクラスのejbCreateメソッドに定義されたすべての例外は、一致するcreateメソッドのthrows句に定義されなければなりません。また、throws句には、javax.ejb.CreateExceptionを含まなければなりません。

---

12.3.1 記述例

12.3.2 使用できるメソッド