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.hayabusa.db.AbstractEditor;
019import org.opengion.hayabusa.db.CellEditor;
020import org.opengion.hayabusa.db.DBColumn;
021// import org.opengion.hayabusa.common.HybsSystem;
022import org.opengion.fukurou.util.XHTMLTag;
023import org.opengion.fukurou.util.StringUtil ;                                   // 6.2.0.0 (2015/02/27)
024
025/**
026 * 先頭１文字目が、アンダーバー(_) の場合に、書込み禁止属性()を強制的に付与するクラスです。
027 *
028 * ・データベースに書き込むときには、通常のアンダーバー無しの文字列とします。
029 *
030 * このエディタはeventColumnに対応していません。
031 *
032 *  カラムの表示に必要な属性は、DBColumn オブジェクト より取り出します。
033 * このクラスは、DBColumn オブジェクト毎に１つ作成されます。
034 *
035 * @og.rev 3.0.0.4 (2003/02/26) 新規追加
036 * @og.group データ編集
037 *
038 * @version  4.0
039 * @author       Kazuhiko Hasegawa
040 * @since    JDK5.0,
041 */
042public class Editor_WRITABLE extends AbstractEditor {
043        /** このプログラムのVERSION文字列を設定します。   {@value} */
044        private static final String VERSION = "4.0.0.0 (2005/08/31)" ;
045
046        /**
047         * デフォルトコンストラクター。
048         * このコンストラクターで、基本オブジェクトを作成します。
049         *
050         * @og.rev 3.1.1.1 (2003/04/03) 各オブジェクトから自分のインスタンスを返すファクトリメソッドを追加。
051         *
052         */
053        public Editor_WRITABLE() { super(); }           // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。
054
055        /**
056         * DBColumnオブジェクトを指定したprivateコンストラクター。
057         *
058         * @og.rev 3.1.1.1 (2003/04/03) 各オブジェクトから自分のインスタンスを返すファクトリメソッドを追加。
059         * @og.rev 3.5.6.0 (2004/06/18) XHTMLTag の 内部配列 INPUT_KEY を隠蔽します。
060         *
061         * @param       clm     DBColumnオブジェクト
062         */
063        private Editor_WRITABLE( final DBColumn clm ) {
064                super( clm );
065                tagBuffer.add( XHTMLTag.inputAttri( attributes ) );
066        }
067
068        /**
069         * 各オブジェクトから自分のインスタンスを返します。
070         * 自分自身をキャッシュするのか、新たに作成するのかは、各サブクラスの実装に
071         * まかされます。
072         *
073         * @og.rev 3.1.1.1 (2003/04/03) 各オブジェクトから自分のインスタンスを返すファクトリメソッドを追加。
074         * @og.rev 3.1.2.1 (2003/04/10) synchronized を、削除します。
075         *
076         * @param       clm     DBColumnオブジェクト
077         *
078         * @return      CellEditorオブジェクト
079         * @og.rtnNotNull
080         */
081        public CellEditor newInstance( final DBColumn clm ) {
082                return new Editor_WRITABLE( clm );
083        }
084
085        /**
086         * データの編集用文字列を返します。
087         *
088         * @og.rev 3.5.4.2 (2003/12/15) 書込み禁止属性("_")のデータは、hidden で出力しておきます。
089         * @og.rev 3.5.5.5 (2004/04/23) hidden の出力に、XHTMLTag.hidden を使用します。
090         *
091         * @param       value 入力値
092         *
093         * @return      データの編集用文字列
094         */
095        @Override
096        public String getValue( final String value ) {
097                if( StringUtil.startsChar( value , '_' ) ) {                    // 6.2.0.0 (2015/02/27) １文字 String.startsWith
098                        final String val = value.substring( 1 );
099                        return val + XHTMLTag.hidden( name,val );                       // 3.5.5.5 (2004/04/23)
100                }
101
102                return super.getValue( value );
103        }
104
105        /**
106         * name属性を変えた、データ表示/編集用のHTML文字列を作成します。
107         * テーブル上の name に 行番号を付加して、名前_行番号 で登録するキーを作成し、
108         * リクエスト情報を１つ毎のフィールドで処理できます。
109         *
110         * @og.rev 2.0.0.3 (2002/09/26) optionAttributes 属性に "$i" を使うとその行数に置き換る機能を追加。
111         * @og.rev 3.5.4.2 (2003/12/15) 書込み禁止属性("_")のデータは、hidden で出力しておきます。
112         * @og.rev 3.5.5.0 (2004/03/12) 名前と行番号の区切り記号("__")を、HybsSystem.JOINT_STRING  に変更。
113         * @og.rev 3.5.5.5 (2004/04/23) hidden の出力に、XHTMLTag.hidden を使用します。
114         *
115         * @param       row   行番号
116         * @param       value 入力値
117         *
118         * @return      データ表示/編集用の文字列
119         */
120        @Override
121        public String getValue( final int row,final String value ) {
122                if( StringUtil.startsChar( value , '_' ) ) {                    // 6.2.0.0 (2015/02/27) １文字 String.startsWith
123                        final String val = value.substring( 1 );
124                        return val + XHTMLTag.hidden( name,val );                       // 3.5.5.5 (2004/04/23)
125                }
126
127                return super.getValue( value );
128        }
129}