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

クラス BizLogicTag

java.lang.Object
jakarta.servlet.jsp.tagext.TagSupport
jakarta.servlet.jsp.tagext.BodyTagSupport
org.opengion.hayabusa.taglib.CommonTagSupport
org.opengion.hayabusa.taglib.BizLogicTag
すべての実装されたインタフェース:
BodyTag, IterationTag, JspTag, Tag, TryCatchFinally, Serializable
public class BizLogicTag extends CommonTagSupport
業務ﾛｼﾞｯｸを呼び出すためのﾀｸﾞです。 logics属性に呼び出す業務ﾛｼﾞｯｸのｸﾗｽ名を記述します。 このﾀｸﾞでは、複数の業務ﾛｼﾞｯｸを1度に呼び出すことができ、 DB接続のcommit,rollbackは一番最後に、1度のみ実行されます。 各業務ﾛｼﾞｯｸは、記述した順番に呼び出されます。 業務ﾛｼﾞｯｸは、AbstractBizLogicを 継承したｻﾌﾞｸﾗｽである必要があります。 標準ｻﾌﾞｸﾗｽとして、BizLogic_ENTRYとBizLogic_TABLE を用意しています。 BizLogic_ENTRY は、ﾊﾟﾗﾒｰﾀｰのみを使用する業務ﾛｼﾞｯｸです。 BizLogic_TABLE は、配列型ﾃｰﾌﾞﾙﾓﾃﾞﾙをﾒｲﾝｶｰｿﾙとした業務ﾛｼﾞｯｸです。 配列型ﾃｰﾌﾞﾙﾓﾃﾞﾙでは、初期処理、ﾙｰﾌﾟ処理、後処理とﾒｿｯﾄﾞがｺｰﾙされます。 fstchk() 変更区分に関わらず 処理を始める前に呼び出し first() 変更区分に関わらず 最初の行でのみ呼び出し useLoop == true befall( int row ) 変更区分に関わらず 各行について呼び出し(insert,modify,deleteの前に呼び出し) insert( int row ) 変更区分が"A"の場合 各行について呼び出し modify( int row ) 変更区分が"C"の場合 各行について呼び出し delete( int row ) 変更区分が"D"の場合 各行について呼び出し allrow( int row ) 変更区分に関わらず 各行について呼び出し(insert,modify,deleteの後に呼び出し) last() 変更区分に関わらず 最後の行でのみ呼び出し 業務ﾛｼﾞｯｸｸﾗｽについては、ﾎｯﾄﾃﾞﾌﾟﾛｲ機能により、動的ｺﾝﾊﾟｲﾙ、ｸﾗｽﾛｰﾄﾞが 行われます。 業務ﾛｼﾞｯｸのｿｰｽﾃﾞｨﾚｸﾄﾘは、ｼｽﾃﾑﾘｿｰｽの BIZLOGIC_SRC_PATH で定義されます。 また、同様にｸﾗｽﾃﾞｨﾚｸﾄﾘは、ｼｽﾃﾑﾘｿｰｽの BIZLOGIC_CLASS_PATH で定義されます。 さらに、ｼｽﾃﾑﾘｿｰｽの BIZLOGIC_HOTDEPLOY を false に設定することで、動的ｺﾝﾊﾟｲﾙ ｸﾗｽﾛｰﾄﾞを行わなくすることもできます。 この場合、予めｺﾝﾊﾟｲﾙされたｸﾗｽを、初回呼び出し時に1回のみﾛｰﾄﾞされます。 SystemData の USE_SQL_INJECTION_CHECK が true か、quotCheck 属性が true の場合は、 ＳＱＬｲﾝｼﾞｪｸｼｮﾝ対策用のｼﾝｸﾞﾙｸｫｰﾄﾁｪｯｸを行います。ﾘｸｴｽﾄ引数に ｼﾝｸﾞﾙｸｫｰﾄ(')が含まれると、ｴﾗｰになります。 同様にUSE_XSS_CHECKがtrueか、xssCheck属性がtrueの場合は、 ｸﾛｽｻｲﾄｽｽｸﾘﾌﾟﾃｨﾝｸﾞ(XSS)対策のためless/greater than signのﾁｪｯｸを行います。 ※ このﾀｸﾞは、Transaction ﾀｸﾞの対象です。
関連項目:
変更履歴:
5.1.1.0 (2009/12/01) 新規作成
機能分類
業務ﾛｼﾞｯｸ
形式ｻﾝﾌﾟﾙ:
●形式： <og:bizLog logics = "業務ﾛｼﾞｯｸのｸﾗｽ名" command = "ENTRY" scope = "session" dbid = "DEFAULT" tableId = "DEFAULT" selectedAll = "false" modifyType = "A" keys = "SYSTEM_ID" vals = "{@SYSTEM_ID}" /> ●body：なし ●Tag定義： <og:bizLogic logics ○【TAG】実行する業務ﾛｼﾞｯｸ名を指定します (必須) command 【TAG】ｺﾏﾝﾄﾞをｾｯﾄします (初期値:ENTRY) scope 【TAG】ｷｬｯｼｭする場合のｽｺｰﾌﾟ[request/session/application]を指定します (初期値:session) dbid 【TAG】(通常は使いません)Queryｵﾌﾞｼﾞｪｸﾄを作成する時のDB接続IDを指定します (初期値:null) tableId 【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのｷｰを指定します selectedAll 【TAG】ﾃﾞｰﾀを全件選択済みとして処理するかどうか[true/false]を指定します (初期値:false) modifyType 【TAG】DB検索時の ﾓﾃﾞｨﾌｧｲﾀｲﾌﾟを指定します[A:追加/C:更新/D:削除] keys 【TAG】ﾘﾝｸ先に渡すｷｰをCSV形式で複数指定します vals 【TAG】ﾘﾝｸ先に渡す値をCSV形式で複数指定します stopError 【TAG】処理ｴﾗｰの時に処理を中止するかどうか[true/false]を設定します (初期値:true) dispError 【TAG】ｴﾗｰ時にﾒｯｾｰｼﾞを表示するか[true/false]を設定します。通常はstopErrorと併用 (初期値:true) quotCheck 【TAG】ﾘｸｴｽﾄ情報の ｼﾝｸﾞﾙｸｫｰﾄ(') 存在ﾁｪｯｸを実施するかどうか[true/false]を設定します (初期値:USE_SQL_INJECTION_CHECK[=true]) xssCheck 【TAG】ﾘｸｴｽﾄ情報の HTMLTag開始/終了文字(><) 存在ﾁｪｯｸを実施するかどうか[true/false]を設定します (初期値:USE_XSS_CHECK[=true]) multi 【TAG】vals属性でﾊﾟﾗﾒｰﾀｰを取得する際、複数件存在する場合に、値を連結するかどうかを指定します (初期値:false) debug 【TAG】ﾃﾞﾊﾞｯｸﾞ情報を出力するかどうか[true/false]を指定します (初期値:false) /> ●使用例 <!-- 業務ﾛｼﾞｯｸの呼び出しを行います --> <og:bizLogic logics="org.opengion.logic.gf9110.BizLogic_0001" keys="SYSTEM_ID" vals="{@MEM.SYSTEM_ID}" />
導入されたバージョン:
JDK1.6,

  • フィールド詳細

  • コンストラクタの詳細

    • BizLogicTag

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

  • メソッドの詳細

    • doStartTag

      public int doStartTag()
      Taglibの開始ﾀｸﾞが見つかったときに処理する doStartTag() を ｵｰﾊﾞｰﾗｲﾄﾞします。
      定義:
      doStartTag インタフェース内 Tag
      オーバーライド:
      doStartTag クラス内 CommonTagSupport
      戻り値:
      後続処理の指示(SKIP_BODY)
      変更履歴:
      5.3.4.0 (2011/04/01) command=ENTRY以外ではDBTableModelの処理を行わない。, 6.4.8.1 (2016/07/02) xssCheckを、doStartTag に移動

    • doEndTag

      public int doEndTag()
      Taglibの終了ﾀｸﾞが見つかったときに処理する doEndTag() を ｵｰﾊﾞｰﾗｲﾄﾞします。
      定義:
      doEndTag インタフェース内 Tag
      オーバーライド:
      doEndTag クラス内 CommonTagSupport
      戻り値:
      後続処理の指示
      変更履歴:
      5.1.8.0 (2010/07/01) isMulti対応, 5.3.4.0 (2011/04/01) command=ENTRY以外ではDBTableModelの処理を行わない。, 6.4.8.1 (2016/07/02) xssCheckを、doStartTag に移動, 5.9.26.1 (2017/11/10) dispErrorの処理追加, 8.3.1.0 (2022/10/14) 正常終了時、過去のｴﾗｰﾒｯｾｰｼﾞが消えない不具合対応

    • release2

      protected void release2()
      ﾀｸﾞﾘﾌﾞｵﾌﾞｼﾞｪｸﾄをﾘﾘｰｽします。 ｷｬｯｼｭされて再利用されるので、ﾌｨｰﾙﾄﾞの初期設定を行います。
      オーバーライド:
      release2 クラス内 CommonTagSupport
      変更履歴:
      5.1.8.0 (2010/07/01) isMultiを追加, 5.1.9.0 (2010/08/01) Transaction 対応, 5.9.26.1 (2017/11/10) dispError追加, 8.0.2.0 (2021/11/30) srcDir,classDir static定義定数を使用

    • setCommand

      public void setCommand(String cmd)
      【TAG】ｺﾏﾝﾄﾞをｾｯﾄします(初期値:ENTRY)。
      パラメータ:
      cmd - ｺﾏﾝﾄﾞ (public static final 宣言されている文字列)
      関連項目:
      説明:
      command=ENTRY以外ではDBTableModelの処理を行いません。 ｺﾏﾝﾄﾞは、HTMLから[get/post]指定されますので、CMD_xxx で設定される ﾌｨｰﾙﾄﾞ定数値のいづれかを、指定できます。

    • setLogics

      public void setLogics(String lgs)
      【TAG】実行する業務ﾛｼﾞｯｸ名を指定します。
      パラメータ:
      lgs - 業務ﾛｼﾞｯｸ名
      説明:
      実行する業務ﾛｼﾞｯｸ名を指定します。業務ﾛｼﾞｯｸ名は、ｸﾗｽ名を指定します。 ｸﾗｽ名については、ｸﾗｽ自身の名称のみを指定することができます。 (ﾊﾟｯｹｰｼﾞ名を含めた完全な形のｸﾗｽ名を指定することもできます) また、CSV形式で、複数指定することもできます。 この場合、指定した順番に処理されます。

    • setDbid

      public void setDbid(String id)
      【TAG】(通常は使いません)Queryｵﾌﾞｼﾞｪｸﾄを作成する時のDB接続IDを指定します(初期値:null)。
      パラメータ:
      id - ﾃﾞｰﾀﾍﾞｰｽ接続ID
      説明:
      Queryｵﾌﾞｼﾞｪｸﾄを作成する時のDB接続IDを指定します。 これは、ｼｽﾃﾑﾘｿｰｽで、DEFAULT_DB_URL 等で指定している ﾃﾞｰﾀﾍﾞｰｽ接続先 情報に、XX_DB_URL を定義することで、 dbid="XX" とすると、この接続先を使用して ﾃﾞｰﾀﾍﾞｰｽにｱｸｾｽできます。

    • setTableId

      public void setTableId(String id)
      【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのｷｰを指定します (初期値:HybsSystem#TBL_MDL_KEY[=])。
      パラメータ:
      id - ﾃｰﾌﾞﾙID (sessionに登録する時のID)
      説明:
      検索結果より、DBTableModelｵﾌﾞｼﾞｪｸﾄを作成します。これを、下流のviewﾀｸﾞ等に 渡す場合に、通常は、session を利用します。その場合の登録ｷｰです。 query ﾀｸﾞを同時に実行して、結果を求める場合、同一ﾒﾓﾘに配置される為、 この tableId 属性を利用して、ﾒﾓﾘ空間を分けます。 (初期値:HybsSystem#TBL_MDL_KEY[=])。

    • setSelectedAll

      public void setSelectedAll(String all)
      【TAG】ﾃﾞｰﾀを全件選択済みとして処理するかどうか[true/false]を指定します(初期値:false)。
      パラメータ:
      all - ﾃﾞｰﾀを全件選択済み [true:全件選択済み/false:通常]
      説明:
      全てのﾃﾞｰﾀを選択済みﾃﾞｰﾀとして扱って処理します。 全件処理する場合に、(true/false)を指定します。 初期値は false です。

    • setModifyType

      public void setModifyType(String type)
      【TAG】DB検索時の ﾓﾃﾞｨﾌｧｲﾀｲﾌﾟを指定します[A:追加/C:更新/D:削除]。
      パラメータ:
      type - ﾓﾃﾞｨﾌｧｲﾀｲﾌﾟ [A:追加/C:更新/D:削除]
      説明:
      DB検索時に、そのﾃﾞｰﾀをA(追加)、C(更新)、D(削除)のﾓﾃﾞｨﾌｧｲﾀｲﾌﾟを つけた状態にします。 その状態で、そのまま、update する事が可能になります。

    • setKeys

      public void setKeys(String key)
      【TAG】ﾘﾝｸ先に渡すｷｰをCSV形式で複数指定します。
      パラメータ:
      key - ﾘﾝｸ先に渡すｷｰ(CSV形式)
      変更履歴:
      3.5.6.2 (2004/07/05) CommonTagSupport#getCSVParameter を使用
      説明:
      ﾘﾝｸ先に渡すｷｰを指定します。 Keysだけを指定して、Valsを指定しない場合、Keysで指定された項目名に対応するﾊﾟﾗﾒｰﾀｰを取得し、 Valsとして使用します。

    • setVals

      public void setVals(String val)
      【TAG】ﾘﾝｸ先に渡す値をCSV形式で複数指定します。
      パラメータ:
      val - ﾘﾝｸ先に渡す値(CSV形式)
      変更履歴:
      3.5.6.2 (2004/07/05) CommonTagSupport#getCSVParameter を使用, 5.1.8.0 (2010/07/01) isMuitl対応
      説明:
      ﾘﾝｸ先に渡す値を指定します。 Keysだけを指定して、Valsを指定しない場合、Keysで指定された項目名に対応するﾊﾟﾗﾒｰﾀｰを取得し、 Valsとして使用します。 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。 こうしないとﾃﾞｰﾀ自身にｶﾝﾏを持っている場合に分解をﾐｽる為です。

    • setStopError

      public void setStopError(String flag)
      【TAG】処理ｴﾗｰの時に処理を中止するかどうか[true/false]を設定します(初期値:true)。
      パラメータ:
      flag - 処理の中止 [true:中止する/false:中止しない]
      説明:
      false(中止しない)に設定する場合、後続処理では、{@DB.ERR_CODE}の値により、 PLSQL/SQLの異常/正常終了によって分岐処理は可能となります。 初期値は、true(中止する)です。

    • setDispError

      public void setDispError(String flag)
      【TAG】PLSQL/SQL処理ｴﾗｰの時にｴﾗｰを画面表示するか[true/false]を設定します(初期値:true)。
      パラメータ:
      flag - [true:表示する/false:表示しない]
      変更履歴:
      5.9.26.1 (2017/11/10) 新規追加
      説明:
      false(表示しない)に設定する場合、後続処理では、{@DB.ERR_MSG}の値により、 本来表示されるはずだったﾒｯｾｰｼﾞを取得可能です。 stopErrorと併用して、JSON形式でｴﾗｰを返す場合等に利用します。 初期値は、true(表示する)です。

    • setQuotCheck

      public void setQuotCheck(String flag)
      【TAG】ﾘｸｴｽﾄ情報の ｼﾝｸﾞﾙｸｫｰﾄ(') 存在ﾁｪｯｸを実施するかどうか[true/false]を設定します (初期値:USE_SQL_INJECTION_CHECK[=])。
      パラメータ:
      flag - ｸｫｰﾄﾁｪｯｸ [true:する/それ以外:しない]
      関連項目:
      説明:
      ＳＱＬｲﾝｼﾞｪｸｼｮﾝ対策の一つとして、暫定的ではありますが、SQLのﾊﾟﾗﾒｰﾀに 渡す文字列にｼﾝｸﾞﾙｸｫｰﾄ(') を許さない設定にすれば、ある程度は防止できます。 数字ﾀｲﾌﾟの引数には、 or 5=5 などのｼﾝｸﾞﾙｸｫｰﾄを使用しないｺｰﾄﾞを埋めても、 数字ﾁｪｯｸで検出可能です。文字ﾀｲﾌﾟの場合は、必ず (')をはずして、 ' or 'A' like 'A のような形式になる為、(')ﾁｪｯｸだけでも有効です。 (') が含まれていたｴﾗｰにする(true)／かﾉｰﾁｪｯｸか(false)を指定します。 (初期値:ｼｽﾃﾑ定数のUSE_SQL_INJECTION_CHECK[=])。

    • setXssCheck

      public void setXssCheck(String flag)
      【TAG】ﾘｸｴｽﾄ情報の HTMLTag開始/終了文字(><) 存在ﾁｪｯｸを実施するかどうか[true/false]を設定します (初期値:USE_XSS_CHECK[=])。
      パラメータ:
      flag - XSSﾁｪｯｸする [true:ﾁｪｯｸする/false:しない]
      関連項目:
      説明:
      ｸﾛｽｻｲﾄｽｸﾘﾌﾟﾃｨﾝｸﾞ(XSS)対策の一環としてless/greater than signについてのﾁｪｯｸを行います。 (><) が含まれていたｴﾗｰにする(true)／かﾉｰﾁｪｯｸか(false)を指定します。 (初期値:ｼｽﾃﾑ定数のUSE_XSS_CHECK[=])。

    • setMulti

      public void setMulti(String flag)
      【TAG】vals属性でﾊﾟﾗﾒｰﾀｰを取得する際、複数件存在する場合に、値を連結するかどうかを指定します(初期値:false)。
      パラメータ:
      flag - 値連結 [true:する/false:しない]
      変更履歴:
      5.1.8.0 (2010/07/01) 新規作成
      説明:
      この属性がtrueに指定された場合、ﾊﾟﾗﾒｰﾀｰが複数存在する場合に、ｶﾝﾏで連結します。 初期値は、false(連結しない)です。

    • getParameterRows

      protected int[] getParameterRows()
      表示ﾃﾞｰﾀの HybsSystem.ROW_SEL_KEY を元に、選ばれた 行を処理の対象とします。
      オーバーライド:
      getParameterRows クラス内 CommonTagSupport
      戻り値:
      選択行の配列

    • toString

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