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

## 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` | `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, 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 属性の追加
    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` - String
  説明:

         ＪＳＰファイル名は、標準で、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` - 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) 新規追加

### setImg

    public void setImg(java.lang.String image)

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

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

         画像ボタン作成支援の属性です。
         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.5.0.1
前のクラス 次のクラス | フレームあり フレームなし
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド

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