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.xml;
017    
018    import java.util.Map;
019    import java.util.LinkedHashMap;
020    import java.util.List;
021    
022    /**
023     * 縺薙?繧ｯ繝ｩ繧ｹ縺ｯ縲々ML繝輔ぃ繧､繝ｫ縺ｮ繧ｿ繧ｰ繧ｨ繝ｬ繝｡繝ｳ繝医ｒ陦ｨ縺吶が繝悶ず繧ｧ繧ｯ繝医〒縺吶?
024     * 繧ｿ繧ｰ縺ｨ縺励※縺ｯ縲√さ繝ｳ繧ｹ繝医Λ繧ｯ繧ｿ縺ｫMap繧呈欠螳壹☆繧後?(defaultMap)繧ｿ繧ｰ縺ｮ繧ｫ繝ｩ繝?ｒ
025     * 蛻晄悄險ｭ螳壹＠縺ｾ縺吶?縺薙?蝣ｴ蜷医?Map 縺ｫ LinkedHashMap 繧呈欠螳壹☆繧後?縲√き繝ｩ繝??
026     * 鬆?分繧よ欠螳夐?縺ｫ縺ｪ繧翫∪縺吶?
027     * 縺薙％縺ｧ謖?ｮ壹＠縺櫪ap縺ｮ蛟､縺ｯ縲｝ut 繝｡繧ｽ繝?ラ縺ｫ繧医ｊ荳頑嶌縺阪＆繧後∪縺吶?
028     * setAfterMap 縺ｧ謖?ｮ壹＠縺櫪ap縺ｯ縲∵里蟄倥?蜀?Κ諠??繧剃ｸ頑嶌縺阪＠縺ｾ縺吶?繧ｭ繝ｼ縺後≠繧後?縲?
029     * afterMap 縺ｮ蛟､縺御ｸ頑嶌縺阪＆繧後?繧ｭ繝ｼ縺檎┌縺代ｌ縺ｰ譁ｰ隕上↓繧ｭ繝ｼ縺瑚ｿｽ蜉?＆繧後∪縺吶?
030     * 荳?握縺ｫ縺ｯ縲々ML繝輔ぃ繧､繝ｫ縺九ｉ讒狗ｯ峨＆繧後◆蠕後〒縲々ML繝輔ぃ繧､繝ｫ縺ｮ諠??繧剃ｸ?峡縺励※
031     * 譖ｸ縺肴鋤縺医ｋ蝣ｴ蜷医↑縺ｩ縺ｫ菴ｿ逕ｨ縺励∪縺吶?
032     * 蜃ｦ逅??騾比ｸｭ縺ｫ繧ｻ繝?ヨ縺励◆蝣ｴ蜷医?縲√◎繧後∪縺ｧ縺ｮ蛟､縺御ｸ頑嶌縺阪＆繧後?縺昴ｌ莉･髯阪?蛟､縺ｯ縲?
033     * put 縺ｫ繧医ｊ險ｭ螳壹＆繧後◆蛟､縺?蜆ｪ蜈医＆繧後∪縺吶?
034     * toString() 縺ｫ繧医ｊ縲∫ｰ｡譏鍋噪縺ｫ 繧ｪ繝ｩ繧ｯ繝ｫ?ｸ?､?ｫ蠖｢蠑上??ｸ?ｭ?ｬ繝輔ぃ繧､繝ｫ縺ｮ
035     * ?代Ξ繧ｳ繝ｼ繝?蛻??諠??繧定ｿ斐＠縺ｾ縺吶?
036     * 繧ｪ繝ｩ繧ｯ繝ｫ?ｸ?､?ｫ蠖｢蠑上??ｸ?ｭ?ｬ繝輔ぃ繧､繝ｫ縺ｨ縺ｯ縲∽ｸ玖ｨ倥?繧医≧縺ｪ ROWSET 繧偵ヨ繝??縺ｨ縺吶ｋ ROW 縺ｮ
037     * 髮?∪繧翫〒?代Ξ繧ｳ繝ｼ繝峨ｒ陦ｨ縺励?蜷СOW縺ｫ縺ｯ縲√き繝ｩ繝?錐繧偵く繝ｼ縺ｨ縺吶ｋXML縺ｫ縺ｪ縺｣縺ｦ縺?∪縺吶?
038     *
039     *   &lt;ROWSET&gt;
040     *       &lt;ROW num="1"&gt;                         竊?縺薙?驛ｨ蛻??縺ｿ
041     *           &lt;繧ｫ繝ｩ繝?&gt;蛟､1&lt;/繧ｫ繝ｩ繝?&gt;      竊?縺薙?驛ｨ蛻??縺ｿ
042     *             ?･?･?･                                   竊?縺薙?驛ｨ蛻??縺ｿ
043     *           &lt;繧ｫ繝ｩ繝?&gt;蛟､n&lt;/繧ｫ繝ｩ繝?&gt;      竊?縺薙?驛ｨ蛻??縺ｿ
044     *       &lt;/ROW&gt;                                竊?縺薙?驛ｨ蛻??縺ｿ
045     *        ?･?･?･
046     *       &lt;ROW num="n"&gt;
047     *          ?･?･?･
048     *       &lt;/ROW&gt;
049     *   &lt;ROWSET&gt;
050     *
051     * 縺薙?蠖｢蠑上〒縺ゅｌ縺ｰ縲々DK(Oracle XML Developer's Kit)繧貞茜逕ｨ縺吶ｌ縺ｰ縲?撼蟶ｸ縺ｫ邁｡蜊倥↓
052     * 繝??繧ｿ繝吶?繧ｹ縺ｨXML繝輔ぃ繧､繝ｫ縺ｨ縺ｮ莠､謠帙′蜿ｯ閭ｽ縺ｧ縺吶?
053     * <a href="http://otn.oracle.co.jp/software/tech/xml/xdk/index.html" target="_blank" >
054     * XDK(Oracle XML Developer's Kit)</a>
055     *
056     * @version  4.0
057     * @author   Kazuhiko Hasegawa
058     * @since    JDK5.0,
059     */
060    public class TagElement {
061            private static final String CR = System.getProperty("line.separator");
062            private final String name ;
063            private final Map<String,String> map ;
064            private String num  = null;
065            private String body = null;
066    
067            /**
068             * Tag蜷阪ｒ謖?ｮ壹＠縺ｦ縲√が繝悶ず繧ｧ繧ｯ繝医ｒ讒狗ｯ峨＠縺ｾ縺吶?
069             *
070             * @param       name    Tag蜷?
071             */
072            public TagElement( final String name ) {
073                    this( name,null );
074            }
075    
076            /**
077             * Tag蜷阪→蛻晄悄蛹悶?繝??繧呈欠螳壹＠縺ｦ縲√が繝悶ず繧ｧ繧ｯ繝医ｒ讒狗ｯ峨＠縺ｾ縺吶?
078             *
079             * @param       name            Tag蜷?
080             * @param       defaultMap      蛻晄悄蛹悶?繝??
081             */
082            public TagElement( final String name, final Map<String,String> defaultMap ) {
083                    this.name = name;
084                    if( defaultMap != null ) {
085                            map = new LinkedHashMap<String,String>( defaultMap );
086                    }
087                    else {
088                            map = new LinkedHashMap<String,String>();
089                    }
090            }
091    
092            /**
093             * Tag蜷阪ｒ蜿門ｾ励＠縺ｾ縺吶?
094             *
095             * @return      Tag蜷?
096             */
097            public String getName() {
098                    return name;
099            }
100    
101            /**
102             * 繧ｫ繝ｩ繝?→蛟､縺ｮ繝壹い繧堤匳骭ｲ縺励∪縺吶?
103             * 縺吶〒縺ｫ 蜀?Κ縺ｫ蜷御ｸ?き繝ｩ繝?′蟄伜惠縺吶ｋ蝣ｴ蜷医?縲∝?縺ｮ譖ｸ縺肴鋤縺医ｒ縲√き繝ｩ繝?′
104             * 蟄伜惠縺励↑縺??蜷医?縲√き繝ｩ繝??霑ｽ蜉?ｒ陦後＞縺ｾ縺吶?
105             * 繧ｫ繝ｩ繝??縲∬ｿｽ蜉?＆繧後◆鬆?分繧貞?迴ｾ縺励※XML蛹悶〒縺阪∪縺吶?
106             *
107             * @og.rev 5.6.6.1 (2013/07/12) key 縺?null 繧?繧ｼ繝ｭ譁?ｭ怜?縺ｮ蝣ｴ蜷医?縲｀ap 縺ｫ霑ｽ蜉?＠縺ｾ縺帙ｓ縲?
108             *
109             * @param       key     繧ｫ繝ｩ繝?
110             * @param       val     蛟､
111             */
112            public void put( final String key, final String val ) {
113                    if( key != null && key.length() > 0 ) {                                      // 5.6.6.1 (2013/07/12)
114                            map.put( key,val );
115                    }
116            }
117    
118            /**
119             * 縺吶〒縺ｫ讒狗ｯ画ｸ医∩縺ｮ 繧ｫ繝ｩ繝?→蛟､縺ｫ縲∽ｸ頑嶌縺阪〒 繝槭ャ繝玲ュ蝣ｱ繧定ｿｽ蜉?＠縺ｾ縺吶?
120             * 縺吶〒縺ｫ 蜀?Κ縺ｫ蜷御ｸ?き繝ｩ繝?′蟄伜惠縺吶ｋ蝣ｴ蜷医?縲∝?縺ｮ譖ｸ縺肴鋤縺医ｒ縲√き繝ｩ繝?′
121             * 蟄伜惠縺励↑縺??蜷医?縲√き繝ｩ繝??霑ｽ蜉?ｒ陦後＞縺ｾ縺吶?
122             * 繧ｫ繝ｩ繝??縲∬ｿｽ蜉?＆繧後◆鬆?分繧貞?迴ｾ縺励※XML蛹悶〒縺阪∪縺吶?
123             *
124             * @param afterMap      蠕瑚ｨｭ螳壹?繝??
125             */
126            public void setAfterMap( final Map<String,String> afterMap ) {
127                    if( afterMap != null ) {
128                            map.putAll( afterMap );
129                    }
130            }
131    
132            /**
133             * 繧ｭ繝ｼ繧呈欠螳壹＠縺ｦ蛟､繧貞叙蠕励＠縺ｾ縺吶?
134             *
135             * @param       key     繧ｫ繝ｩ繝?
136             *
137             * @return      蛟､
138             */
139            public String get( final String key ) {
140                    return map.get( key );
141            }
142    
143            /**
144             * 陦檎分蜿ｷ繧貞叙蠕励＠縺ｾ縺吶?
145             *
146             * @return      蛟､
147             */
148            public String getRowNo() {
149                    return num;
150            }
151    
152            /**
153             * 陦檎分蜿ｷ繧定ｨｭ螳壹＠縺ｾ縺吶?
154             *
155             * @param       num     蛟､
156             */
157            public void setRowNo( final String num ) {
158                    this.num = num ;
159            }
160    
161            /**
162             * BODY驛ｨ縺ｮ譁?ｭ怜?繧貞叙蠕励＠縺ｾ縺吶?
163             *
164             * @return      蛟､
165             */
166            public String getBody() {
167                    return body;
168            }
169    
170            /**
171             * BODY驛ｨ縺ｮ譁?ｭ怜?繧定ｨｭ螳壹＠縺ｾ縺吶?
172             *
173             * @param       body    蛟､
174             */
175            public void setBody( final String body ) {
176                    this.body = body ;
177            }
178    
179            /**
180             * 繧ｫ繝ｩ繝??驟榊?繧定ｿ斐＠縺ｾ縺吶?
181             *
182             * @return      繧ｫ繝ｩ繝??驟榊?(鬆?ｺ上?縲√き繝ｩ繝??逋ｻ骭ｲ鬆?
183             */
184            public String[] getKeys() {
185                    return map.keySet().toArray( new String[map.size()] );
186            }
187    
188            /**
189             * 繧ｫ繝ｩ繝??蛻励?鬆?→蜷後§縲∝?縺ｮ驟榊?繧定ｿ斐＠縺ｾ縺吶?
190             *
191             * @return      蛟､縺ｮ驟榊?(鬆?ｺ上?縲√き繝ｩ繝??逋ｻ骭ｲ鬆?→荳??縺励※縺?∪縺吶?)
192             */
193            public String[] getValues() {
194                    return map.values().toArray( new String[map.size()] );
195            }
196    
197            /**
198             * 蠑墓焚縺ｮ繧ｫ繝ｩ繝?錐縺ｮList縺ｮ鬆?分縺ｧ縲√き繝ｩ繝??蛻励?蛟､縺ｮ驟榊?繧定ｿ斐＠縺ｾ縺吶?
199             *
200             * @param clms  繧ｫ繝ｩ繝?錐縺ｮList繧ｪ繝悶ず繧ｧ繧ｯ繝?
201             *
202             * @return      蛟､縺ｮ驟榊?(鬆?ｺ上?縲√き繝ｩ繝??逋ｻ骭ｲ鬆?→荳??縺励※縺?∪縺吶?)
203             */
204            public String[] getValues( final List<String> clms ) {
205                    int size = clms.size();
206                    String[] vals = new String[size];
207                    for( int i=0; i<size; i++ ) {
208                            vals[i] = map.get( clms.get(i) );
209                    }
210    
211                    return vals;
212            }
213    
214            /**
215             * 蠑墓焚縺ｮ繧ｫ繝ｩ繝?錐縺ｮ驟榊?縺ｮ鬆?分縺ｧ縲√き繝ｩ繝??蛻励?蛟､縺ｮ驟榊?繧定ｿ斐＠縺ｾ縺吶?
216             * 繧ｫ繝ｩ繝?錐縺後?蟄伜惠縺励↑縺??蜷医?縲∝?縺ｯ縲］ull 繧定ｿ斐＠縺ｾ縺吶?
217             *
218             * @param       clms    繧ｫ繝ｩ繝?錐縺ｮ驟榊?譁?ｭ怜?
219             *
220             * @return      蛟､縺ｮ驟榊?(鬆?ｺ上?縲√き繝ｩ繝??驟榊?鬆?→荳??縺励※縺?∪縺吶?)
221             */
222            public String[] getValues( final String[] clms ) {
223                    int size = clms.length;
224                    String[] vals = new String[size];
225                    for( int i=0; i<size; i++ ) {
226                            vals[i] = map.get( clms[i] );
227                    }
228    
229                    return vals;
230            }
231    
232            /**
233             * 蜀?Κ諠??縺ｮ譁?ｭ怜?陦ｨ迴ｾ繧定ｿ斐＠縺ｾ縺吶?
234             * ?代Ξ繧ｳ繝ｼ繝牙?繧定｡ｨ縺?ROW 縺ｮXML陦ｨ迴ｾ繧剃ｽ懈?縺励∪縺吶?蜑榊ｾ後↓縲ヽOWSET 繧?
235             * 霑ｽ蜉?☆繧後?縲√が繝ｩ繧ｯ繝ｫXDK蠖｢蠑上?XML繧剃ｽ懈?縺ｧ縺阪∪縺吶?
236             *
237             * @return      蜀?Κ諠??縺ｮ譁?ｭ怜?陦ｨ迴ｾ
238             */
239            @Override
240            public String toString() {
241    
242                    StringBuilder buf = new StringBuilder();
243                    buf.append( "<" ).append( name );
244                    if( num != null ) {
245                            buf.append( " num=\"" ).append( num ).append( "\" " );
246                    }
247                    buf.append( ">" ).append( CR );
248    
249                    if( body != null ) {
250                            buf.append( body ).append( CR );
251                    }
252                    else {
253                            String[] keys = getKeys();
254                            for( int i=0; i<keys.length; i++ ) {
255                                    String val = get( keys[i] );
256                                    if( val == null ) {
257                                            buf.append( "  <" ).append( keys[i] ).append( " />" );
258                                    }
259                                    else {
260                                            buf.append( "  <" ).append( keys[i] ).append( ">" );
261                                            buf.append( val );
262                                            buf.append( "</" ).append( keys[i] ).append( ">" );
263                                    }
264                                    buf.append( CR );
265                            }
266                    }
267                    buf.append( "</" ).append( name ).append( ">" ).append( CR );
268    
269                    return buf.toString();
270            }
271    }