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     */
016    package org.opengion.plugin.column;
017    
018    import org.opengion.hayabusa.db.AbstractEditor;
019    import org.opengion.hayabusa.db.CellEditor;
020    import org.opengion.hayabusa.db.DBColumn;
021    import org.opengion.fukurou.util.XHTMLTag;
022    import org.opengion.fukurou.util.StringUtil;
023    
024    /**
025     * HTMLタグを含ã‚?ƒ‡ータを編é›?�™るå?合に使用するエãƒ?‚£タークラスですã?
026     *
027     * ãƒ??タベã?スに対して、加工なしデータを登録してã�?�¾すã?HTMLタグã‚?
028     * 含ã‚?ƒ‡ータは、DBTypeのチェãƒ?‚¯によりã€??常は登録できませんã€?
029     * これは、クロスサイトスクリプティング対策ã?為ですã?DBTypeを指定すã‚?
030     * ことで、HTMLタグの登録が可能になりますã?
031     * しかしã?エンジンでは、検索時å?ç�?‚’優先させる為、検索時にはåŠ?·¥して
032     * ã�?�¾せん。つまりã?HTMLタグを含ã‚?ƒ‡ータをそのまま表示させると、HTMLの
033     * コードと解釈されã?レイアウトが崩れることになりますã?
034     * HTMLエãƒ?‚£ターは、データのHTMLタグをエスケープすることで、表示上ã?ã€?
035     * HTMLコードがそã?まま表示/編é›?�§きる状態にしますã?
036     *
037     * カラãƒ??表示にå¿?¦�な属æ?は, DBColumn オブジェクãƒ?より取り出しますã?
038     * こã?クラスは、DBColumn オブジェクト毎に?‘つ作æ?されますã?
039     *
040     * @og.rev 2.1.1.1 (2002/11/15) HTML エãƒ?‚£ターを新規追åŠ?�—ましたã€?
041     * @og.group ãƒ??タ編é›?
042     *
043     * @version  4.0
044     * @author       Kazuhiko Hasegawa
045     * @since    JDK5.0,
046     */
047    public class Editor_HTML extends AbstractEditor {
048            //* こã?プログラãƒ??VERSIONæ–?­—å?を設定しますã?       {@value} */
049            private static final String VERSION = "4.0.0.0 (2005/08/31)" ;
050    
051            /**
052             * ãƒ?ƒ•ォルトコンストラクターã€?
053             * こã?コンストラクターで、基本オブジェクトを作æ?しますã?
054             *
055             * @og.rev 3.1.1.1 (2003/04/03) å�?‚ªブジェクトからè?åˆ??インスタンスを返すファクトリメソãƒ?ƒ‰を追åŠ??
056             *
057             */
058            public Editor_HTML() {
059                    // 4.3.4.4 (2009/01/01)
060    //              super();
061            }
062    
063            /**
064             * コンストラクターã€?
065             *
066             * @og.rev 3.1.1.1 (2003/04/03) å�?‚ªブジェクトからè?åˆ??インスタンスを返すファクトリメソãƒ?ƒ‰を追åŠ??
067             * @og.rev 3.5.6.0 (2004/06/18) XHTMLTag の å†?ƒ¨配å? INPUT_KEY を隠蔽しますã?
068             *
069             * @param       clm     DBColumnオブジェクãƒ?
070             */
071            private Editor_HTML( final DBColumn clm ) {
072                    super( clm );
073                    tagBuffer.add( XHTMLTag.inputAttri( attributes ) );
074            }
075    
076            /**
077             * å�?‚ªブジェクトからè?åˆ??インスタンスを返しますã?
078             * 自åˆ??身をキャãƒ?‚·ュするのかã?新たに作æ?するのかã?、各サブクラスの実è£?�«
079             * まかされますã?
080             *
081             * @og.rev 3.1.1.1 (2003/04/03) å�?‚ªブジェクトからè?åˆ??インスタンスを返すファクトリメソãƒ?ƒ‰を追åŠ??
082             * @og.rev 3.1.2.1 (2003/04/10) synchronized をã?削除しますã?
083             *
084             * @param       clm     DBColumnオブジェクãƒ?
085             *
086             * @return      CellEditorオブジェクãƒ?
087             */
088            public CellEditor newInstance( final DBColumn clm ) {
089                    return new Editor_HTML( clm );
090            }
091    
092            /**
093             * ãƒ??タの編é›?”¨æ–?­—å?を返しますã?
094             *
095             * @param       value 入力å?
096             *
097             * @return      ãƒ??タの編é›?”¨æ–?­—å?
098             */
099            @Override
100            public String getValue( final String value ) {
101                    return super.getValue( StringUtil.htmlFilter( value ) );
102            }
103    
104            /**
105             * name属æ?を変えたã?ãƒ??タ表示/編é›?”¨のHTMLæ–?­—å?を作æ?しますã?
106             * ãƒ??ブル上ã? name に 行番号を付加して、名前_行番号 で登録するキーを作æ?ã�?
107             * リクエスト情報を1つ毎ã?フィールドで処ç�?�§きますã?
108             *
109             * @og.rev 2.0.0.3 (2002/09/26) optionAttributes 属æ?に "$i" を使ã�?�¨そã?行数に置き換る機è?を追åŠ??
110             *
111             * @param       row   行番号
112             * @param       value 入力å?
113             *
114             * @return      ãƒ??タ表示/編é›?”¨のæ–?­—å?
115             */
116            @Override
117            public String getValue( final int row,final String value ) {
118                    return super.getValue( row, StringUtil.htmlFilter( value ) );
119            }
120    }