概要 | パッケージ | クラス | 階層ツリー | 非推奨 API | 索引 | ヘルプ
openGion 5.1.3.0
前のクラス 次のクラス | フレームあり フレームなし
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド

## org.opengion.hayabusa.taglib
クラス QueryTag

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

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

直系の既知のサブクラス:
  EntryQueryTag, FileQueryTag, PlsqlUpdateTag, TableUpdateTag, UpdateTag

    public class QueryTag

extends CommonTagSupport

データベースの検索を行うタグです。 このタグの内容に、SQL文を記述します。 whereタグ、 andタグ を使うと引数に応じて 実行されるSQL文が異なります(使用例参照)。 また、PL/SQLのSPで検索を行うときもこのタグを使います。 SystemData の USE_SQL_INJECTION_CHECK が true か、quotCheck 属性が true の場合は、 ＳＱＬインジェクション対策用のクォーティションチェックを行います。リクエスト引数に クォーティション(')が含まれると、エラーになります。 同様にUSE_XSS_CHECKがtrueか、xssCheck属性がtrueの場合は、 クロスサイトススクリプティング(XSS)対策のためless/greater than signのチェックを行います。

関連項目:
  直列化された形式
機能階層
  ＤＢ検索, ＤＢ登録
形式サンプル:

       ●形式：
             ・<og:query command="NEW" >
                   <jsp:text > SELECT文 </jsp:text >
               </og:query>
             ・<og:query command="NEW" names="･･･" queryType="JDBCErrMsg" >
                   <jsp:text > { call PL/SQL(?,?,?,? ) } </jsp:text>
               </og:query>
       ●body：あり

       ●使用例
           <og:query command="NEW">
               <jsp:text>
                   select PN,YOBI,NMEN,HINM from XX01 where PN = '{@PN}' order by PN
               </jsp:text>
           </og:query>

                ・検索条件が入力された時({@PN}がNOT NULLのとき)
                  作成されるSQL文⇒select PN,YOBI,NMEN,HINM from XX01 where PN = 'AAA' order by PN
                ・検索条件が入力されなかった時({@PN}がNULLのとき)
                  作成されるSQL文⇒select PN,YOBI,NMEN,HINM from XX01 where PN = '' order by PN

           <og:query command="NEW">
               <jsp:text>
                   select PN,YOBI,NMEN,HINM from XX01
               </jsp:text>
               <og:where>
                   <og:and value="PN = '{@PN}%'" />
                   <og:and value="YOBI like '{@YOBI}%'" />
               </og:where>
               <jsp:text>
                   order by PN
               </jsp:text>
           </og:query>

                ・検索条件が入力された時({@PN}がNOT NULLのとき)
                  作成されるSQL文⇒select PN,YOBI,NMEN,HINM from XX01 PN = 'AAA%' and YOBI like 'BBB%' order by PN
                ・検索条件が入力されなかった時({@PN}がNULLのとき) WHERE句がなくなる。
                  作成されるSQL文⇒select PN,YOBI,NMEN,HINM from XX01 order by PN

              注意:WhereTagを使った場合、下のようにはなりません。
                  select PN,YOBI,NMEN,HINM from XX01 PN = '' and YOBI like '%' order by PN

           <og:query command="NEW">
               <jsp:text>
                   select PN,YOBI,NMEN,HINM from XX01 where PN="11111"
               </jsp:text>
               <og:where startKey="and">
                   <og:and value="YOBI like '{@PN}%'" />
               </og:where>
               <jsp:text>
                   order by PN
               </jsp:text>
           </og:query>

                ・検索条件が入力された時({@YOBI}がNOT NULLのとき)
                  作成されるSQL文⇒select PN,YOBI,NMEN,HINM from XX01 PN = '11111' and YOBI like 'BBB%' order by PN
                ・検索条件が入力されなかった時({@YOBI}がNULLのとき) WHERE句がなくなる。
                  作成されるSQL文⇒select PN,YOBI,NMEN,HINM from XX01 PN = '11111' order by PN

           <og:query
                command    = "NEW"
                names      = "SYSTEM_ID,LANG,CLM,NAME_JA,LABEL_NAME,KBSAKU,USER.ID"
                checkNames = "CLM,NAME_JA"
                queryType  = "JDBCErrMsg"
                displayMsg = "">
                <jsp:text>
                    {call TYPE3B01.TYPE3B01(?,?,?,?)}
                </jsp:text>
           </og:query>

                ・queryType に JDBCErrMsg を指定して、PL/SQL をコールできます。
                  引数は、names 属性をキーにリクエスト変数から読み込みます。
                ・checkNames にカラム名を指定すると、columns.valueSet による
                  リクエスト変数の正規化を行います。

バージョン
  4.0
作成者
  Kazuhiko Hasegawa
導入されたバージョン:
  JDK5.0,

フィールドの概要
`static String` | `CMD_NEW` command 引数に渡す事の出来る コマンド 新規 "NEW"
`static String` | `CMD_RENEW` command 引数に渡す事の出来る コマンド 再検索 "RENEW"
`protected String` | `command`
`protected String` | `displayMsg`
`protected long` | `dyStart`
`protected int` | `errCode`
`protected ErrorMessage` | `errMessage`
`protected static String` | `errMsgId`
`protected int` | `executeCount`
`protected int` | `maxRowCount`
`protected String` | `names`
`protected boolean` | `outMessage`
`protected boolean` | `quotCheck`
`protected int` | `skipRowCount`
`protected String` | `sql`
`protected boolean` | `stopError`
`protected DBTableModel` | `table`
`protected String` | `tableId`
`protected boolean` | `xssCheck`

クラス 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`

コンストラクタの概要
`QueryTag()`

メソッドの概要
`int` | `doAfterBody()` Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。
`int` | `doEndTag()` Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
`int` | `doStartTag()` Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
`protected void` | `execute(Query query)` Query を実行します。
`protected String[]` | `getRequest(String[] nameArray)` 名称配列を元に、リクエスト情報のデータを取得します。
`protected void` | `release2()` タグリブオブジェクトをリリースします。
`void` | `setCheckNames(String nm)` 【TAG】リクエスト変数の正規化を行うカラムをCSV形式で複数指定します。
`void` | `setCommand(String cmd)` 【TAG】コマンド(NEW,RENEW)をセットします（PlsqlUpdateTag,UpdateTag の場合は、ENTRY）。
`void` | `setDbid(String id)` 【TAG】(通常は使いません)Queryオブジェクトを作成する時のDB接続IDを指定します。
`void` | `setDisplayMsg(String id)` 【TAG】検索結果を画面上に表示するメッセージリソースIDを指定します(初期値:MSG0033[　件検索しました])。
`void` | `setMaxRowCount(String count)` 【TAG】(通常は使いません)データの最大読み込み件数を指定します(初期値:ユーザーパラメータ の DB_MAX_ROW_COUNT)。
`void` | `setModifyType(String type)` 【TAG】DB検索時の モディファイタイプ（A(追加),C(更新),D(削除)）を指定します。
`void` | `setNames(String nm)` 【TAG】PL/SQLを利用する場合の引数にセットすべき データの名称をCSV形式で複数指定します。
`void` | `setNotfoundMsg(String id)` 【TAG】検索結果がゼロ件の場合に表示するメッセージリソースIDを指定します(初期値:MSG0077[対象データはありませんでした])。
`void` | `setOutMessage(String flag)` 【TAG】検索結果のメッセージを表示する/しない(true/false)を指定します(初期値:true)。
`void` | `setOverflowMsg(String id)` 【TAG】検索データが最大検索数をオーバーした場合に表示するメッセージリソースIDを指定します (初期値:MSG0007[検索結果が、制限行数を超えましたので、残りはカットされました])。
`void` | `setQueryType(String id)` 【TAG】Query を発行する為のクラスID(JDBC,JDBCCallable,JDBCErrMsg,JDBCUpdate)を指定します(初期値:JDBC)。
`void` | `setQuotCheck(String flag)` 【TAG】リクエスト情報の クォーティション(') 存在チェックを実施するかどうか(true/false)を設定します(初期値:USE_SQL_INJECTION_CHECK)。
`void` | `setSkipRowCount(String count)` 【TAG】(通常は使いません)データの読み始めの初期値を指定します。
`void` | `setStopError(String flag)` 【TAG】PLSQL/SQL処理エラーの時に処理を中止するかどうかを設定します。
`void` | `setStopZero(String cmd)` 【TAG】検索結果が０件のとき処理を続行するかどうか(true/false)を指定します(初期値:false[続行する])。
`void` | `setTableId(String id)` 【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのキーを指定します。
`void` | `setTrace(String flag)` 【TAG】引数の SQL 文を EXPLAIN PLAN を行う/行わない(true/false)を指定します(初期値:false)
`void` | `setXssCheck(String flag)` 【TAG】リクエスト情報の HTMLTag開始/終了文字(><) 存在チェックを実施するかどうか(true/false)を設定します(初期値:USE_XSS_CHECK)。
`String` | `toString()` このオブジェクトの文字列表現を返します。

クラス org.opengion.hayabusa.taglib.CommonTagSupport から継承されたメソッド
`add, add, addEventColumnSQL, check, check, commitTableObject, debugPrint, doCatch, doFinally, get, getApplicationInfo, getAttributes, getBodyRawString, getBodyString, getContextAttribute, getContextPath, getCookie, getCSVParameter, getDataCondition, getDateFormat, getDBColumn, getDBFunctionName, getDocumentLink, getGUIInfo, getGUIInfoAttri, getLabel, getLabelInterface, getLanguage, getLongLabel, getMsglbl, getObject, getParameterNames, getParameterRows, getRequest, getRequestAttribute, getRequestCacheData, getRequestParameter, getRequestParameterValues, getRequestValue, getRequestValue, getRequestValues, getResource, getScope, getSessionAttribute, getTagName, getUser, getUserInfo, isAjaxSubmitRequest, isDebug, isNoTransitionRequest, isNull, jspPrint, removeContextAttribute, removeObject, removeRequestAttribute, removeSessionAttribute, set, setAjaxSubmitRequest, setContextAttribute, setCookie, setDebug, setLanguage, setLbl, setMsglbl, setNoTransitionRequest, setObject, setParameterRows, setRequestAttribute, setRequestCacheData, setScope, setSessionAttribute, setUserInfo, setUseValue, startQueryTransaction, sys, sysBool, sysInt, useQuotCheck, 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_NEW

    public static final String CMD_NEW

  command 引数に渡す事の出来る コマンド 新規 "NEW"

  関連項目:
    定数フィールド値

### CMD_RENEW

    public static final String CMD_RENEW

  command 引数に渡す事の出来る コマンド 再検索 "RENEW"

  関連項目:
    定数フィールド値

### errMsgId

    protected static final String errMsgId

関連項目:
  定数フィールド値

### table

    protected transient DBTableModel table

### errMessage

    protected transient ErrorMessage errMessage

### tableId

    protected String tableId

### command

    protected String command

### skipRowCount

    protected int skipRowCount

### maxRowCount

    protected int maxRowCount

### sql

    protected String sql

### executeCount

    protected int executeCount

### names

    protected String names

### outMessage

    protected boolean outMessage

### errCode

    protected int errCode

### quotCheck

    protected boolean quotCheck

### displayMsg

    protected String displayMsg

### dyStart

    protected long dyStart

### stopError

    protected boolean stopError

### xssCheck

    protected boolean xssCheck

コンストラクタの詳細

### QueryTag

    public QueryTag()

メソッドの詳細

### doStartTag

    public int doStartTag()

  Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。

  定義:
    インタフェース `Tag` 内の `doStartTag`
  オーバーライド:
    クラス `CommonTagSupport` 内の `doStartTag`
  戻り値:
    int
  変更履歴:

    3.5.4.7 (2004/02/06) 実行時間測定用に、開始時刻を取得します。
    3.5.6.5 (2004/08/09) 暫定的に、DBTableModelを先行削除します。
    3.6.0.0 (2004/09/24) DBTableModel の先行削除は、scope="session" の場合のみ。

### doAfterBody

    public int doAfterBody()

  Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。

  定義:
    インタフェース `IterationTag` 内の `doAfterBody`
  オーバーライド:
    クラス `CommonTagSupport` 内の `doAfterBody`
  戻り値:
    int
  変更履歴:

    3.1.1.0 (2003/03/28) ボディの内容を取得する処理を、CommonTagSupport で行う。
    3.6.0.8 (2004/11/19) エラー発生時に確実にリリースされるように try finally 追加
    3.8.5.3 (2006/08/07) USER.LASTSQL へのSQL文の保存は、実行前に行っておきます。
    3.8.6.3 (2006/11/30) SQL 文の前後のスペースを取り除きます。
    3.8.7.0 (2006/12/15) アクセスログ取得の為,ApplicationInfo オブジェクトを設定
    4.0.0 (2005/01/31) lang ⇒ ResourceManager へ変更
    4.0.0 (2005/08/31) useQuotCheck() によるＳＱＬインジェクション対策
    4.3.4.0 (2008/12/01) GE20(ユーザー定数)へ登録するかのフラグへの対応
    5.0.0.2 (2009/09/15) XSS対応

### doEndTag

    public int doEndTag()

  Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。

  定義:
    インタフェース `Tag` 内の `doEndTag`
  オーバーライド:
    クラス `CommonTagSupport` 内の `doEndTag`
  戻り値:
    int
  変更履歴:

    2.0.0.8 (2002/10/09) command="NEW" のときのみ、displayMsg を表示させます。
    2.1.1.4 (2002/11/25) デバッグ時に最終SQLをユーザー情報をセットするように変更。
    2.1.2.1 (2002/11/27) ErrorMessage をクリアしないように変更。
    3.1.1.0 (2003/03/28) JspWriter オブジェクトの使用箇所を、jspPrint() を使用するように変更。
    3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
    3.2.1.0 (2003/05/28) 最終ＳＱＬ文を、UserInfo に、キャッシュしておく。
    3.3.3.3 (2003/08/06) 検索結果の件数を、"DB.COUNT" キーでリクエストにセットする。
    3.3.3.3 (2003/08/06) 検索結果を、"DB.ERR_CODE" キーでリクエストにセットする。
    3.5.4.7 (2004/02/06) 実行時間測定用のDIV要素を出力しておきます。
    3.5.4.9 (2004/02/25) 警告時に停止していましたが、継続処理させます。
    3.5.5.0 (2004/03/12) ErrorMessage オブジェクトを、query が成功した時にもクリアするように変更
    3.5.5.2 (2004/04/02) TaglibUtil.makeHTMLErrorTable メソッドを利用
    3.5.5.8 (2004/05/20) ErrorMessage オブジェクトを、コマンドが NEW の場合のみ、クリア
    3.5.6.0 (2004/06/18) debugMsg 属性を出力するように修正します。
    3.6.0.8 (2004/11/19) DBTableModel をセーブする時に、トランザクションチェックを行います。
    3.8.5.3 (2006/08/07) USER.LASTSQL へのSQL文の保存は、実行前に行っておきます。
    4.0.0 (2006/11/14) notfoundMsg 属性を追加。displayMsg は、VIEW_USE_DISPLAY_MSG で制御
    4.0.0.0 (2007/10/18) メッセージリソース統合( getResource().getMessage > getResource().getLabel )
    4.3.3.0 (2008/09/22) 属性 stopError の設定により、JSP処理を中止するかどうかを制御します。

### release2

    protected void release2()

  タグリブオブジェクトをリリースします。 キャッシュされて再利用されるので、フィールドの初期設定を行います。

  オーバーライド:
    クラス `CommonTagSupport` 内の `release2`
  変更履歴:

    2.0.0.4 (2002/09/27) カスタムタグの release() メソッドを、追加
    3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
    3.5.4.7 (2004/02/06) 実行時間測定用に、dyStart を追加します。
    3.5.6.0 (2004/06/18) debugMsg 属性を追加します。
    3.8.0.5 (2005/08/20) checkNames 属性を追加します。
    3.8.5.1 (2006/05/08) modifyType 属性を追加します。
    3.8.5.1 (2006/05/08) traceMsg 属性(トレース時のメッセージ文字列)を追加します。
    4.0.0 (2005/08/31) quotCheck 属性の追加
    4.0.0.0 (2007/10/10) dbid の初期値を、"DEFAULT" から null に変更
    4.3.3.0 (2008/09/22) stopError 属性の追加
    5.0.0.2 (2009/09/15) XSS対応

### execute

    protected void execute(Query query)

  Query を実行します。

  パラメータ:
    `query` - オブジェクト
  変更履歴:

    2.1.2.3 (2002/12/02) データベース更新時に、更新フラグをセットするように変更
    3.4.0.0 (2003/09/01) 登録エラー時のキーと値を表示するように変更。
    3.5.6.0 (2004/06/18) デバッグ情報出力用に、printDebug メソッドを追加。
    3.6.1.0 (2005/01/05) エラーコードによる commit/rollback の判断追加

### getRequest

    protected String[] getRequest(String[] nameArray)

  名称配列を元に、リクエスト情報のデータを取得します。 checkNames 属性に設定されているカラムがあれば、値を正規化します。

  パラメータ:
    `nameArray` - String[] キーとなる名称の配列
  戻り値:
    String[] そのリクエスト情報
  変更履歴:

    3.8.0.5 (2005/08/20) リクエスト変数の正規化(checkNames)対応

### setSkipRowCount

    public void setSkipRowCount(String count)

  【TAG】(通常は使いません)データの読み始めの初期値を指定します。

  パラメータ:
    `count` - 読み始めの初期値
  TagLib:

    データベース自体の検索は,指定されたSQLの全件を検索しますが, DBTableModelのデータとしては、スキップ件数分は登録されません。 サーバーのメモリ資源と応答時間の確保の為です。

### setMaxRowCount

    public void setMaxRowCount(String count)

  【TAG】(通常は使いません)データの最大読み込み件数を指定します(初期値:ユーザーパラメータ の DB_MAX_ROW_COUNT)。

  パラメータ:
    `count` - 最大読み込み件数
  TagLib:

    データベース自体の検索は,指定されたSQLの全件を検索しますが, DBTableModelのデータとして登録する最大件数をこの値に設定します。 サーバーのメモリ資源と応答時間の確保の為です。 0 をセットすると、無制限(Integer.MAX_VALUE)になります。

### setTableId

    public void setTableId(String id)

  【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのキーを指定します。

  パラメータ:
    `id` - sessionに登録する時の ID
  TagLib:

    検索結果より、DBTableModel オブジェクトを作成します。これを、以下のview 等のタグに 渡す場合に、通常は、session を利用します。その場合の登録キーです。 query タグを同時に実行して、結果を求める場合、同一メモリに配置される為、 この tableId 属性を利用して、メモリ空間を分けます。 初期値は、HybsSystem.TBL_MDL_KEY です。

### setQueryType

    public void setQueryType(String id)

  【TAG】Query を発行する為のクラスID(JDBC,JDBCCallable,JDBCErrMsg,JDBCUpdate)を指定します(初期値:JDBC)。

  パラメータ:
    `id` - Query を発行する為の実クラス ID
  関連項目:
    `Queryのサブクラス`, `Query.execute( String[] )`
  TagLib:

    検索を実行する手段は、Query インターフェースの実装クラスになります。 このタグでは、Query.execute( String[] ) メソッドが呼ばれます。 例えば、ストアドプロシージャ等を実行する場合に、queryType="JDBCErrMsg" を指定することができます。 初期値は、"JDBC" です。 queryType は、システムリソースの Query_**** 宣言の **** を与えます。 これらは、Query インターフェースを継承したサブクラスである必要があります。 標準で、org.opengion.hayabusa.db 以下の Query_**** クラスが、Query_**** 宣言 と して、定義されています。 属性クラス定義の queryType を参照願います。

### setDbid

    public void setDbid(String id)

  【TAG】(通常は使いません)Queryオブジェクトを作成する時のDB接続IDを指定します。

  パラメータ:
    `id` - データベース接続ID
  TagLib:

    Queryオブジェクトを作成する時のDB接続IDを指定します。 これは、システムリソースで、DEFAULT_DB_URL 等で指定している データベース接続先 情報に、XX_DB_URL を定義することで、 dbid="XX" とすると、この 接続先を使用して データベースにアクセスできます。

### setCommand

    public void setCommand(String cmd)

  【TAG】コマンド(NEW,RENEW)をセットします（PlsqlUpdateTag,UpdateTag の場合は、ENTRY）。

  パラメータ:
    `cmd` - コマンド（public static final 宣言されている文字列)
  関連項目:
    コマンド定数
  TagLib:

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

