openGionopenGion
5.4.3.3

org.opengion.hayabusa.taglib
クラス SubmitTag

java.lang.Object
  上位を拡張 javax.servlet.jsp.tagext.TagSupport
      上位を拡張 javax.servlet.jsp.tagext.BodyTagSupport
          上位を拡張 org.opengion.hayabusa.taglib.CommonTagSupport
              上位を拡張 org.opengion.hayabusa.taglib.HTMLTagSupport
                  上位を拡張 org.opengion.hayabusa.taglib.SubmitTag
すべての実装されたインタフェース:
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

public class SubmitTag
extends HTMLTagSupport

サブミットボタンを表示するHTML拡張タグです(forward.jsp の commonForward タグと同時に使用します)。 このタグは、value に指定された値+".jsp" の画面へサブミットします。 その際、command に設定された値を 送信します。 従来は、value に、copy/modify/delete など、処理するJSPを個別に設定していましたので、 command と lbl が未設定時には、value の値を使用していました。(下位互換性のため残しています) Ver5 になって、update.jsp ですべての処理を行う方向で開発するに当たり、 command と lbl を記述する必要がでてきました。 そこで、現在最新版では、action 属性を用意し、command を記述するだけで良くなりました。 [action属性] [初期設定されるパラメータ郡] INSERT value="update" command="INSERT" lbl="INSERT" accesskey="I" COPY value="update" command="COPY" lbl="COPY" accesskey="C" MODIFY value="update" command="MODIFY" lbl="MODIFY" accesskey="M" DELETE value="update" command="DELETE" lbl="DELETE" accesskey="Z" ENTRY value="entry" command="ENTRY" lbl="ENTRY" accesskey="E" RESET value="reset" command="RESET" lbl="ENTRY" accesskey="R" columnWritable , noWritable の属性追加(5.2.2.0 (2010/11/01)) これは、各コマンドごとに、次ページの view のカラム属性の設定に利用する属性です。 Ver4 では、keys,vals の一般引数として設定していましたが、ここでは、専用属性として 用意しています。

関連項目:
直列化された形式
形式サンプル:
 ●形式:<og:submit value="…" lbl="…" />
 ●body:なし

 ●使用例 
     Ver5 推奨ケース:指定の action 属性に設定された値に応じた、value , command , lbl , accesskey を初期化します。
                      (5.2.2.0 (2010/11/01)以降)
     <og:writeCheck>
         <og:submit  action="COPY"    noWritable="FGJ,UNIQ" />
         <og:submit  action="MODIFY"  noWritable="CLM,FGJ,UNIQ" />
         <og:submit  action="DELETE"  columnWritable="null" />
         <og:submit  gamenId="GF9110" value="index" dbkeys="SYSTEM_ID,LANG,CLM" command="NEW" lbl="GF9100" target="CONTENTS" />
         <br />
     </og:writeCheck>

     Ver4 一般的なケース:value は共通になったため、command と lbl の設定が必要(下位互換性のための設定)
     <og:writeCheck>
         <og:submit  value="update"   command="COPY"   lbl="COPY"    accesskey="C" />
         <og:submit  value="update"   command="MODIFY" lbl="MODIFY"  accesskey="M" />
         <og:submit  value="update"   command="DELETE" lbl="DELETE"  accesskey="Z" />
         <og:submit  gamenId="GF9110" value="index" dbkeys="SYSTEM_ID,LANG,CLM" command="NEW" lbl="GF9100" target="CONTENTS" />
         <br />
     </og:writeCheck>

     従来のケース:value に設定された値JSPに対してサブミットされます。(下位互換性のための設定)
     <og:writeCheck>
         <og:submit value="copy"     lbl="MSG0035" accesskey="C"  />
         <og:submit value="modify"   lbl="MSG0036" accesskey="M"  />
         <og:submit value="delete"   lbl="MSG0037" accesskey="Z"  />
         <og:submit  gamenId="GF9110" value="index" dbkeys="SYSTEM_ID,LANG,CLM" command="NEW" lbl="GF9100" target="CONTENTS" />
         <br />
     </og:writeCheck>
