パッケージ org.opengion.hayabusa.taglib

クラス PopupTag

java.lang.Object
jakarta.servlet.jsp.tagext.TagSupport
jakarta.servlet.jsp.tagext.BodyTagSupport
org.opengion.hayabusa.taglib.CommonTagSupport
org.opengion.hayabusa.taglib.HTMLTagSupport
org.opengion.hayabusa.taglib.PopupTag
すべての実装されたインタフェース:
BodyTag, DynamicAttributes, IterationTag, JspTag, Tag, TryCatchFinally, Serializable
public class PopupTag extends HTMLTagSupport
ﾃｷｽﾄﾌｨｰﾙﾄﾞの入力を補助するﾎﾟｯﾌﾟｱｯﾌﾟを作成します。 通常のﾃｷｽﾄﾌｨｰﾙﾄﾞに組み込むｹｰｽと、一覧表に組み込むｹｰｽに対応しています。 基本的には、columnMarker ﾀｸﾞと同じ使い方ですが、ﾌｨｰﾙﾄﾞが書き込み許可時に表示させる必要が あるため、実際には、viewMarker の isRendere="false" で使用するｹｰｽが多いと思います。 なお、ﾎﾟｯﾌﾟｱｯﾌﾟ専用なので href="index.jsp" がﾃﾞﾌｫﾙﾄで設定されています。
関連項目:
変更履歴:
3.8.6.1 (2006/10/20) 新規作成
機能分類
画面部品
形式ｻﾝﾌﾟﾙ:
●形式：<og:popup gamenId="…" href="…" keys="…,…" vals="…,…" rtnKeys="…,…" /> ●body：なし ●Tag定義： <og:popup gamenId 【TAG】画面ID属性を登録します useGamenId 【TAG】GAMENID 属性を付加するかどうか[true/false]を設定します(初期値:true) 7.0.4.0 (2019/05/31) href 【TAG】ﾎﾟｯﾌﾟｱｯﾌﾟ先のURLを指定します(初期値:index.jsp) keys 【TAG】ﾎﾟｯﾌﾟｱｯﾌﾟ先に渡す入力ｷｰ配列をCSV形式で複数指定します vals 【TAG】ﾎﾟｯﾌﾟｱｯﾌﾟ先に渡す値配列をCSV形式で複数指定します rtnKeys 【TAG】ﾎﾟｯﾌﾟｱｯﾌﾟ先より受け取るｷｰ配列をCSV形式で複数指定します column 【TAG】ﾘﾝｸをつけたいｶﾗﾑを指定します onMark 【TAG】ﾘﾝｸを張る(true or 1)/張らない(false or 0)の設定を指定します(初期値:true) markList 【TAG】処理するﾏｰｸを、"|"区切りの文字列で指定します height 【TAG】ﾀﾞｲｱﾛｸﾞの縦幅をﾋﾟｸｾﾙ数で指定します width 【TAG】ﾀﾞｲｱﾛｸﾞの横幅をﾋﾟｸｾﾙ数で指定します src 【TAG】表示させる画像のURLを指定します title 【HTML】要素に対する補足的情報(title)を設定します accesskey 【HTML】ｱｸｾｽｷｰ(alt+ｷｰで直接指定)を割り当てます clazz 【HTML】要素に対して class 属性を設定します lbl 【TAG】ﾗﾍﾞﾙﾘｿｰｽのﾗﾍﾞﾙIDを指定します language 【TAG】ﾀｸﾞ内部で使用する言語ｺｰﾄﾞ[ja/en/zh/…]を指定します command 【TAG】(通常は使いません)処理の実行を指定する command を設定できます(初期値:NEW) append 【TAG】返ってきた値をｷｬﾚｯﾄ位置に追記するかどうか(初期値：false) useSpan 【TAG】buttonではなくspanﾀｸﾞでﾎﾟｯﾌﾟｱｯﾌﾟを指定するかどうか[true/false]を設定します(初期値:false) 7.0.3.0 (2019/05/13) useAttStrict 【TAG】XHTMLTag に指定されている Attributes のみ使えるかどうか [true/false]を指定します(初期値:true) caseKey 【TAG】このﾀｸﾞ自体を利用するかどうかの条件ｷｰを指定します(初期値:null) caseVal 【TAG】このﾀｸﾞ自体を利用するかどうかの条件値を指定します(初期値:null) caseNN 【TAG】指定の値が、null/ｾﾞﾛ文字列 でない場合(Not Null=NN)は、このﾀｸﾞは使用されます(初期値:判定しない) caseNull 【TAG】指定の値が、null/ｾﾞﾛ文字列 の場合は、このﾀｸﾞは使用されます(初期値:判定しない) caseIf 【TAG】指定の値が、true/TRUE文字列の場合は、このﾀｸﾞは使用されます(初期値:判定しない) debug 【TAG】ﾃﾞﾊﾞｯｸﾞ情報を出力するかどうか[true/false]を指定します(初期値:false) /> ●使用例 ・普通のﾎﾟｯﾌﾟｱｯﾌﾟ <og:popup gamenId="GE0002" href="index.jsp" keys="AAA,BBB,CCC" vals="{@AAA},{@B},ABC" rtnKeys="DDD,EEE" /> ・QUERYの入力ﾌｨｰﾙﾄﾞに組み込む ①keys、vals、rtnKeys がｾｯﾄされる場合 ｾｯﾄされる keys に対して vals の値をﾎﾟｯﾌﾟｱｯﾌﾟ画面に渡し、ﾎﾟｯﾌﾟｱｯﾌﾟ画面の戻り値を rtnKeys にｾｯﾄされます。 <og:column name="AAA" > <og:popup gamenId="GE0002" keys="AAA,BBB,CCC" vals="{@AAA},{@B},ABC" rtnKeys="DDD,EEE" /> </og:column> ②keys、vals、rtnKeys がｾｯﾄされない場合 ﾎﾟｯﾌﾟｱｯﾌﾟ画面にﾘｸｴｽﾄ変数 XNAME に外側のｶﾗﾑ名、XVALUE にｶﾗﾑの入力値、rtnKeys にｶﾗﾑ名を自動的にｾｯﾄされます。 <og:column name="AAA" > <og:popup gamenId="GE0002" /> </og:column> ・RESULTの入力ﾌｨｰﾙﾄﾞに組み込む(viewMarker 経由) gamenId を指定しなければこの画面へのURLを作成します。 このURLは、その画面の index.jsp に直接ｼﾞｬﾝﾌﾟするためのURLです。 <og:viewMarker command="{@command}" isRenderer="false"> <og:popup gamenId="GE0002" column="ABC" onMark="[ABC]" markList="1|2|3" keys="AAA,BBB,CCC" vals="[AAA],[BBB].value,{@CCC}" rtnKeys="DDD,EEE" /> </og:viewMarker> ・ﾎﾟｯﾌﾟｱｯﾌﾟ側のJSPﾌｧｲﾙ(view 部分) <og:view viewFormType = "HTMLTable" command = "{@command}" selectedType = "radio" popupReturnKeys = "DDD,EE" />
導入されたバージョン:
JDK1.1,

  • コンストラクタの詳細

    • PopupTag

      public PopupTag()
      ﾃﾞﾌｫﾙﾄｺﾝｽﾄﾗｸﾀｰ
      変更履歴:
      6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.

  • メソッドの詳細

    • doEndTag

      public int doEndTag()
      Taglibの終了ﾀｸﾞが見つかったときに処理する doEndTag() を ｵｰﾊﾞｰﾗｲﾄﾞします。
      定義:
      doEndTag インタフェース内 Tag
      オーバーライド:
      doEndTag クラス内 HTMLTagSupport
      戻り値:
      後続処理の指示
      変更履歴:
      5.2.2.0 (2010/11/01) caseKey、caseVal 属性対応, 8.5.3.0 (2023/09/08) DynamicAttributes対応

    • makeTag

      protected String makeTag()
      使用しません。
      定義:
      makeTag クラス内 HTMLTagSupport
      戻り値:
      (null 固定)

    • release2

      protected void release2()
      ﾀｸﾞﾘﾌﾞｵﾌﾞｼﾞｪｸﾄをﾘﾘｰｽします。 ｷｬｯｼｭされて再利用されるので、ﾌｨｰﾙﾄﾞの初期設定を行います。
      オーバーライド:
      release2 クラス内 HTMLTagSupport
      変更履歴:
      7.0.3.0 (2019/05/13) GAMENIDの追加(useGamenIdで、GAMENID属性をhrefに追加), 8.5.3.0 (2023/09/08) HTML5廃止対応

    • setGamenId

      public void setGamenId(String id)
      【TAG】画面ID を指定します。
      パラメータ:
      id - 画面ID
      説明:
      gamenId 属性は、画面IDをｷｰに、実ｱﾄﾞﾚｽを求めるのに使用します。 画面IDが指定された場合は、実ｱﾄﾞﾚｽに変換する。指定されない場合は、 href 属性をそのままﾘﾝｸ情報を作成します。 画面IDを指定する場合の href は、JSPﾌｧｲﾙ名(例えば、index.jsp 等)です。

    • setUseGamenId

      public void setUseGamenId(String flag)
      【TAG】GAMENID 属性を付加するかどうか[true/false]を設定します(初期値:true)。
      パラメータ:
      flag - GAMENID 属性を付加するかどうか [true:追加する/false:追加しない]
      変更履歴:
      7.0.3.0 (2019/05/13) GAMENIDの追加(useGamenIdで、GAMENID属性をhrefに追加), 7.0.4.0 (2019/05/31) 初期値を true に変更
      説明:
      "true"の場合は、GAMENID 属性を href に追加します。(?KEY1=VAL1&KEY2=VAL2･･･) "false"の場合は、付加しません。 popupなので、BACK_GAMENIDは付与しません。GAMENIDを付与することで、画面のﾛｰﾙやﾓｰﾄﾞを 考慮したﾎﾟｯﾌﾟｱｯﾌﾟが起動します。 初期値を他のﾀｸﾞと合わせるため、true にしています（互換性はありません）

    • setHref

      public void setHref(String href)
      【TAG】ﾎﾟｯﾌﾟｱｯﾌﾟ先のURLを指定します(初期値:index.jsp)。
      パラメータ:
      href - ﾎﾟｯﾌﾟｱｯﾌﾟ先のURL
      説明:
      通常、gamenId を指定している場合は、それ以降(index.jsp , result.jsp など)を指定します。 通常のﾘﾝｸの場合、GAMENID/href というｱﾄﾞﾚｽに合成されます。( GE0001/result.jsp など ) (正確には、画面IDではなく、対応する画面ADDRESSを使用します。) ﾎﾟｯﾌﾟｱｯﾌﾟ専用のﾘﾝｸなので、初期値は、index.jsp です。

    • setKeys

      public void setKeys(String key)
      【TAG】ﾎﾟｯﾌﾟｱｯﾌﾟ先に渡す入力ｷｰ配列をCSV形式で複数指定します。
      パラメータ:
      key - 渡す入力ｷｰ配列(CSV形式)
      説明:
      ﾎﾟｯﾌﾟｱｯﾌﾟ先に渡す入力ｷｰ配列を指定します。 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。 こうしないとﾃﾞｰﾀ自身にｶﾝﾏを持っている場合に分解をﾐｽる為です。

    • setVals

      public void setVals(String val)
      【TAG】ﾎﾟｯﾌﾟｱｯﾌﾟ先に渡す値配列をCSV形式で複数指定します。
      パラメータ:
      val - 渡す値配列(CSV形式)
      説明:
      ﾎﾟｯﾌﾟｱｯﾌﾟ先に渡す値配列を指定します。 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。 こうしないとﾃﾞｰﾀ自身にｶﾝﾏを持っている場合に分解をﾐｽる為です。

    • setRtnKeys

      public void setRtnKeys(String key)
      【TAG】ﾎﾟｯﾌﾟｱｯﾌﾟ先より受け取るｷｰ配列をCSV形式で複数指定します。
      パラメータ:
      key - 受け取るｷｰ配列(CSV形式)
      説明:
      ﾎﾟｯﾌﾟｱｯﾌﾟ先より受け取るｷｰ配列を指定します。 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。 こうしないとﾃﾞｰﾀ自身にｶﾝﾏを持っている場合に分解をﾐｽる為です。

    • setColumn

      public void setColumn(String clm)
      【TAG】ﾘﾝｸをつけたいｶﾗﾑを指定します。
      パラメータ:
      clm - ｶﾗﾑ名
      説明:
      このｶﾗﾑ名のTableModelに対して、ViewLink ﾀｸﾞが存在する場合は、 ﾘﾝｸを張ります。

    • setOnMark

      public void setOnMark(String flag)
      【TAG】ﾏｰｸを処理する(true or 1)/処理しない(false or 0)の設定を指定します(初期値:true)。
      パラメータ:
      flag - ﾏｰｸの処理 [true,1:処理する/それ以外:処理しない]
      変更履歴:
      3.5.0.0 (2003/09/17) onMark に、[ｶﾗﾑ名] の値をｾｯﾄできるように修正。
      説明:
      ﾏｰｸを処理する場合は、"true"(または "1") 処理しない場合は、"true以外"(または "0")をｾｯﾄします。 初期値は、"true"(ﾏｰｸを処理する)です。 さらに、[ｶﾗﾑ名] で、動的にｶﾗﾑの値で、ﾏｰｸをする、しないを 選ぶ事が可能になります。値は、"true"(または "1") で、ﾏｰｸします。 追記 3.5.2.0 (2003/10/20)：markList属性に、処理対象文字列郡を指定できます。 これにより、ﾏｰｸを処理するかどうかの判断が、true,1 以外にも使用できるようになりました。

    • setMarkList

      public void setMarkList(String list)
      【TAG】処理するﾏｰｸを含むような文字列を、"|"区切りの文字列で指定します(初期値:"true|TRUE|1")。
      パラメータ:
      list - 処理するﾏｰｸ (indexOf による含む/含まない判定)
      説明:
      markListで与えられた文字列に、onMark文字列(大文字/小文字の区別あり)が 含まれていれば、処理します。 例えば、"A","B","C" という文字列が、onMark で指定された 場合に処理するようにしたい場合は、"A|B|C" をｾｯﾄします。 markList には、[ｶﾗﾑ名]指定が可能です。(ただし、単独 linkﾀｸﾞ時は除く) 初期値は、"true|TRUE|1"です。

    • setHeight

      public void setHeight(String ht)
      【TAG】ﾀﾞｲｱﾛｸﾞの縦幅をﾋﾟｸｾﾙ数で指定します。
      パラメータ:
      ht - ﾀﾞｲｱﾛｸﾞの縦幅(ﾋﾟｸｾﾙ数)
      変更履歴:
      5.2.1.0 (2010/10/01) height、width には、"px" などの単位を付ける前提での対応
      説明:
      縦幅を指定します。単位も含めて入力してください。 設定しない場合は、ogPopup JavaScript の内部初期値が採用されます。

    • setWidth

      public void setWidth(String wh)
      【TAG】ﾀﾞｲｱﾛｸﾞの横幅をﾋﾟｸｾﾙ数で指定します。
      パラメータ:
      wh - ﾀﾞｲｱﾛｸﾞの横幅(ﾋﾟｸｾﾙ数)
      変更履歴:
      5.2.1.0 (2010/10/01) height、width には、"px" などの単位を付ける前提での対応
      説明:
      横幅を指定します。単位も含めて入力してください。 設定しない場合は、ogPopup JavaScript の内部初期値が採用されます。

    • setSrc

      public void setSrc(String src)
      【TAG】表示させる画像のURLを指定します。
      パラメータ:
      src - 画像のURL
      説明:
      この属性を設定すると、自動的に ｲﾒｰｼﾞﾘﾝｸでの onclick属性で ﾎﾟｯﾌﾟｱｯﾌﾟの起動画面を作成します。 この属性が設定されていない場合は、button での起動になります。

    • setCommand

      public void setCommand(String cmd)
      【TAG】(通常は使いません)処理の実行を指定する command を設定できます(初期値:NEW)。
      パラメータ:
      cmd - ｺﾏﾝﾄﾞ
      変更履歴:
      5.1.7.0 (2010/06/01) 新規作成
      説明:
      ここで指定されたcommandは、ﾎﾟｯﾌﾟｱｯﾌﾟ画面の引数として渡されます。 初期値は、NEW です。

    • setAppend

      public void setAppend(String flg)
      【TAG】返り値をｷｬﾚｯﾄ位置に追記する(true)/しない(false)の設定を指定します(初期値:false)。
      パラメータ:
      flg - 返り値のｷｬﾚｯﾄ位置に追記 [true:追記/それ以外:置換]
      変更履歴:
      5.8.5.0 (2015/02/06)
      説明:
      ﾎﾟｯﾌﾟｱｯﾌﾟからの返り値を、元の値と置換するのではなく、ｷｬﾚｯﾄ位置に挿入するかどうかを指定します。

    • setUseSpan

      public void setUseSpan(String flag)
      【TAG】buttonではなくﾃｷｽﾄでﾎﾟｯﾌﾟｱｯﾌﾟを指定するかどうか[true/false]を設定します(初期値:false)。
      パラメータ:
      flag - buttonではなくspanﾀｸﾞでﾎﾟｯﾌﾟｱｯﾌﾟするかどうか [true:する/false:しない]
      変更履歴:
      7.0.3.0 (2019/05/13) buttonではなくspanﾀｸﾞでpopupするかどうか[true/false]を決める属性を追加。
      説明:
      "true"の場合は、spanﾀｸﾞでﾎﾟｯﾌﾟｱｯﾌﾟのﾍﾞｰｽとなるﾀｸﾞを作成します。 false は従来通り、ﾎﾞﾀﾝでﾎﾟｯﾌﾟｱｯﾌﾟのﾍﾞｰｽを作成します。 srcを指定した場合は、imgﾀｸﾞでﾎﾟｯﾌﾟｱｯﾌﾟのﾍﾞｰｽを作成します。 互換性の関係から、初期値は、false にしています。

    • toString

      public String toString()
      このｵﾌﾞｼﾞｪｸﾄの文字列表現を返します。 基本的にﾃﾞﾊﾞｯｸﾞ目的に使用します。
      オーバーライド:
      toString クラス内 CommonTagSupport
      戻り値:
      このｸﾗｽの文字列表現
      このﾒｿｯﾄﾞは、nullを返しません