    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 * データは、キー単位に１レコード作成されます。（キーブレイク）その間、日時順に
    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 * 画像ファイルは、全データに対して、１画像だけなので、サイズは大きくなりますが、１レコード
    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         ;       // １レコードのチャートの間隔をpxで指定。実際の幅は、CHART_HEIGHT＋MARGIN＊２
    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) 短縮ラベルなど、&lt;span&gt;タグが付与される値から、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                // イメージの 最大Ｘ、Ｙサイズを求め、結果を、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 座標,幅,高さ) ＋１は罫線の分
    178
    179                StringBuilder out = new StringBuilder( HybsSystem.BUFFER_LARGE );
    180
    181                String oldKeyVal = "";                          // 初期値。１回目にキーブレイクさせる。
    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)場合は、２行分、使わない場合は、ヘッダーの１行が初期値
    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                                // キーブレイクで最初に行うのは、前のレコードの未出力分の処理。１行目は、処理不要
    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"           );      // １レコードのチャートの間隔をpxで指定。実際の幅は、CHART_HEIGHT＋MARGIN＊２
    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         * イメージの ＸＹサイズを求め、結果を、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 = "";  // 初期値。１回目にキーブレイクさせる。
    444
    445                int clmSu = labelClmsNo.length;
    446                maxClmWidth = new int[clmSu];
    447
    448                int rowCnt = useLegend ? 2 : 1;         // 凡例(useLegend)を使う(true)場合は、２行分、使わない場合は、ヘッダーの１行が初期値
    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                        // 最大ラベル幅は、各ラベルの最大値＋（マージン＊２）＊カラム数
    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 ;   // １レコード分の高さを加算しておく。
    553                        posY2 += chartHeight+recodeMargin*2 ;   // １レコード分の高さを加算しておく。
    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  １日
    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                 * 内部カウンターを＋１ しながら、内部の色オブジェクトを返します。
    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         * 引数の時間は、分を表す整数です。２４時間表記であれば、0 ～ 1440 の範囲で収まりますが、
    831         * 期間が長い場合は、その値を超えます。また、２４時間を超える場合は、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 ;         // 時(２４時間制)
    849                int mtm = timeVal % 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}