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 |
メソッドの概要 |
protected void |
addOption(java.lang.String opt)
メニュー項目の選択項目を追加します。 |
int |
doStartTag()
Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。 |
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】メニューの名称を指定します。 |
protected void |
setRawParam(java.lang.String param)
パラメーター変換({@XXXX}の置き換えをしない状態のパラメーターをセットします。 |
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, 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, setContextAttribute, setCookie, setDebug, setLanguage, setLbl, setMsglbl, setNoTransitionRequest, setObject, setParameterRows, setRequestAttribute, setRequestCacheData, setScope, setSessionAttribute, setUserInfo, startQueryTransaction, sys, sysBool, sysInt, useMainTrans, 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
- 変更履歴:
5.0.2.0 (2009/11/01) 複数パラメーターの選択に対応 |
5.1.7.0 (2010/06/01) command=RENEWの場合はdefaultValを無視する。 |
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追加 |
5.1.7.0 (2010/06/01) 動的プルダウン実装見直し |
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化 |
5.1.7.0 (2010/06/01) 動的プルダウン実装見直し |
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:
- 変更履歴:
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) 新規作成 |
5.0.2.0 (2009/11/01) 複数パラメーターの選択に対応 |
getValue
protected java.lang.String getValue()
- 値を外部から取り出します。
OptionTag で、value を取り出して、内部の値と同じ場合は、選択状態にします。
- 戻り値:
- val String
- 変更履歴:
3.5.4.0 (2003/11/25) 新規作成 |
setEventColumn
public void setEventColumn(java.lang.String col)
- 【TAG】イベントカラム(親カラム)を指定します。
- パラメータ:
col
- String- TagLib:
親子関係のカラムを作成する場合に利用します。
queryOptionタグとセットで利用して下さい。
※詳細はcolumnTagのeventColumn属性の説明をご覧下さい。 |
- 変更履歴:
setEventURL
public void setEventURL(java.lang.String url)
- 【TAG】イベントカラム指定時に呼び出すURL。
- パラメータ:
url
- - TagLib:
イベントカラム指定時に部品を作成するJSPを指定します。
初期値はシステムリソースのEVENT_COLUMN_URLです。
(例:eventURL="makeColumn_custom.jsp")
※詳細はcolumnTagのeventURL属性の説明をご覧下さい。 |
- 変更履歴:
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属性に値がセットされていないときに、初期値をセットします。
なお、commandがRENEWの場合は、このdefaultValは適用されません。
これは、defaultValの値が埋め込まれた項目が存在する画面に戻った際に、
defaultValの項目の値がnullとなっていた場合に、defaultValの値が復元されると、
検索結果との不一致が発生するためです。 |
- 変更履歴:
3.5.4.0 (2003/11/25) 新規作成 |
5.0.2.0 (2009/11/01) 複数パラメーターの選択に対応 |
setRawParam
protected void setRawParam(java.lang.String param)
- パラメーター変換({@XXXX}の置き換えをしない状態のパラメーターをセットします。
- パラメータ:
param
- String- 変更履歴:
5.1.7.0 (2010/06/01) 新規作成(動的プルダウン実装見直し) |
toString
public java.lang.String toString()
- このオブジェクトの文字列表現を返します。
基本的にデバッグ目的に使用します。
- オーバーライド:
- クラス
CommonTagSupport
内の toString
- 戻り値:
- このクラスの文字列表現
Webアプリケーションフレームワーク openGion
Copyright (c) 2009 The openGion Project.