public class ViewTimeBarParamTag extends ViewParamImpl
viewタグの viewFormType が ImageTimeBar の場合にパラメータを設定します。 キー、日時、状況コードを持つ稼働状況の表示を行う、ViewForm_ImageTimeBar クラスに対して、 各種パラメータを設定します。 (パラメータを使用するには、viewタグのuseParam 属性をtrueに設定する必要があります。) SELECT文は、キー、日時、状況コードが、必須項目で、カラムの並び順は、完全に固定です。 よって、カラム位置を指定する必要はありませんが、SELECT文を自由に設定することも 出来ませんので、ご注意ください。 この固定化に伴い、WRITABLE 指定も使用できません。(そもそも書き込み不可です) それ以降のカラムについては、内部処理としては、使用していません。 ただし、パラメータで、カラー色指定、ラベル表記部、イメージ重ね合わせ、 ポップアップ表記、リンク表記に使えます。 データの並び順(ORDER BY)も、キー、日時順にしてください。 データは、キー単位に1レコード作成されます。(キーブレイク)その間、日時順に データを処理します。 データの表示は、今のレコードの日時から、次のレコードの日時までを一つの状態と して表します。今のレコードを表示するには、次のレコードが必要になります。 画面表示は、表示開始日時(minStartTime) から 表示期間(timeSpan)分を表示します。 通常、開始時刻は、表示開始時刻より前より始まり、次のレコードで、終了時刻が決定 されます。最後のデータは、期間満了まで続いていると仮定されます。 データが存在しないのであれば、「存在しないデータ」を作成してください。 ImageTimeBar では、キーでまとめた値について、各状況コードをカラー化し、積み上げ 帯グラフ形式でPNG画像化します。 この画像を、読み込む HTML を出力することで、画面上に、積み上げ帯グラフを表示します。 状況コードに対応する色は、標準では自動作成ですが、外部から色文字列を与えることで 自由に指定する事も可能です。 ポップアップ表記(tipsClm)、リンク表記(linkClm)は、この画像に対するエリア指定タグを出力する事で実現します。 画像ファイルは、全データに対して、1画像だけなので、サイズは大きくなりますが、1レコード 単位に画像を作成しないため、レスポンスは向上します。 それぞれ、viewMarker , viewLink を利用することが可能です。特に、リンク表記(linkClm) については、 linkタグの hrefTarget 属性を true に設定することで適用できます。 画像ファイルは、java.io.File.createTempFile( File ) で作成するため、JavaVM(=Tomcat)が 正常終了するときに、削除されます。異常終了時には残りますが、temp フォルダを定期的に 整理すれば、それほど大量のファイルが残ることはないと思われます。 データは、イベント発生時に作成されると仮定しています。つまり、書き込まれた日時から、 状況コードに対応する状況が発生し、次の状況違いのレコードまで継続していると考えます。 よって、データを途中で切り出す場合、切り出す範囲の前の状態が必要になります。 一番最初の状態は、"不明" として扱います。(空欄=白色)
●形式:<og:timeBarParam startDate="・・・" timeSpan="・・・" ・・・ /> ●body:なし ●Tag定義: <og:timeBarParam startDate ○【TAG】タイムテーブルの表示開始日時をセットします(必須)。 timeSpan ○【TAG】タイムテーブルの表示期間を時間で指定します(必須)。 labelClms 【TAG】一覧表のラベル表示部に表示するカラムをCSV形式で指定します(初期値:キーのRenderer値)。 colorClm 【TAG】レコードに付ける色を色文字列で指定する場合のカラム名を指定します(初期値:指定しない)。 tipsClm 【TAG】レコード単位に、マウスオーバー時のTips表示を行うカラムを指定します(初期値:指定しない)。 linkClm 【TAG】レコード単位に、クリッカブルリンクを設定するカラムを指定します(初期値:指定しない)。 useLegend 【TAG】カラーの凡例を使用するかどうか[true/false]を指定します(初期値:true)。 maxLabelWidth 【TAG】ラベル表記部の最大サイズをpxで指定します(初期値:null)。 maxTimeWidth 【TAG】タイム表記部の最大サイズをpxで指定をpxで指定します(初期値:600)。 chartHeight 【TAG】1行のタイムチャートの幅をpxで指定します(初期値:20)。 headerHeight 【TAG】チャートの凡例、ヘッダー部の高さ(指定されない場合は、チャートの間隔:chartHeight)(初期値:20)。 padding 【TAG】イメージ作成の 全体テーブルの隙間(パディング)をpxで指定します(初期値:5)。 margin 【TAG】1レコードの文字やタイムチャートのマージンをpxで指定します(初期値:3)。 useLastData 【TAG】行の最後の情報が、継続しているとして使うかどうか[true/false]を指定(初期値:true)。 debug 【TAG】内部情報を出力します(初期値:false)。 /> ●使用例 ViewFormTag の viewFormType が、ImageTimeBar の場合に使用します。 useParam 属性を設定しておかないと、使用されません。 <og:view viewFormType = "ImageTimeBar" command = "{@command}" useParam = "true" > <og:timeBarParam startDate = "{@DYFROM}" timeSpan = "24" /> </og:view >
BR, BUFFER_MIDDLE, CR
bodyContent
id, pageContext
EVAL_BODY_BUFFERED, EVAL_BODY_TAG
EVAL_BODY_AGAIN
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE
コンストラクタと説明 |
---|
ViewTimeBarParamTag()
デフォルトコンストラクター
|
修飾子とタイプ | メソッドと説明 |
---|---|
int |
doStartTag()
Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
|
protected java.lang.String |
getTagName()
タグの名称を、返します。
|
void |
setChartHeight(java.lang.String chartHeight)
【TAG】1行のタイムチャートの幅をpxで指定します(初期値:20)。
|
void |
setColorClm(java.lang.String colorClm)
【TAG】レコードに付ける色を色文字列で指定する場合のカラム名を指定します(初期値:指定しない)。
|
void |
setHeaderHeight(java.lang.String headerHeight)
【TAG】チャートの凡例、ヘッダー部の高さをpxで指定します(初期値:20)。
|
void |
setLabelClms(java.lang.String labelClms)
【TAG】一覧表のラベル表示部に表示するカラムをCSV形式で指定します(初期値:キーのRenderer値)。
|
void |
setLinkClm(java.lang.String linkClm)
【TAG】レコード単位に、クリッカブルリンクを設定するカラムを指定します(初期値:指定しない)。
|
void |
setMargin(java.lang.String margin)
【TAG】1レコードの文字やタイムチャートのマージンをpxで指定します(初期値:3)。
|
void |
setMaxLabelWidth(java.lang.String maxLblWidth)
【TAG】ラベル表記部の最大サイズをpxで指定します(初期値:null)。
|
void |
setMaxTimeWidth(java.lang.String maxTmWidth)
【TAG】タイム表記部の最大サイズをpxで指定をpxで指定します(初期値:600)。
|
void |
setPadding(java.lang.String padding)
【TAG】イメージ作成のパディング (全体テーブルの隙間)をpxで指定します(初期値:5)。
|
void |
setStartDate(java.lang.String startDate)
【TAG】タイムテーブルの表示開始日時をセットします(初期値:データの最小日時)。
|
void |
setTimeSpan(java.lang.String timeSpan)
【TAG】タイムテーブルの表示期間を時間で指定します(初期値:24)。
|
void |
setTipsClm(java.lang.String tipsClm)
【TAG】レコード単位に、マウスオーバー時のTips表示を行うカラムを指定します(初期値:指定しない)。
|
void |
setUseLastData(java.lang.String useLastData)
【TAG】行の最後の情報が、継続しているとして使うかどうか[true/false]を指定します(初期値:true)。
|
void |
setUseLegend(java.lang.String useLegend)
【TAG】カラーの凡例を使用可否[true:する/false:しない]を指定します(初期値:true)。
|
doEndTag, initParam, putParam, release2, toString
add, add, addEventColumn, addEventColumn, check, commitTableObject, debugPrint, doAfterBody, doCatch, doFinally, get, getApplicationInfo, getAttributes, getBodyRawString, getBodyString, getContextAttribute, getContextPath, getCookie, getCSVParameter, getCSVParameter, getDataCondition, getDateFormat, getDBColumn, getDBFunctionName, getDocumentLink, getGUIInfo, getGUIInfoAttri, getHostName, getLabel, getLabelInterface, getLanguage, getLASTAttri, getLongLabel, getMsg, getMsglbl, getNVLAttri, getObject, getParameterNames, getParameterRows, getRequest, getRequestAttribute, getRequestCacheData, getRequestMethod, getRequestParameter, getRequestParameterValues, getRequestValue, getRequestValue, getRequestValues, getReservedParameter, getReservedValue, getResource, getSanitizedBodyString, getScope, getSessionAttribute, getSumRequestValue, getTransaction, getUser, getUserEditInfo, getUserInfo, isAjaxSubmitRequest, isDebug, isNoTransitionRequest, isNull, jspPrint, makeUrl, removeContextAttribute, removeObject, removeRequestAttribute, removeSessionAttribute, set, setAjaxSubmitRequest, setCaseIf, setCaseKey, setCaseNN, setCaseNull, setCaseVal, setContextAttribute, setCookie, setDebug, setLanguage, setLbl, setNoTransitionRequest, setObject, setObject, setParameterNames, setParameterRows, setRequestAttribute, setRequestCacheData, setScope, setSessionAttribute, setUserInfo, startQueryTransaction, sys, sysBool, sysInt, useMainTrans, useQuotCheck, useTag, useXssCheck
doInitBody, getBodyContent, getPreviousOut, release, setBodyContent
findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
getParent, setPageContext, setParent
public ViewTimeBarParamTag()
public int doStartTag()
doStartTag
インタフェース内 Tag
doStartTag
クラス内 CommonTagSupport
public void setStartDate(java.lang.String startDate)
startDate
- 表示開始日時public void setTimeSpan(java.lang.String timeSpan)
timeSpan
- 表示期間(時)public void setLabelClms(java.lang.String labelClms)
labelClms
- ラベルカラム (CSV形式)public void setColorClm(java.lang.String colorClm)
colorClm
- 色指定カラム名public void setTipsClm(java.lang.String tipsClm)
tipsClm
- Tips表示カラム名public void setLinkClm(java.lang.String linkClm)
linkClm
- リンク設定カラム名public void setUseLegend(java.lang.String useLegend)
useLegend
- 凡例使用可否 [true:する/false:しない]public void setMaxLabelWidth(java.lang.String maxLblWidth)
maxLblWidth
- ラベル最大幅 (px)public void setMaxTimeWidth(java.lang.String maxTmWidth)
maxTmWidth
- タイム最大幅(px)public void setChartHeight(java.lang.String chartHeight)
chartHeight
- タイムチャートの幅public void setHeaderHeight(java.lang.String headerHeight)
headerHeight
- タイムチャートの幅public void setPadding(java.lang.String padding)
padding
- パディング (全体テーブルの隙間)public void setMargin(java.lang.String margin)
margin
- マージン(px)public void setUseLastData(java.lang.String useLastData)
useLastData
- 継続使用可否 [true:する/false:しない]protected java.lang.String getTagName()
getTagName
クラス内 CommonTagSupport
CommonTagSupport.getDocumentLink()
Webアプリケーションフレームワーク openGionCopyright (c) 2009 The openGion Project.