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

## 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：なし

       ●Tag定義：
         <og:submit
             action             【TAG】アクション(INSERT,COPY,MODIFY,DELETE,ENTRY,RESET)を指定します
             value              【TAG】forward したいＪＳＰファイル名を記述します(例:insert,copy,modify,delete など)
             command            【TAG】処理コマンドを登録します(初期値:大文字の value 属性値[INSERT,COPY,MODIFY,DELETE など])
             gamenId            【TAG】gamenId 属性を登録します
             lbl                【TAG】ラベルリソースのラベルIDを指定します
             target             【TAG】サブミット先の文書を表示させるフレーム、またはウィンドウの名前を指定します
             keys               【TAG】ボタン専用のリクエストキーをCSV形式で複数指定します
             vals               【TAG】ボタン専用のリクエスト値をCSV形式で複数指定します
             roles              【TAG】ロールをセットします
             dbkeys             【TAG】commonForward の dbkeys にカラム指定を行います
             optionAttributes   【TAG】JavaScript などの HTML基本タグ以外の属性を、そのままタグとして使用します
             columnWritable     【TAG】書き込み可能カラム名を、カンマ区切りで与えます
             noWritable         【TAG】書き込み不可カラム名を、カンマ区切りで与えます
             caseKey            【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null)
             caseVal            【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null)
             id                 【HTML】要素に対して固有の名前(id)をつける場合に設定します
             lang               【HTML】要素の内容と他の属性値の言語(lang,xml:lang)を指定します
             dir                【HTML】文字表記の方向(dir)を指定します
             title              【HTML】要素に対する補足的情報(title)を設定します
             style              【HTML】この要素に対して適用させるスタイルシート(style)を設定します
             readonly           【TAG】その部品に対して変更が出来ないように(readonly)指定します(サーバーに送信される)
             disabled           【TAG】その部品に対して、選択や変更が出来ないように(disabled)指定します(サーバーに送信されない)
             tabindex           【HTML】タブの移動順(tabindex)を指定します(0 ～ 32767)
             accesskey          【HTML】アクセスキー(alt+キーで直接指定)を割り当てます
             clazz              【HTML】要素に対して class 属性を設定します
             language           【TAG】タグ内部で使用する言語コード[ja/en/zh/…]を指定します
             onClick            【HTML】JavaScriptのイベント onClick を設定します(例:onClick="renew('query.jsp','QUERY');")
             onBlur             【HTML】JavaScriptのイベント onBlur を設定します(例:onBlur="this.value=value.toUpperCase();")
             onFocus            【HTML】JavaScriptのイベント onFocus を設定します
             ondblClick         【HTML】JavaScriptのイベント ondblClick を設定します
             onMouseDown        【HTML】JavaScriptのイベント onMouseDown を設定します
             onMouseUp          【HTML】JavaScriptのイベント onMouseUp を設定します
             onMouseMove        【HTML】JavaScriptのイベント onMouseMove を設定します
             onMouseOut         【HTML】JavaScriptのイベント onMouseOut を設定します
             onMouseOver        【HTML】JavaScriptのイベント onMouseOver を設定します
             img                【TAG】画像ボタンを作る場合の、画像ファイルを指定します
             debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
         />

       ●使用例
           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` | `setImg(java.lang.String image)` 【TAG】画像ボタンを作る場合の、画像ファイルを指定します。
`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 したいＪＳＰファイル名を記述します(例: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, getReservedParameter, getReservedValue, 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`
  戻り値:
    後続処理の指示( 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 属性の追加
    5.5.0.0 (2012/03/01) bgImg追加

### 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 属性が未設定時の処理追加
    5.5.0.0 (2012/03/01) bgImg対応

### 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 したいＪＳＰファイル名を記述します(例:insert,copy,modify,delete など)。

  パラメータ:
    `val` - ＪＳＰファイル名(insert,copy,modify,delete など)
  説明:

         ＪＳＰファイル名は、標準で、insert,copy,modify,delete などと指定します。
         実際には、各JSP画面(insert.jsp,copy.jsp,modify.jsp,delete.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` - dbkeys のにカラム指定
  説明:

         カラム指定は、CSV形式(カンマ区切り)で指定してください。
         なお、引数は、自動的に受けるのではなく、commonForward タグに、
         dbkeys="{@dbkeys}" の記述は必要です。

  変更履歴:

    4.0.0 (2007/05/23) 新規追加

### setColumnWritable

    public void setColumnWritable(java.lang.String columnName)

  【TAG】書き込み可能カラム名を、カンマ区切りで与えます。

  パラメータ:
    `columnName` - 例："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` - 例："OYA,KO,HJO,SU,DYSET,DYUPD"
  関連項目:
    `setColumnWritable( String )`
  説明:

         これは、書き込み可能カラム名の指定(columnWritable)と同時にセットする
         ことは出来ません。
         なお、カラム名の代わりに、"null" を指定すると、なにも指定しないこと
         になります。つまり、columnWritable にすべてのカラムを指定することと
         同じになります。
         "*" を指定すると、すべてのカラムを(noWritable)指定したことになります。

  変更履歴:

    5.2.2.0 (2010/11/01) 新規追加

### setImg

    public void setImg(java.lang.String image)

  【TAG】画像ボタンを作る場合の、画像ファイルを指定します。

  パラメータ:
    `image` - ボタンの背景画像
  説明:

         画像ボタン作成支援の属性です。
         inputタグでtype=imageにした場合、IEではname,valueのセットが
         次の画面に渡されない仕様になっているためエンジンのsubmitでは
         利用できません。(どのボタンが押されたか分からない)
         そこで、typeはsubmitのままcssの背景画像としてここで指定した
         画像を配置します。
         内部的にはbackground: url(imgFile) left top no-repeat;
         をstyleタグに書く事と同じです。
         高さ、幅は把握できないため、別途style属性でhight,widthを指定して下さい。

  変更履歴:

    5.5.0.0 (2012/03/01) 新規追加

### toString

    public java.lang.String toString()

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

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

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

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