openGionopenGion
5.5.2.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
すべての実装されたインタフェース:
java.io.Serializable, javax.servlet.jsp.tagext.BodyTag, javax.servlet.jsp.tagext.IterationTag, javax.servlet.jsp.tagext.JspTag, javax.servlet.jsp.tagext.Tag, javax.servlet.jsp.tagext.TryCatchFinally
直系の既知のサブクラス:
EntryQueryTag, FileQueryTag, GuiQueryTag, PlsqlUpdateTag, TableUpdateTag, UpdateTag

public class QueryTag
extends CommonTagSupport

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

関連項目:
直列化された形式
形式サンプル:
 ●形式:
       ・<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 による
            リクエスト変数の正規化を行います。
機能階層
DB検索, DB登録
バージョン
4.0
作成者
Kazuhiko Hasegawa
導入されたバージョン:
JDK5.0,

フィールドの概要
static java.lang.String CMD_NEW
          command 引数に渡す事の出来る コマンド 新規 "NEW"
static java.lang.String CMD_RENEW
          command 引数に渡す事の出来る コマンド 再検索 "RENEW"
protected  java.lang.String command
           
protected  java.lang.String displayMsg
           
protected  long dyStart
           
protected  int errCode
           
protected  ErrorMessage errMessage
           
protected static java.lang.String errMsgId
          エラーメッセージID "h_errMsg"
protected  int executeCount
           
protected  int maxRowCount
           
protected  java.lang.String names
           
protected  boolean outMessage
           
protected  boolean quotCheck
           
protected  int skipRowCount
           
protected  java.lang.String sql
           
protected  boolean stopError
           
protected  DBTableModel table
           
protected  java.lang.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  java.lang.String[] getRequest(java.lang.String[] nameArray)
          名称配列を元に、リクエスト情報のデータを取得します。
