Ajaxフレームワーク ユーザーズガイド

3.2.3 ビジネスメソッドの実行

JavaScriptでApcoordinatorのビジネスクラスを呼び出すには、UjiRequestオブジェクトのsend関数を使用します。

■UjiRequest.send関数の形式

以下に、関数の記述形式を示します。

UjiRequest.send(dataObj, requestParams, option);

• dataObj
  サーバ側に送信するデータのオブジェクトです。
  データを送信しない場合は、nullを指定します。

• requestParams
  コマンド名やデータBean IDなど、Apcoordinatorの動作を制御するための値を格納したリクエストパラメタオブジェクトです。
  リクエストパラメタが不要な場合は、nullを指定します。

  以下に、リクエストパラメタオブジェクトのプロパティを示します。

  プロパティ名	概要	型	省略可否
  beanId	送信データを格納するデータBean ID Ajaxフレームワーク環境定義ファイルに定義されたデータBeanの名前を指定します。	string	dataObjがnullの場合は省略可 それ以外の場合は省略不可
  verb	コマンド名	string	可

• option
  UjiRequestの動作を制御するための値を格納した通信設定オブジェクトです。
  optionにnullが指定された場合、または省略された場合は、通信せずにエラーが発生します。

  以下に、通信設定オブジェクトのプロパティを示します。

  プロパティ名	概要	型	省略可否
  url	通信先のURL 固定で“acf/apc”を指定します。 URLには、任意のクエリ文字列やURLリライティングで使用するセションIDを付加することができます。詳細は、“リクエスト送信時のURLについて”を参照してください。	string	不可
  callback	レスポンスハンドラ(正常終了時のコールバック) 戻り値がある場合は、第1引数に渡されます。voidの場合は、パラメタなしで呼ばれます。	function	不可
  errorHandler	エラーハンドラ(エラー発生時のコールバック) 第1引数にエラーオブジェクトが渡されます。 詳細は、“通信フレームワーク内のエラー”を参照してください。	function	可
  timeout	タイムアウト時間(ミリ秒) サーバからのレスポンスが完了するまでの最大待ち時間です。この時間を超えると、エラーハンドラ呼出しとなります。	number	可
  preInvoke	メソッド呼出し直前に呼ばれるコールバック 引数はありません。	function	可
  postInvoke	メソッド呼出し完了直後に呼ばれるコールバック 引数はありません。	function	可

  以下に、通信設定オブジェクトのプロパティに関する注意事項を示します。

  • 各種コールバック関数がnullの場合、コールバック呼出しは行われません。
  • プロパティの型がfunctionとなっているものは、JavaScriptの関数を指定します。
    以下に、callbackプロパティにレスポンスハンドラを記述する例を示します。

    var option = {
      ...,
      // サーバからの戻り値を引数に指定
      // 引数の名前は任意
      callback:function(res){
        // サーバからの戻り値に対する処理を記述
        ...;
      }
    };

    
    

■UjiRequest.send関数が通知する例外

UjiRequest.send関数が通知する例外については、“通信フレームワーク(JavaScript)に関するメッセージ”を参照してください。