クラス ViewAjaxTreeParamTag

  • すべての実装されたインタフェース:
    java.io.Serializable, BodyTag, IterationTag, JspTag, Tag, TryCatchFinally

    public class ViewAjaxTreeParamTag
    extends ViewParamImpl
    viewタグの viewFormType が HTMLAjaxTreeTable の場合にパラメータを設定します。 ツリービューを表示する、ViewForm_HTMLAjaxTreeTable クラスに対して、各種パラメータを 設定します。 パラメータが設定されていない場合は、ViewAjaxTreeTableParam の初期値が使用されます。 (パラメータを使用するには、viewタグのuseParam 属性をtrueに設定する必要があります。) ここで定義された子データを取得するためのJSPは、別に作成する必要があります。 また、levelClmに設定されたカラムは、レベルと展開を表示するための画像イメージが表示されます。 展開レベルに応じて階層を視覚的に表示する場合は、levelClmに設定されたカラムのレンデラーを 定義して下さい。 (例:LVLのコードリソースとして、1→- 2→-- 3→--- 等) 各属性は、{@XXXX} 変数が使用できます。 これは、ServletRequest から、XXXX をキーに値を取り出し,この変数に割り当てます。 つまり、このXXXXをキーにリクエストすれば、この変数に値をセットすることができます。 http://localhost/query.jsp?KEY1=VLA1&KEY2=VAL2 のようなリクエストで、{@KEY1} とすれば、 VAL1 がセットされます。
    関連項目:
    直列化された形式
    機能分類
    画面表示
    形式サンプル:
    ●形式:<og:ajaxTreeParam keys="YYY,XXX,ZZZ" childJsp="getChildTag.jsp" /> ●body:なし ●Tag定義: <og:ajaxTreeParam childSearchKeys 【TAG】子データを取得するためのJSPに渡す引数のカラム名をセットします(初期値:"") childSearchJsp 【TAG】子データを取得するためのJSPをセットします(初期値:"getChildTag.jsp") levelClm 【TAG】階層レベルとして処理(展開を制御するための画像イメージを表示)するカラム名をセットします(初期値:"LVL") imgCollapsed 【TAG】折りたたまれた状態を表現するための画像ファイル名をセットします(初期値:"/jsp/image/collapsed.gif") imgExpanded 【TAG】展開された状態を表現するための画像ファイル名をセットします(初期値:"/jsp/image/expanded.gif") imgNoSub 【TAG】展開後子データが存在しない状態を表現するための画像ファイル名をセットします(初期値:"/jsp/image/nosub.gif") expandAll 【TAG】初期状態で全展開を行うかを指定します(初期値:false=全展開しない) childViewStartNo 【TAG】子データを表示するためのStartNoを指定します(初期値:-1) expCtrlClm 【TAG】初期全展開した際に最下位の要素の状態(展開済 or 下位あり)を制御するためのカラムを指定します(初期値:EXPAND_CONTROL) debug 【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false) /> ●使用例 ViewFormTag の viewFormType が、HTMLAjaxTreeTable の場合に使用します。 useParam 属性を設定しておかないと、使用されません。 <og:view viewFormType = "HTMLAjaxTreeTable" command = "{@command}" startNo = "0" pageSize = "20" useParam = "true" > <og:ajaxTreeParam childSearchkeys = "YYY,XXX,ZZZ" childSearchJsp = "getChildTag.jsp" levelClm = "LVL" imgCollapsed = "collapsed.gif" imgExpanded = "expanded.gif" imgNoSub = "nosub.gif" /> </og:view >
    バージョン
    4.0
    作成者
    Hiroki Nakamura
    導入されたバージョン:
    JDK5.0,
    • コンストラクタの詳細

      • ViewAjaxTreeParamTag

        public ViewAjaxTreeParamTag()
        デフォルトコンストラクター
        変更履歴:
        6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
    • メソッドの詳細

      • setChildSearchKeys

        public void setChildSearchKeys​(java.lang.String keys)
        【TAG】子データを取得するためのJSPに渡す引数のカラム名をセットします(初期値:"")。
        パラメータ:
        keys - 子データ検索カラム
        説明:
        子データを取得するためのJSPに渡す引数のカラム名をセットします。 親データから子データを展開する際に、ここで設定されたキーの値をDBTableModelから 取得し、子データ検索用のJSPに渡します。 子データ検索用のJSPでは通常のリクエスト変数({@カラム名})として値を取得することが可能です。
      • setChildSearchJsp

        public void setChildSearchJsp​(java.lang.String jsp)
        【TAG】子データを取得するためのJSPをセットします(初期値:"getChildTag.jsp")。
        パラメータ:
        jsp - JSPファイル名
        説明:
        子データを取得するためのJSPをセットします。 このJSPで子データを取得し、viewタグでHTML出力した結果をパースし、子データとして 親データの直下に要素を挿入します。 子データ検索用のJSPでは通常のリクエスト変数({@カラム名})として値を取得することが可能です。
      • setLevelClm

        public void setLevelClm​(java.lang.String clm)
        【TAG】階層レベルとして処理(展開を制御するための画像イメージを表示)するカラム名をセットします(初期値:"LVL")。
        パラメータ:
        clm - レベルカラム
        説明:
        階層レベルとして処理(展開を制御するための画像イメージを表示)するカラム名をセットします。 子データを取得した際に、ここで指定されたカラムは、親レベルに対して自動的に+1されます。
      • setImgCollapsed

        public void setImgCollapsed​(java.lang.String img)
        【TAG】折りたたまれた状態を表現するための画像ファイル名をセットします(初期値:"/jsp/image/collapsed.gif")。
        パラメータ:
        img - 画像ファイル名
        説明:
        折りたたまれた状態を表現するための画像ファイル名をセットします。 「折りたたまれた状態」とは、未展開の状態、及び展開後に折りたたんだ状態の両方を指します。
      • setImgExpanded

        public void setImgExpanded​(java.lang.String img)
        【TAG】展開された状態を表現するための画像ファイル名をセットします(初期値:"/jsp/image/expanded.gif")。
        パラメータ:
        img - 画像ファイル名
        説明:
        展開された状態を表現するための画像ファイル名をセットします。
      • setImgNoSub

        public void setImgNoSub​(java.lang.String img)
        【TAG】展開後子データが存在しない状態を表現するための画像ファイル名をセットします(初期値:"/jsp/image/nosub.gif")。
        パラメータ:
        img - 画像ファイル名
        説明:
        展開後子データが存在しない状態を表現するための画像ファイル名をセットします。
      • setExpandAll

        public void setExpandAll​(java.lang.String flag)
        【TAG】初期状態で全展開を行うかを指定します(初期値:false=全展開しない)。
        パラメータ:
        flag - 全展開を行うか [true:行う/false:行わない]
        説明:
        初期状態で全展開を行うかを指定します。DBTableModel上のデータが展開済みのデータ であると仮定し、全展開を行った状態で表示します。 ※ この属性をtrueに指定しても子データ取得用のJSPが再帰的に呼び出される訳では ありません。子データの取得は、予めqueryで行っておく必要があります。
        変更履歴:
        4.3.3.0 (2008/10/01) 新規作成
      • setChildViewStartNo

        public void setChildViewStartNo​(java.lang.String no)
        【TAG】子データを表示するためのStartNoを指定します(初期値:-1)。
        パラメータ:
        no - 子データ表示開始番号
        説明:
        子データを取得するためのJSP内で使用します。 子データを取得し、元のDBTableModelにマージした後、子データのみを表示するため、 ここでstartNoを指定して差分データを表示します。
        変更履歴:
        4.3.3.0 (2008/10/01) 新規作成
      • setExpCtrlClm

        public void setExpCtrlClm​(java.lang.String key)
        【TAG】初期全展開した際に最下位の要素の状態(展開済 or 下位あり)を制御するためのカラムを指定します(初期値:EXPAND_CONTROL)。
        パラメータ:
        key - 最下位展開 [0,false:展開済/1,true:未展開]
        説明:
        初期全展開した際に最下位の要素の状態(展開済 or 下位あり)を制御するためのカラムを指定します。 ここで指定されたカラムの値により、全展開された結果の最下位の要素の状態指定することができます。 この機能を利用することで、第3レベルまで存在するデータの内、第2レベルまでを展開しておく、 ということを実現することができます。 ここで指定したカラムが持つ値の意味は以下の通りです。 '0' or 'false' 展開済 (初期値) '1' or 'true' 未展開 ※展開ボタンを押すことで更に下位展開が可能 なお、この機能は、全展開時(expandAll="true")のみ有効であり、通常の第1レベル展開の場合は、 このカラムは無視されます。
        変更履歴:
        4.3.5.0 (2008/02/01) 新規作成
      • getTagName

        protected java.lang.String getTagName()
        タグの名称を、返します。 自分自身のクラス名より、自動的に取り出せないため、このメソッドをオーバーライドします。
        オーバーライド:
        getTagName クラス内 CommonTagSupport
        戻り値:
        タグの名称
        関連項目:
        CommonTagSupport.getDocumentLink()
        変更履歴:
        4.3.1.0 (2008/09/03) 新規追加
        このメソッドは、nullを返しません