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( "'","&#39;" );
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( "'","&#39;" );
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( "'","&#39;" );
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}