001/* 002 * Copyright (c) 2009 The openGion Project. 003 * 004 * Licensed under the Apache License, Version 2.0 (the "License"); 005 * you may not use this file except in compliance with the License. 006 * You may obtain a copy of the License at 007 * 008 * http://www.apache.org/licenses/LICENSE-2.0 009 * 010 * Unless required by applicable law or agreed to in writing, software 011 * distributed under the License is distributed on an "AS IS" BASIS, 012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, 013 * either express or implied. See the License for the specific language 014 * governing permissions and limitations under the License. 015 */ 016package org.opengion.plugin.view; 017 018import org.opengion.hayabusa.common.HybsSystemException; 019import org.opengion.fukurou.util.StringUtil; 020import org.opengion.fukurou.util.ColorMap; // 6.0.2.1 (2014/09/26) 021import org.opengion.fukurou.system.OgBuilder ; // 6.4.4.1 (2016/03/18) 022 023import java.util.Calendar; 024import java.util.Map; 025import java.util.TreeMap; 026import java.util.Collection; 027import java.util.Locale ; 028import java.util.Date; 029import java.text.DateFormat; 030import java.text.SimpleDateFormat; 031 032import java.awt.Graphics2D; 033import java.awt.Color; 034import java.awt.FontMetrics; 035import java.awt.Stroke; 036import java.awt.BasicStroke; 037import java.awt.image.BufferedImage; 038 039import javax.imageio.ImageIO; 040import java.io.File; 041import java.io.IOException; 042 043/** 044 * キー、日時、状況コードを持つ稼働状況の表示を行うクラスです。 045 * 046 * パラメータが必要な場合は、ViewTimeBarParamTag を使用してください。 047 * 048 * パラメータが設定されていない場合は、ViewForm_ImageTimeBar の初期値が使用されます。 049 * (パラメータを使用するには、viewタグのuseParam 属性をtrueに設定する必要があります。) 050 * 051 * SELECT文は、キー、日時、状況コードが、必須項目で、カラムの並び順は、完全に固定です。 052 * よって、カラム位置を指定する必要はありませんが、SELECT文を自由に設定することも 053 * 出来ませんので、ご注意ください。 054 * この固定化に伴い、WRITABLE 指定も使用できません。(そもそも書き込み不可です) 055 * それ以降のカラムについては、内部処理としては、使用していません。 056 * ただし、パラメータで、カラー色指定、ラベル表記部、イメージ重ね合わせ、 057 * ポップアップ表記、リンク表記に使えます。 058 * 059 * データの並び順(ORDER BY)も、キー、日時順にしてください。 060 * データは、キー単位に1レコード作成されます。(キーブレイク)その間、日時順に 061 * データを処理します。 062 * 063 * データの表示は、今のレコードの日時から、次のレコードの日時までを一つの状態と 064 * して表します。今のレコードを表示するには、次のレコードが必要になります。 065 * 画面表示は、表示開始日時(minStartTime) から 表示期間(timeSpan)分を表示します。 066 * 通常、開始時刻は、表示開始時刻より前より始まり、次のレコードで、終了時刻が決定 067 * されます。最後のデータは、期間満了まで続いていると仮定されます。 068 * データが存在しないのであれば、「存在しないデータ」を作成してください。 069 * 070 * ImageTimeBar では、キーでまとめた値について、各状況コードをカラー化し、積み上げ 071 * 帯グラフ形式でPNG画像化します。 072 * この画像を、読み込む HTML を出力することで、画面上に、積み上げ帯グラフを表示します。 073 * 状況コードに対応する色は、標準では自動作成ですが、外部から色文字列(colorClm)を与えることで 074 * 自由に指定する事も可能です。 075 * 076 * ポップアップ表記(tipsClm)、リンク表記(linkClm)は、この画像に対するエリア指定タグを出力する事で実現します。 077 * 画像ファイルは、全データに対して、1画像だけなので、サイズは大きくなりますが、1レコード 078 * 単位に画像を作成しないため、レスポンスは向上します。 079 * それぞれ、viewMarker , viewLink を利用することが可能です。特に、リンク表記(linkClm) については、 080 * linkタグの hrefTarget 属性を true に設定することで適用できます。 081 * 082 * 画像ファイルは、java.io.File.createTempFile( File ) で作成するため、JavaVM(=Tomcat)が 083 * 正常終了するときに、削除されます。異常終了時には残りますが、temp フォルダを定期的に 084 * 整理すれば、それほど大量のファイルが残ることはないと思われます。 085 * 086 * データは、イベント発生時に作成されると仮定しています。つまり、書き込まれた日時から、 087 * 状況コードに対応する状況が発生し、次の状況違いのレコードまで継続していると考えます。 088 * よって、データを途中で切り出す場合、切り出す範囲の前の状態が必要になります。 089 * 一番最初の状態は、"不明" として扱います。(空欄=白色) 090 * 091 * @og.rev 5.5.5.6 (2012/08/31) 新規追加 092 * @og.group 画面表示 093 * 094 * @version 4.0 095 * @author Kazuhiko Hasegawa 096 * @since JDK5.0, 097 */ 098public class ViewForm_ImageTimeBar extends ViewForm_HTMLTable { 099 /** このプログラムのVERSION文字列を設定します。 {@value} */ 100 private static final String VERSION = "6.7.9.1 (2017/05/19)" ; 101 102 private static final Color LABEL_COLOR = Color.BLACK; // ラベル記述時の色 103 private static final Color NULL_COLOR = Color.WHITE; // 5.6.1.1 (2013/02/08) 不明(空欄)時の色 104 105 private static final int M_60 = 60; // 6.1.0.0 (2014/12/26) refactoring 106 private static final int H_24 = 24; // 6.1.0.0 (2014/12/26) refactoring 107 private static final int W_7 = 7; // 6.1.0.0 (2014/12/26) refactoring 108 private static final int DEC = 10; // 6.1.0.0 (2014/12/26) refactoring 109 110 private static final int MINUTE_OF_DAY = 24 * 60 ; // 6.0.2.0 (2014/09/19) 1日が何分 なのか(=1440) 111 private static final long MILLI_MINUTE = 60 * 1000L; // 6.0.2.0 (2014/09/19) ミリ秒に換算した分。(=60000L) 112 113 // 5.6.5.0 (2013/06/07) 曜日データを配列で持っておきます。 114 // 6.4.1.1 (2016/01/16) DAY_OF_WEEK_ja → DAY_OF_WEEK_JA refactoring 115 private static final String[] DAY_OF_WEEK_JA = { "土","日","月","火","水","木","金","土" }; // [0]="土" は、1~7 の余計算で、 7=0 になる為。 116 117 private long startDate ; // タイムテーブルの表示開始日時から求めた long 値(1=分単位) 118 private long timeSpan ; // タイムテーブルの表示期間。元は時間指定であるが、分単位で持つ。(1=分単位) 119 120 private boolean useLegend ; // カラーの凡例を使用するかどうか[true/false] 121 private int maxLabelWidth ; // ラベル表記部の最大サイズをpxで指定。何もなければ、可変長サイズ 122 private int maxTimeWidth ; // タイム表記部の最大サイズをpxで指定。 123 private int chartHeight ; // 1レコードのチャートの間隔をpxで指定。実際の幅は、CHART_HEIGHT+MARGIN*2 124 private int headerHeight ; // 6.4.6.1 (2016/06/03) チャートのヘッダー部の高さ(初期値は、チャートの間隔:chartHeight) 125 private int chartPadding ; // イメージ作成の 全体テーブルの隙間 126 private int recodeMargin ; // 各レコード、文字等の内部の間隔 127 private boolean useLastData ; // 5.6.1.1 (2013/02/08) 行の最後の情報が、継続しているとして使うかどうか[true/false] 128 private boolean isDebug ; // 6.4.8.2 (2016/07/08) debug 属性を、パラメータにセットします[true/false]。 129 130 private String tempDir ; // 画像ファイルを作成するテンポラリディレクトリ(相対パス) 131 private String tempUrl ; // 作成した画像ファイルを取得するときに使用するURL(コンテキスト/相対パス) 132 133 // SELECT文は、キー、日時、状況コードが、必須項目 134 // 6.4.1.1 (2016/01/16) keyClmNo → KEY_CLMNO , dyClmNo → DY_CLMNO , fgjClmNo → FGJ_CLMNO refactoring 135 private static final int KEY_CLMNO = 0; // ヘッダー1:キーカラムNo 136 private static final int DY_CLMNO = 1; // ヘッダー2:日時カラムNo 137 private static final int FGJ_CLMNO = 2; // ヘッダー3:状況コードカラムNo 138 139 private int[] labelClmsNo ; // 初期値は、キーカラム 140 private int[] maxClmWidth ; // labelClms 単位の最大文字列長 141 private int colClmNo = -1; // カラーコード直接指定する場合に色文字列を指定するカラムNo 142 private int tipsClmNo = -1; // マウスオーバー時のTips表示を行うカラムNo 143 private int linkClmNo = -1; // クリッカブルリンクを設定するカラムNo 144 145 private int str2DateTime ; // getStr2Date(String)処理をおこなった時の、引数の時刻情報(分単位)をセットするテンポラリ変数。 146 private int startTime ; // startDate の時刻情報。上記処理で、startDate を getStr2Date(String) 処理したときの値を持っておくための変数。 147 private long nowTime ; // 6.0.2.0 (2014/09/19) データがない最後の処理で使用する現在時刻 148 149 // 6.3.9.0 (2015/11/06) Variables should start with a lowercase character(PMD) 150 private int maxX ; // イメージの最大横幅(X)方向のサイズpx。chartPadding*2 + maxLabelWidth + maxTimeWidth ; 151 private int maxY ; // イメージの最大縦幅(Y)方向のサイズpx。chartPadding*2 + (headerHeight+recodeMargin*2)*2 + (chartHeight+recodeMargin*2)*(rowCnt-2); 152 153 // imageHeaderPaintメソッドで使用する 破線の定義 154 private static final Stroke DSAH_STROK = new BasicStroke( 155 1.0f , // BasicStroke の幅 156 BasicStroke.CAP_BUTT , // 両端の装飾 157 BasicStroke.JOIN_MITER , // 輪郭線セグメントの接合部の装飾 158 1.0f , // 接合トリミングの制限値 159 new float[] {2.0f, 1.0f} , // 破線パターンを表す配列 160 0.0f // 破線パターン開始位置のオフセット 161 ); 162 163 /** 164 * DBTableModel から HTML文字列を作成して返します。 165 * startNo(表示開始位置)から、pageSize(表示件数)までのView文字列を作成します。 166 * 表示残りデータが pageSize 以下の場合は,残りのデータをすべて出力します。 167 * 168 * @og.rev 5.6.1.0 (2013/02/01) tips や link は、ひとつ前のデータで作成する必要がる為、最初の1件目は、処理しないように修正 169 * @og.rev 5.6.1.1 (2013/02/08) 初期値の色を、直接の値ではなく、static final で定義された色を使用する。色自体は変えていません 170 * @og.rev 5.6.1.1 (2013/02/08) useLastData 追加 171 * @og.rev 5.6.3.0 (2013/04/01) tipsのシングルクォーテーション のエスケープ 172 * @og.rev 5.6.3.1 (2013/04/05) 短縮ラベルなど、<span>タグが付与される値から、spanタグを削除します。 173 * @og.rev 6.0.2.0 (2014/09/19) データが存在しない最後の処理で、現在時刻まで、継続しているとします。 174 * @og.rev 6.4.2.0 (2016/01/29) alt属性にtitle属性を追記。 175 * @og.rev 6.4.4.1 (2016/03/18) StringBuilderの代わりに、OgBuilderを使用する。 176 * @og.rev 6.4.4.2 (2016/04/01) 引数を、Supplierクラスに変更して、結果を複数指定できるようにします。 177 * @og.rev 6.4.6.1 (2016/06/03) ヘッダー部の高さを指定できるようにする。 178 * @og.rev 6.4.7.1 (2016/06/17) useLastData属性は、最後の処理のみに適用する。 179 * @og.rev 6.4.8.2 (2016/07/08) 未来時刻の場合に、現在時刻まで巻き戻って塗りつぶしているので、未来時刻の判定を追加。 180 * @og.rev 6.7.5.0 (2017/03/10) COLOR_CLM の値を、getValueLabel で取得するように変更。 181 * 182 * @param startNo 表示開始位置 183 * @param pageSize 表示件数 184 * 185 * @return DBTableModelから作成された HTML文字列 186 * @og.rtnNotNull 187 */ 188 @Override 189 public String create( final int startNo, final int pageSize ) { 190 if( getRowCount() == 0 ) { return ""; } // 暫定処置 191 192 // パラメータの情報を初期化&取得します。 193 paramInit(); 194 195 final int lastNo = getLastNo( startNo, pageSize ); 196 197 // イメージの 最大X、Yサイズを求め、結果を、maxX,maxY 変数に設定する。 198 calcImageSize( startNo,lastNo ); 199 200 final BufferedImage img = new BufferedImage( maxX, maxY, BufferedImage.TYPE_INT_ARGB); 201 final Graphics2D g2 = img.createGraphics(); 202 203 // chartPadding を考慮した領域のクリップ(クリップ外にDrowされても無視されます。) 204 g2.setClip( chartPadding , chartPadding , maxX-chartPadding*2+1 , maxY-chartPadding*2+1 ); // (x 座標,y 座標,幅,高さ) +1は罫線の分 205 206 final StringBuilder out = new StringBuilder( BUFFER_LARGE ); 207 208 String oldKeyVal = ""; // 初期値。1回目にキーブレイクさせる。 209 long oldTime = 0L; // 日付項目の一つ前の値 210 211 Color oldColor = NULL_COLOR; // 5.6.1.1 (2013/02/08) 不明(空欄)時の色(初期値) 212 213 // 6.0.2.1 (2014/09/26) fukurou.util.ColorMap とクラス名がかぶるので、こちらを変更します。 214 final FlgColorMap colMap = new FlgColorMap(); // 状況コード、ラベル、カラーを管理するクラス 215 216 // 6.4.6.1 (2016/06/03) ヘッダー部の高さを指定できるようにする。 217 // ヘッダー文の考慮。rowCnt は、使わず、imgY は、加算していきます。 218 219 int imgY = chartPadding + (headerHeight+recodeMargin*2)*(useLegend ? 2 : 1); // 6.4.6.1 (2016/06/03) 220 221 final int rowH = chartHeight+recodeMargin*2; // 罫線出力時の高さ(drawRectで使用) 222 223 final double timeScale = (double)maxTimeWidth/(double)timeSpan; 224 final boolean useTipsLink = tipsClmNo >= 0 || linkClmNo >= 0 ; // tipsClm か linkClm かどちらかを使用する場合、true 225 226 for( int row=startNo; row<lastNo; row++ ) { 227 // キーブレイクの判定 228 final String keyVal = getValue( row,KEY_CLMNO ); 229 final String dyVal = getValue( row,DY_CLMNO ); 230 231 // キーブレイク判定。キーブレイクは、一番初めから来る。 232 if( !oldKeyVal.equals( keyVal ) ) { 233 // キーブレイクで最初に行うのは、前のレコードの未出力分の処理。1行目は、処理不要 234 if( row > startNo ) { 235 // 6.0.2.0 (2014/09/19) データが存在しない最後の処理で、現在時刻まで、継続しているとします。 236 long lastTime = nowTime ; // 現在時刻(分単位に変換する) 237 // 5.9.10.5 (2016/07/08) 現在時刻がtimeSpanより大きいor最終値より小さい場合は、lastTimeをtimeSpanにする。 238 if( lastTime > timeSpan || lastTime < oldTime ) { lastTime = timeSpan; } // 5.9.10.5 (2016/07/08) 239 240 if( !useLastData ) { oldColor = NULL_COLOR; } // 6.4.7.1 (2016/06/17) 241 while( oldTime < timeSpan ) { 242 // 6.3.9.0 (2015/11/06) Found 'DD'-anomaly for variable(PMD) 243 final int imgX = chartPadding + maxLabelWidth + (int)(oldTime*timeScale); // イメージ出力時の X軸の左端 px数 244 final int imgW = (int)((lastTime-oldTime)*timeScale) ; // イメージ出力時の 幅(fillRectで使用) 245 246 if( isDebug ) { 247 final int step = TimeScaleStep.getStep( timeScale ); 248 final String stTM = getTime2Str(startTime+(int)oldTime ,step,0) ; 249 final String edTM = getTime2Str(startTime+(int)lastTime,step,0) ; 250 System.out.println( "② ROW[" + row + "]=" + stTM + " - " + edTM + " imgX=" + imgX + " imgW=" + imgW ); 251 } 252 imageMeker(g2, oldColor, imgX, imgY, imgW, useTipsLink, row, out); // 6.0.2.0 (2014/09/19) 253 254 oldTime = lastTime ; 255 lastTime = timeSpan ; 256 oldColor = NULL_COLOR; // 5.6.1.1 (2013/02/08) キーブレイクによる初期化=不明(空欄)時の色 257 } 258 imgY += rowH ; // 初期値にヘッダー高さを加算しているため、2回目以降に加算していく。 6.4.6.1 (2016/06/03) 259 } 260 261 // 次に、新しい行の出力(ラベルは、ブレイク時に出力しておきます。) 262 oldKeyVal = keyVal; // null は来ないはず 263 // 6.4.6.1 (2016/06/03) ヘッダー部の高さを指定できるようにする。 264 // ヘッダー文の考慮。rowCnt は、使わず、imgY は、加算していきます。 265 // レコードのラベル分だけ、繰返し描画する。 266 final int clmSu = labelClmsNo.length; 267 int posX = chartPadding ; // ラベル文字列の書き出し位置の初期値 268 final int posY2 = imgY+chartHeight+recodeMargin ; // ラベルのY軸基準。 269 g2.setColor( LABEL_COLOR ); 270 for( int col=0; col<clmSu; col++ ) { 271 final String lbl = StringUtil.spanCut( getValueLabel( row,labelClmsNo[col] ) ); // 5.6.3.1 (2013/04/05) spanタグを削除 272 g2.drawString( lbl , posX + recodeMargin, posY2 ); // 文字列,ベースラインのx座標,y座標 273 posX += recodeMargin*2 + maxClmWidth[col] ; // 次の書き出し位置は、文字最大長+マージン 274 } 275 276 // レコードの枠線 277 g2.drawRect( chartPadding , imgY , maxX-chartPadding*2 , rowH ); // (レコード枠)左端x,上端y,幅w,高さh 278 279 oldTime = 0L; // キーブレイクによる初期化 280 oldColor= NULL_COLOR; // 5.6.1.1 (2013/02/08) キーブレイクによる初期化=不明(空欄)時の色 281 } 282 283 long newTime = getStr2Date( dyVal ) - startDate; // 次の時刻 284 if( newTime < oldTime ) { newTime = oldTime; } // 前の時刻より小さい場合は、前の時刻まで、進めておく。 285 286 // 6.3.9.0 (2015/11/06) Found 'DD'-anomaly for variable(PMD) 287 final int imgX = chartPadding + maxLabelWidth + (int)(oldTime*timeScale); // old時刻から書き始める(左端x) 288 final int imgW = (int)((newTime-oldTime)*timeScale) ; // 差分幅だけ描画する。 289 290 if( isDebug ) { 291 final int step = TimeScaleStep.getStep( timeScale ); 292 final String stTM = getTime2Str(startTime+(int)oldTime,step,0) ; 293 final String edTM = getTime2Str(startTime+(int)newTime,step,0) ; 294 System.out.println( "① ROW[" + row + "]=" + stTM + " - " + edTM + " imgX=" + imgX + " imgW=" + imgW ); 295 } 296 imageMeker(g2, oldColor, imgX, imgY, imgW, useTipsLink, row, out); // 6.0.2.0 (2014/09/19) 297 298 oldTime = newTime ; 299 300 final String fgjVal = getValue( row,FGJ_CLMNO ); // 状況コードのキー 301 final String fgjLbl = getValueLabel( row,FGJ_CLMNO ); // 状況コードのラベル 302 if( colClmNo >= 0 ) { 303 // 6.7.5.0 (2017/03/10) COLOR_CLM の値を、getValueLabel で取得するように変更。 304 oldColor = colMap.getColor( fgjVal,fgjLbl,getValueLabel( row,colClmNo ) ); // 色文字列を指定する場合 305 } 306 else { 307 oldColor = colMap.getColor( fgjVal,fgjLbl ); // 色文字列を指定しない=自動設定 308 } 309 } 310 311 // レコードのいちばん最後の出力。一応、ジャストの場合(oldTime == maxEdTime)は、処理しない 312 // 5.6.1.1 (2013/02/08) レコードのいちばん最後の出力は、NULL色を使うように変更 313 long lastTime = nowTime ; // 現在時刻(分単位に変換する) 314 // 6.4.8.2 (2016/07/08) 未来日付の場合に、現在時刻まで巻き戻って塗りつぶしている。 315 if( lastTime > timeSpan || lastTime < oldTime ) { lastTime = timeSpan; } // 現在時刻が、timeSpanより大きい場合 OR 未来時刻の場合は、同じにする。 316 317 if( !useLastData ) { oldColor = NULL_COLOR; } // 6.4.7.1 (2016/06/17) 318 while( oldTime < timeSpan ) { 319 // 6.3.9.0 (2015/11/06) Found 'DD'-anomaly for variable(PMD) 320 final int imgX = chartPadding + maxLabelWidth + (int)(oldTime*timeScale); // イメージ出力時の X軸の左端 px数 321 final int imgW = (int)((lastTime-oldTime)*timeScale) ; // イメージ出力時の 幅(fillRectで使用) 322 323 if( isDebug ) { 324 final int step = TimeScaleStep.getStep( timeScale ); 325 final String stTM = getTime2Str(startTime+(int)oldTime ,step,0) ; 326 final String edTM = getTime2Str(startTime+(int)lastTime,step,0) ; 327 System.out.println( "③ ROW[" + lastNo + "]=" + stTM + " - " + edTM + " imgX=" + imgX + " imgW=" + imgW ); 328 } 329 imageMeker(g2, oldColor, imgX, imgY, imgW, useTipsLink, lastNo, out); // 6.0.2.0 (2014/09/19) 330 331 oldTime = lastTime ; 332 lastTime = timeSpan ; 333 oldColor = NULL_COLOR; // 5.6.1.1 (2013/02/08) キーブレイクによる初期化=不明(空欄)時の色 334 } 335 336 // ヘッダー情報のイメージを作成します。 337 imageHeaderPaint( g2 , timeScale , colMap ); 338 339 // イメージファイルを出力し、URLを返します。 340 final File file ; // 6.3.9.0 (2015/11/06) Found 'DU'-anomaly for variable(PMD) 341 try { 342 final File dir = new File( tempDir ); // 画像ファイル出力先のフォルダ 343 // 6.0.2.4 (2014/10/17) RV java.io.File.mkdirs() の例外的戻り値を無視しています。 344 if( ! dir.exists() && ! dir.mkdirs() ) { 345 final String errMsg = "画像ファイル出力先のフォルダの作成に失敗しました。tempDir=[" + dir +"]" ; 346 throw new HybsSystemException( errMsg ); 347 } 348 349 file = File.createTempFile( "Img",".png", dir ); // テンポラリファイルの作成 350 file.deleteOnExit(); // JavaVM 停止時にテンポラリファイルの削除 351 352 ImageIO.write(img, "PNG", file ); 353 g2.dispose(); 354 } 355 catch( final IOException ex ) { 356 final String errMsg = "画像ファイルの作成に失敗しました。tempDir=[" + tempDir +"]" ; 357 throw new HybsSystemException( errMsg,ex ); 358 } 359 360 // imgタグを作成します。 361 // 6.3.9.0 (2015/11/06) width,height にセットしているが、値を変更していないので、直接設定する。 362 // 6.4.4.1 (2016/03/18) StringBuilderの代わりに、OgBuilderを使用する。 363 return new OgBuilder() 364 .append( "<img id='ImageTimeBar' alt='ImageTimeBar' title='ImageTimeBar' border='0'" 365 , " width='" , String.valueOf( maxX ) 366 , "px' height='" , String.valueOf( maxY ) 367 , "px' src='" , tempUrl 368 , file.getName() , "'" ) 369 // 6.4.4.2 (2016/04/01) 引数がSupplierに変更。 370 // area タグのデータが作成されていれば、出力します。 371 .appendCase( out.length() > 0 372 , () -> new String[] { " usemap='#TimeBarMap' /><map name='TimeBarMap'>" 373 , out.toString() 374 , "</map>" } // true 375 , () -> new String[] { " />" } // false 376 ).toString(); 377 } 378 379 /** 380 * データが存在しない最後の処理で、現在時刻まで、継続している処理をまとめます。 381 * 382 * このメソッドは、キーブレイク、通常の出力処理、データの最後の3か所に同じ処理が出てくるため 383 * 一つに整理しました。 384 * 385 * @og.rev 6.0.2.0 (2014/09/19) 新規作成 386 * @og.rev 6.4.2.0 (2016/01/29) alt属性にtitle属性を追記。 387 * @og.rev 6.4.7.1 (2016/06/17) useLastData属性は、最後の処理のみに適用する。 388 * @og.rev 6.4.8.2 (2016/07/08) クリッカブルマップの設定で、普通のリンクタグや、hrefOnly、hrefTarget が使えるようにする。 389 * @og.rev 6.4.9.5 (2016/09/09) title属性を廃止したが、一旦戻します。(ネイティブモードでツールチップが表示しない) 390 * @og.rev 6.7.9.1 (2017/05/19) 幅が0の場合は、1ピクセルだけ一つ前の領域に描画する。 391 * 392 * @param g2 描画オブジェクト(Graphics2D) 393 * @param oldColor 旧色 394 * @param imgX イメージ出力時の X軸の左端 px数 395 * @param imgY イメージ出力時の Y軸の上端 px数 396 * @param imgW イメージ出力時の 幅(fillRectで使用) 397 * @param useTipsLink Tipsのリンクを作成するかどうか(true:作成する) 398 * @param row 行番号 399 * @param outBuf 出力用 StringBuilder 400 */ 401 private void imageMeker( final Graphics2D g2,final Color oldColor, 402 final int imgX,final int imgY,final int imgW, 403 final boolean useTipsLink,final int row,final StringBuilder outBuf ) { 404 // 幅が0以上の場合のみ描画する。 405 if( imgW > 0 ) { 406 // 6.4.7.1 (2016/06/17) 407 g2.setColor( oldColor ); 408 g2.fillRect( imgX , imgY+recodeMargin , imgW, chartHeight ); // (実際の状態)左端x,上端y,幅w,高さh 409 410 // 6.0.2.0 (2014/09/19) Tips表示を出さない条件に、oldColor == NULL_COLOR を加える。 411 // equals ではなく、!= でオブジェクトの直接比較で判定する。 412 // 6.4.7.1 (2016/06/17) 413 final boolean useTips = oldColor != NULL_COLOR && useTipsLink && row > 0 ; 414 415 // tipsClm か linkClm を使用する。 416 // 5.6.1.0 (2013/02/01) tips や link は、ひとつ前のデータで作成する必要がる為、最初の1件目は、処理しないように修正 417 if( useTips ) { 418 // tips や link は、ひとつ前のデータで作成する必要がある。(row-1) 419 String tips = tipsClmNo >= 0 ? getValueLabel( row-1,tipsClmNo ) : getValueLabel( row-1,FGJ_CLMNO ) ; 420 if( tips != null && tips.indexOf( '\'' ) >= 0 ) { // 5.6.3.0 (2013/04/01) シングルクォーテーション のエスケープ 421 tips = tips.replaceAll( "'","'" ); 422 } 423 tips = StringUtil.spanCut( tips ); // 5.6.3.1 (2013/04/05) spanタグを削除 424 425 outBuf.append( "<area shape='rect' alt='" ).append( tips ).append( "' title='" ).append( tips ).append( '\'' ); // 6.4.9.5 (2016/09/09) 一旦戻す。 426 if( linkClmNo >= 0 ) { 427 final String hrefVal = getValueLabel( row-1,linkClmNo ); 428 if( hrefVal != null ) { 429 // 6.4.8.2 (2016/07/08) クリッカブルマップの設定で、普通のリンクタグや、hrefOnly、hrefTarget が使えるようにする。 430 outBuf.append( ' ' ); 431 final int stAd = hrefVal.indexOf( "href" ); 432 final int edAd = hrefVal.indexOf( '>' ); 433 if( stAd >= 0 ) { // href が存在する。 434 if( edAd >= 0 ) { outBuf.append( hrefVal.substring( stAd,edAd ) ); } // a href ・・・ の場合の処置 435 else { outBuf.append( hrefVal.substring( stAd ) ); } // 従来の互換設定 436 } 437 else { 438 outBuf.append( " href='" ).append( hrefVal ).append( '\'' ); // リンクタグの hrefOnlyや、hrefTarget が使えるようにする。 439 } 440 } 441 } 442 443 // 6.4.8.2 (2016/07/08) title を、tips からキーの値に変更。ただし、未設定の場合のみ。 444 if( outBuf.indexOf( "title=" ) < 0 ) { 445 final String title = getValueLabel( row-1,KEY_CLMNO ); // 6.4.8.2 (2016/07/08) title を、tips からキーの値に変更。 446 outBuf.append( "' title='" ).append( title ).append( '\'' ); 447 } 448 449 // 6.0.2.5 (2014/10/31) char を append する。 450 outBuf.append( " coords='" ).append( imgX ) 451 .append( ',' ).append( imgY+recodeMargin ) // 左端x1,上端y1 452 .append( ',' ).append( imgX+imgW ) 453 .append( ',' ).append( imgY+recodeMargin+chartHeight ) // 右端x2,下段y2 454 .append( "' />\n" ); 455 } 456 } 457 // 6.7.9.1 (2017/05/19) 幅が0の場合は、1ピクセルだけ一つ前の領域に描画する。 458 else { 459 g2.setColor( oldColor ); 460 g2.fillRect( imgX -1 , imgY+recodeMargin , 1, chartHeight ); // (実際の状態)左端x,上端y,幅w,高さh 461 } 462 } 463 464 /** 465 * パラメータ内容を初期化します。 466 * 467 * @og.rev 5.6.1.1 (2013/02/08) useLastData 追加 468 * @og.rev 6.0.2.0 (2014/09/19) nowTime データがない最後の処理で使用する現在時刻 469 * @og.rev 6.4.6.1 (2016/06/03) ヘッダー部の高さを指定できるようにする。 470 * @og.rev 6.4.8.2 (2016/07/08) debug 属性を、パラメータにセットします。 471 */ 472 private void paramInit() { 473 final String s_startDate = getParam( "START_DATE" ); // タイムテーブルの表示開始日時をセットします(初期値:データの最小日時)。 474 final int timeSpanHour = getIntParam( "TIME_SPAN" ); // タイムテーブルの表示期間を時間で指定します(初期値:{@og.value TIME_SPAN})。 475 476 final String[] s_labelClms = StringUtil.csv2Array( getParam( "LABEL_CLMS" ) ); // 一覧表のラベル表示部に表示するカラム名をCSV形式で指定します。 477 final String s_colClm = getParam( "COLOR_CLM" ); // レコードに付ける色を色文字列で指定する場合のカラム名を指定します。 478 final String s_tipsClm = getParam( "TIPS_CLM" ); // レコード単位に、マウスオーバー時のTips表示を行うカラム名を指定します。 479 final String s_linkClm = getParam( "LINK_CLM" ); // レコード単位に、クリッカブルリンクを設定するカラム名を指定します。 480 481 useLegend = getBoolParam( "USE_LEGEND" ); // カラーの凡例を使用するかどうか[true/false] 482 maxLabelWidth = getIntParam( "MAX_LABEL_WIDTH" ); // ラベル表記部の最大サイズをpxで指定。何もなければ、可変長サイズ 483 maxTimeWidth = getIntParam( "MAX_TIME_WIDTH" ); // タイム表記部の最大サイズをpxで指定。 484 chartHeight = getIntParam( "CHART_HEIGHT" ); // 1レコードのチャートの間隔をpxで指定。実際の幅は、CHART_HEIGHT+MARGIN*2 485 headerHeight = getIntParam( "HEADER_HEIGHT" ); // 6.4.6.1 (2016/06/03) ヘッダー部の高さをpxで指定。凡例とヘッダーの高さになります。 486 if( headerHeight < 0 ) { headerHeight = chartHeight; } // 指定が無い場合は、チャート幅と同じにします。 487 chartPadding = getIntParam( "CHART_PADDING" ); // イメージ作成の 全体テーブルの隙間 488 recodeMargin = getIntParam( "RECODE_MARGIN" ); // 各レコード、文字等の内部の間隔 489 useLastData = getBoolParam( "USE_LAST_DATA" ); // 5.6.1.1 (2013/02/08) 行の最後の情報が、継続しているとして使うかどうか[true/false] 490 isDebug = getBoolParam( "debug" ); // 6.4.8.2 (2016/07/08) debug 属性を、パラメータにセットします[true/false]。 491 492 tempDir = getParam( "TEMP_DIR" ); // 画像ファイルを作成するテンポラリディレクトリ(相対パス) 493 tempUrl = getParam( "TEMP_URL" ); // 作成した画像ファイルを取得するときに使用するURL(コンテキスト/相対パス) 494 495 startDate = getStr2Date( s_startDate ); // 分単位に変換する。 496 startTime = str2DateTime ; // 開始日時の時刻情報(分単位)の値。str2DateTime は、getStr2Date(String)メソッド実行後にセットされる。 497 timeSpan = timeSpanHour * 60L ; // 分単位に変換する。 498 499 final int len = s_labelClms.length; 500 if( len > 0 ) { 501 labelClmsNo = new int[len]; 502 for( int i=0; i<len; i++ ) { 503 labelClmsNo[i] = getColumnNo( s_labelClms[i] ); 504 } 505 } 506 else { 507 labelClmsNo = new int[] { KEY_CLMNO }; // 初期値は、キーカラム 508 } 509 510 // 指定のカラム名に対するカラム番号を取得。なければ、-1 を設定しておく。 511 if( s_colClm != null ) { colClmNo = getColumnNo( s_colClm ); } // レコードに付ける色を色文字列で指定する場合のカラムNo 512 if( s_tipsClm != null ) { tipsClmNo = getColumnNo( s_tipsClm ); } // レコード単位に、マウスオーバー時のTips表示を行うカラムNo 513 if( s_linkClm != null ) { linkClmNo = getColumnNo( s_linkClm ); } // レコード単位に、クリッカブルリンクを設定するカラムNo 514 515 // 6.0.2.0 (2014/09/19) データがない最後の処理で使用する現在時刻 516 final Calendar cal = Calendar.getInstance(); 517 nowTime = cal.getTimeInMillis() / MILLI_MINUTE - startDate ; // 6.0.2.0 (2014/09/19) ミリ秒を分に換算、現在時刻(分単位) 518 } 519 520 /** 521 * イメージの XYサイズを求め、結果を、maxX,maxY 変数に設定します。 522 * 523 * また、ラベル文字列の最大長が指定されていない場合(maxLabelWidth == -1)最大長を自動計算し、maxLabelWidth変数にセットします。 524 * 525 * maxLabelWidth : -1 の場合は、ラベル文字列の最大長を求めて、この値を計算する。= (recodeMargin*2 + ラベル文字列の最大長) 526 * maxX : イメージの最大横幅(X)方向のサイズpx。chartPadding*2 + maxLabelWidth + maxTimeWidth 527 * maxY : イメージの最大縦幅(Y)方向のサイズpx。chartPadding*2 + (chartHeight+recodeMargin*2)*(レコード数+ヘッダー数) 528 * 529 * @og.rev 5.6.3.1 (2013/04/05) 短縮ラベルなど、<span>タグが付与される値から、spanタグを削除します。 530 * @og.rev 6.4.6.1 (2016/06/03) ヘッダー部の高さを指定できるようにする。 531 * 532 * @param startNo 計算の開始列番号 533 * @param lastNo 計算の終了列番号 534 */ 535 private void calcImageSize( final int startNo , final int lastNo ) { 536 String oldKeyVal = ""; // 初期値。1回目にキーブレイクさせる。 537 538 final int clmSu = labelClmsNo.length; 539 maxClmWidth = new int[clmSu]; 540 541 // 6.4.6.1 (2016/06/03) ヘッダー部の高さは、凡例とヘッダー部が対象。 542 int rowCnt = 0; // 6.4.6.1 (2016/06/03) レコード数 543 544 // ラベル領域の長さを各ラベル長を積み上げて計算する。 545 if( maxLabelWidth < 0 ) { 546 // FontMetrics を取得する為だけの BufferedImage 547 final BufferedImage img = new BufferedImage( 1, 1, BufferedImage.TYPE_INT_ARGB); 548 final Graphics2D g2 = img.createGraphics(); 549 final FontMetrics fontM = g2.getFontMetrics(); 550 551 // 初期値の計算は、ヘッダーのラベルの幅を使用する。 552 for( int col=0; col<clmSu; col++ ) { 553 final String lbl = StringUtil.spanCut( getColumnLabel( labelClmsNo[col] ) ); // 5.6.3.1 (2013/04/05) spanタグを削除 554 maxClmWidth[col] = fontM.stringWidth( lbl ); // 最大値の初期値として、ヘッダーラベルの幅をセットしておく。 555 } 556 557 for( int row=startNo; row<lastNo; row++ ) { 558 // キーブレイク判定。キーブレイクは、一番初めから来る。 559 final String keyVal = getValue( row,KEY_CLMNO ); 560 if( !oldKeyVal.equals( keyVal ) ) { 561 oldKeyVal = keyVal; 562 rowCnt++; // レコード数 563 564 // ラベルは、キーブレイク時の値のみ採用する。 565 for( int col=0; col<clmSu; col++ ) { 566 final String lbl = StringUtil.spanCut( getValueLabel( row,labelClmsNo[col] ) ); // 5.6.3.1 (2013/04/05) spanタグを削除 567 final int fontW = fontM.stringWidth( lbl ); 568 if( maxClmWidth[col] < fontW ) { maxClmWidth[col] = fontW; } 569 } 570 } 571 } 572 g2.dispose(); 573 574 // 最大ラベル幅は、各ラベルの最大値+(マージン*2)*カラム数 575 maxLabelWidth = recodeMargin * 2 * clmSu ; 576 for( int col=0; col<clmSu; col++ ) { 577 maxLabelWidth += maxClmWidth[col]; 578 } 579 } 580 else { 581 for( int row=startNo; row<lastNo; row++ ) { 582 // キーブレイク判定。キーブレイクは、一番初めから来る。 583 final String keyVal = getValue( row,KEY_CLMNO ); 584 if( !oldKeyVal.equals( keyVal ) ) { 585 oldKeyVal = keyVal; 586 rowCnt++; // レコード数 587 } 588 } 589 590 // 最大ラベル幅は、均等割り付け。端数は無視(どうせ、ラベル部は、maxLabelWidth で計算するので。) 591 final int clmWidth = ( maxLabelWidth - recodeMargin * 2 * clmSu ) / clmSu ; 592 for( int col=0; col<clmSu; col++ ) { 593 maxClmWidth[col] = clmWidth; 594 } 595 } 596 597 maxX = chartPadding*2 + maxLabelWidth + maxTimeWidth ; 598 // 6.4.6.1 (2016/06/03) ヘッダー部の高さは、凡例とヘッダー部を考慮して、加算する。 599 maxY = chartPadding*2 + (headerHeight+recodeMargin*2)*(useLegend ? 2 : 1) + (chartHeight+recodeMargin*2)*rowCnt ; 600 } 601 602 /** 603 * ヘッダー情報のイメージを作成します。 604 * 605 * 全体の枠もここで作成しておきます。 606 * イメージは、キーカラムのラベルと、時間軸になります。時間軸は縦方向にすべて線を引きます。 607 * 時間軸の間隔は、timeScale によって、切り替わります。 608 * 凡例を使う場合(useLegend=true)は、引数の FlgColorMap を利用して作成します。 609 * 610 * @og.rev 5.6.3.1 (2013/04/05) 短縮ラベルなど、<span>タグが付与される値から、spanタグを削除します。 611 * @og.rev 5.6.5.0 (2013/06/07) 年月日情報を表示します。なお、日単位の場合は、年月は省略します。 612 * @og.rev 6.3.9.0 (2015/11/06) FlgColorMapで管理している内部クラスを新規作成します。 613 * @og.rev 6.4.6.1 (2016/06/03) ヘッダー部の高さを指定できるようにする。 614 * 615 * @param g2 描画するGraphics2Dオブジェクト 616 * @param timeScale 時間(分)当たりのピクセル数 617 * @param colMap 状況コードに対応したカラーマップ 618 */ 619 private void imageHeaderPaint( final Graphics2D g2 , final double timeScale , final FlgColorMap colMap ) { 620 621 int posY1 = chartPadding ; 622 int posY2 = chartPadding+headerHeight+recodeMargin ; // 6.4.6.1 (2016/06/03) ヘッダー部の高さ 623 624 // 凡例を使う場合 625 if( useLegend && colMap != null ) { 626 // 凡例を並べる間隔を求める。 627 final FontMetrics fontM = g2.getFontMetrics(); 628 final int maxSize = fontM.stringWidth( colMap.getMaxLengthLabel() ) ; // 文字列の最大長ラベルの幅 629 final int imgW = headerHeight ; // 凡例■の幅(高さと同じにしているので真四角) 、6.4.6.1 (2016/06/03) 630 final int mgnW = recodeMargin ; // 凡例■から文字までの間 631 final int spanW = maxSize + recodeMargin ; // 凡例■から凡例■までの間隔。文字最大長+α 632 633 int legX = chartPadding ; 634 635 // 6.3.9.0 (2015/11/06) FlgColorMapで管理している内部クラスを新規作成します。 636 for( final FlgColorObj obj : colMap.values() ) { 637 g2.setColor( obj.COL ); // 凡例■の色 638 g2.fillRect( legX , posY1+recodeMargin , imgW , headerHeight ); // (実際の状態)左端x,上端y,幅w,高さh、6.4.6.1 (2016/06/03) 639 640 legX += imgW + mgnW ; 641 g2.setColor( LABEL_COLOR ); 642 g2.drawString( obj.LBL , legX , posY2 ); // 文字列,ベースラインのx座標,y座標 643 644 legX += spanW ; 645 } 646 posY1 += headerHeight+recodeMargin*2 ; // 1レコード分の高さを加算しておく。、6.4.6.1 (2016/06/03) 647 posY2 += headerHeight+recodeMargin*2 ; // 1レコード分の高さを加算しておく。、6.4.6.1 (2016/06/03) 648 } 649 650 // まずは、全体の枠線の描画 651 g2.setColor( LABEL_COLOR ); 652 g2.drawRect( chartPadding, posY1, maxX-chartPadding*2, maxY-posY1-chartPadding ); // 左端,上端,幅,高さ 653 654 // ヘッダーのラベル分だけ、繰返し描画する。 655 final int clmSu = labelClmsNo.length; 656 int posX = chartPadding ; // ラベル文字列の書き出し位置の初期値 657 for( int col=0; col<clmSu; col++ ) { 658 // 6.3.9.1 (2015/11/27) Found 'DD'-anomaly for variable(PMD) 659 final String lbl = StringUtil.spanCut( getColumnLabel( labelClmsNo[col] ) ); // 5.6.3.1 (2013/04/05) spanタグを削除 660 g2.drawString( lbl , posX + recodeMargin, posY2 ); // 文字列,ベースラインのx座標,y座標 661 posX += recodeMargin*2 + maxClmWidth[col] ; // 次の書き出し位置は、文字最大長+マージン*2 662 g2.drawLine( posX, posY1, posX, maxY-chartPadding ); // 始点(x 座標,y 座標),終点(x 座標,y 座標) 663 } 664 665 final int step = TimeScaleStep.getStep( timeScale ); // 時間スケールに対応したSTEP数 666 667 // 日付ヘッダー部の描画のためのカレンダー 668 final Calendar cal = Calendar.getInstance(); 669 cal.setTimeInMillis( startDate * MILLI_MINUTE ); // 6.0.2.0 (2014/09/19) ミリ秒に換算した分 670 671 final int week = cal.get( Calendar.DAY_OF_WEEK ); // 開始曜日 672 673 final String fmt = step < MINUTE_OF_DAY ? "yyyy/MM/dd(EE)" : "dd" ; // 上段フォーマットは、時間ベースの場合は、"yyyy/MM/dd(EE)" 、日ベースの場合は、"dd" 674 final DateFormat format1 = new SimpleDateFormat( fmt,Locale.JAPAN ); 675 676 // グラフ領域の日付ヘッダー部の描画 677 g2.setStroke( DSAH_STROK ); // 日付部は、破線 678 posX = chartPadding+maxLabelWidth ; // グラフ領域は、chartPadding+maxLabelWidth から。 679 for( int tm=0; tm<timeSpan; tm+=step ) { 680 681 int offset = headerHeight / 2 + recodeMargin; // ヘッダーの表示基準のオフセット(チャート幅の半分)6.4.6.1 (2016/06/03) 682 683 // 上段:ヘッダー出力 684 if( tm % MINUTE_OF_DAY == 0 ) { // 6.0.2.0 (2014/09/19) 1日が何分 685 final Date dt = new Date( (startDate + tm) * MILLI_MINUTE ); // 6.0.2.0 (2014/09/19) ミリ秒に換算した分 686 g2.drawString( format1.format( dt ) , posX + recodeMargin , posY2-offset ); // 文字列,ベースラインのx座標,y座標 687 offset = 0; // ヘッダーを表示する場合のみ上まで線を引く。 688 } 689 690 g2.drawString( getTime2Str(startTime+tm,step,week) , posX + recodeMargin , posY2 ); // 文字列,ベースラインのx座標,y座標 691 g2.drawLine( posX, posY1+offset, posX, maxY-chartPadding ); // 始点(x 座標,y 座標),終点(x 座標,y 座標) 692 693 posX += (int)(step*timeScale); 694 } 695 } 696 697 /** 698 * 時間スケールに対応したSTEP数を管理するための内部クラス 699 * 700 * 時間ヘッダーを表示する場合、ある程度意味のある間隔でラベル表示したいと思います。 701 * 全体の描画領域の長さと、時間当たりのスケールファクター(ピクセル数)から、 702 * ラベルの描画間隔を求めます。 703 * 意味のある間隔は、STEPS で定義し、10分,30分,60分,1/4日,1/2日,1日 まで定義しています。 704 * 一番大きな単位以上の場合は、その最大単位の整数倍を返します。 705 * 706 * 一時間当たりの表示幅を、MIN_PX としていますので、この値以下の間隔では描画されません。 707 * 初期値は、600px を 24時間表示できる 600px/24h = 25px にしています。 708 */ 709 private static final class TimeScaleStep { 710 // 分 分 時 1/4 1/2 1日 711 private static final int[] STEPS = new int[] { 10 , 30 , 60 , 360 , 720 , 1440 }; 712 private static final int MIN_PX = 25; // スケールに対する最小値 713 714 /** 715 * オブジェクトを作らせない為の、private コンストラクタ 716 */ 717 private TimeScaleStep() {} 718 719 /** 720 * 時間を意味のある範囲の整数として返します。 721 * 722 * 全体の描画領域の長さと、時間当たりのスケールファクター(ピクセル数)から、 723 * 10分,30分,60分,1/4日,1/2日,1日 までの整数値で返します。 724 * 一番大きな単位以上の場合は、その最大単位の整数倍を返します。 725 * 726 * @param timeScale 時間(分)当たりのピクセル数 727 * @return 時間スケールに対応した意味のある範囲の整数 728 */ 729 public static int getStep( final double timeScale ) { 730 final int tmStep = (int)Math.ceil(MIN_PX/(timeScale)); // 整数切り上げ 731 732 for( int i=0; i<STEPS.length; i++ ) { 733 if( tmStep <= STEPS[i] ) { return STEPS[i]; } // 配列の数字に切り上げ 734 } 735 736 // 未設定の場合は、最上位の値の整数倍に切り上げ 737 return (int)Math.ceil( (double)tmStep / STEPS[STEPS.length-1] ) * STEPS[STEPS.length-1]; 738 } 739 } 740 741 /** 742 * 状況コード、ラベル、色を管理するための内部クラス 743 * 744 * 状況に応じたコード、ラベル、色を管理します。 745 * これは、getColor(状況コード,ラベル) または、getColor(状況コード,ラベル,色文字列) で 746 * 要求された情報を内部で管理し、同じコードの場合に同じ色を返します。 747 * また、凡例作成用に、最も文字数が長いラベルを管理します。 748 * 色文字列を指定した場合でも、最初に要求された状況コードに対応する色を返します。 749 * これは、同一状況コードで色違いを作成することができないことを意味します。 750 * 色文字列を指定しない場合は、内部の色配列から、順番に色を割り当てます。 751 * 色を割り当てる順番は、状況コードの発生順です。よって、検索条件によって、 752 * 状況コードの現れる順番が異なると、色も毎回異なることになります。 753 * 754 * 自動割り当ての色は、BLUE,CYAN,GRAY,GREEN,LIGHT_GRAY,MAGENTA,DARK_GRAY,ORANGE,PINK,RED,YELLOW 755 * となっており、それを超えると、RGBをランダムに発生させて色を作成します。 756 * よって、どのような色になるかは全くわかりません。 757 * 758 * @og.rev 6.4.3.3 (2016/03/04) CLR_ARY等、カラー関連処理を、ColorMapクラスへ移動します。 759 */ 760 private static final class FlgColorMap { 761 // 6.4.3.3 (2016/03/04) ColorMapクラスへ移動 762 private final Map<String,FlgColorObj> colMap = new TreeMap<>(); // 6.3.9.0 (2015/11/06) 763 764 private int lastCnt ; 765 private String maxLabel = "" ; // 最大長のラベル 766 private int maxlen = -1 ; // 最大長のラベルのlength() 767 768 /** 769 * 状況コードに対応した色オブジェクトを返します。 770 * 771 * 状況コードが初めて指定された場合は、順番に内部の色を割り当てます。 772 * また、その時のラベルも管理します。ラベルと色のセットは、凡例作成時に利用されます。 773 * 774 * 自動割り当ての色は、BLUE,CYAN,GRAY,GREEN,LIGHT_GRAY,MAGENTA,DARK_GRAY,ORANGE,PINK,RED,YELLOW 775 * となっており、それを超えると、RGBをランダムに発生させて色を作成します。 776 * よって、どのような色になるかは全くわかりません。 777 * 778 * @param fgj 状況コード 779 * @param lbl 状況コードのラベル 780 * @return 状況コードに対応した色オブジェクト 781 */ 782 public Color getColor( final String fgj,final String lbl ) { 783 return getColor( fgj,lbl,null ); 784 } 785 786 /** 787 * 状況コードに対応した色オブジェクトを返します。 788 * 789 * 状況コードが初めて指定された場合は、引数の色文字列の色を割り当てます。 790 * また、その時のラベルも管理します。ラベルと色のセットは、凡例作成時に利用されます。 791 * 792 * 色文字列を指定した場合でも、最初に要求された状況コードに対応する色を返します。 793 * これは、同一状況コードで色違いを作成することができないことを意味します。 794 * 色文字列 が null の場合は、自動割り当てのメソッドと同じです。 795 * よって、色文字列の指定と、自動割り当てが同時に発生すると、異なる状況コードで 796 * 同じ色が指定される可能性がありますので、混在して使用しないでください。 797 * 798 * @og.rev 6.0.2.1 (2014/09/26) StringUtil → ColorMap 799 * @og.rev 6.3.9.0 (2015/11/06) FlgColorMapで管理している内部クラスを新規作成します。 800 * @og.rev 6.4.3.3 (2016/03/04) ColorMapクラスへ移動。それに関連する修正。 801 * 802 * @param fgj 状況コード 803 * @param lbl 状況コードのラベル 804 * @param colStr 状況コードに対応した色文字列(nullの場合は、自動割り当て) 805 * @return 状況コードに対応した色オブジェクト 806 * @og.rtnNotNull 807 */ 808 public Color getColor( final String fgj,final String lbl,final String colStr ) { 809 // 6.3.9.1 (2015/11/27) A method should have only one exit point, and that should be the last statement in the method.(PMD) 810 final Color rtn ; 811 if( fgj == null ) { rtn = LABEL_COLOR; } 812 else { 813 if( lbl != null ) { 814 final int len = lbl.length(); 815 if( len > maxlen ) { maxLabel = lbl; maxlen = len; } 816 } 817 818 // Map#computeIfAbsent : 戻り値は、既存の、または計算された値。追加有り、置換なし、削除なし 819 // colMap からは、FlgColorObj が戻されるので、COL 属性を取得する。 820 final String cloCnt = colStr == null ? String.valueOf( lastCnt++ ) : colStr ; 821 rtn = colMap.computeIfAbsent( fgj , k -> new FlgColorObj( lbl , cloCnt ) ).COL; 822 } 823 824 return rtn ; 825 } 826 827 /** 828 * 内部で管理している、ラベル(String)と色オブジェクト(Color)の コレクションを返します。 829 * 830 * 内部で管理しているコレクションです。 831 * このコレクションは、状況コードでソートされています。 832 * コレクションの中身は、オブジェクト配列となっており、[0]は、String型のラベル、[1]は、 833 * Color型の色です。 834 * 835 * @og.rev 6.3.9.0 (2015/11/06) FlgColorMapで管理している内部クラスを新規作成します。 836 * 837 * @return ラベル(String)と色オブジェクト(Color)の コレクション 838 */ 839 public Collection<FlgColorObj> values() { 840 return colMap.values(); 841 } 842 843 /** 844 * 登録されたラベル文字列で、最も文字数が長いラベルを返します。 845 * 846 * 凡例で、ラベルの最大長を求めるのに利用できます。 847 * ただし、簡易的に、length() 計算しているだけなので、英語、日本語混在や、 848 * プロポーショナルフォント使用時の厳密な最大長の文字列ではありません。 849 * 850 * @return 最も文字数が長いラベル 851 */ 852 public String getMaxLengthLabel() { return maxLabel; } 853 } 854 855 /** 856 * FlgColorMapで管理している内部クラス 857 * 858 * フラグに対して、Object[] 配列の [0]:ラベル、[1]:カラー で管理してましたが、 859 * きちんとString と Color で管理します。そのための内部クラスです。 860 * 861 * @og.rev 6.3.9.0 (2015/11/06) FlgColorMapで管理している内部クラスを新規作成します。 862 */ 863 private static final class FlgColorObj { 864 private final String LBL ; 865 private final Color COL ; 866 867 /** 868 * ラベルとカラーを指定したインストラクター 869 * 870 * @param lbl ラベル 871 * @param col カラー 872 */ 873 FlgColorObj( final String lbl , final Color col ) { 874 LBL = lbl ; 875 COL = col ; 876 } 877 878 /** 879 * ラベルとカラー文字列を指定したインストラクター 880 * 881 * カラー文字列は、ColorMap で定義されている文字列です。 882 * 883 * @og.rev 6.4.3.3 (2016/03/04) 新規追加。 884 * 885 * @param lbl ラベル 886 * @param colStr カラー文字列 887 */ 888 FlgColorObj( final String lbl , final String colStr ) { 889 LBL = lbl ; 890 COL = ColorMap.getColorInstance( colStr ); 891 } 892 893 /** 894 * ラベルとカラー番号を指定したインストラクター 895 * 896 * カラー番号は、ColorMap で定義されている番号です。 897 * 898 * @og.rev 6.4.3.3 (2016/03/04) 新規追加。 899 * 900 * @param lbl ラベル 901 * @param no カラー番号 902 */ 903 FlgColorObj( final String lbl , final int no ) { 904 LBL = lbl ; 905 COL = ColorMap.getColorInstance( no ); 906 } 907 908 /** 909 * ラベルを返します。 910 * 911 * @og.rev 6.4.3.3 (2016/03/04) 新規追加。 912 * 913 * @return ラベル 914 */ 915 /* default */ String getLabel() { return LBL; } 916 917 /** 918 * カラーを返します。 919 * 920 * @return カラー 921 */ 922 /* default */ Color getColor() { return COL; } 923 } 924 925 /** 926 * 日時文字列を数字に変換します。 927 * 928 * 日時文字列は、yyyyMMdd または、yyyyMMddhhmmss 形式とします。 929 * これを、エポックタイムからの経過時間の 分単位の値を求めます。 930 * 具体的には、Calendar オブジェクトの getTimeInMillis() の結果を、 931 * 60000 で割り算した値を作成します。 932 * よって、Calendar オブジェクト作成時も、秒の単位は切り捨てます。 933 * 引数が null の場合は、現在時刻より、作成します。 934 * 935 * @param val 日時文字列の値(yyyyMMdd または、yyyyMMddhhmmss 形式 など) 936 * 937 * @return 日時文字列を分換算した数字 938 */ 939 private long getStr2Date( final String val ) { 940 final Calendar cal = Calendar.getInstance(); 941 str2DateTime = 0; 942 if( val == null ) { 943 cal.set( Calendar.HOUR_OF_DAY, 0 ); // 5.3.5.0 (2011/05/01) 時間の解決規則が適用されるため、「時」だけは、setメソッドで 0 にセットする。 944 cal.clear( Calendar.MINUTE ); 945 cal.clear( Calendar.SECOND ); 946 cal.clear( Calendar.MILLISECOND ); 947 } 948 else if( val.length() == 8 ) { 949 cal.clear(); 950 cal.set( Integer.parseInt( val.substring( 0,4 ) ) , // 年 951 Integer.parseInt( val.substring( 4,6 ) ) - 1, // 月(0から始まる) 952 Integer.parseInt( val.substring( 6,8 ) ) // 日 953 ); 954 } 955 else { 956 cal.clear(); 957 cal.set( Integer.parseInt( val.substring( 0,4 ) ) , // 年 958 Integer.parseInt( val.substring( 4,6 ) ) - 1, // 月(0から始まる) 959 Integer.parseInt( val.substring( 6,8 ) ) , // 日 960 Integer.parseInt( val.substring( 8,10 ) ) , // 時 961 Integer.parseInt( val.substring( 10,12 ) ) // 分 962 ); 963 str2DateTime = Integer.parseInt( val.substring( 8,10 ) ) * 60 + Integer.parseInt( val.substring( 10,12 ) ) ; 964 } 965 return cal.getTimeInMillis() / MILLI_MINUTE ; // 6.0.2.0 (2014/09/19) ミリ秒に換算した分 966 } 967 968 /** 969 * 数字(分)を時間文字列に変換します。 970 * 971 * 480 は、"08" に、1260 は、"21" に変換します。 972 * 引数の時間は、分を表す整数です。24時間表記であれば、0 ~ 1440 の範囲で収まりますが、 973 * 期間が長い場合は、その値を超えます。また、24時間を超える場合は、0 に戻ります。 974 * 文字列にする場合の最小単位は、(時)なので、60(分)で割り算して、余は、切り捨てます。 975 * step は、60(分)単位の表示時に飛ばす数です。step=60 なら、60(分)単位、step=120 なら、120(分) 976 * 単位となります。stepが、1440 以下の場合は、そのまま、24時間表記で構いませんが、 977 * それを超えると時間ではなく、日数表記に切り替わります。 978 * 979 * @og.rev 5.6.5.0 (2013/06/07) 月単位の場合は、曜日を表示します。 980 * 981 * @param timeVal 引数の時間整数(分) 982 * @param step 60分単位のステップ数( 10,30,60,720,1440 単位となるように調整) 983 * @param week カレンダクラスの曜日フィールド(DAY_OF_WEEK) 984 * 985 * @return 数字を時間文字列に変換した結果( "08" など) 986 * @og.rtnNotNull 987 */ 988 private String getTime2Str( final int timeVal, final int step, final int week ) { 989 990 final StringBuilder rtn = new StringBuilder( BUFFER_MIDDLE ); 991 992 if( step >= MINUTE_OF_DAY ) { // 6.0.2.0 (2014/09/19) 1日が何分 993 final int dtm = timeVal / MINUTE_OF_DAY ; // 日の整数値 994 rtn.append( DAY_OF_WEEK_JA[ ( dtm + week ) % W_7 ] ); // 曜日を表示 995 } 996 else { 997 final int htm = (timeVal / M_60) % H_24 ; // 時(24時間制) 998 if( htm < DEC ) { rtn.append( '0' ); } // 6.0.2.5 (2014/10/31) char を append する。 999 rtn.append( htm ); 1000 1001 if( step < M_60 ) { 1002 final int mtm = timeVal % M_60 ; // 分(60分制) 1003 rtn.append( ':' ); // 6.0.2.5 (2014/10/31) char を append する。 1004 if( mtm < DEC ) { rtn.append( '0' ); } // 6.0.2.5 (2014/10/31) char を append する。 1005 rtn.append( mtm ); 1006 } 1007 } 1008 1009 return rtn.toString(); 1010 } 1011 1012 /** 1013 * 表示項目の編集(並び替え)が可能かどうかを返します。 1014 * 1015 * @return 表示項目の編集(並び替え)が可能かどうか(false:不可能) 1016 */ 1017 @Override 1018 public boolean isEditable() { 1019 return false; 1020 } 1021}