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