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.fukurou.util;
017    
018    /**
019     * TagBuffer.java 縺ｯ縲∝?騾夂噪縺ｫ菴ｿ逕ｨ縺輔ｌ繧?邁｡譏薙ち繧ｰ菴懈?繧ｯ繝ｩ繧ｹ縺ｧ縺吶?
020     * 繧ｿ繧ｰ繝倥ャ繝??縺ｯ縲√が繝悶ず繧ｧ繧ｯ繝井ｽ懈?譎ゅ↓逋ｻ骭ｲ縺吶ｋ轤ｺ縲∝ｾ後?螟画峩縺ｯ蜃ｺ譚･縺ｾ縺帙ｓ縲?
021     * BODY驛ｨ繧??螻樊?縺ｯ縲∽ｸ?ｺｦ逋ｻ骭ｲ縺吶ｋ縺ｨ譖ｸ縺肴鋤縺医〒縺阪∪縺帙ｓ縲?
022     * 縺ｾ縺溘?蜷御ｸ?ｱ樊?繝√ぉ繝?け縺ｯ陦後＞縺ｾ縺帙ｓ縲ら匳骭ｲ縺励◆螻樊?縺ｮ繧ｭ繝ｼ繧??蛟､繧貞叙繧雁?縺吶％縺ｨ繧ょ?譚･縺ｾ縺帙ｓ縲?
023     * 縺ゅ￥縺ｾ縺ｧ縲√ち繧ｰ譁?ｭ怜?繧偵せ繝医Ξ繝ｼ繝医↓菴懈?縺吶ｋ縺薙→縺ｫ迚ｹ蛹悶＠縺溘け繝ｩ繧ｹ縺ｧ縺吶?
024     * 縺薙ｌ繧峨?鬮伜ｺｦ縺ｪ讖溯?縺悟ｿ?ｦ√〒縺ゅｌ縺ｰ縲＋@link org.opengion.fukurou.util.Attributes } 繧偵＃蜿ら?縺上□縺輔＞縲?
025     *
026     * makeTag() 繝｡繧ｽ繝?ラ繧貞他縺ｳ蜃ｺ縺励◆譎らせ縺ｧ縲∝?驛ｨ縺ｫ繧ｿ繧ｰ譁?ｭ怜?繧偵く繝｣繝?す繝･縺励∪縺吶?
027     * 縺昴ｌ莉･髯阪?螟画峩縺ｯ縲∝?譚･縺ｾ縺帙ｓ縲?
028     *
029     * 蜀?Κ逧?↓縺ｯ縲∵ｧ矩?蛹悶＆繧後※縺?∪縺帙ｓ縲ゅ≠縺上∪縺ｧ縲∵枚蟄怜?騾｣邨?StringBuilder)縺ｮ
030     * 邁｡譏薙け繝ｩ繧ｹ縺ｨ縺励※縲∽ｽｿ逕ｨ縺励※縺上□縺輔＞縲?
031     *
032     * @og.group 繝ｦ繝ｼ繝?ぅ繝ｪ繝?ぅ
033     *
034     * @version  4.0
035     * @author       Kazuhiko Hasegawa
036     * @since    JDK5.0,
037     */
038    public final class TagBuffer {
039            private final StringBuilder buf = new StringBuilder(100);
040            private final String tagName ;
041            private       String tagBody     = null;
042            private       String cacheTag = null;
043    
044            /**
045             * 繝?ヵ繧ｩ繝ｫ繝医さ繝ｳ繧ｹ繝医Λ繧ｯ繧ｿ繝ｼ
046             * 縺薙?繧ｳ繝ｳ繧ｹ繝医Λ繧ｯ繧ｿ繝ｼ繧剃ｽｿ逕ｨ縺吶ｋ縺ｨ縲√ち繧ｰ蜷阪ｒ謖?ｮ壹〒縺阪↑縺?◆繧√?
047             * 螳梧?蠖｢縺ｮ繧ｿ繧ｰ縺ｯ縲∽ｽ懈?縺ｧ縺阪∪縺帙ｓ縲ょｱ樊?繝ｪ繧ｹ繝?key="value")縺ｮ
048             * 騾｣邨仙ｽ｢蠑上ｒ蠕励ｋ蝣ｴ蜷医↓縺ｮ縺ｿ縲∽ｽｿ逕ｨ縺励※荳九＆縺??
049             *
050             */
051            public TagBuffer() {
052                    this.tagName = null;
053            }
054    
055            /**
056             * 繧ｳ繝ｳ繧ｹ繝医Λ繧ｯ繧ｿ繝ｼ
057             * 繧ｿ繧ｰ蜷阪↓ null 繧呈欠螳壹☆繧九→縲√ョ繝輔か繝ｫ繝医さ繝ｳ繧ｹ繝医Λ繧ｯ繧ｿ繝ｼ縺ｨ蜷梧ｧ倥↓縲?
058             * 螳梧?蠖｢縺ｮ繧ｿ繧ｰ縺ｯ縲∽ｽ懈?縺ｧ縺阪∪縺帙ｓ縲ょｱ樊?繝ｪ繧ｹ繝?key="value")縺ｮ
059             * 騾｣邨仙ｽ｢蠑上ｒ蠕励ｋ蝣ｴ蜷医↓縺ｮ縺ｿ縲√ち繧ｰ蜷?縺ｫnull 繧呈欠螳壹＠縺ｦ荳九＆縺??
060             *
061             * @param       tagName  繧ｿ繧ｰ蜷咲ｧｰ
062             */
063            public TagBuffer( final String tagName ) {
064                    this.tagName = tagName;
065                    if( tagName != null ) {
066                            buf.append( "<" ).append( tagName ).append( " " );
067                    }
068            }
069    
070            /**
071             * 繧ｿ繧ｰ縺ｮ BODY驛ｨ繧堤匳骭ｲ縺励∪縺吶?
072             * 逋ｻ骭ｲ縺励↑縺??蜷医?縲。ODY驛ｨ縺ｮ縺ｪ縺?ち繧ｰ(遨ｺ隕∫ｴ?ち繧ｰ)繧堤函謌舌＠縺ｾ縺吶?
073             * BODY驛ｨ繧呈欠螳壹☆繧九→縲?lt;tagName key="val" ?･?･?･ &gt;body&lt;/tagName&gt; 蠖｢蠑上↓縺ｪ繧翫∪縺吶?
074             * BODY驛ｨ縺後?null 縺ｮ蝣ｴ蜷医?縲?&lt;tagName key="val" ?･?･?･ /&gt; 蠖｢蠑上↓縺ｪ繧翫∪縺吶?
075             * 縺薙?繝｡繧ｽ繝?ラ縺ｯ縲［akeTag() 縺悟他縺ｰ繧後◆蠕後?縲∫匳骭ｲ縺ｧ縺阪↑縺上↑繧翫∪縺吶?
076             *
077             *      @deprecated {@link TagBuffer#addBody(String)}
078             * @param       body     繧ｿ繧ｰ縺ｮBODY驛ｨ
079             */
080            public void setBody( final String body ) {
081                    if( cacheTag != null ) {
082                            String errMsg = "makeTag() 螳溯｡悟ｾ後↓縲。ODY驛ｨ縺ｮ蛟､繧呈嶌縺肴鋤縺医ｋ縺薙→縺ｯ蜃ｺ譚･縺ｾ縺帙ｓ縲? ;
083                            throw new RuntimeException( errMsg );
084                    }
085    
086                    this.tagBody = body;
087            }
088            
089            /**
090             * 繧ｿ繧ｰ縺ｮ BODY驛ｨ繧定ｿｽ蜉?匳骭ｲ縺励∪縺吶?
091             *
092             * 縺吶〒縺ｫ縲∫匳骭ｲ貂医∩縺ｮ蝣ｴ蜷医?縲√◎縺ｮ蛟､縺ｫ縲∬ｿｽ險倥＠縺ｾ縺吶?
093             * 縺昴≧縺ｧ縺ｪ縺??蜷?蛻昴ａ縺ｦ縺ｮ蝣ｴ蜷?縺ｯ縲√◎縺ｮ蛟､繧偵そ繝?ヨ縺励∪縺吶?
094             * null 繧堤匳骭ｲ縺励◆蝣ｴ蜷医?縲∽ｽ輔ｂ縺励∪縺帙ｓ縲?
095             * 窶ｻ 蠕捺擂縺ゅ▲縺?#setBody(String)縺ｮ讒倥↓縲］ull 繧堤匳骭ｲ縺励◆蝣ｴ蜷医?Body 繧?
096             * 繝ｪ繧ｻ繝?ヨ縺吶ｋ讖溯?縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲よ眠縺励＞繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ菴懈?縺励※縺上□縺輔＞縲?
097             *
098             * 縺薙?繝｡繧ｽ繝?ラ縺ｯ縲［akeTag() 縺悟他縺ｰ繧後◆蠕後?縲∫匳骭ｲ縺ｧ縺阪↑縺上↑繧翫∪縺吶?
099             *
100             * @og.rev 5.8.4.1 (2015/02/20) 6.1.1.0騾?ｧｻ讀?#setBody(String) 縺ｮ莉｣譖ｿ縺医Γ繧ｽ繝?ラ縺ｨ縺励※縲∵眠隕剰ｿｽ蜉?
101             *
102             * @param       body     繧ｿ繧ｰ縺ｮBODY驛ｨ縺ｫ霑ｽ蜉?☆繧区枚蟄怜?
103             *
104             * @return      閾ｪ蛻??霄ｫ
105             * @og.rtnNotNull
106             */
107            public TagBuffer addBody( final String body ) {
108                    return addBody( body,true );
109            }
110            
111            /**
112             * 繧ｿ繧ｰ縺ｮ BODY驛ｨ繧定ｿｽ蜉?匳骭ｲ縺励∪縺吶?
113             *
114             * 縺吶〒縺ｫ縲?setBody(String) 縺ｧ縲∫匳骭ｲ貂医∩縺ｮ蝣ｴ蜷医?縲√◎縺ｮ蛟､縺ｫ縲∬ｿｽ險倥＠縺ｾ縺吶?
115             * 縺昴≧縺ｧ縺ｪ縺??蜷医?縲?setBody(String) 縺ｨ蜷後§蜍穂ｽ懊↓縺ｪ繧翫∪縺吶?
116             * null 繧堤匳骭ｲ縺励◆蝣ｴ蜷医?縲∽ｽ輔ｂ縺励∪縺帙ｓ縲?
117             * 
118             * flag 縺ｫ縲’alse 繧呈欠螳壹☆繧九→縲∬ｿｽ蜉?匳骭ｲ縺励∪縺帙ｓ縲ゅ％繧後?縲（f( flag ) { tagBuffer.addBody( body ); }
119             * 縺ｮ讒倥↑蛻､螳壼?逅?ｒ縲》agBuffer.body( body,flag ); 縺ｫ邁｡邏?喧縺吶ｋ縺溘ａ縺ｫ菴ｿ逕ｨ縺ｧ縺阪∪縺吶?
120             * TagBuffer 縺ｯ縲ヾtringBuilder縺ｮ讒倥↓縲√Γ繧ｽ繝?ラ縺ｮ謌ｻ繧雁?縺ｯ縲∬?蛻??霄ｫ縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医↑縺ｮ縺ｧ縲?
121             * 荳願ｨ倥? flag 繧剃ｽｿ逕ｨ縺励※縲∝?繧檎岼縺ｪ縺城?邨舌＆縺帙ｋ縺薙→縺悟庄閭ｽ縺ｫ縺ｪ繧翫∪縺吶?
122             *
123             * 縺薙?繝｡繧ｽ繝?ラ縺ｯ縲［akeTag() 縺悟他縺ｰ繧後◆蠕後?縲∫匳骭ｲ縺ｧ縺阪↑縺上↑繧翫∪縺吶?
124             *
125             * @og.rev 5.8.4.1 (2015/02/20) 6.1.1.0騾?ｧｻ讀?謌ｻ繧雁?縺ｫ縲∬?蛻??霄ｫ繧定ｿ斐☆繧医≧縺ｫ縺励∪縺吶?
126             *
127             * @param       body    繧ｿ繧ｰ縺ｮBODY驛ｨ縺ｫ霑ｽ蜉?☆繧区枚蟄怜?
128             * @param       flag    繧ｿ繧ｰ縺ｮBODY驛ｨ縺ｫ霑ｽ蜉?°縺ｩ縺?°繧呈ｱｺ繧√ｋ繝輔Λ繧ｰ(true:霑ｽ蜉?☆繧?false:菴輔ｂ縺励↑縺?
129             *
130             * @return      閾ｪ蛻??霄ｫ
131             * @og.rtnNotNull
132             */
133            public TagBuffer addBody( final String body,final boolean flag ) {
134                    if( cacheTag != null ) {
135                            final String errMsg = "makeTag() 螳溯｡悟ｾ後↓縲。ODY驛ｨ縺ｮ蛟､繧呈嶌縺肴鋤縺医ｋ縺薙→縺ｯ蜃ｺ譚･縺ｾ縺帙ｓ縲? ;
136                            throw new RuntimeException( errMsg );
137                    }
138    
139                    if( flag && body != null ) {
140                            if( tagBody !=null ) { tagBody += body; }
141                            else                             { tagBody =  body; }
142                    }
143    
144                    return this ;
145            }
146    
147            /**
148             * 繧ｿ繧ｰ縺ｮ 螻樊?(key="value")繧堤匳骭ｲ縺励∪縺吶?
149             * 螻樊?縺ｯ縲〔ey="value" 縺ｮ譁?ｭ怜?繧剃ｽ懈?縺励∪縺吶?key 縺九?value 縺ｮ縺ｩ縺｡繧峨°縺?null
150             * 縺ｮ蝣ｴ蜷医?縲∫匳骭ｲ縺励∪縺帙ｓ縲?
151             * value 縺ｫ縲√ム繝悶Ν繧ｳ繝ｼ繝??繧ｷ繝ｧ繝ｳ(")縺悟性縺ｾ繧後※縺?ｋ蝣ｴ蜷医?縲∝ｱ樊?蛟､繧偵す繝ｳ繧ｰ繝ｫ繧ｳ繝ｼ繝??繧ｷ繝ｧ繝ｳ
152             * 縺ｧ縺上￥繧翫∪縺吶?
153             * 荳｡譁ｹ蜷ｫ縺ｾ繧後※縺?ｋ蝣ｴ蜷医?縲√す繝ｳ繧ｰ繝ｫ繧ｳ繝ｼ繝??繧ｷ繝ｧ繝ｳ繧偵お繧ｹ繧ｱ繝ｼ繝玲枚蟄励↓螟画鋤縺励∪縺吶?
154             * 縺薙?繝｡繧ｽ繝?ラ縺ｯ縲［akeTag() 縺悟他縺ｰ繧後◆蠕後?縲∫匳骭ｲ縺ｧ縺阪↑縺上↑繧翫∪縺吶?
155             *
156             * @og.rev 3.8.6.1 (2006/10/20) 繧ｷ繝ｳ繧ｰ繝ｫ縺ｨ繝?ヶ繝ｫ縺梧ｷｷ蝨ｨ縺吶ｋ蝣ｴ蜷医?縲√す繝ｳ繧ｰ繝ｫ繧偵お繧ｹ繧ｱ繝ｼ繝励☆繧?
157             *
158             * @param       key      螻樊?繧ｭ繝ｼ (null 縺ｮ蝣ｴ蜷医?縲√↑縺ｫ繧ゅ＠縺ｪ縺?
159             * @param       val      螻樊?蛟､ (null 縺ｮ蝣ｴ蜷医?縲√↑縺ｫ繧ゅ＠縺ｪ縺?
160             */
161            public void add( final String key,final String val ) {
162                    if( cacheTag != null ) {
163                            String errMsg = "makeTag() 螳溯｡悟ｾ後↓縲∝ｱ樊?繧定ｿｽ蜉?☆繧九％縺ｨ縺ｯ蜃ｺ譚･縺ｾ縺帙ｓ縲? ;
164                            throw new RuntimeException( errMsg );
165                    }
166    
167                    if( key != null && val != null ) {
168                            if( val.indexOf( '\"' ) >= 0 ) {
169                                    String temp = val ;
170                                    if( val.indexOf( "'" ) >= 0 ) { temp = val.replaceAll( "'","&#39;" ); }
171                                    buf.append( key ).append( "='" ).append( temp ).append( "' " );
172                            }
173                            else {
174                                    buf.append( key ).append( "=\"" ).append( val ).append( "\" " );
175                            }
176                    }
177            }
178    
179            /**
180             * 繧ｿ繧ｰ縺ｮ螻樊?縺ｫ縲∬ｿｽ蜉?匳骭ｲ縺励∪縺吶?
181             * 譁?ｭ怜?縺ｨ縺励※縲〔ey="value" 縺ｮ蠖｢蠑上ョ繝ｼ繧ｿ繧剃ｸ弱∴縺ｦ縺上□縺輔＞縲る?邨先凾縺ｯ縲∝ｾ後ｍ縺ｫ
182             * 繧ｹ繝壹?繧ｹ繧剃ｸ?▽謖溘∩縺ｾ縺吶?縺ｧ縲∽ｸ弱∴繧句ｼ墓焚閾ｪ菴薙↓騾｣邨千畑繧ｹ繝壹?繧ｹ繧定ｿｽ蜉?＠縺ｦ縺翫￥
183             * 蠢?ｦ√?縺ゅｊ縺ｾ縺帙ｓ縲?
184             * 騾壼ｸｸ縺ｯ縲》agName 縺ｪ縺励〒菴懈?縺励◆縲ゝagbuffer 繧ｪ繝悶ず繧ｧ繧ｯ繝医? makeTag() 繝｡繧ｽ繝?ラ縺ｮ
185             * 霑斐ｊ蛟､繧呈ｸ｡縺励∪縺吶′縲、ttributes.getAttribute() 縺ｮ霑斐ｊ蛟､縺ｧ繧ゆｽｿ逕ｨ縺ｧ縺阪∪縺吶?
186             * 蠑墓焚縺?null 縺ｮ蝣ｴ蜷医?縲√↑縺ｫ繧ゅ＠縺ｾ縺帙ｓ縲?
187             * 縺薙?繝｡繧ｽ繝?ラ縺ｯ縲［akeTag() 縺悟他縺ｰ繧後◆蠕後?縲∫匳骭ｲ縺ｧ縺阪↑縺上↑繧翫∪縺吶?
188             *
189             * @param       str     繧ｿ繧ｰ繝舌ャ繝輔ぃ繝ｼ繧定ｿｽ蜉?＠縺ｾ縺吶?
190             * @see         #makeTag()
191             * @see         Attributes#getAttribute()
192             */
193            public void add( final String str ) {
194                    if( cacheTag != null ) {
195                            String errMsg = "makeTag() 螳溯｡悟ｾ後↓縲∝ｱ樊?繧定ｿｽ蜉?☆繧九％縺ｨ縺ｯ蜃ｺ譚･縺ｾ縺帙ｓ縲? ;
196                            throw new RuntimeException( errMsg );
197                    }
198    
199                    if( str != null ) {
200                            buf.append( str ).append( " " );
201                    }
202            }
203    
204            /**
205             * 繧ｿ繧ｰ縺ｮ 謨ｴ蠖｢縺輔ｌ縺滓枚蟄怜?繧?菴懈?縺励∪縺吶?
206             * 縺薙?繝｡繧ｽ繝?ラ縺ｯ縲》agName,body,螻樊?繧医ｊ 繧ｿ繧ｰ縺ｮ螳梧?蠖｢縺ｮ譁?ｭ怜?繧剃ｽ懈?縺励∪縺吶?
207             * 菴懈?縺輔ｌ縺滓枚蟄怜?縺ｯ縲∝?驛ｨ縺ｧ繧ｭ繝｣繝?す繝･縺輔ｌ縺ｾ縺吶?
208             * BODY驛ｨ繧呈欠螳壹☆繧九→縲?lt;tagName key="val" ?･?･?･ &gt;body&lt;/tagName&gt; 蠖｢蠑上↓縺ｪ繧翫∪縺吶?
209             * BODY驛ｨ縺後?null 縺ｮ蝣ｴ蜷医?縲?&lt;tagName key="val" ?･?･?･ /&gt; 蠖｢蠑上↓縺ｪ繧翫∪縺吶?
210             * 繧ｿ繧ｰ蜷阪ｒ謖?ｮ壹＠縺ｪ縺?null)縺ｨ縲∝ｮ梧?蠖｢縺ｮ繧ｿ繧ｰ縺ｯ縲∽ｽ懈?縺ｧ縺阪∪縺帙ｓ縲?
211             * 螻樊?繝ｪ繧ｹ繝?key="value")縺ｮ騾｣邨仙ｽ｢蠑上ｒ霑斐＠縺ｾ縺吶?
212             *
213             * 縺薙?繝｡繧ｽ繝?ラ縺ｮ蜻ｼ縺ｳ蜃ｺ縺嶺ｻ･髯阪〒縺ｯ縲《etBody() 繧?add() 繧ょｮ溯｡後〒縺阪∪縺帙ｓ縲?
214             *
215             * @return      謨ｴ蠖｢縺輔ｌ縺?繧ｿ繧ｰ譁?ｭ怜?
216             */
217            public String makeTag() {
218                    if( cacheTag == null ) {
219                            if( tagName != null ) {
220                                    if( tagBody == null ) {
221                                            buf.append( "/>" );
222                                    }
223                                    else {
224                                            buf.append( ">" ).append( tagBody );
225                                            buf.append( "</" ).append( tagName ).append( ">" );
226                                    }
227                            }
228                            cacheTag = buf.toString();
229                    }
230    
231                    return cacheTag;
232            }
233    
234            /**
235             * 陦檎分蜿ｷ莉倥″縺ｮ繧ｿ繧ｰ縺ｮ 謨ｴ蠖｢縺輔ｌ縺滓枚蟄怜?繧?菴懈?縺励∪縺吶?
236             * 縺薙?繝｡繧ｽ繝?ラ縺ｯ縲［akeTag() 縺ｮ邨先棡繧医ｊ縲ーI] 譁?ｭ怜?繧貞ｼ墓焚縺ｮ陦檎分蜿ｷ縺ｨ螟画鋤縺励∪縺吶?
237             * 縺薙ｌ縺ｫ繧医ｊ縲∝虚逧?↓陦檎分蜿ｷ縺､縺阪?諠??繧貞ｱ樊?縺ｫ莉倅ｸ弱☆繧九％縺ｨ縺悟庄閭ｽ縺ｫ縺ｪ繧翫∪縺吶?
238             * 蜀?Κ縺ｫ繧ｭ繝｣繝?す繝･縺輔ｌ繧句?縺ｯ縲ーI] 險伜捷繧貞､画鋤縺励※縺?↑縺?憾諷九?譁?ｭ怜?縺ｧ縺吶?
239             * 繧医▲縺ｦ縲√％縺ｮ繝｡繧ｽ繝?ラ縺ｯ縲〉owNo 繧貞､峨∴縺ｦ縲∽ｽ募ｺｦ縺ｧ繧ょ他縺ｳ蜃ｺ縺吶％縺ｨ縺ｯ蜿ｯ閭ｽ縺ｧ縺吶′縲?
240             * setBody() 繧?add() 縺ｯ螳溯｡後〒縺阪∪縺帙ｓ縲?
241             *
242             * @param       rowNo   陦檎分蜿ｷ([I] 譁?ｭ怜?繧貞､画鋤縺励∪縺吶?)
243             * @param       val     險ｭ螳壼?([V] 譁?ｭ怜?繧貞､画鋤縺励∪縺吶?)
244             *
245             * @return      謨ｴ蠖｢縺輔ｌ縺?繧ｿ繧ｰ譁?ｭ怜?
246             */
247            public String makeTag( final int rowNo,final String val ) {
248                    String tag = makeTag();
249                    tag = StringUtil.replace( tag,"[I]",String.valueOf( rowNo ) );
250                    tag = StringUtil.replace( tag,"[V]",val );
251    
252                    return tag ;
253            }
254    }