Apcoordinator ユーザーズガイド

3.1 ビジネスクラス

ビジネスクラスには、クライアントから入力したデータを処理するメソッドを作成します。ビジネスクラスを複数作成することも可能です。ビジネスクラスの例を示します。

package calc;
import com.fujitsu.uji.DispatchContext;

public class CalcHandler extends com.fujitsu.uji.GenericHandler
{

    public boolean init() {
        return true;
    }

    public void add(DispatchContext context, BodyBean dataBean) {
        double result = dataBean.getVal1() + dataBean.getVal2();
        dataBean.setMessage("加算を実行しました。");
        dataBean.setResult(result);
        dataBean.setVerb("resmode");
        context.setResponseBean("body", dataBean);
    }

    public void sub(DispatchContext context, BodyBean dataBean) {
        double result = dataBean.getVal1() - dataBean.getVal2();
        dataBean.setMessage("減算を実行しました。");
        dataBean.setResult(result);
        dataBean.setVerb("resmode");
        context.setResponseBean("body", dataBean);
    }

    public void next(DispatchContext context, BodyBean dataBean) {
        dataBean.setVerb("reqmode");
        context.setResponseBean("body", dataBean);
    }

    public void startup(DispatchContext context) {
        BodyBean dataBean = new BodyBean();
        dataBean.setVerb("reqmode");
        context.setResponseBean("body", dataBean);
    }
}

ビジネスクラスはcom.fujitsu.uji.Handler インタフェースを実装して作成してください。簡単に作成するにはcom.fujitsu.uji.GenericHandlerクラスを継承して作成することもできます。GenericHandlerクラスはHandlerインタフェースの簡単な実装を提供します。

入力データを処理するメソッドの引数は、次のようにします。

public void someMethod(com.fujitsu.uji.DispatchContext context, [入力データのクラス名] data);

ただし、入力データがnullの場合に呼び出されるメソッドは、次のようにDispatchContextクラスのみを引数とします。

public void someMethod(com.fujitsu.uji.DispatchContext context);

クライアントから入力するデータには次の4種類があり、アプリケーション種別ごとに使用する種類が異なります。

種類	説明	使用できるアプリケーション種別(*)
		Web	EJB	SOAP	電子フォーム	携帯端末
データBean	データをJavaBean形式のプロパティで保持するクラスです。詳細はデータBeanを参照してください。	○	○	-	○	○
XMLデータBean（com.fujitsu.uji.xml.XmlDataBeanクラス）	データをXMLで保持するクラスです。詳細はXMLデータの利用を参照してください。	○	○	○	○	-
FormデータBean（com.fujitsu.uji.formc.FormDataBeanクラス）	電子フォームアプリケーションにおいて、電子フォームのデータを保持するクラスです。詳細は電子フォームアプリケーションの開発を参照してください。	-	-	-	○	-
HashMap（java.util.HashMapクラス）	EJBセションBeanで使用します。詳細はHashMapによるデータの入力を参照してください。	-	○	-	-	-

(*)アプリケーション種別を以下のように省略して表記しています。

• Webアプリケーション → Web
• EJBセションBean → EJB
• SOAPサーバアプリケーション → SOAP
• 電子フォームアプリケーション → 電子フォーム
• 携帯端末対応アプリケーション → 携帯端末

欄内の記号は以下を表します。

• ○: その種類の入力データが使用できます。
• - : その種類の入力データは使用できません。

メソッドの返り値の型は、アプリケーションの種別やメソッドの用途によって異なります。以下を参照してください。

• Webアプリケーション、携帯端末対応アプリケーション: Webcoordinatorアプリケーションのファイル
• EJBセションBean: Javaソースファイルと関係定義ファイルの作成
• SOAPサーバアプリケーション: ビジネスクラスの開発
• 電子フォームアプリケーション: 電子フォームの表示

Handlerインタフェースのinitメソッドをオーバライドし返り値を変更することによって、ビジネスクラスのライフサイクルを以下から選択できます。

• initメソッドがtrueを返す場合: 最初にビジネスクラスが呼び出されたときにインスタンスが作成され、以降セションが終了するまで同じインスタンスが使用されます。この場合、セションが終了するときにビジネスクラスのdestroyメソッドが呼び出されます。
• initメソッドがfalseを返す場合: クライアントからのリクエストのたびにインスタンスが作成されます。

ビジネスクラスの作成方法に関する各アプリケーション種別に固有の解説については、以下を参照してください。

• Webアプリケーション、携帯端末対応アプリケーション: Webcoordinatorアプリケーションのファイル
• EJBセションBean: Javaソースファイルと関係定義ファイルの作成
• SOAPサーバアプリケーション: ビジネスクラスの開発
• 電子フォームアプリケーション: 電子フォームの表示