変更履歴:
3.1.1.0 (2003/03/28) 新規作成
機能階層
画面制御
バージョン
4.0
作成者
Kazuhiko Hasegawa
導入されたバージョン:
JDK5.0,

フィールドの概要
static java.lang.String ACT_COPY
          command 引数に渡す事の出来る コマンド 複写 "COPY"
static java.lang.String ACT_DELETE
          command 引数に渡す事の出来る コマンド 削除 "DELETE"
static java.lang.String ACT_ENTRY
          command 引数に渡す事の出来る コマンド エントリー "ENTRY"
static java.lang.String ACT_INSERT
          command 引数に渡す事の出来る コマンド 新規 "INSERT"
static java.lang.String ACT_MODIFY
          command 引数に渡す事の出来る コマンド 変更 "MODIFY"
static java.lang.String ACT_RESET
          command 引数に渡す事の出来る コマンド リセット "RESET"
 
クラス 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
 
コンストラクタの概要
SubmitTag()
           
 
メソッドの概要
 int doStartTag()
          Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
protected  java.lang.String makeTag()
          サブミットボタンを作成します。
protected  void release2()
          タグリブオブジェクトをリリースします。
 void setAction(java.lang.String act)
          【TAG】アクション(INSERT,COPY,MODIFY,DELETE,ENTRY,RESET)を指定します。
 void setColumnWritable(java.lang.String columnName)
          【TAG】書き込み可能カラム名を、カンマ区切りで与えます。
 void setCommand(java.lang.String cmd)
          【TAG】処理コマンドを登録します(初期値:大文字の value 属性値[INSERT,COPY,MODIFY,DELETE など])。
 void setDbkeys(java.lang.String keys)
          【TAG】commonForward の dbkeys にカラム指定を行います。
 void setGamenId(java.lang.String id)
          【TAG】gamenId 属性を登録します。
 void setKeys(java.lang.String key)
          【TAG】ボタン専用のリクエストキーをCSV形式で複数指定します。
 void setNoWritable(java.lang.String columnName)
          【TAG】書き込み不可カラム名を、カンマ区切りで与えます。
 void setTarget(java.lang.String flag)
          【TAG】サブミット先の文書を表示させるフレーム、またはウィンドウの名前を指定します。
 void setVals(java.lang.String val)
          【TAG】ボタン専用のリクエスト値をCSV形式で複数指定します。
 void setValue(java.lang.String val)
          【TAG】forward したいJSPファイル名を記述します(例:insert,copy,modify,delete など)。
 java.lang.String toString()
          このオブジェクトの文字列表現を返します。
 
クラス org.opengion.hayabusa.taglib.HTMLTagSupport から継承されたメソッド
doEndTag, getMustType, makeMustHidden, setAccesskey, setClazz, setDir, setDisabled, setId, setLang, setMust, setMustAny, setOnBlur, setOnChange, setOnClick, setOndblClick, setOnFocus, setOnKeydown, setOnKeypress, setOnKeyup, setOnMouseDown, setOnMouseMove, setOnMouseOut, setOnMouseOver, setOnMouseUp, setOnSelect, setOptionAttributes, setReadonly, setRoles, setStyle, setTabindex, setTitle
 
クラス 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, 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, setPageContext, setParent, setValue
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
インタフェース javax.servlet.jsp.tagext.Tag から継承されたメソッド
getParent, setPageContext, setParent
 

フィールドの詳細

ACT_INSERT

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

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

ACT_COPY

public static final java.lang.String ACT_COPY
command 引数に渡す事の出来る コマンド 複写 "COPY"

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

ACT_MODIFY

public static final java.lang.String ACT_MODIFY
command 引数に渡す事の出来る コマンド 変更 "MODIFY"

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

