org.opengion.hayabusa.taglib

## クラス TableExistTag

- java.lang.Object
- - javax.servlet.jsp.tagext.TagSupport
  - - javax.servlet.jsp.tagext.BodyTagSupport
    - - org.opengion.hayabusa.taglib.CommonTagSupport
      - - org.opengion.hayabusa.taglib.TableExistTag

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

  非推奨です。
  代わりに dataCheckタグを使用してください

      @Deprecated
      public class TableExistTag
      extends CommonTagSupport

  【廃止】登録すべきデータのマスタ存在チェックを行うためのタグです(通常はentry.jspでupdateタグの直前で使用します)。 この要素の内容に、SQL文を記述します。 names に対応するカラム名を、カンマ区切りで複数与えます。その値を、DBTableModel より、取得し、先のSQL文の ? に値を設定します。 または、引数部に、[カラム名]を用いたHybs拡張SQL文を指定することも可能です。 値の取得は、先に選択された行のみについて、実行されます。 exist 属性に指定された 、｢true:存在する｣、｢false:存在しない｣、｢one:ひとつ以下｣、 の値は、チェック方法を設定しています。 いずれの場合も、成立時は、正常とみなします。 (｢true:存在する｣ には、データが存在した場合に、ＯＫで、なければエラーです。)
  関連項目:
    直列化された形式
  形式サンプル:

         ●形式：
               ・<og:tableExist
                            command   = "{@command}"
                            names     = "[…]"
                            from      = "…"                           必須
                            where     = "…"                           必須
                            exist     = "[auto|true|false|one|notuse]" 必須
                            errRemove = "[true|false]"
                 />

         ●body：なし

         ●Tag定義：
           <og:tableExist
               command            【廃止】コマンド(ENTRY)をセットします
               scope              【TAG】キャッシュする場合のスコープ[request/page/session/applicaton]を指定します(初期値:session)
               names              【廃止】引数にセットすべき データの名称(カラム名)をCSV形式で複数指定します
               from             ○【廃止】チェックするデータベース名(from 句)を指定します(必須)。
               where            ○【廃止】チェックする検索条件(where句)を指定します(必須)。
               exist              【廃止】データベースのチェック方法(auto/true/false/one/notuse)を指定します(初期値:｢auto:自動｣)
               tableId            【廃止】(通常は使いません)結果をDBTableModelに書き込んで、sessionに登録するときのキーを指定します
               dbid               【廃止】(通常は使いません)Queryオブジェクトを作成する時のDB接続IDを指定します
               errRemove          【廃止】エラー時の選択行を取り除いて継続処理を行うかどうか[true/false]を指定します(初期値:false)
               debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
           />

         ●使用例
               ・<og:tableExist
                            command = "{@command}"
                            names   = "USERID,SYSTEM_ID"
                            from    = "GE10"
                            where   = "USERID=? AND SYSTEM_ID=?"
                            exist   = "true"         />

                  ・where 条件の ? 文字に、names で指定したカラム名の値が、DBTableModelより
                    取得されます。
                    値の取得は、先に選択された行のみについて、実行されます。
                  ・exist 属性の値に応じて、チェック方法が異なります。
                    auto , true , false , one , notuse が指定できます。
                  ・テーブルは、１つのみ指定できます。複数指定や、UNIONで結合する場合は、
                    ビュー等を作成して対応してください。

               ・<og:tableExist
                            command = "{@command}"
                            from    = "GE10"
                            where   = "USERID=[USERID] AND SYSTEM_ID=[SYSTEM_ID]"  />

                  ・where 条件の [カラム名] 文字に、DBTableModelより値がセットされます。
                  ・exist は、初期値(auto)になります。内部のA,C,Dに応じて自動判別します。

  変更履歴:

    3.5.0.0 (2003/09/17) 新規作成

  機能分類
    (廃止)ＤＢ登録
  バージョン
    4.0
  作成者
    Kazuhiko Hasegawa
  導入されたバージョン:
    JDK5.0,

