    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.fukurou.model;
    017
    018import java.util.ArrayList;
    019import java.util.List;
    020
    021
    022/**
    023 * [PN],[OYA] などの [] で指定されたカラムで表されたフォーマットデータに対して、
    024 * DataModel オブジェクトを適用して 各カラムに実データを割り当てるオブジェクトです。
    025 *
    026 * カラム名には、特殊カラム名が使用できます。これは、DataModel に存在しないカラム名
    027 * ですが、値を返すことが出来ます。
    028 * <pre>
    029 * [KEY.カラム名] : 行番号付きカラム名
    030 * [I]            : 行番号
    031 * [ROW.ID]       : 行毎のチェックボックスのID
    032 * [ROW.JSON]     : 行毎の全データのJavaScriptオブジェクト形式 { key:val,key:val,... }
    033 * カラムの前に修飾記号(#,$,!)を付けるとフォーマットを変更できます。
    034 * ただし、FormatTextField 系 と FormatTable 系で、出力される形式が異なります。
    035 *                  FormatTextField 系               FormatTable 系
    036 * [#カラム名]    : TDなしのラベルと入力フィールド   ラベルを出力
    037 * [$カラム名]    : TDなしの入力フィールドのみ       レンデラーを出力
    038 * [!カラム名]    : TDなしの値のみ                   値を出力
    039 *
    040 * </pre>
    041 * @og.group 画面表示
    042 *
    043 * @version  4.0
    044 * @author   Kazuhiko Hasegawa
    045 * @since    JDK5.0,
    046 */
    047public class Formatter {
    048        /** カラムID(連結文字列)行番号の連結文字列を定義 {@value} */
    049        public static final String JOINT_STRING = "__" ;
    050
    051        /** テーブル表示のチェックボックスを特定する id の 名称( id は、この名称＋行番号) {@value} */
    052        public static final String ROW_ID_KEY = "cb";   // 3.6.0.0 (2004/09/17)
    053
    054        /** 特殊カラム名の定義: 行番号 [I]  */
    055        public static final int SYS_ROWNUM      = -1;           // [KEY.カラム名],[I],[ROW.ID]
    056        /** 特殊カラム名の定義: [ROW.JSON]       */
    057        public static final int SYS_JSON        = -2;           // [ROW.JSON]
    058
    059        private final DataModel<?>      model   ;                       // 4.3.3.6 (2008/11/15) Generics警告対応
    060        private int[]                           clmNos  = null;         // フォーマットのカラム番号配列
    061        private String[]                        format  = null;
    062        private String[]                        clmKeys = null;         // フォーマットのカラム名配列
    063        private char[]                          type    = null;         // '#':ラベルのみ  '$':レンデラー '!':値のみ  その他:通常
    064
    065        /**
    066         * データモデルを指定してフォーマッターを構築します。
    067         *
    068         * @param  model データモデル
    069         */
    070        public Formatter( final DataModel<?> model ) {          // 4.3.3.6 (2008/11/15) Generics警告対応
    071                this.model = model;
    072        }
    073
    074        /**
    075         * フォーマットをセットします。
    076         *
    077         * @param       fmt  [カラム名] 形式のフォーマットデータ
    078         */
    079        public void setFormat( final String fmt ) {
    080                makeFormatList( fmt );
    081                advanceFormat();
    082        }
    083
    084        /**
    085         * フォーマットをセットします。
    086         *
    087         * @param       fmt  [カラム名] 形式のフォーマットデータ
    088         */
    089        private void makeFormatList( final String fmt ) {
    090                int start = 0;
    091                int index = fmt.indexOf( '[' );
    092                List<String> clmKeyList = new ArrayList<String>();
    093                List<String> formatList = new ArrayList<String>();
    094                while( index >= 0 ) {
    095                        int end = fmt.indexOf( ']',index );
    096                        if( end < 0 ) {
    097                                String errMsg = "[ と ] との対応関係がずれています。"
    098                                                        + "format=[" + fmt + "] : index=" + index ;
    099                                throw new RuntimeException( errMsg );
    100                        }
    101
    102                        // [ より前方の文字列は、formatList へ
    103                        if( index > 0 ) { formatList.add( fmt.substring( start,index ) ); }
    104                        else                    { formatList.add( "" ); }       // ][ と連続しているケース
    105
    106                        // [XXXX] の XXXX部分を処理
    107                        clmKeyList.add( fmt.substring( index+1,end ) );
    108
    109                        start = end+1 ;
    110                        index = fmt.indexOf( '[',start );
    111                }
    112                // ] の後方部分は、formatList へ
    113                formatList.add( fmt.substring( start ) );
    114
    115                format  = formatList.toArray( new String[formatList.size()] );
    116                clmKeys = clmKeyList.toArray( new String[clmKeyList.size()] );
    117        }
    118
    119        /**
    120         * 追加機能フォーマットを作成します。
    121         *
    122         */
    123        private void advanceFormat() {
    124
    125                int size = clmKeys.length ;
    126                clmNos = new int[size];
    127                type   = new char[size];
    128
    129                // カラム番号の設定と、特殊カラム名処理
    130                String clm ;
    131                for( int i=0; i<size; i++ ) {
    132                        clm = clmKeys[i];
    133                        char ch = clm.charAt(0);
    134                        if( ch == '#' || ch == '$' || ch == '!' ) {
    135                                type[i] = ch;
    136                                clm = clm.substring(1);
    137                                clmKeys[i]      = clm;
    138                                clmNos[i] = model.getColumnNo( clm );
    139                        }
    140                        // [KEY.カラム名] 機能追加
    141                        else if( clm.startsWith( "KEY." ) ) {
    142                                clmNos[i]       = SYS_ROWNUM;
    143                                format[i]       = format[i] + clm.substring(4) + JOINT_STRING ;
    144                        }
    145                        // [I] 機能追加
    146                        else if( "I".equals( clm ) ) {
    147                                clmNos[i]       = SYS_ROWNUM;
    148                        }
    149                        // [ROW.ID] 機能追加
    150                        else if( "ROW.ID".equals( clm ) ) {
    151                                clmNos[i] = SYS_ROWNUM;
    152                                format[i] = format[i] + ROW_ID_KEY ;
    153                        }
    154                        // [ROW.JSON] 機能追加
    155                        else if( "ROW.JSON".equals( clm ) ) {
    156                                clmNos[i] = SYS_JSON;
    157                        }
    158                        else {
    159                                clmNos[i] = model.getColumnNo( clm );
    160                        }
    161                }
    162        }
    163
    164        /**
    165         * column にあるセルの属性値をStringに変換して返します。
    166         *
    167         * @param       row     処理中の行番号
    168         * @param       clm     値が参照されるカラム番号
    169         *
    170         * @return      指定されたセルの値
    171         *
    172         */
    173        public String getValue( final int row,final int clm ) {
    174                final String rtn ;
    175                if( clm >= 0 ) {
    176                        rtn = String.valueOf( model.getValue( row,clm ) );
    177                }
    178                else if( clm == SYS_ROWNUM ) {
    179                        rtn = String.valueOf( row );
    180                }
    181                else if( clm == SYS_JSON ) {
    182                        rtn = getJson( row );
    183                }
    184                else {
    185                        String errMsg = "指定のカラム番号に該当する処理が見つかりません。"
    186                                                + "clm=[" + clm + "]" ;
    187                        throw new RuntimeException( errMsg );
    188                }
    189
    190                return rtn ;
    191        }
    192
    193        /**
    194         * 指定の 行番号に対する、DataModel を元に作成したフォーマット文字列を返します。
    195         *
    196         * @param       row     行番号( [I]フォーマット処理用 )
    197         *
    198         * @return  指定のObject配列を元に作成したフォーマット文字列
    199         */
    200        public String getFormatString( final int row ) {
    201                return getFormatString( row, null );
    202        }
    203
    204        /**
    205         * 指定の 行番号に対する、DataModel を元に作成したフォーマット文字列を返します。
    206         * データはseparatorで指定された区切り文字で囲まれて返されます。
    207         *
    208         * @og.rev 4.3.1.1 (2008/08/23) switch に、default label が存在しないため、追加
    209         *
    210         * @param       row     行番号( [I]フォーマット処理用 )
    211         * @param       separator       セパレーター
    212         *
    213         * @return  指定のObject配列を元に作成したフォーマット文字列
    214         */
    215        public String getFormatString( final int row, final String separator ) {
    216                StringBuilder rtnStr = new StringBuilder( 200 );
    217
    218                int count = clmNos.length;
    219                for( int i=0; i<count; i++ ) {
    220                        rtnStr.append( format[i] );
    221                        if( clmNos[i] == SYS_ROWNUM ) {
    222                                rtnStr.append( row );
    223                        }
    224                        else if( clmNos[i] == SYS_JSON ) {
    225                                rtnStr.append( getJson( row ) );
    226                        }
    227                        else {
    228                                if( separator == null || separator.length() == 0 ) {
    229                                        rtnStr.append( model.getValue( row,clmNos[i] ) );
    230                                }
    231                                else {
    232                                        // 4.3.1.1 (2008/08/23) default label が存在しないため、追加
    233                                        switch( model.getNativeType( clmNos[i] ) ) {
    234                                                case INT:
    235                                                case LONG:
    236                                                case DOUBLE:
    237                                                        rtnStr.append( model.getValue( row,clmNos[i] ) );
    238                                                        break;
    239                                                case STRING:
    240                                                case CALENDAR:
    241                                                        rtnStr.append( separator ).append( model.getValue( row,clmNos[i] ) ).append( separator );
    242                                                        break;
    243                                                default:
    244                                                        throw new AssertionError( "Unexpected enumrated value! " + model.getNativeType( clmNos[i] ) );
    245                                        }
    246                                }
    247                        }
    248                }
    249                rtnStr.append( format[count] );
    250
    251                return rtnStr.toString();
    252        }
    253
    254        /**
    255         * 先のフォーマット情報の[カラム名]を、? に置き換えたフォーマットを返します。
    256         * これは、java.sql.PreparedStatement 形式のQuery文字列を合成する場合に使用します。
    257         *
    258         * @return  PreparedStatement形式のQuery文字列
    259         */
    260        public String getQueryFormatString() {
    261                StringBuilder rtnStr = new StringBuilder( 200 );
    262
    263                int count = clmKeys.length;
    264                for( int i=0; i<count; i++ ) {
    265                        rtnStr.append( format[i] ).append( '?' );
    266                }
    267                rtnStr.append( format[count] );
    268
    269                return rtnStr.toString();
    270        }
    271
    272        /**
    273         * フォーマットのカラム名配列を返します。
    274         *
    275         * @return      フォーマットのカラム名配列
    276         */
    277        public String[] getClmKeys() {
    278                return clmKeys.clone();
    279        }
    280
    281        /**
    282         * フォーマットのカラム番号配列を返します。
    283         *
    284         * @return      フォーマットのカラム番号配列
    285         */
    286        public int[] getClmNos() {
    287                return clmNos.clone();
    288        }
    289
    290        /**
    291         * フォーマット配列を返します。
    292         *
    293         * @return      フォーマット配列
    294         */
    295        public String[] getFormat() {
    296                return format.clone();
    297        }
    298
    299        /**
    300         * タイプ文字列配列を返します。
    301         * タイプとは、[XXX] の記述で、[#XXX] は、XXXカラムのラベルを、[$XXX]は、XXXカラムの
    302         * レンデラーを、[!XXX} は、値のみ取り出す指定を行います。
    303         * 主に、TextField系のフォーマットとTable系では、意味合いが異なりますので、
    304         * ご注意ください。
    305         *
    306         * @return タイプ文字列配列 '#':ラベルのみ  '$':レンデラー '!':値のみ  その他:通常
    307         */
    308        public char[] getType() {
    309                return type.clone();
    310        }
    311
    312        /**
    313         * 行毎の全データのJavaScriptオブジェクト形式 を返します。
    314         *
    315         * JavaScriptオブジェクト形式とは、{ key:val,key:val,... }の形式で、
    316         * ここでは、内部設定された DataModel のすべてのカラム名をキーに、
    317         * 引数で渡された 配列を 値として使用します。
    318         *
    319         * @param       row     (DataModelの)行番号
    320         *
    321         * @return  指定の行番号に対応する全データのJSON形式データ
    322         */
    323        public String getJson( final int row ) {
    324                String[] names = model.getNames();
    325                Object[] vals  = model.getValues( row );
    326
    327                StringBuilder rtnStr = new StringBuilder( 200 );
    328
    329                rtnStr.append( "{'I':'" ).append( row ).append( "'" );  // 行番号
    330
    331                for( int i=0; i<names.length; i++ ) {
    332                        rtnStr.append( ",'" ).append( names[i] ).append( "':'" );
    333                        rtnStr.append( vals[i] ).append( "'" );
    334                }
    335                rtnStr.append( "}" );
    336
    337                return rtnStr.toString();
    338        }
    339}