protected  void release2()
          タグリブオブジェクトをリリースします。
 void setCheckNames(java.lang.String nm)
          【TAG】リクエスト変数の正規化を行うカラムをCSV形式で複数指定します。
 void setCommand(java.lang.String cmd)
          【TAG】コマンド(NEW,RENEW)をセットします(PlsqlUpdateTag,UpdateTag の場合は、ENTRY)。
 void setDbid(java.lang.String id)
          【TAG】(通常は使いません)Queryオブジェクトを作成する時のDB接続IDを指定します。
 void setDisplayMsg(java.lang.String id)
          【TAG】検索結果を画面上に表示するメッセージリソースIDを指定します(初期値:MSG0033[ 件検索しました])。
 void setMainTrans(java.lang.String flag)
          【TAG】(通常使いません)タグで処理される処理がメインとなるトランザクション処理かどうかを指定します。
 void setMaxRowCount(java.lang.String count)
          【TAG】(通常は使いません)データの最大読み込み件数を指定します(初期値:ユーザーパラメータ の DB_MAX_ROW_COUNT)。
 void setModifyType(java.lang.String type)
          【TAG】DB検索時の モディファイタイプ(A(追加),C(更新),D(削除))を指定します。
 void setNames(java.lang.String nm)
          【TAG】PL/SQLを利用する場合の引数にセットすべき データの名称をCSV形式で複数指定します。
 void setNotfoundMsg(java.lang.String id)
          【TAG】検索結果がゼロ件の場合に表示するメッセージリソースIDを指定します(初期値:MSG0077[対象データはありませんでした])。
 void setOutMessage(java.lang.String flag)
          【TAG】検索結果のメッセージを表示する/しない(true/false)を指定します(初期値:true)。
 void setOverflowMsg(java.lang.String id)
          【TAG】検索データが最大検索数をオーバーした場合に表示するメッセージリソースIDを指定します (初期値:MSG0007[検索結果が、制限行数を超えましたので、残りはカットされました])。
 void setQueryType(java.lang.String id)
          【TAG】Query を発行する為のクラスID(JDBC,JDBCCallable,JDBCErrMsg,JDBCUpdate)を指定します(初期値:JDBC)。
 void setQuotCheck(java.lang.String flag)
          【TAG】リクエスト情報の クォーティション(') 存在チェックを実施するかどうか(true/false)を設定します(初期値:USE_SQL_INJECTION_CHECK)。
 void setSkipRowCount(java.lang.String count)
          【TAG】(通常は使いません)データの読み始めの初期値を指定します。
 void setStopError(java.lang.String flag)
          【TAG】PLSQL/SQL処理エラーの時に処理を中止するかどうかを設定します。
 void setStopZero(java.lang.String cmd)
          【TAG】検索結果が0件のとき処理を続行するかどうか(true/false)を指定します(初期値:false[続行する])。
 void setTableId(java.lang.String id)
          【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのキーを指定します。
 void setTrace(java.lang.String flag)
          【TAG】引数の SQL 文を EXPLAIN PLAN を行う/行わない(true/false)を指定します(初期値:false)
 void setUseBeforeHtmlTag(java.lang.String useTag)
          【TAG】 処理時間(queryTime)などの情報出力の有効/無効を指定します(初期値:true)
 void setXssCheck(java.lang.String flag)
          【TAG】リクエスト情報の HTMLTag開始/終了文字(><) 存在チェックを実施するかどうか(true/false)を設定します(初期値:USE_XSS_CHECK)。
 java.lang.String toString()
          このオブジェクトの文字列表現を返します。
 
クラス org.opengion.hayabusa.taglib.CommonTagSupport から継承されたメソッド
add, add, addEventColumn, addEventColumn, 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, getSanitizedBodyString, getScope, getSessionAttribute, getTagName, getUser, getUserInfo, isAjaxSubmitRequest, isDebug, isNoTransitionRequest, isNull, jspPrint, removeContextAttribute, removeObject, removeRequestAttribute, removeSessionAttribute, set, setAjaxSubmitRequest, setCaseKey, 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_NEW

public static final java.lang.String CMD_NEW
command 引数に渡す事の出来る コマンド 新規 "NEW"

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

CMD_RENEW

public static final java.lang.String CMD_RENEW
command 引数に渡す事の出来る コマンド 再検索 "RENEW"

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

errMsgId

protected static final java.lang.String errMsgId
エラーメッセージID "h_errMsg"

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

table

protected transient DBTableModel table

errMessage

protected transient ErrorMessage errMessage

tableId

protected java.lang.String tableId

command

protected java.lang.String command

skipRowCount

protected int skipRowCount

maxRowCount

protected int maxRowCount

sql

protected java.lang.String sql

executeCount

protected int executeCount

names

protected java.lang.String names

outMessage

protected boolean outMessage

errCode

protected int errCode

quotCheck

protected boolean quotCheck

displayMsg

protected java.lang.String displayMsg

dyStart

protected long dyStart

stopError

protected boolean stopError

xssCheck

protected boolean xssCheck
コンストラクタの詳細

QueryTag

public QueryTag()
メソッドの詳細

doStartTag

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

定義:
インタフェース javax.servlet.jsp.tagext.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が新規作成された処理でのみ行う。
5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応

doAfterBody

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

定義:
インタフェース javax.servlet.jsp.tagext.IterationTag 内の doAfterBody
オーバーライド:
クラス CommonTagSupport 内の doAfterBody
戻り値:
int 後続処理の指示(SKIP_BODY)
変更履歴:
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() によるSQLインジェクション対策
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が新規作成された処理でのみ行う。
5.1.9.0 (2010/08/01) TransactionTag 対応。上位に TransactionTag があれば、そこからConnection をもらう。
5.3.6.0 (2011/06/01) 集計、合計などのEdit機能に対応します。
5.3.7.0 (2011/07/01) TransactionReal の引数変更
5.3.7.0 (2011/07/01) PL/SQLかつscope="request"で正しく出力するためqueryType,namesも保存する。
5.3.8.0 (2011/08/01) Transaction発生箇所でclose()

doEndTag

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

定義:
インタフェース javax.servlet.jsp.tagext.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) 最終SQL文を、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処理を中止するかどうかを制御します。
5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応
5.3.5.0 (2011/05/01) 処理時間(queryTime)などの情報出力の有効/無効を指定します。
5.5.0.3 (2012/03/13) オーバーフローメッセージが存在しないときは、何もしない。(改行も入れない)

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が新規作成された処理でのみ行う。
5.3.5.0 (2011/05/01) 処理時間(queryTime)などの情報出力の有効/無効を指定します。

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 の判断追加
5.3.7.0 (2011/07/01) nameの判定にゼロ文字列を付加

getRequest

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

パラメータ:
nameArray - String[] キーとなる名称の配列
戻り値:
String[] そのリクエスト情報
変更履歴:
3.8.0.5 (2005/08/20) リクエスト変数の正規化(checkNames)対応

setSkipRowCount

public void setSkipRowCount(java.lang.String count)
【TAG】(通常は使いません)データの読み始めの初期値を指定します。

パラメータ:
count - 読み始めの初期値
説明:
 データベース自体の検索は,指定されたSQLの全件を検索しますが,
 DBTableModelのデータとしては、スキップ件数分は登録されません。
 サーバーのメモリ資源と応答時間の確保の為です。

setMaxRowCount

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

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

setTableId

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

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

setQueryType

public void setQueryType(java.lang.String id)
【TAG】Query を発行する為のクラスID(JDBC,JDBCCallable,JDBCErrMsg,JDBCUpdate)を指定します(初期値:JDBC)。

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

setDbid

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

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

setCommand

public void setCommand(java.lang.String cmd)
【TAG】コマンド(NEW,RENEW)をセットします(PlsqlUpdateTag,UpdateTag の場合は、ENTRY)。

パラメータ:
cmd - コマンド(public static final 宣言されている文字列)
関連項目:
コマンド定数
説明:
 コマンドは,HTMLから(get/post)指定されますので,CMD_xxx で設定される
 フィールド定数値のいづれかを、指定できます。