- - ### フィールドのサマリー

    フィールド
    修飾子とタイプ | フィールドと説明
    --- | ---
    `static java.lang.String` | `CMD_ENTRY` 非推奨です。 command 引数に渡す事の出来る コマンド エントリー "ENTRY"

    - ### クラスから継承されたフィールド javax.servlet.jsp.tagext.BodyTagSupport

      `bodyContent`

    - ### クラスから継承されたフィールド javax.servlet.jsp.tagext.TagSupport

      `id, pageContext`

    - ### インタフェースから継承されたフィールド javax.servlet.jsp.tagext.BodyTag

      `EVAL_BODY_BUFFERED, EVAL_BODY_TAG`

    - ### インタフェースから継承されたフィールド javax.servlet.jsp.tagext.IterationTag

      `EVAL_BODY_AGAIN`

    - ### インタフェースから継承されたフィールド javax.servlet.jsp.tagext.Tag

      `EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE`

  - ### コンストラクタのサマリー

    コンストラクタ
    コンストラクタと説明
    `TableExistTag()` 非推奨です。

  - ### メソッドのサマリー

    メソッド
    修飾子とタイプ | メソッドと説明
    --- | ---
    `int` | `doEndTag()` 非推奨です。 Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
    `int` | `doStartTag()` 非推奨です。 Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
    `protected void` | `release2()` 非推奨です。 タグリブオブジェクトをリリースします。
    `void` | `setCommand(java.lang.String cmd)` 非推奨です。 クラスが廃止されました。
    `void` | `setDbid(java.lang.String id)` 非推奨です。 クラスが廃止されました。
    `void` | `setErrRemove(java.lang.String flag)` 非推奨です。 クラスが廃止されました。
    `void` | `setExist(java.lang.String ext)` 非推奨です。 クラスが廃止されました。
    `void` | `setFrom(java.lang.String fm)` 非推奨です。 クラスが廃止されました。
    `void` | `setNames(java.lang.String nm)` 非推奨です。 クラスが廃止されました。
    `void` | `setTableId(java.lang.String id)` 非推奨です。 クラスが廃止されました。
    `void` | `setWhere(java.lang.String wr)` 非推奨です。 クラスが廃止されました。
    `java.lang.String` | `toString()` 非推奨です。 このオブジェクトの文字列表現を返します。

    - ### クラスから継承されたメソッド org.opengion.hayabusa.taglib.CommonTagSupport

      `add, add, addEventColumn, addEventColumn, check, check, commitTableObject, debugPrint, doAfterBody, doCatch, doFinally, get, getApplicationInfo, getAttributes, getBodyRawString, getBodyString, getContextAttribute, getContextPath, getCookie, getCSVParameter, getDataCondition, getDateFormat, getDBColumn, getDBFunctionName, getDocumentLink, getGUIInfo, getGUIInfoAttri, getHostName, getLabel, getLabelInterface, getLanguage, getLASTAttri, getLongLabel, getMsglbl, getNVLAttri, getObject, getParameterNames, getParameterRows, getRequest, getRequestAttribute, getRequestCacheData, getRequestMethod, getRequestParameter, getRequestParameterValues, getRequestValue, getRequestValue, getRequestValues, getReservedParameter, getReservedValue, getResource, getSanitizedBodyString, getScope, getSessionAttribute, getTagName, getUser, getUserEditInfo, getUserInfo, isAjaxSubmitRequest, isDebug, isNoTransitionRequest, isNull, jspPrint, removeContextAttribute, removeObject, removeRequestAttribute, removeSessionAttribute, set, setAjaxSubmitRequest, setCaseKey, setCaseNN, setCaseNull, setCaseVal, setContextAttribute, setCookie, setDebug, setLanguage, setLbl, setNoTransitionRequest, setObject, setObject, setParameterNames, setParameterRows, setRequestAttribute, setRequestCacheData, setScope, setSessionAttribute, setUserInfo, startQueryTransaction, sys, sysBool, sysInt, useMainTrans, useQuotCheck, useTag, useXssCheck`

    - ### クラスから継承されたメソッド javax.servlet.jsp.tagext.BodyTagSupport

      `doInitBody, getBodyContent, getPreviousOut, release, setBodyContent`

    - ### クラスから継承されたメソッド javax.servlet.jsp.tagext.TagSupport

      `findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue`

    - ### クラスから継承されたメソッド java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

    - ### インタフェースから継承されたメソッド javax.servlet.jsp.tagext.Tag

      `getParent, setPageContext, setParent`

