openGionopenGion
5.5.0.0

org.opengion.hayabusa.taglib
クラス OptionTag

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.OptionTag
すべての実装されたインタフェース:
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 OptionTag
extends HTMLTagSupport

プルダウンメニューの選択項目を作成するHTML拡張タグです。 name 属性は、ラベルリソース のキーを与えることで、使用する上位のタグの ロケールにあわせたリソースを使用して、画面に表示します。 従って、このタグでは ロケールは指定できません。 selected属性は、そのタグが選ばれている場合を、"true" で指定します。 初期値は、"false" です。

関連項目:
直列化された形式
形式サンプル:
 ●形式:<og:option value="…" lbl ="…" selected="…" />
 ●body:なし

 ●使用例
     プルダウンで選択する 値(value) に対して ラベル(lbl) を付けられます。
     <og:select name="ORDER_BY" msg="ORDER_BY">
         <og:option value="SYSTEM_ID,CLM,LANG" lbl ="CLM" selected="selected" />
     </og:select>

     ラベルが複数ある場合は、lbls 属性を使用します。
     <og:select name="ORDER_BY" msg="ORDER_BY">
         <og:option value="SYSTEM_ID,CLM,LANG" lbls="LANG,NAME_JA" />
     </og:select>

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

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

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

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

     選択肢をSELECT文の結果から作成したいときはqueryOptionタグと組み合わせて使います。
     <og:select name="CDC">
         <og:queryOption>
         <jsp:text>
                     select NOSYN,NOSYN,':',NMSYN from DB01 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
 
コンストラクタの概要
OptionTag()
           
 
メソッドの概要
 int doEndTag()
          Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
protected  java.lang.String makeTag()
          ラベルを作成します。
protected  void release2()
          タグリブオブジェクトをリリースします。
 void setLabel(java.lang.String label)
          【TAG】optionタグのラベルを指定します。
 void setLbls(java.lang.String lbls)
          【TAG】ラベルをCSV形式で複数指定します。
 void setSelected(java.lang.String sel)
          【TAG】オプションを選択済みの状態(selected)にセットします(初期値:未選択)。
 void setValue(java.lang.String val)
          【TAG】値を指定します。
 java.lang.String toString()
          このオブジェクトの文字列表現を返します。
 
クラス org.opengion.hayabusa.taglib.HTMLTagSupport から継承されたメソッド
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, doStartTag, 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
 

コンストラクタの詳細

OptionTag

public OptionTag()
メソッドの詳細

doEndTag

public int doEndTag()
Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。

定義:
インタフェース javax.servlet.jsp.tagext.Tag 内の doEndTag
オーバーライド:
クラス HTMLTagSupport 内の doEndTag
戻り値:
int 後続処理の指示
変更履歴:
3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
3.5.4.0 (2003/11/25) selVal 属性を追加。
3.8.0.9 (2005/10/17) 複数選択可能時に全選択を設定する。
4.3.0.0 (2008/07/04) ロールモードマルチ対応
5.0.2.0 (2009/11/01) 複数パラメーターの選択に対応
5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応

release2

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

オーバーライド:
クラス HTMLTagSupport 内の release2
変更履歴:
2.0.0.4 (2002/09/27) カスタムタグの release() メソッドを、追加
3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
3.5.4.0 (2003/11/25) selVal 属性を追加。

makeTag

protected java.lang.String makeTag()
ラベルを作成します。 lbl 属性/msg 属性でセットされた場合は,そちらを優先します。 セットされていない場合は,value 属性をキーに、 LabelResource プロパティの値をセットします。 value 属性に、カンマ(,)で区切られた複数の Label を セットできます。

定義:
クラス HTMLTagSupport 内の makeTag
戻り値:
オプションタグのラベル
変更履歴:
3.5.4.0 (2003/11/25) selVal 属性を追加。
3.5.5.7 (2004/05/10) DBColumn.getOption( String ) メソッド廃止
3.8.0.9 (2005/10/17) 複数選択可能時に全選択を設定する。
5.0.2.0 (2009/11/01) 複数パラメーターの選択に対応

setValue

public void setValue(java.lang.String val)
【TAG】値を指定します。

パラメータ:
val - 値を指定
説明:
 ここで指定した値がプルダウンメニュー中に存在する場合、選択状態になります。

setLabel

public void setLabel(java.lang.String label)
【TAG】optionタグのラベルを指定します。

パラメータ:
label - String
説明:
 ここでのラベルは、optionタグのラベルです。(lbl属性は、異なります。)
 これは、optgroup とともに使用される階層化メニュー時に使用されます。

setSelected

public void setSelected(java.lang.String sel)
【TAG】オプションを選択済みの状態(selected)にセットします(初期値:未選択)。

パラメータ:
sel - 選択済み "selected" /未選択(初期値) それ以外
説明:
 selected="selected" または selected="true" 以外の値はセットできないように
 制限をかけます。

setLbls

public void setLbls(java.lang.String lbls)
【TAG】ラベルをCSV形式で複数指定します。

パラメータ:
lbls - 複数ラベルID(カンマ区切り)
説明:
 シングルラベルの lbl 属性との違いは,ここではラベルを複数 カンマ区切りで
 渡すことが可能であることです。これにより、"A,B,C" という値に対して、
 "Aのラベル表示,Bのラベル表示,Cのラベル表示" という具合に文字列を
 再合成します。
 これは、SQL文のOrdr By 句で、ソート順を指定する場合などに便利です。
 <og:option lbls="MKNMJP,MKCD,MKNMEN" />

 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
 こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。
変更履歴:
3.5.6.2 (2004/07/05) 先に配列に分解してからリクエスト変数の値を取得
5.2.2.0 (2010/11/01) setMsglbl 廃止 ⇒ setLbl に置換え

toString

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

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

openGion 5.5.0.0

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