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

## org.opengion.hayabusa.taglib
クラス SelectTag

    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.SelectTag

すべての実装されたインタフェース:
  Serializable, BodyTag, IterationTag, JspTag, Tag, TryCatchFinally

    public class SelectTag

extends HTMLTagSupport

プルダウンメニューを作成するHTML拡張タグです。 プルダウンメニュー内の選択肢は、selectタグの内容であるoptionタグ、 またはqueryOptionタグによって指定します。 optionタグがセットされない場合は、name属性の、コードリソース からoption文字列より、 プルダウンメニューの選択肢を作成します。 name 属性に ラベルリソース のキーを与えることで、 ロケールにあわせたリソースを使用して、 画面に表示します。ロケールは、ユーザー情報の lang 属性を初期値で使用し、 セットされていない場合は、リクエスト情報のロケールから取得します。 language 属性で定義されている場合は、そちらを優先します。

関連項目:
  直列化された形式
機能階層
  選択データ制御
形式サンプル:

       ●形式：<og:select name="…" />
       ●body：あり

       ●使用例
          <og:select name="CDC">                       CodeResource プロパティの値を使用したいときはcode属性を使います。
              <og:option code="CDC" />
          </og:select>

          <og:select name="CDC">                       選択項目の一番上に項目を付け足すことも可能です。
              <og:option msg="MSG0001" />              MessageResource プロパティの値を使用したいとききはmsg属性を使います。
              <og:option code="CDC" />
          </og:select>

          <og:select name="CDC">                       選択項目の一番上に項目を付け足すことも可能です。
              <og:option lbl="CDC1" />                 LabelResource プロパティの値を使用したいとききはlbl属性を使います。
              <og:option code="CDC" />
          </og:select>

          <og:select name="CDC" multiple="multiple">   選択肢の中から複数選択できるようにするときはmultiple属性を使います。
              <og:option code="CDC" />
          </og:select>

          <og:select name="CDC" disabled="disabled">   選択不可にするときはdisabled属性を使います。
              <og:option code="CDC" />
          </og:select>

          <og:select name="CDC">                       選択肢をSELECT文の結果から作成したいときはqueryOptionタグと組み合わせて使います。
              <og:queryOption>
              <jsp:text>
                          select NOSYN,NOSYN,':',NMSYN from DB01 ORDER BY 1
              </jsp:text>
              </og:queryOption>
          </og:select>

          <og:select name="CDC" eventColumn="OYA" >    親子関係のプルダウンを作る場合
              <og:queryOption>
              <jsp:text>
                          select NOSYN,NOSYN,':',NMSYN from DB01
                           where CLM = "{@OYA}" ORDER BY 1
              </jsp:text>
              </og:queryOption>
          </og:select>

バージョン
  4.0
作成者
  Kazuhiko Hasegawa
導入されたバージョン:
  JDK5.0,

フィールドの概要