### setStopZero

    public void setStopZero(String cmd)

  【TAG】検索結果が０件のとき処理を続行するかどうか(true/false)を指定します(初期値:false[続行する])。

  パラメータ:
    `cmd` - 検索結果が０件のとき、処理を中止する（true) / 続行する（false)
  TagLib:

    初期値は、false(続行する)です。

### setDisplayMsg

    public void setDisplayMsg(String id)

  【TAG】検索結果を画面上に表示するメッセージリソースIDを指定します(初期値:MSG0033[　件検索しました])。

  パラメータ:
    `id` - ディスプレイに表示させるメッセージ ID
  TagLib:

    ここでは、検索結果の件数や登録された件数をまず出力し、 その次に、ここで指定したメッセージをリソースから取得して表示します。 表示させたくない場合は, displayMsg = "" をセットしてください。 なお、システムリソースの VIEW_USE_DISPLAY_MSG にて、表示する/しない を指定できます。 VIEW_USE_DISPLAY_MSG の初期値は、false(表示しない)です。 displayMsg の初期値は、MSG0033[　件検索しました]です。

### setOverflowMsg

    public void setOverflowMsg(String id)

  【TAG】検索データが最大検索数をオーバーした場合に表示するメッセージリソースIDを指定します (初期値:MSG0007[検索結果が、制限行数を超えましたので、残りはカットされました])。

  パラメータ:
    `id` - ディスプレイに表示させるメッセージ ID
  TagLib:

    検索結果が、maxRowCount で設定された値より多い場合、何らかのデータは検索されず 切り捨てられたことになります。 ここでは、displayMsg を表示した後、必要に応じて、このメッセージを表示します。 表示させたくない場合は, overflowMsg = "" をセットしてください。 初期値は、MSG0007[検索結果が、制限行数を超えましたので、残りはカットされました]です。

