5.5.2 getParamValueメソッド
入出力プラグインのメソッドの引数paramに格納されるMapオブジェクトから,指定したパラメタのキャッシュ値を取得するメソッドです。
結線しているガイドパーツが,ラジオボタン,チェックボックス,またはハイパーリンクの場合は,キャッシュ値を取得する際,ラベル部分を含めた値全体を取得するか,ラベル部分を除外した値を取得するかを指定できます。
(1) 形式
形式1
public static String getParamValue(Map<String, Object> param, String paramName);
形式2
public static String getParamValue(Map<String, Object> param, String paramName, boolean withLabel);
(2) 引数
(a) param
inputFromNodeメソッドの第2引数(param)に渡されるMapオブジェクトを指定します。
(b) paramName
キャッシュ値を取得するパラメタ名を指定します。
(c) withLabel
パラメタのキャッシュ値を取得する際,ラベルを含めた値全体を取得するかどうかを指定します。なお,このメソッドを形式1で使用する場合は「false」が仮定されます。
-
true
ラベルを含めた値全体がそのまま返されます。
-
false
結線しているガイドパーツの種類に応じて,次の表に示す値が返されます。
表5‒11 ガイドパーツの種類と取得する値 項番
ガイドパーツの種類
取得する値
1
固定テキスト
キャッシュ値
2
画像
キャッシュ値
3
テキストボックス
キャッシュ値
4
テキストエリア
キャッシュ値
5
ラジオボタン
■[ラベル情報も格納]がチェック状態の場合
キャッシュ値
■[ラベル情報も格納]が未チェック状態の場合
キャッシュ値のラベル部分(先頭から改行コード(\r\n)まで)を除外した値
6
チェックボックス
■[ラベル情報も格納]がチェック状態の場合
キャッシュ値
■[ラベル情報も格納]が未チェック状態の場合
キャッシュ値のラベル部分(先頭から改行コード(\r\n)まで)を除外した値
7
ドロップダウン
キャッシュ値
8
ハイパーリンク
キャッシュ値のラベル部分(先頭から改行コード(\r\n)まで)を除外した値
9
インラインフレーム
キャッシュ値
(3) 戻り値
指定したパラメタのキャッシュ値が返されます。
(4) 例外
なし
(5) 使用例
入出力プラグインのサンプルを使用して,executeメソッド内で,getParamValueメソッドを使用する例を説明します。
入出力プラグインのサンプルについては,「付録A.1 入出力プラグイン(サンプル)の使用方法」を参照してください。
入出力プラグインとガイドパーツの前提
-
ラジオボタン1(ラベル:Label1,値:Value1),ラジオボタン2(ラベル:Label2,値:Value2),ラジオボタン3(ラベル:Label3,値:Value3)から入出力プラグインの入力パラメタ「inputItemName1」に結線
-
チェックボックス(ラベル:CheckboxLabel,値:trueまたはfalse)から入出力プラグインの入力パラメタ「inputItemName2」に結線
処理の概要
-
inputFromNodeメソッドでMapオブジェクトを取得する。
-
ラジオボタン1〜3の値を,ラベルを除外した値で取得する。
-
チェックボックスの値を,ラベルを含めた値のままで取得する。
実装例
public Map<String, Object> inputFromNode(HttpSession session, Map<String, Object> param) { Map<String, Object> map = new HashMap<String, Object>(); // ラベルを除外した値で取得 radioButtonValue = ParamConvertUtil.getParamValue(param, "inputItemName1"); // ラベルを含めた値で取得 checkBoxValue = ParamConvertUtil.getParamValue(param, "inputItemName2", true); return map; }