クラス 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`

コンストラクタの概要
`SelectTag()`

メソッドの概要
`protected void` | `addOption(String opt)` メニュー項目の選択項目を追加します。
`int` | `doStartTag()` Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
`protected String` | `getEventColumn()` 親のカラムを取得 QueryOptiontagで、eventColumnを取り出して生SQL文の セッションへの登録判断をします
`protected String` | `getValue()` 値を外部から取り出します。
`protected boolean` | `isMultipleAll()` 複数選択可能時に全選択を設定するかどうかを返します。
`protected String` | `makeTag()` 入力用のプルダウンメニューを作成します。
`protected void` | `release2()` タグリブオブジェクトをリリースします。
`void` | `setColspan(String sp)` 【TAG】フィールド部分の colspan を指定します。
`void` | `setDefaultVal(String dv)` 【TAG】value属性に値がセットされていないとき使用する、初期値を指定します。
`void` | `setEventColumn(String col)` 【TAG】イベントカラム（親カラム）を指定します。
`void` | `setEventURL(String url)` 【TAG】イベントカラム指定時に呼び出すURL。
`void` | `setMultiple(String multi)` 【TAG】複数選択を可能(multiple)にします(初期値:未設定)。
`void` | `setMust(String flag)` 【TAG】必須入力を表す色に変えるかどうか(true/false)指定します(初期値:false)。
`void` | `setMustAny(String flag)` 【TAG】選択必須入力(どれかひとつ必須)を表す色(true|mustAny|その他)を指定します(初期値:無指定)。
`void` | `setName(String name)` 【TAG】メニューの名称を指定します。
`void` | `setSize(String size)` 【TAG】リストボックスとして表示する場合の表示行数を指定します。
`void` | `setTd(String flag)` 【TAG】テーブル形式の <td> タグを使用するかどうか(yes/no/false)を指定します(初期値:yes)。
`void` | `setValue(String val)` 【TAG】値を指定します。
`String` | `toString()` このオブジェクトの文字列表現を返します。

クラス org.opengion.hayabusa.taglib.HTMLTagSupport から継承されたメソッド
`doEndTag, setAccesskey, setClazz, setDir, setDisabled, setId, setLang, 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, addEventColumnSQL, 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, 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, useQuotCheck, 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`

コンストラクタの詳細

### SelectTag

    public SelectTag()

メソッドの詳細

### doStartTag

    public int doStartTag()

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

  定義:
    インタフェース `Tag` 内の `doStartTag`
  オーバーライド:
    クラス `CommonTagSupport` 内の `doStartTag`
  戻り値:
    int
  変更履歴:

    5.0.2.0 (2009/11/01) 複数パラメーターの選択に対応

### release2

    protected void release2()

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

  オーバーライド:
    クラス `CommonTagSupport` 内の `release2`
  変更履歴:

    2.0.0.4 (2002/09/27) カスタムタグの release() メソッドを、追加
    2.0.0.8 (2002/10/09) yes/no/false で指定するように変更
    3.0.1.3 (2003/03/11) colspan 属性を追加。
    3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
    3.5.4.0 (2003/11/25) value ,defaultVal 属性を追加。
    3.8.0.9 (2005/10/17) 複数選択可能時に全選択を設定する。
    4.1.2.1 (2008/03/13) must , mustAny 属性を自動化します。
    4.3.6.0 (2009/04/01) eventColumn,eventURL追加

### makeTag

    protected String makeTag()

  入力用のプルダウンメニューを作成します。 表示順の項目名タグは、あらかじめ作成済みの値をここでは受け取ります。 hasSelect 属性の値に応じて，タグの作成方法は変わります。

  定義:
    クラス `HTMLTagSupport` 内の `makeTag`
  戻り値:
    表示順選択用のプルダウンメニュータグ
  変更履歴:

    2.0.0.8 (2002/10/09) yes/no/false で指定するように変更
    2.0.1.0 (2002/10/10) ラベルとフィールドのセパレーターとして、コロン（：）を使用するかどうかを指定できる
    3.0.1.3 (2003/03/11) colspan 属性を追加。
    3.5.4.0 (2003/11/25) value ,defaultVal 属性を追加。
    4.0.0 (2005/01/31) マルチセレクションのON/OFFをここで指定。
    4.1.2.1 (2008/03/13) must , mustAny 属性を自動化します。
    4.3.6.0 (2009/04/01) eventColumn対応
    4.3.7.1 (2009/06/08) id=labelのclass化

### addOption

    protected void addOption(String opt)

  メニュー項目の選択項目を追加します。 select タグのBODY要素の OptionTag よりアクセスされます。

  パラメータ:
    `opt` - オプションタグ文字列
  変更履歴:

    3.1.2.0 (2003/04/07) taglib パッケージ内部で使用している箇所を protected 化する。

### setName

    public void setName(String name)

  【TAG】メニューの名称を指定します。

  パラメータ:
    `name` - String
  TagLib:

    メニューの名称を指定します。

### setSize

    public void setSize(String size)

  【TAG】リストボックスとして表示する場合の表示行数を指定します。

  パラメータ:
    `size` - String
  TagLib:

    表示行数を指定します。

### setMultiple

    public void setMultiple(String multi)

  【TAG】複数選択を可能(multiple)にします(初期値:未設定)。

  パラメータ:
    `multi` - 複数選択("multiple" または "true") ,初期値全選択( "ALL" )
  TagLib:

    multiple 値が "multiple" または "true" の場合、複数選択状態になります。 また、"ALL" を設定する場合は、OptionTag上で、すべてのOption が選択状態に 初期設定されます。 大文字、小文字の種別はなくしますが、指定以外の文字が設定された場合は、エラーになります。

  変更履歴:

    3.8.0.9 (2005/10/17) 複数選択可能時に全選択を設定する。

### setMust

    public void setMust(String flag)

  【TAG】必須入力を表す色に変えるかどうか(true/false)指定します(初期値:false)。

  パラメータ:
    `flag` - 必須入力 ("true")／必須でない (それ以外)
  TagLib:

    初期値は、必須でない("false") です。 (注意)必須チェックとは連動していません。

  変更履歴:

    4.0.0 (2005/02/28) must属性の登録を、id属性から、class 属性に変更します。
    4.1.2.1 (2008/03/13) must属性を自動化します。

### setMustAny

    public void setMustAny(String flag)

  【TAG】選択必須入力(どれかひとつ必須)を表す色(true|mustAny|その他)を指定します(初期値:無指定)。

  パラメータ:
    `flag` - 選択必須入力(どれかひとつ必須)を表す色を指定(true|mustAny|その他)
  TagLib:

    複数のカラムのうち、どれかひとつを必須とする選択必須入力を示す色を指定します。 true または、mustAny を設定すると、class属性に、mustAny がセットされます。 mustAny は、CSSファイルに初期設定されています。true または、mustAny 以外の値をセット すると、その値がそのまま、class属性にセットされますので、選択必須のグループ化が 可能です。 なお、実際の選択必須入力チェックは、ここではなく、columnCheck タグで指定が必要です。 自動処理は、mustAny="true" 指定の場合のみ有効です。 初期値は、無指定です。

  変更履歴:

    3.8.0.9 (2005/10/17) 新規追加
    4.1.2.1 (2008/03/13) mustAny属性を自動化します。

### setTd

    public void setTd(String flag)

  【TAG】テーブル形式の <td> タグを使用するかどうか(yes/no/false)を指定します(初期値:yes)。

  パラメータ:
    `flag` - yes:<td> タグを使用 / no:ラベルとフィールド / false:フィールドのみ
  TagLib:

    初期値は、使用する("yes") です。

  変更履歴:

    2.0.0.8 (2002/10/09) yes/no/false で指定するように変更

### setColspan

    public void setColspan(String sp)

  【TAG】フィールド部分の colspan を指定します。

  パラメータ:
    `sp` - フィールド部分の colspan
  TagLib:

    通常は、3 を指定して、フィールド、ラベル、フィールドの 組み合わせ部分に、長いフィールドが適用されるように使用します。 <og:select name="CDK" colspan="3" />

  変更履歴:

    3.0.1.3 (2003/03/11) colspan 属性を追加。

### setValue

    public void setValue(String val)

  【TAG】値を指定します。

  パラメータ:
    `val` - String
  TagLib:

    ここで指定された値が、optionタグの値と同じであれば、選択状態になります。 <og:select name="CDC" value="{@ABC}" defaultVal="XYZ" > <og:option value="ABC" lbl="CDC1" /> <og:option value="XYZ" lbl="CDC2" /> </og:select>

  変更履歴:

    3.5.4.0 (2003/11/25) 新規作成
    5.0.2.0 (2009/11/01) 複数パラメーターの選択に対応

### getValue

    protected String getValue()

  値を外部から取り出します。 OptionTag で、value を取り出して、内部の値と同じ場合は、選択状態にします。

  戻り値:
    val String
  変更履歴:

    3.5.4.0 (2003/11/25) 新規作成

### getEventColumn

    protected String getEventColumn()

  親のカラムを取得 QueryOptiontagで、eventColumnを取り出して生SQL文の セッションへの登録判断をします

  戻り値:
    イベントカラム
  変更履歴:

    4.3.6.0 (2009/04/01)

### setEventColumn

    public void setEventColumn(String col)

  【TAG】イベントカラム（親カラム）を指定します。

  パラメータ:
    `col` - String
  TagLib:

    親子関係のカラムを作成する場合に利用します。 queryOptionタグとセットで利用して下さい。 詳しくはcolumnTagの説明をご覧下さい。

  変更履歴:

    4.3.6.0 (2009/04/01)

### setEventURL

    public void setEventURL(String url)

  【TAG】イベントカラム指定時に呼び出すURL。

  パラメータ:
    `url` -
  TagLib:

    イベントカラム指定時に部品を作成するJSPを指定します。 初期値はシステムリソースのEVENT_COLUMN_URLです。 (例：eventURL="makeColumn_custom.jsp")

  変更履歴:

    4.3.6.0 (2009/04/01)

### isMultipleAll

    protected boolean isMultipleAll()

  複数選択可能時に全選択を設定するかどうかを返します。 これは、上位入れ子のタグの OptionTag で、multipleAll を取り出して、 true であれば、全選択に設定します。

  戻り値:
    boolean 全選択:true / 通常:false
  変更履歴:

    3.8.0.9 (2005/10/17) 新規作成

### setDefaultVal

    public void setDefaultVal(String dv)

  【TAG】value属性に値がセットされていないとき使用する、初期値を指定します。

  パラメータ:
    `dv` - 初期値
  TagLib:

    value属性に値がセットされていないときに、初期値をセットします。

  変更履歴:

    3.5.4.0 (2003/11/25) 新規作成
    5.0.2.0 (2009/11/01) 複数パラメーターの選択に対応

### toString

    public String toString()

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

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

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

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