### setNotfoundMsg

    public void setNotfoundMsg(String id)

  【TAG】検索結果がゼロ件の場合に表示するメッセージリソースIDを指定します(初期値:MSG0077[対象データはありませんでした])。

  パラメータ:
    `id` - ディスプレイに表示させるメッセージ ID
  TagLib:

    ここでは、検索結果がゼロ件の場合のみ、特別なメッセージを表示させます。 従来は、displayMsg と兼用で、『0　件検索しました』という表示でしたが、 displayMsg の初期表示は、OFF になりましたので、ゼロ件の場合のみ別に表示させます。 表示させたくない場合は, notfoundMsg = "" をセットしてください。 初期値は、MSG0077[対象データはありませんでした]です。

### setNames

    public void setNames(String nm)

  【TAG】PL/SQLを利用する場合の引数にセットすべき データの名称をCSV形式で複数指定します。

  パラメータ:
    `nm` - 引数の名称（複数ある場合は、カンマ区切り文字）
  TagLib:

    複数ある場合は、カンマ区切り文字で渡します。 names 属性は、queryType に応じて設定可否が異なりますので、ご注意ください。 names なし：JDBC,JDBCUpdate names あり：JDBCCallable,JDBCErrMsg,JDBCUpdate (JDBCUpdateは、names 属性のあり/なし両方に対応しています。)

  変更履歴:

    3.0.1.3 (2003/03/11) names 属性に null で渡す場合のバグを修正