ACT_DELETE

public static final java.lang.String ACT_DELETE
command 引数に渡す事の出来る コマンド 削除 "DELETE"

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

ACT_ENTRY

public static final java.lang.String ACT_ENTRY
command 引数に渡す事の出来る コマンド エントリー "ENTRY"

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

ACT_RESET

public static final java.lang.String ACT_RESET
command 引数に渡す事の出来る コマンド リセット "RESET"

関連項目:
定数フィールド値
コンストラクタの詳細

SubmitTag

public SubmitTag()
メソッドの詳細

doStartTag

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

定義:
インタフェース javax.servlet.jsp.tagext.Tag 内の doStartTag
オーバーライド:
クラス CommonTagSupport 内の doStartTag
戻り値:
int 後続処理の指示( SKIP_BODY )
変更履歴:
5.2.2.0 (2010/11/01) 新規追加

release2

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

オーバーライド:
クラス HTMLTagSupport 内の release2
変更履歴:
3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
3.5.5.2 (2004/04/02) target 属性の追加
3.5.5.5 (2004/04/23) keys,vals 属性の追加
5.2.2.0 (2010/11/01) action,columnWritable,noWritable 属性の追加

makeTag

protected java.lang.String makeTag()
サブミットボタンを作成します。

定義:
クラス HTMLTagSupport 内の makeTag
戻り値:
サブミットボタンタグ
変更履歴:
3.3.1.1 (2003/07/03) ForwardManager クラスの廃止。飛び先のキャッシュを廃止します。
3.5.5.2 (2004/04/02) target 属性の追加
3.5.5.9 (2004/06/07) target 属性を、set ではなく add で追加。
3.5.5.9 (2004/06/07) target 属性を、set ではなく add で追加。
4.0.0 (2005/11/30) title 属性が未設定時の処理追加

setAction

public void setAction(java.lang.String act)
【TAG】アクション(INSERT,COPY,MODIFY,DELETE,ENTRY,RESET)を指定します。

パラメータ:
act - アクション文字列
関連項目:
アクション定数
説明:
 Ver5 になって、update.jsp ですべての処理を行う方向で開発するに当たり、
 command と lbl を記述する必要がでてきました。
 そこで、現在最新版では、action 属性を用意し、command を記述するだけで良くなりました。

    [action属性]  [初期設定されるパラメータ郡]
      INSERT       value="update" command="INSERT" lbl="INSERT"  accesskey="I"
      COPY         value="update" command="COPY"   lbl="COPY"    accesskey="C"
      MODIFY       value="update" command="MODIFY" lbl="MODIFY"  accesskey="M"
      DELETE       value="update" command="DELETE" lbl="DELETE"  accesskey="Z"
      ENTRY        value="entry"  command="ENTRY"  lbl="ENTRY"   accesskey="E"
      RESET        value="reset"  command="RESET"  lbl="ENTRY"   accesskey="R"
変更履歴:
5.2.2.0 (2010/11/01) 新規追加

setValue

public void setValue(java.lang.String val)
【TAG】forward したいJSPファイル名を記述します(例:insert,copy,modify,delete など)。

パラメータ:
val - String
説明:
 JSPファイル名は、標準で、insert,copy,modify,delete などと指定します。
 実際には、各JSP画面(insert.jsp,copy.jsp,modify.jsp,delete.jsp )に
 リクエストが転送されます。
 このJSPファイル名は、同一画面ID内のフォルダに属している必要があります。
 ここのIDは、JSP画面そのものですので、大文字小文字は区別されます。

setGamenId

public void setGamenId(java.lang.String id)
【TAG】gamenId 属性を登録します。

パラメータ:
id - gamenId 属性
説明:
 gamenId 属性は、別の画面にforward する場合に使用します。
 実際は、forward ではなく、sendRedirect されます。

setCommand

public void setCommand(java.lang.String cmd)
【TAG】処理コマンドを登録します(初期値:大文字の value 属性値[INSERT,COPY,MODIFY,DELETE など])。

