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

クラス FrameTag

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.FrameTag
すべての実装されたインタフェース:
BodyTag, DynamicAttributes, IterationTag, JspTag, Tag, TryCatchFinally, Serializable
直系の既知のサブクラス:
IframeTag
public class FrameTag extends HTMLTagSupport
ﾌﾚｰﾑを作成するHTML拡張ﾀｸﾞで、引数の受け渡しが可能です。
関連項目:
機能分類
画面部品
形式ｻﾝﾌﾟﾙ:
●形式：<og:frame src="…" name="…" /> ●body：なし ●Tag定義： <og:frame src ○【HTML】ﾌﾚｰﾑに表示するｿｰｽﾌｧｲﾙを指定します(必須)。 name ○【HTML】ﾌﾚｰﾑ名を指定します(例：QUERY,RESULT,CONTENTS など)(必須)。 changeGamen 【TAG】ｿｰｽ指定の画面を変更します changeHref 【TAG】forwardしたいJSPﾌｧｲﾙ名を記述します(例:result など) 7.4.2.0 (2021/05/14) keys 【TAG】引数のｷｰを指定します vals 【TAG】引数の値を指定します 7.4.3.0 (2021/06/11) dbTable 【TAG】前ﾍﾟｰｼﾞで選択したﾃﾞｰﾀ列の情報を次のﾍﾟｰｼﾞに渡すかどうか[true/false]を指定します(初期値:false) forceEnc 【TAG】(通常は使いません) valsの値が[で開始している場合でもURLEncodeを通すかを設定します(初期値:false) 5.10.15.3 (2019/09/27) clazz 【HTML】要素に対して class 属性を設定します title 【HTML】要素に対する補足的情報(title)を設定します useAttStrict 【TAG】XHTMLTag に指定されている Attributes のみ使えるかどうか [true/false]を指定します(初期値:true) caseKey 【TAG】このﾀｸﾞ自体を利用するかどうかの条件ｷｰを指定します(初期値:null) 5.7.7.2 (2014/06/20) caseVal 【TAG】このﾀｸﾞ自体を利用するかどうかの条件値を指定します(初期値:null) 5.7.7.2 (2014/06/20) caseNN 【TAG】指定の値が、null/ｾﾞﾛ文字列 でない場合(Not Null=NN)は、このﾀｸﾞは使用されます(初期値:判定しない) 5.7.7.2 (2014/06/20) caseNull 【TAG】指定の値が、null/ｾﾞﾛ文字列 の場合は、このﾀｸﾞは使用されます(初期値:判定しない) 5.7.7.2 (2014/06/20) caseIf 【TAG】指定の値が、true/TRUE文字列の場合は、このﾀｸﾞは使用されます(初期値:判定しない) debug 【TAG】ﾃﾞﾊﾞｯｸﾞ情報を出力するかどうか[true/false]を指定します(初期値:false) /> ●使用例： ・一般的な例：ﾌﾚｰﾑ分割する構文は、HTML準拠。ﾘｸｴｽﾄ変数は各ﾌﾚｰﾑまで転送されます。 <frameset> <og:frame src="query.jsp" name="QUERY" /> <og:frame src="forward.jsp" name="RESULT" /> </frameset> ・DBTableModel の値(例ではPN)を、取り出して、ﾘｸｴｽﾄ変数として利用します。 現状では、commonForward ﾀｸﾞ の useTableData="true" dbkeys="{@dbkeys}" 属性を利用します。 <frameset> <og:frame src="query.jsp" name="QUERY" keys="PN" dbTable="true" /> <og:frame src="forward.jsp" name="RESULT" keys="PN" dbTable="true" /> </frameset> ・changeGamen 属性を利用して、ｿｰｽ指定の画面を切り替えます。 たとえば、jsp/index.jsp では、GAMENID属性がURLに存在する場合、直接その画面を 表示させることができます。 <frameset cols="160,*,0" frameborder="1" framespacing="1"> <og:frame src="menu/menu.jsp" name="MENU" /> <og:frame src="GE0000/index.jsp" name="CONTENTS" keys="PN" vals="LKIS" changeGamen="{@GAMENID}" /> </frameset>
導入されたバージョン:
JDK5.0,

  • フィールド詳細

    • useForceEnc

      protected boolean useForceEnc
      強制URLｴﾝｺｰﾄﾞ用

  • コンストラクタの詳細

    • FrameTag

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

  • メソッドの詳細

    • release2

      protected void release2()
      ﾀｸﾞﾘﾌﾞｵﾌﾞｼﾞｪｸﾄをﾘﾘｰｽします。 ｷｬｯｼｭされて再利用されるので、ﾌｨｰﾙﾄﾞの初期設定を行います。
      オーバーライド:
      release2 クラス内 HTMLTagSupport
      変更履歴:
      2.0.0.4 (2002/09/27) ｶｽﾀﾑﾀｸﾞの release() ﾒｿｯﾄﾞを、追加, 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。, 5.10.15.3 (2019/09/27) forceEnc追加, 7.4.3.0 (2021/06/11) URL の引数にｾｯﾄする値を指定する

    • makeTag

      protected String makeTag()
      ﾘﾝｸを作成します。
      定義:
      makeTag クラス内 HTMLTagSupport
      戻り値:
      ﾘﾝｸﾀｸﾞ文字列
      変更履歴:
      3.5.4.0 (2003/11/25) comand="RENEW" 時には、dbTable 属性は、強制的に false とします。, 5.9.1.2 (2015/10/23) iframeとの継承関係で、共通的に呼び出すﾒｿｯﾄﾞを追加します。, 8.3.0.0 (2022/08/01) title 属性が未設定の場合、name 属性を設定する。
      このﾒｿｯﾄﾞは、nullを返しません

    • makeTagFrame

      protected String makeTagFrame(String urlEnc)
      ﾘﾝｸを作成します。
      パラメータ:
      urlEnc - ｴﾝｺｰﾄﾞされたURL
      戻り値:
      ﾘﾝｸﾀｸﾞ文字列
      変更履歴:
      5.9.1.2 (2015/10/23) iframeとの継承関係で、共通的に呼び出すﾒｿｯﾄﾞを追加します。
      このﾒｿｯﾄﾞは、nullを返しません

    • getUrlEncode

      protected String getUrlEncode()
      keys 属性 を元に、request情報より values の値を取り込む。 keys属性は ｷｰ情報がCSV形式になっている為、ばらして values属性の配列に一つづつ設定していきます。
      戻り値:
      URLｴﾝｺｰﾄﾞされた文字列
      変更履歴:
      2.0.0.2 (2002/09/24) 検索結果の値を取り込めていなかったﾊﾞｸﾞを修正。, 2.1.1.1 (2002/11/15) 選択行情報を取り込めていなかったﾊﾞｸﾞを修正。, 3.4.0.3 (2003/09/10) DBTableModelへのﾘｸｴｽﾄ情報をURLに連結しないように変更。, 4.0.0.0 (2005/01/31) getParameterRows() を使用するように変更, 5.10.15.3 (2019/09/27) forceEnc追加, 7.4.3.0 (2021/06/11) URL の引数にｾｯﾄする値を指定する, 8.5.4.2 (2024/01/12) PMD 7.0.0 SingularField 対応
      このﾒｿｯﾄﾞは、nullを返しません

    • setSrc

      public void setSrc(String src)
      【HTML】ﾌﾚｰﾑに表示するｿｰｽﾌｧｲﾙを指定します。
      パラメータ:
      src - ｿｰｽﾌｧｲﾙ
      説明:
      ﾌﾚｰﾑに表示するｿｰｽﾌｧｲﾙを指定します。 必須属性の為、DynamicAttributes を経由せず、tld属性に追加しています。 tld属性に追加した分は、ﾀｸﾞﾘﾌﾞのsetterﾒｿｯﾄﾞが必要です。

    • setName

      public void setName(String name)
      【HTML】ﾌﾚｰﾑ名を指定します(例：QUERY,RESULT,CONTENTS など)。
      パラメータ:
      name - ﾌﾚｰﾑ名
      説明:
      ﾌﾚｰﾑ名を指定します。 必須属性の為、DynamicAttributes を経由せず、tld属性に追加しています。 tld属性に追加した分は、ﾀｸﾞﾘﾌﾞのsetterﾒｿｯﾄﾞが必要です。

    • setChangeGamen

      public void setChangeGamen(String src)
      【TAG】ｿｰｽ指定の画面を変更します。
      パラメータ:
      src - 置換えｿｰｽ
      変更履歴:
      3.1.2.0 (2003/04/07) 画面IDと実画面ﾃﾞｨﾚｸﾄﾘとの関連見直し(DIRの代りにGAMENIDを推奨), 4.2.1.1 (2008/04/30) 画面切り替えをするのは、ｱﾄﾞﾚｽが設定されいる場合に限る
      説明:
      src 指定がﾃﾞﾌｫﾙﾄ設定で、changeGamen属性が設定されている 場合には、この値が優先されます。 changeGamen は、画面IDのみ指定してください。src には、このID＋"/index.jsp" が 追加されます。つまり、changeGamen="{@GAMENID}" という指定をしておけば、 FavoriteLinkTag 等で引数に GAMENID が指定された場合のみ、この属性が有効になり、 src="実画面ID/index.jsp" が指定されたことと同じ結果になります。 changeHref が指定され場合には、src="実画面ID/JSPID.jsp" が指定されたことと同じ 結果になります。

    • setChangeHref

      public void setChangeHref(String href)
      【TAG】ｿｰｽ指定の画面を変更します。
      パラメータ:
      href - 置換えｿｰｽ
      変更履歴:
      7.4.2.0 (2021/05/14) frameﾀｸﾞでforwardしたいJSPﾌｧｲﾙの指定ができるようにする
      説明:
      forwardしたいJSPﾌｧｲﾙ名を記述します。(例:result など) 初期値は "index.jsp" が設定されます。 実際には、各JSP画面(result.jsp )にﾘｸｴｽﾄが転送されます。 changeGamenとchangeHref が指定され場合には、src="実画面ID/JSPID.jsp" が 指定されたことと同じ結果になります。

    • setKeys

      public void setKeys(String key)
      【TAG】引数のｷｰを指定します。
      パラメータ:
      key - ｷｰ(CSV形式)
      説明:
      URL の引数にｾｯﾄするｷｰを CSV形式でｾｯﾄします。

    • setVals

      public void setVals(String val)
      【TAG】引数の値を指定します。
      パラメータ:
      val - 値(CSV形式)
      変更履歴:
      7.4.3.0 (2021/06/11) URL の引数にｾｯﾄする値を指定する
      説明:
      URL の引数にｾｯﾄする値を CSV形式でｾｯﾄします。

    • setDbTable

      public void setDbTable(String db)
      【TAG】前ﾍﾟｰｼﾞで選択したﾃﾞｰﾀ列の情報を次のﾍﾟｰｼﾞに渡すかどうか[true:渡す/false:渡さない]を指定します(初期値:false)。
      パラメータ:
      db - 選択ﾃﾞｰﾀを渡すかどうか [true:渡す/false:渡さない]
      説明:
      ただし、1行分のﾃﾞｰﾀのみです。(複数選択時は、最初の１件目) trueを指定すると、ﾃﾞｰﾀを渡します。falseの場合は、渡しません。 初期値は、false:渡さない です。

    • setForceEnc

      public void setForceEnc(String flg)
      【TAG】valsの値が[で開始している場合でもURLEncodeを通すかを設定します(初期値:false)。
      パラメータ:
      flg - URLEncodeを通す場合は、trueをｾｯﾄ
      変更履歴:
      5.10.15.3 (2019/09/27) forceEnc追加
      説明:
      ﾃｰﾌﾞﾙﾓﾃﾞﾙの値の変換のため、通常は先頭が[の場合はｴﾝｺｰﾄﾞがかかりません。 強制的にかける場合にtrueにします。

    • toString

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