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.hayabusa.db;
017
018import org.opengion.hayabusa.common.HybsSystem;
019import org.opengion.fukurou.system.HybsConst ;                                  // 6.1.0.0 (2014/12/26)
020import org.opengion.fukurou.util.Attributes;
021import org.opengion.fukurou.util.TagBuffer;
022
023import static org.opengion.fukurou.util.StringUtil.isNull;              // 6.1.0.0 (2014/12/26)
024
025/**
026 * CellEditor の具象クラスで、カラムのデータを編集する場合に使用するクラスです。
027 *
028 *  カラムの表示に必要な属性は, DBColumn オブジェクト より取り出します。
029 * このクラスは、DBColumn オブジェクト毎に1つ作成されます。
030 *
031 * @og.group データ編集
032 *
033 * @version  4.0
034 * @author       Kazuhiko Hasegawa
035 * @since    JDK5.0,
036 */
037public abstract class AbstractEditor implements CellEditor {
038        private final int COLUMNS_MAXSIZE = HybsSystem.sysInt( "HTML_COLUMNS_MAXSIZE" ) ;       // 表示フィールドの大きさ
039        // 3.5.4.7 (2004/02/06) viewタグで表示する場合のカラムの大きさ
040        private final int VIEW_COLUMNS_MAXSIZE = HybsSystem.sysInt( "HTML_VIEW_COLUMNS_MAXSIZE" ) ;
041
042        /** システムの改行コードを設定します。*/
043        protected static final String CR                 = HybsConst.CR;                        // 6.1.0.0 (2014/12/26) refactoring
044        /** StringBilderなどの初期値を設定します。   {@value} */
045        protected static final int BUFFER_MIDDLE = HybsConst.BUFFER_MIDDLE;     // 6.1.0.0 (2014/12/26) refactoring
046
047        // 3.3.1.1 (2003/07/03) name , attributes 属性を final にする。
048        protected  Attributes   attributes ;            // SubClass で誤って new することを防止
049
050        // 6.4.4.2 (2016/04/01) size1,size2,name,tagBuffer をfinal化します。
051        protected  final String         size1            ;
052        protected  final String         size2            ;
053        protected  final String         name             ;
054        protected  final TagBuffer      tagBuffer = new TagBuffer() ;
055
056        /**
057         * デフォルトコンストラクター。
058         * このコンストラクターで、基本オブジェクトを作成します。
059         *
060         * @og.rev 3.1.1.1 (2003/04/03) 各オブジェクトから自分のインスタンスを返すファクトリメソッドを追加。
061         * @og.rev 6.4.3.3 (2016/03/04) PMD refactoring. Each class should declare at least one constructor.
062         *
063         */
064        public AbstractEditor() {
065                super();
066                name    = "null" ;
067                size1   = "20"   ;
068                size2   = "30"   ;
069        }
070
071        /**
072         * コンストラクター。
073         *
074         * @og.rev 3.1.1.1 (2003/04/03) 各オブジェクトから自分のインスタンスを返すファクトリメソッドを追加。
075         * @og.rev 3.5.4.2 (2003/12/15) 漢字入力(IMEモード)をONにするのを、"K" のみとします。
076         * @og.rev 3.5.4.2 (2003/12/15) size が 1 の場合、CSSファイルでサイズ指定を行うクラスを出力します。
077         * @og.rev 3.5.4.6 (2004/01/30) 漢字入力(IMEモード)をONにするのを、"K" と、"KX" のみとします。
078         * @og.rev 3.5.5.5 (2004/04/23) maxlength の導入
079         * @og.rev 4.0.0.0 (2005/01/31) getFieldSize メソッドを XHTMLTag から DBColumn へ移動
080         * @og.rev 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
081         * @og.rev 6.0.4.0 (2014/11/28) optionAttributes は、コンストラクタで設定します。
082         * @og.rev 6.2.0.0 (2015/02/27) 小さなカラムのサイズ指定は、すでに廃止 ("S0" + 桁数(1~5))
083         * @og.rev 6.2.0.0 (2015/02/27) フィールドサイズ 追加(VIEW_LENGTHと分離して、役割を明確にする)
084         *
085         * @param       clm     DBColumnオブジェクト
086         */
087        protected AbstractEditor( final DBColumn clm ) {
088                name = clm.getName();
089                final String disabled = clm.isWritable() ? null : "disabled" ;
090
091                final int maxlength = clm.getTotalSize();               // 4.0.0 (2005/01/31) メソッド名変更
092
093                // 6.1.1.0 (2015/01/17) Attributesの連結記述
094                attributes = new Attributes()
095                                                .set( "type"            , "text" )
096                                                .set( "maxlength"       , String.valueOf( maxlength ) )
097                                                .set( "disabled"        , disabled )
098                                                .set( clm.getEditorAttributes() )                                       // #addAttributes( Attributes ) の代替え
099                                                .add( "class"           , clm.getDbType() );                    // clazz 属性として使用
100
101                // 6.1.1.0 (2015/01/17) TagBufferの連結記述
102                tagBuffer.add( attributes.get( "optionAttributes" ) );  // 6.0.4.0 (2014/11/28)
103
104                // 3.5.5.5 (2004/04/23) size の導入、初期値は、一覧表のサイズにします。
105
106                // 6.2.0.0 (2015/02/27) フィールドサイズ 追加(VIEW_LENGTHと分離して、役割を明確にする)
107                size1 = String.valueOf( clm.getFieldSize( COLUMNS_MAXSIZE      ) );
108                size2 = String.valueOf( clm.getFieldSize( VIEW_COLUMNS_MAXSIZE ) );
109        }
110
111        /**
112         * データの編集用文字列を返します。
113         *
114         * @og.rev 3.5.5.5 (2004/04/23) viewSize の導入
115         * @og.rev 4.3.7.2 (2009/06/15) 属性でidが出力される場合は、idを出力しない
116         * @og.rev 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
117         *
118         * @param       value 値
119         *
120         * @return      データの編集用文字列
121         * @og.rtnNotNull
122         */
123        public String getValue( final String value ) {
124                // 6.1.1.0 (2015/01/17) TagBufferの連結記述
125                return new TagBuffer( "input" )
126                                        .add( "name"    , name )                                                                                // 4.3.6.0 (2009/04/01)
127                                        .add( "id"              , name , isNull( attributes.get( "id" ) ) )             // 4.3.7.2 (2009/06/15)
128                                        .add( "value"   , value )
129                                        .add( "size"    , size1 )
130                                        .add( tagBuffer.makeTag() )
131                                        .makeTag();
132        }
133
134        /**
135         * name属性を変えた、データ表示/編集用のHTML文字列を作成します。
136         * テーブル上の name に 行番号を付加して、名前_行番号 で登録するキーを作成し,
137         * リクエスト情報を1つ毎のフィールドで処理できます。
138         *
139         * @og.rev 2.0.0.3 (2002/09/26) optionAttributes 属性に "$i" を使うとその行数に置き換る機能を追加。
140         * @og.rev 3.1.0.0 (2003/03/20) 名前と行番号の区切り記号を "^" から "__" に変更。
141         * @og.rev 3.5.4.2 (2003/12/15) getFieldSize を、XHTMLTag.getFieldSize に変更。
142         * @og.rev 3.5.4.7 (2004/02/06) viewタグで表示する場合のカラムの大きさ VIEW_COLUMNS_MAXSIZE 追加
143         * @og.rev 3.5.5.0 (2004/03/12) 名前と行番号の区切り記号("__")を、HybsSystem.JOINT_STRING  に変更。
144         * @og.rev 3.5.5.5 (2004/04/23) viewSize の導入、初期値は、一覧表にあわせました。
145         * @og.rev 3.5.5.5 (2004/04/23) 新規に Attributes オブジェクトを作成する方式を止めます。
146         * @og.rev 4.3.7.2 (2009/06/15) 属性でidが出力される場合は、idを出力しない
147         * @og.rev 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
148         *
149         * @param       row   行番号
150         * @param       value 値
151         *
152         * @return      データ表示/編集用の文字列
153         * @og.rtnNotNull
154         */
155        public String getValue( final int row,final String value ) {
156                final String newName = name + HybsSystem.JOINT_STRING + row;
157
158                // 6.1.1.0 (2015/01/17) TagBufferの連結記述
159                return new TagBuffer( "input" )
160                                        .add( "name"    , newName )                                                                             // 4.3.6.0 (2009/04/01)
161                                        .add( "id"              , newName , isNull( attributes.get( "id" ) ) )  // 4.3.7.2 (2009/06/15)
162                                        .add( "value"   , value )
163                                        .add( "size"    , size2 )
164                                        .add( tagBuffer.makeTag() )
165                                        .makeTag( row,value );
166        }
167}