### setOutMessage

    public void setOutMessage(String flag)

  【TAG】検索結果のメッセージを表示する/しない(true/false)を指定します(初期値:true)。

  パラメータ:
    `flag` - 表示する ("true")／含めない (それ以外)
  TagLib:

    初期値は、表示する：true です。

### setTrace

    public void setTrace(String flag)

  【TAG】引数の SQL 文を EXPLAIN PLAN を行う/行わない(true/false)を指定します(初期値:false)

  パラメータ:
    `flag` - トレースを行う ("true")／行わない(それ以外)
  TagLib:

    ここでは、以下の処理を行います。 １．引数の SQL 文を画面に表示します。 ２．引数の SQL 文を EXPLAIN PLAN した結果を、画面に表示します。 なお、以前は、セッションのトレースを行っていましたが、その機能は、廃止いたします。 初期値は、行わない：false です。

### setCheckNames

    public void setCheckNames(String nm)

  【TAG】リクエスト変数の正規化を行うカラムをCSV形式で複数指定します。

  パラメータ:
    `nm` - リクエスト変数の正規化を行うカラム
  TagLib:

    PL/SQLを利用する場合の引数にセットすべき データを、リクエスト変数の 値そのままではなく、カラムオブジェクトの valueSet メソッド経由で正規化 した値を使用するようにします。

  変更履歴:

    3.8.0.5 (2005/08/20) 新規追加

