    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.util.HybsDateUtil;
    019
    020import org.opengion.hayabusa.db.AbstractRenderer;
    021import org.opengion.hayabusa.db.CellRenderer;
    022import org.opengion.hayabusa.db.DBColumn;
    023
    024/**
    025 * TMSTMP レンデラーは、日付ネイティブのカラムのデータから、数字部分だけをピックアップし、
    026 * 日時(年/月/日 時:分:秒)または、日付(年/月/日)表示する場合に使用するクラスです。
    027 * 数字以外は、各データベースによって、まちまちなので、'/',':','-',' ' を削除します。
    028 * なお、並び順は、必須に、YYYYMMDDHHMISS の順番とし、January 8 などの形式や、
    029 * 04:05 AM 、1/8/1999 などの形式は受け付けることは出来ません。
    030 * あくまで、先頭から 数字を順次取得し、YYYYMMDDHHMISS 形式に当てはめていきます。
    031 * また、時刻部分 HHMISS が 000000 の場合は、日付のみに自動的にします。
    032 * これは、日付ネイティブでは、時刻情報も持っているため、使っているのかどうかの
    033 * 判定は、実際のデータが、000000 に設定されているかどうかでしか判断できないためです。
    034 * 自動判定がまずい場合は、通常のレンデラーで、表示桁数制限しても構いません。
    035 *
    036 * このクラスは、不変オブジェクトとして、共有されます。
    037 *
    038 * @og.group データ表示
    039 *
    040 * @og.rev 5.3.10.0 (2011/10/01) synchronized を、削除します。
    041 *
    042 * @version  4.0
    043 * @author   Kazuhiko Hasegawa
    044 * @since    JDK5.0,
    045 */
    046public class Renderer_TMSTMP extends AbstractRenderer {
    047        /** このプログラムのVERSION文字列を設定します。   {@value} */
    048        private static final String VERSION = "6.4.2.0 (2016/01/29)" ;
    049
    050        private static final CellRenderer DB_CELL = new Renderer_TMSTMP() ;
    051
    052        /**
    053         * デフォルトコンストラクター
    054         *
    055         * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
    056         */
    057        public Renderer_TMSTMP() { super(); }           // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。
    058
    059        /**
    060         * 各オブジェクトから自分のインスタンスを返します。
    061         * 自分自身をキャッシュするのか、新たに作成するのかは、各サブクラスの実装に
    062         * まかされます。
    063         *
    064         * @param       clm     DBColumnオブジェクト
    065         *
    066         * @return      CellRendererオブジェクト
    067         * @og.rtnNotNull
    068         */
    069        public CellRenderer newInstance( final DBColumn clm ) {
    070                return DB_CELL;
    071        }
    072
    073        /**
    074         * データの表示用文字列を返します。
    075         * 日時(年/月/日 時:分:秒)または、日付(年/月/日)表示する場合に使用するクラスです。
    076         * 数字以外は、各データベースによって、まちまちなので、'/',':','-',' ' を削除します。
    077         * なお、並び順は、必須に、YYYYMMDDHHMISS の順番とし、January 8 などの形式や、
    078         * 04:05 AM 、1/8/1999 などの形式は受け付けることは出来ません。
    079         * あくまで、先頭から 数字を順次取得し、YYYYMMDDHHMISS 形式に当てはめていきます。
    080         * また、時刻部分 HHMISS が 000000 の場合は、日付のみに自動的にします。
    081         * これは、日付ネイティブでは、時刻情報も持っているため、使っているのかどうかの
    082         * 判定は、実際のデータが、000000 に設定されているかどうかでしか判断できないためです。
    083         * 自動判定がまずい場合は、通常のレンデラーで、表示桁数制限しても構いません。
    084         *
    085         * ここでは、規定のフォーマット(８ケタ OR １４ケタ)でない場合は、エラー表示を行います。
    086         *
    087         * @og.rev 5.5.7.2 (2012/10/09) HybsDateUtil を利用するように修正します。
    088         * @og.rev 6.0.4.0 (2014/11/28) ロジックの共通化
    089         *
    090         * @param   value 入力値
    091         *
    092         * @return  データの表示用文字列
    093         * @og.rtnNotNull
    094         */
    095        @Override
    096        public String getValue( final String value ) {
    097                return getValue( value , true );
    098
    099        }
    100
    101        /**
    102         * データ出力用の文字列を作成します。
    103         * ファイル等に出力する形式を想定しますので、HTMLタグを含まない
    104         * データを返します。
    105         * 基本は、#getValue( String ) をそのまま返します。
    106         *
    107         * @og.rev 6.0.4.0 (2014/11/28) データ出力用のレンデラー
    108         *
    109         * @param   value 入力値
    110         *
    111         * @return  データ出力用の文字列
    112         * @og.rtnNotNull
    113         * @see         #getValue( String )
    114         */
    115        @Override
    116        public String getWriteValue( final String value ) {
    117                return getValue( value , false );
    118        }
    119
    120        /**
    121         * データ表示用/出力用の文字列を作成します。
    122         * 第二引数の isView == true で、データ表示用文字列を、false で
    123         * データ出力用の文字列を作成します。
    124         * 処理の共通化を行うためのメソッドです。
    125         *
    126         * @og.rev 6.0.4.0 (2014/11/28) ロジックの共通化
    127         *
    128         * @param   value  入力値
    129         * @param   isView データ表示用かどうか(true:表示用/false:出力用)
    130         *
    131         * @return  データ表示用/出力用の文字列
    132         * @og.rtnNotNull
    133         * @see         #getValue( String )
    134         */
    135        private String getValue( final String value , final boolean isView ) {
    136                if( value == null || value.isEmpty() ) { return ""; }
    137
    138                String rtn = value;                     // 初期値:isView = false の時の値
    139
    140                if( rtn.length() != 8 && rtn.length() != 14 ) {
    141                        rtn = HybsDateUtil.parseNumber( value );
    142                }
    143
    144                char[] ch1 = new char[19];
    145                if( rtn.length() == 8 || rtn.length() == 14 ) {
    146                        ch1[0] = rtn.charAt(0);
    147                        ch1[1] = rtn.charAt(1);
    148                        ch1[2] = rtn.charAt(2);
    149                        ch1[3] = rtn.charAt(3);
    150                        ch1[4] = '/' ;
    151                        ch1[5] = rtn.charAt(4);
    152                        ch1[6] = rtn.charAt(5);
    153                        ch1[7] = '/' ;
    154                        ch1[8] = rtn.charAt(6);
    155                        ch1[9] = rtn.charAt(7);
    156
    157                        // 6.3.9.0 (2015/11/06) 条件は効果がない(findbugs)。rtn.length() == 14 は確定している。
    158                        if( rtn.length() == 8 || rtn.endsWith( "000000" ) ) {
    159                                rtn = new String( ch1 , 0 , 10 );       // YYYY/MM/DD 形式を返す。
    160                        }
    161                        else {
    162                                ch1[10] = ' ';
    163                                ch1[11] = rtn.charAt(8);
    164                                ch1[12] = rtn.charAt(9);
    165                                ch1[13] = ':';
    166                                ch1[14] = rtn.charAt(10);
    167                                ch1[15] = rtn.charAt(11);
    168                                ch1[16] = ':';
    169                                ch1[17] = rtn.charAt(12);
    170                                ch1[18] = rtn.charAt(13);
    171                                rtn = new String( ch1 );                        // YYYY/MM/DD HH:MM:SS 形式を返す。
    172                        }
    173                }
    174                else {
    175                        if( isView ) {
    176                                rtn = "<span class=\"error\">" + value + "</span>";
    177                        }
    178                }
    179
    180                return rtn ;
    181        }
    182}