27.2 Enterprise Beanクラスを作成する

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

目次索引

第3部 EJB編

> 第27章 Message-driven Bean編

27.2 Enterprise Beanクラスを作成する

　Enterprise Beanクラスは、ユーザがインタフェースで定義した ejbCreateメソッドおよびビジネスメソッドを実装します。

　Apworksを使用して開発を行った場合、ApdesignerまたはコンポーネントデザイナによりEnterprise Beanクラスのひな形が自動生成されます。

　以下に、Enterprise Beanクラスの記述の形式を示します。

■ 記述形式

public class Enterprise Bean名

implements javax.ejb.MessageDrivenBean, javax.jms.MessageListener {

    
    ・・・
    
    public void ejbCreate() {
    ・・・
    }
    public void ejbRemove() {
    ・・・
    }
・・・
    public void onMessage(javax.jms.Message msg) {
    ・・・
    }
}

■ 規約

　Enterprise Beanクラスは以下の規約を満たしていなければなりません。

javax.ejb.MessageDrivenBeanインタフェースを実装していなければなりません。
javax.jms.MessageListenerインタフェースを実装していなければなりません。
publicとして定義されていなければなりません。finalやabstractとして定義してはいけません。
パラメタを取らないpublicコンストラクタをもつ必要があります。
finalizeメソッドを定義してはなりません。
ejbCreateメソッドを実装しなければなりません。
スーパークラスを持ったり、インタフェースを実装することができます。
スーパークラスにejbCreateメソッドやその他のMessageDrivenBeanインタフェースやMessageListenerのインタフェースを実装することができます。
Enterprise Beanクラスは、EJB仕様に定められたメソッドのほかにも、メソッド(ビジネスメソッドが内部で呼び出すヘルパーメソッドなど)を実装できます。

　ejbCreate、onMessage、ejbRemoveには、以下の規約があります。

◆ ejbCreateの規約

　ejbCreateは以下の規約を満たしていなければなりません。

メソッド名は ejbCreateでなければなりません。
メソッドは publicとして定義されていなければなりません。
メソッドはfinalやstaticで定義してはなりません。
返却値は voidでなければなりません。
引数を持ってはなりません。
throws句には任意のアプリケーション固有の例外を定義してはなりません。

◆ onMessageの規約

　onMessageは以下の規約を満たしていなければなりません。

メソッドは publicとして宣言されていなければなりません。
メソッドはfinalやstaticで定義してはなりません。
返却値は voidでなければなりません。
メソッド引数は、javax.jms.Message型の引数を一つだけ定義しなければなりません。
throws句には任意のアプリケーション固有の例外を定義してはなりません。

◆ ejbRemoveの規約

　ejbRemoveは以下の規約を満たしていなければなりません。

メソッド名は ejbRemoveでなければなりません。
メソッドは publicとして定義されていなければなりません。
メソッドはfinalやstaticで定義してはなりません。
返却値は voidでなければなりません。
引数を持ってはなりません。
throws句には任意のアプリケーション固有の例外を定義してはなりません。

■ その他のメソッドについて

　ejbCreate、onMessage、ejbRemove以外に、Enterprise Beanクラスには、コンテナが処理の各フェーズで呼び出す以下のメソッドがあります。このクラスにはユーザが任意の処理を指定できます。このメソッドは省略できません。

　以下に使用できるメソッドを示します。

メソッド名	内容
setMessageDrivenContext	コンテナによって保守されているコンテキストへのアクセスを与えます。

■ MessageDrivenContextインタフェースのメソッド

　MessageDrivenContextは、コンテナによって保守されているコンテキストへのアクセスを与えます。このインタフェースは、setSessionContextのパラメタとして指定することにより取得できます。それにより SessionContextより拡張される EJBContextインタフェースのメソッドを使用できます。

　以下に使用できるメソッドの一覧を示します。

メソッド名	内容
setRollbackOnly()	カレントトランザクションを“rollback”にマークします。
getRollbackOnly()	そのトランザクションが“rollback only”でマークされているか判定します。
getUserTransaction()	トランザクション区別インタフェースを取得します。

27.2.1 記述例
27.2.2 Enterprise Beanクラスのメソッドが実行可能な操作

目次索引