- - ### フィールドの詳細

    - #### CMD_ENTRY

          public static final java.lang.String CMD_ENTRY

      非推奨です。
      command 引数に渡す事の出来る コマンド エントリー "ENTRY"
      関連項目:
        定数フィールド値

  - ### コンストラクタの詳細

    - #### TableExistTag

          public TableExistTag()

      非推奨です。

  - ### メソッドの詳細

    - #### doStartTag

          public int doStartTag()

      非推奨です。
      Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
      定義:
        `doStartTag` インタフェース内 `Tag`
      オーバーライド:
        `doStartTag` クラス内 `CommonTagSupport`
      戻り値:
        後続処理の指示(SKIP_BODY)
      変更履歴:

        3.7.1.0 (2005/04/15) notuse 値を追加

    - #### doEndTag

          public int doEndTag()

      非推奨です。
      Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
      定義:
        `doEndTag` インタフェース内 `Tag`
      オーバーライド:
        `doEndTag` クラス内 `CommonTagSupport`
      戻り値:
        後続処理の指示
      変更履歴:

        3.5.4.2 (2003/12/15) HTMLTableViewForm クラス名変更(⇒ ViewForm_HTMLTable)
        3.5.4.4 (2004/01/16) エラー結果を表示するテーブル形式のフォーム修正
        3.5.5.2 (2004/04/02) TaglibUtil.makeHTMLErrorTable メソッドを利用

    - #### release2

          protected void release2()

      非推奨です。
      タグリブオブジェクトをリリースします。 キャッシュされて再利用されるので、フィールドの初期設定を行います。
      オーバーライド:
        `release2` クラス内 `CommonTagSupport`
      変更履歴:

        4.0.0.0 (2007/10/10) dbid の初期値を、"DEFAULT" から null に変更

    - #### setTableId

          @Deprecated
          public void setTableId(java.lang.String id)

      非推奨です。 クラスが廃止されました。
      【廃止】(通常は使いません)結果をDBTableModelに書き込んで、sessionに登録するときのキーを指定します。
      パラメータ:
        `id` - sessionに登録する時の ID
      説明:

             (初期値:HybsSystem#TBL_MDL_KEY[={@og.value org.opengion.hayabusa.common.HybsSystem#TBL_MDL_KEY}])。

    - #### setDbid

          @Deprecated
          public void setDbid(java.lang.String id)

      非推奨です。 クラスが廃止されました。
      【廃止】(通常は使いません)Queryオブジェクトを作成する時のDB接続IDを指定します。
      パラメータ:
        `id` - データベース接続ID
      説明:

             Queryオブジェクトを作成する時のDB接続IDを指定します。

    - #### setCommand

          @Deprecated
          public void setCommand(java.lang.String cmd)

      非推奨です。 クラスが廃止されました。
      【廃止】コマンド(ENTRY)をセットします。
      パラメータ:
        `cmd` - コマンド(public static final 宣言されている文字列)
      関連項目:
        コマンド定数
      説明:

             コマンドは,HTMLから(get/post)指定されますので,CMD_xxx で設定される
             フィールド定数値のいづれかを、指定できます。

    - #### setNames

          @Deprecated
          public void setNames(java.lang.String nm)

      非推奨です。 クラスが廃止されました。
      【廃止】引数にセットすべき データの名称(カラム名)をCSV形式で複数指定します。
      パラメータ:
        `nm` - 引数の名称(複数ある場合は、カンマ区切り文字)
      説明:

             複数ある場合は、カンマ区切り文字で渡します。
             引数をnames ではなく、[カラム名]形式で直接指定するほうが、SQL文が判りやすくなります。

    - #### setFrom

          @Deprecated
          public void setFrom(java.lang.String fm)

      非推奨です。 クラスが廃止されました。
      【廃止】チェックするデータベース名(from 句)を指定します。
      パラメータ:
        `fm` - データベースID
      説明:

             from 句 に指定するデータベース名です。

    - #### setWhere

          @Deprecated
          public void setWhere(java.lang.String wr)

      非推奨です。 クラスが廃止されました。
      【廃止】チェックする検索条件(where句)を指定します。
      パラメータ:
        `wr` - 検索条件(where句)
      説明:

             where 区 に指定する検索条件です。? の部分に、names 属性で指定した
             カラムのデータが、DBTableModelより取り出されて適用されます。
             または、[カラム名]形式で、直接指定することもできます。その場合は、
             name 属性は指定する必要がありません。
             [カラム名]の前後に、(')シングルコーテーションは、不要です。

    - #### setExist

          @Deprecated
          public void setExist(java.lang.String ext)

      非推奨です。 クラスが廃止されました。
      【廃止】データベースのチェック方法(auto/true/false/one/notuse)を指定します(初期値:｢auto:自動｣)。
      パラメータ:
        `ext` - チェック方法(｢auto:自動｣、｢true:存在する｣、｢false:存在しない｣、｢one:ひとつ以下｣、｢notuse:チェックしない｣)
      説明:

             exist 属性に指定された 、｢true:存在する｣、｢false:存在しない｣、｢one:ひとつ以下｣、
             の値は、いずれの場合も、成立時は、正常とみなします。
             ｢auto:自動｣は、DBTableModeleのmodifyType(A,C,D)に応じて、チェックします。
             A,C,D は、entryタグにコマンドを渡してデータを作成したときに、内部で作成されます。
             notuse は、チェックを行いません。これは、このタグを共有使用する場合に、外部で
             チェックを行うかどうかを指定できるようにするために使用します。
             (｢true:存在する｣ には、データが存在した場合に、ＯＫで、なければエラーです。)
             初期値は、｢auto:自動｣です。

    - #### setErrRemove

          @Deprecated
          public void setErrRemove(java.lang.String flag)

      非推奨です。 クラスが廃止されました。
      【廃止】エラー時の選択行を取り除いて継続処理を行うかどうか[true/false]を指定します(初期値:false)。
      パラメータ:
        `flag` - エラー時の継続処理 [true:エラー行番号を取り除き継続処理/false:エラー時停止]
      説明:

             exist 属性に指定された 、｢true:存在する｣、｢false:存在しない｣、｢one:ひとつ以下｣、
             に対して、エラーが発生した選択行番号を、取り除いて以下の処理を継続するかどうかを
             指定します。
             true に設定した場合は、エラーデータを削除し、継続処理を行うことができます。
             flase の場合は、エラーデータを表示して、継続処理を停止します。
             初期値は、｢false:エラー時停止｣です。

    - #### toString

          public java.lang.String toString()

      非推奨です。
      このオブジェクトの文字列表現を返します。 基本的にデバッグ目的に使用します。
      オーバーライド:
        `toString` クラス内 `CommonTagSupport`
      戻り値:
        このクラスの文字列表現

Webアプリケーションフレームワーク openGion
Copyright (c) 2009 The openGion Project.