パラメータ:
cmd - コマンド
説明:
 command 属性を指定しない場合は、このvalue 属性値が、コマンドになります。
 value 属性に、insert,copy,modify,delete などと指定されていた場合は、
 それぞれ、INSERT,COPY,MODIFY,DELETE というコマンドになります。
 コマンドは、大文字です。

setTarget

public void setTarget(java.lang.String flag)
【TAG】サブミット先の文書を表示させるフレーム、またはウィンドウの名前を指定します。

パラメータ:
flag - サブミット先の文書のフレーム名(ターゲット属性)
説明:
 サブミット先のフレーム名(ターゲット属性)を設定します。
変更履歴:
3.5.5.2 (2004/04/02) 新規追加

setKeys

public void setKeys(java.lang.String key)
【TAG】ボタン専用のリクエストキーをCSV形式で複数指定します。

パラメータ:
key - ボタンが押された時に転送するキー
説明:
 このサブミットボタンが押された場合のみ、転送されるリクエスト情報の
 キーを設定できます。カンマ区切りで複数指定できます。
 vals 属性には、キーに対応する値を、設定してください。
 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
 こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。
変更履歴:
3.5.5.5 (2004/04/23) 新規追加
3.5.6.2 (2004/07/05) CommonTagSupport#getCSVParameter を使用

setVals

public void setVals(java.lang.String val)
【TAG】ボタン専用のリクエスト値をCSV形式で複数指定します。

パラメータ:
val - keys属性に対応する値
説明:
 キーに対応した値を、カンマ区切り文字で複数指定出来ます。
 指定順序は、キーと同じにしておいて下さい。
 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
 こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。
変更履歴:
3.5.5.5 (2004/04/23) 新規追加
3.5.6.2 (2004/07/05) CommonTagSupport#getCSVParameter を使用

setDbkeys

public void setDbkeys(java.lang.String keys)
【TAG】commonForward の dbkeys にカラム指定を行います。

パラメータ:
keys - String dbkeys のにカラム指定
説明:
 カラム指定は、CSV形式(カンマ区切り)で指定してください。
 なお、引数は、自動的に受けるのではなく、commonForward タグに、
 dbkeys="{@dbkeys}" の記述は必要です。
変更履歴:
4.0.0 (2007/05/23) 新規追加

setColumnWritable

public void setColumnWritable(java.lang.String columnName)
【TAG】書き込み可能カラム名を、カンマ区切りで与えます。

パラメータ:
columnName - String 例:"OYA,KO,HJO,SU,DYSET,DYUPD"
関連項目:
setNoWritable( String )
説明:
 これは、書き込み不可カラム名の指定(noWritable)と同時にセットする
 ことは出来ません。
 なお、カラム名の代わりに、"null" を指定すると、なにも指定しないこと
 になります。つまり、noWritable にすべてのカラムを指定することと
 同じになります。(デフォルトなので、あまり意味はありません。)
 "*" を指定すると、すべてのカラムを(columnWritable)指定したことになります。
変更履歴:
5.2.2.0 (2010/11/01) 新規追加

setNoWritable

public void setNoWritable(java.lang.String columnName)
【TAG】書き込み不可カラム名を、カンマ区切りで与えます。

パラメータ:
columnName - String 例:"OYA,KO,HJO,SU,DYSET,DYUPD"
関連項目:
setColumnWritable( String )
説明:
 これは、書き込み可能カラム名の指定(columnWritable)と同時にセットする
 ことは出来ません。
 なお、カラム名の代わりに、"null" を指定すると、なにも指定しないこと
 になります。つまり、columnWritable にすべてのカラムを指定することと
 同じになります。
 "*" を指定すると、すべてのカラムを(noWritable)指定したことになります。
変更履歴:
5.2.2.0 (2010/11/01) 新規追加

toString

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

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

openGion 5.4.3.3

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