概要 | パッケージ | クラス | 階層ツリー | 非推奨 API | 索引 | ヘルプ
openGion 5.1.6.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` | `setMainTrans(String flag)` 【TAG】(通常使いません)タグで処理される処理がメインとなるトランザクション処理かどうかを指定します。
`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, useMainTrans, 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" の場合のみ。
    5.1.6.0 (2010/05/01) DBLastSqlの処理は、DBTableModelが新規作成された処理でのみ行う。

### 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対応
    5.1.6.0 (2010/05/01) DBLastSqlの処理は、DBTableModelが新規作成された処理でのみ行う。

### 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対応
    5.1.6.0 (2010/05/01) DBLastSqlの処理は、DBTableModelが新規作成された処理でのみ行う。

### 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) 新規追加

### setMainTrans

    public void setMainTrans(String flag)

  【TAG】(通常使いません)タグで処理される処理がメインとなるトランザクション処理かどうかを指定します。(初期値:true)

  パラメータ:
    `flag` - メイントランザクションかどうか
  TagLib:

    (通常使いません)タグで処理される処理が、メインとなるトランザクション処理かどうかを指定します。(初期値:true) この値は、ファイルダウンロード処理に影響します。この値がtrueに指定された時にcommitされたDBTableModelが ファイルダウンロードの対象の表になります。 このパラメーターは、通常、各タグにより実装され、ユーザーが指定する必要はありません。 但し、1つのJSP内でDBTableModelが複数生成される場合に、前に処理したDBTableModelについてファイルダウンロードをさせたい 場合は、後ろでDBTableModelを生成するタグで、明示的にこの値をfalseに指定することで、ファイルダウンロード処理の対象から 除外することができます。

  変更履歴:

    5.1.6.0 (2010/05/01) 新規作成

### toString

    public String toString()

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

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

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

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