openGionopenGion
5.0.0.2

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

定義:
インタフェース javax.servlet.jsp.tagext.Tag 内の doStartTag
オーバーライド:
クラス CommonTagSupport 内の doStartTag
戻り値:
int

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 java.lang.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(java.lang.String opt)
メニュー項目の選択項目を追加します。 select タグのBODY要素の OptionTag よりアクセスされます。

パラメータ:
opt - オプションタグ文字列
変更履歴:
3.1.2.0 (2003/04/07) taglib パッケージ内部で使用している箇所を protected 化する。

setName

public void setName(java.lang.String name)
【TAG】メニューの名称を指定します。

パラメータ:
name - String
TagLib:
メニューの名称を指定します。

setSize

public void setSize(java.lang.String size)
【TAG】リストボックスとして表示する場合の表示行数を指定します。

パラメータ:
size - String
TagLib:
表示行数を指定します。

setMultiple

public void setMultiple(java.lang.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(java.lang.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(java.lang.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(java.lang.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(java.lang.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(java.lang.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) 新規作成

getValue

protected java.lang.String getValue()
値を外部から取り出します。 OptionTag で、value を取り出して、内部の値と同じ場合は、選択状態にします。

戻り値:
val String
変更履歴:
3.5.4.0 (2003/11/25) 新規作成

getEventColumn

protected java.lang.String getEventColumn()
親のカラムを取得 QueryOptiontagで、eventColumnを取り出して生SQL文の セッションへの登録判断をします

戻り値:
イベントカラム
変更履歴:
4.3.6.0 (2009/04/01)

setEventColumn

public void setEventColumn(java.lang.String col)
【TAG】イベントカラム(親カラム)を指定します。

パラメータ:
col - String
TagLib:
親子関係のカラムを作成する場合に利用します。 queryOptionタグとセットで利用して下さい。 詳しくはcolumnTagの説明をご覧下さい。
変更履歴:
4.3.6.0 (2009/04/01)

setEventURL

public void setEventURL(java.lang.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(java.lang.String dv)
【TAG】value属性に値がセットされていないとき使用する、初期値を指定します。

パラメータ:
dv - 初期値
TagLib:
value属性に値がセットされていないときに、初期値をセットします。
変更履歴:
3.5.4.0 (2003/11/25) 新規作成

toString

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

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

openGion 5.0.0.2

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