### setModifyType

    public void setModifyType(String type)

  【TAG】DB検索時の モディファイタイプ（A(追加),C(更新),D(削除)）を指定します。

  パラメータ:
    `type` - DB検索時の モディファイタイプ（A,C,D属性）
  TagLib:

    DB検索時に、そのデータをA(追加）、C(更新）、D(削除)のモディファイタイプを つけた状態にします。 その状態で、そのまま、update する事が可能になります。

  変更履歴:

    3.8.5.1 (2006/05/08) 新規追加

### setQuotCheck

    public void setQuotCheck(String flag)

  【TAG】リクエスト情報の クォーティション(') 存在チェックを実施するかどうか(true/false)を設定します(初期値:USE_SQL_INJECTION_CHECK)。

  パラメータ:
    `flag` - クォーティションチェックする ("true")／しない (それ以外)
  TagLib:

    ＳＱＬインジェクション対策の一つとして、暫定的ではありますが、SQLのパラメータに 渡す文字列にクォーティション(') を許さない設定にすれば、ある程度は防止できます。 数字タイプの引数には、 or 5=5 などのクォーティションを使用しないコードを埋めても、 数字チェックで検出可能です。文字タイプの場合は、必ず (')をはずして、 ' or 'A' like 'A のような形式になる為、(')チェックだけでも有効です。 (') が含まれていたエラーにする（true)／かノーチェックか(false)を指定します。 初期値は、SystemData#USE_SQL_INJECTION_CHECK です。

  変更履歴:

    4.0.0 (2005/08/31) 新規追加

### setXssCheck

    public void setXssCheck(String flag)

  【TAG】リクエスト情報の HTMLTag開始/終了文字(><) 存在チェックを実施するかどうか(true/false)を設定します(初期値:USE_XSS_CHECK)。

  パラメータ:
    `flag` - boolean XSSチェックする (true)／しない (false)
  TagLib:

    クロスサイトスクリプティング(XSS)対策の一環としてless/greater than signについてのチェックを行います。 (><) が含まれていたエラーにする（true)／かノーチェックか(false)を指定します。 初期値は、SystemData#USE_XMLLTAG_CHECK です。

  変更履歴:

    5.0.0.2 (2009/09/15) 新規追加

### setStopError

    public void setStopError(String flag)

  【TAG】PLSQL/SQL処理エラーの時に処理を中止するかどうかを設定します。

  パラメータ:
    `flag` - 中止する ("true")／中止しない("false")
  TagLib:

    初期値は、true(中止する)です。 　false(中止しない)に設定する場合、後続処理では、{@DB.ERR_CODE}の値により、 　PLSQL/SQLの異常/正常終了によって分岐処理は可能となります。

  変更履歴:

    4.3.3.0 (2008/09/22) 新規追加

### toString

    public String toString()

  このオブジェクトの文字列表現を返します。 基本的にデバッグ目的に使用します。

  オーバーライド:
    クラス `CommonTagSupport` 内の `toString`
  戻り値:
    このクラスの文字列表現

概要 | パッケージ | クラス | 階層ツリー | 非推奨 API | 索引 | ヘルプ
| openGion 5.1.3.0
前のクラス 次のクラス | フレームあり フレームなし
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド

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