Hitachi

JP1 Version 12 JP1/Navigation Platform ナビゲーション プラットフォーム 開発ガイド


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 入出力プラグイン(サンプル)の使用方法」を参照してください。

入出力プラグインとガイドパーツの前提

処理の概要

実装例

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;
}