    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.column;
    017
    018import org.opengion.fukurou.system.DateSet;                                                     // 6.4.2.0 (2016/01/29)
    019import org.opengion.fukurou.util.HybsDateUtil;
    020import org.opengion.hayabusa.common.HybsSystem;
    021import org.opengion.hayabusa.db.AbstractRenderer;
    022import org.opengion.hayabusa.db.CellRenderer;
    023import org.opengion.hayabusa.db.DBColumn;
    024
    025import java.util.Calendar;
    026
    027/**
    028 * DATE レンデラーは、カラムのデータを表示パラメータで指定されたフォーマットで
    029 * 日付表示する場合に使用するクラスです。
    030 * 6桁未満のデータの場合はフォーマットをかけずにそのまま出力します。
    031 *
    032 * 表示パラメータで指定されたフォーマットを、java.text.SimpleDateFormat で
    033 * 解析してフォーマット変換します。
    034 * フォーマットルールは、{@link java.text.SimpleDateFormat} を参照願います。
    035 * フォーマット初期値はシステムリソースのSYS_TIMEです。
    036 *
    037 *  カラムの表示に必要な属性は, DBColumn オブジェクト より取り出します。
    038 * このクラスは、DBColumn オブジェクト毎に１つ作成されます。
    039 *
    040 * @og.rev 3.5.0.0 (2003/09/17) 新規作成
    041 * @og.rev 5.4.3.6 (2012/01/19) コメント修正
    042 * @og.group データ表示
    043 *
    044 * @version  4.0
    045 * @author       Kazuhiko Hasegawa
    046 * @since    JDK5.0,
    047 */
    048public class Renderer_DATE extends AbstractRenderer {
    049        /** このプログラムのVERSION文字列を設定します。   {@value} */
    050        private static final String VERSION = "6.8.3.1 (2017/12/01)" ;
    051
    052        private final String    format ;                        // 5.5.7.2 (2012/10/09) HybsDateUtil を利用
    053        private final String    defValue ;
    054
    055        // 6.8.3.1 (2017/12/01) 標準オブジェクトのキャッシュ
    056        private static final CellRenderer DB_CELL = new Renderer_DATE();
    057
    058        /**
    059         * デフォルトコンストラクター。
    060         * このコンストラクターで、基本オブジェクトを作成します。
    061         *
    062         * @og.rev 6.8.3.1 (2017/12/01) 標準オブジェクトとして、利用できる形にして、キャッシュします。
    063         */
    064        public Renderer_DATE() {
    065                super();                // 6.4.1.1 (2016/01/16) PMD refactoring. It is a good practice to call super() in a constructor
    066                format          = HybsSystem.sys( "SYS_TIME" );
    067                defValue        = "";
    068        }
    069
    070        /**
    071         * DBColumnオブジェクトを指定したprivateコンストラクター。
    072         *
    073         * @og.rev 3.5.1.0 (2003/10/03) 初期値が nullの場合は、""、８桁以下はそのまま返す。
    074         * @og.rev 3.8.5.3 (2006/08/01) 日付を６桁以上 とし、それ以下はそのまま返す。
    075         * @og.rev 5.5.7.2 (2012/10/09) HybsDateUtil を利用するように修正します。
    076         * @og.rev 6.8.3.1 (2017/12/01) 標準オブジェクトとして、利用できる形にして、キャッシュします。
    077         *
    078         * @param       clm     DBColumnオブジェクト
    079         */
    080        private Renderer_DATE( final DBColumn clm ) {
    081                super();                // 6.4.1.1 (2016/01/16) PMD refactoring. It is a good practice to call super() in a constructor
    082
    083                String fm = clm.getRendererParam();
    084                if( fm == null || fm.isEmpty() || fm.equals( "_" ) ) {
    085                        fm = HybsSystem.sys( "SYS_TIME" );
    086                }
    087                format = fm;                    // 5.5.7.2 (2012/10/09) HybsDateUtil を利用
    088
    089                final String defv = clm.getDefault();
    090                if( defv == null || defv.equals( "_" ) ) {
    091                        defValue = "";
    092                }
    093                else if( defv.length() < 6 ) {
    094                        defValue = defv;
    095                }
    096                else {
    097                        final Calendar cal = HybsDateUtil.getCalendar( defv );
    098                        defValue = DateSet.getDate( cal.getTimeInMillis() , format );
    099                }
    100        }
    101
    102        /**
    103         * 各オブジェクトから自分のインスタンスを返します。
    104         * 自分自身をキャッシュするのか、新たに作成するのかは、各サブクラスの実装に
    105         * まかされます。
    106         *
    107         * @og.rev 6.8.3.1 (2017/12/01) 標準オブジェクトとして、利用できる形にして、キャッシュします。
    108         *
    109         * @param       clm     DBColumnオブジェクト
    110         * @return      CellRendererオブジェクト
    111         * @og.rtnNotNull
    112         */
    113        public CellRenderer newInstance( final DBColumn clm ) {
    114                // 6.8.3.1 (2017/12/01) 標準オブジェクトとして、利用できる形にして、キャッシュします。
    115                final String fm   = clm.getRendererParam();
    116                final String defv = clm.getDefault();
    117
    118                if( ( fm == null || fm.isEmpty() || fm.equals( "_" ) ) &&
    119                        ( defv == null || defv.equals( "_" ) ) ) {
    120                                return DB_CELL;
    121                }
    122
    123                return new Renderer_DATE( clm );
    124        }
    125
    126        /**
    127         * データの表示用文字列を返します。
    128         *
    129         * @og.rev 3.5.1.0 (2003/10/03) データが nullの場合は、デフォルト値を、８桁以下はそのまま返す。
    130         * @og.rev 3.8.5.3 (2006/08/01) 日付を６桁以上 とし、それ以下はそのまま返す。
    131         * @og.rev 5.5.7.2 (2012/10/09) HybsDateUtil を利用するように修正します。
    132         *
    133         * @param       value 入力値
    134         * @return      データの表示用文字列
    135         */
    136        @Override
    137        public String getValue( final String value ) {
    138                if( value == null      ) { return defValue; }
    139                if( value.length() < 6 ) { return value; }
    140
    141                final Calendar cal = HybsDateUtil.getCalendar( value );
    142                return DateSet.getDate( cal.getTimeInMillis() , format );
    143        }
    144
    145        /**
    146         * name属性を変えた、データ表示用のHTML文字列を作成します。
    147         * レンデラーのため、row(行番号)は使いません。
    148         * 第３引数に、パラメータを渡すことが出来ます。これは、viewMarker で
    149         * [$XXXX param] 形式を渡すことで、行単位に表示形式を変更できます。
    150         *
    151         * @og.rev 6.8.3.1 (2017/12/01) パラメータを渡せるようにします。
    152         *
    153         * @param   row   行番号
    154         * @param   value 値
    155         * @param   param パラメータ
    156         * @return  データ表示/編集用の文字列
    157         */
    158        @Override
    159        public String getValue( final int row,final String value,final String param ) {
    160                if( value == null      ) { return defValue; }
    161                if( value.length() < 6 ) { return value; }
    162
    163                String fm = param;
    164                if( fm == null || fm.isEmpty() || fm.equals( "_" ) ) {
    165                        fm = HybsSystem.sys( "SYS_TIME" );
    166                }
    167
    168                final Calendar cal = HybsDateUtil.getCalendar( value );
    169                return DateSet.getDate( cal.getTimeInMillis() , fm );
    170        }
    171}