setStopZero

public void setStopZero(java.lang.String cmd)
【TAG】検索結果が0件のとき処理を続行するかどうか(true/false)を指定します(初期値:false[続行する])。

パラメータ:
cmd - 検索結果が0件のとき、処理を中止する(true) / 続行する(false)
説明:
 初期値は、false(続行する)です。

setDisplayMsg

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

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

setOverflowMsg

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

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

setNotfoundMsg

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

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

setNames

public void setNames(java.lang.String nm)
【TAG】PL/SQLを利用する場合の引数にセットすべき データの名称をCSV形式で複数指定します。

パラメータ:
nm - 引数の名称(複数ある場合は、カンマ区切り文字)
説明:
 複数ある場合は、カンマ区切り文字で渡します。
 names 属性は、queryType に応じて設定可否が異なりますので、ご注意ください。
 names なし:JDBC,JDBCUpdate
 names あり:JDBCCallable,JDBCErrMsg,JDBCUpdate
 (JDBCUpdateは、names 属性のあり/なし両方に対応しています。)
変更履歴:
3.0.1.3 (2003/03/11) names 属性に null で渡す場合のバグを修正

setOutMessage

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

パラメータ:
flag - 表示する ("true")/含めない (それ以外)
説明:
 初期値は、表示する:true です。

setTrace

public void setTrace(java.lang.String flag)
【TAG】引数の SQL 文を EXPLAIN PLAN を行う/行わない(true/false)を指定します(初期値:false)

パラメータ:
flag - トレースを行う ("true")/行わない(それ以外)
説明:
 ここでは、以下の処理を行います。
 1.引数の SQL 文を画面に表示します。
 2.引数の SQL 文を EXPLAIN PLAN した結果を、画面に表示します。
 なお、以前は、セッションのトレースを行っていましたが、その機能は、廃止いたします。
 初期値は、行わない:false です。

setCheckNames

public void setCheckNames(java.lang.String nm)
【TAG】リクエスト変数の正規化を行うカラムをCSV形式で複数指定します。

パラメータ:
nm - リクエスト変数の正規化を行うカラム
説明:
 PL/SQLを利用する場合の引数にセットすべき データを、リクエスト変数の
 値そのままではなく、カラムオブジェクトの valueSet メソッド経由で正規化
 した値を使用するようにします。
変更履歴:
3.8.0.5 (2005/08/20) 新規追加

setModifyType

public void setModifyType(java.lang.String type)
【TAG】DB検索時の モディファイタイプ(A(追加),C(更新),D(削除))を指定します。

パラメータ:
type - DB検索時の モディファイタイプ(A,C,D属性)
説明:
 

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

変更履歴:
3.8.5.1 (2006/05/08) 新規追加

setQuotCheck

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

パラメータ:
flag - クォーティションチェックする ("true")/しない (それ以外)
説明:
 SQLインジェクション対策の一つとして、暫定的ではありますが、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(java.lang.String flag)
【TAG】リクエスト情報の HTMLTag開始/終了文字(><) 存在チェックを実施するかどうか(true/false)を設定します(初期値:USE_XSS_CHECK)。

パラメータ:
flag - boolean XSSチェックする (true)/しない (false)
説明:
 クロスサイトスクリプティング(XSS)対策の一環としてless/greater than signについてのチェックを行います。
 (><) が含まれていたエラーにする(true)/かノーチェックか(false)を指定します。
 初期値は、SystemData#USE_XMLLTAG_CHECK です。
変更履歴:
5.0.0.2 (2009/09/15) 新規追加

setStopError

public void setStopError(java.lang.String flag)
【TAG】PLSQL/SQL処理エラーの時に処理を中止するかどうかを設定します。

パラメータ:
flag - 中止する ("true")/中止しない("false")
説明:
 初期値は、true(中止する)です。
 false(中止しない)に設定する場合、後続処理では、{@DB.ERR_CODE}の値により、
 PLSQL/SQLの異常/正常終了によって分岐処理は可能となります。
変更履歴:
4.3.3.0 (2008/09/22) 新規追加

setMainTrans

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

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

setUseBeforeHtmlTag

public void setUseBeforeHtmlTag(java.lang.String useTag)
【TAG】 処理時間(queryTime)などの情報出力の有効/無効を指定します(初期値:true)

パラメータ:
useTag - 情報出力の有効/無効を指定(true/false)
説明:
 Query で、検索する場合に、処理時間(queryTime)などの情報を出力していますが、
 ViewForm で、CustomData などの 非HTML表示ビューを使用する場合、データとして、
 紛れ込んでしまうため、出力を抑制する必要があります。
 true(有効)にすると、これらのHTMLが出力されます。false にすると、出力されません。
 初期値は、true(有効) です。
変更履歴:
5.3.5.0 (2011/05/01) 新規追加

toString

public java.lang.String toString()
このオブジェクトの文字列表現を返します。 基本的にデバッグ目的に使用します。

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

openGion 5.5.2.0

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