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.hayabusa.taglib;
017    
018    import static org.opengion.fukurou.util.StringUtil.nval;
019    
020    import java.io.IOException;
021    import java.io.ObjectInputStream;
022    import java.io.ObjectOutputStream;
023    
024    import org.opengion.fukurou.util.Options;
025    import org.opengion.hayabusa.common.HybsSystem;
026    
027    /**
028     * 繝輔か繝ｼ繝??蜈･蜉帶ｬ?↑縺ｩ縺ｧ蜈･蜉帛?陬懊→縺ｪ繧九ョ繝ｼ繧ｿ繝ｪ繧ｹ繝医ｒ螳夂ｾｩ縺吶ｋHTML諡｡蠑ｵ繧ｿ繧ｰ縺ｧ縺吶?
029     * HTML5 縺九ｉ縲∵眠縺溘↓霑ｽ蜉?＆繧後◆隕∫ｴ?〒縺吶?
030     *
031     * 繝??繧ｿ繝ｪ繧ｹ繝亥?縺ｮ驕ｸ謚櫁い縺ｯ縲｛ption繧ｿ繧ｰ縲〈ueryOption繧ｿ繧ｰ縺ｫ繧医▲縺ｦ謖?ｮ壹＠縺ｾ縺吶?
032     * 繝??繧ｿ繝ｪ繧ｹ繝?縺ｮ id 螻樊?縺ｯ縲√ヵ繧ｩ繝ｼ繝?? list 螻樊?縺ｨ蜷後§繧ｭ繝ｼ繧呈欠螳壹☆繧倶ｺ九〒髢｢騾｣莉倥￠縺励∪縺吶?
033     *
034     * @og.formSample
035     * 笳丞ｽ｢蠑擾ｼ?lt;og:datalist id="窶ｦ" /&gt;
036     * 笳獣ody?壹≠繧?EVAL_BODY_INCLUDE:BODY繧偵う繝ｳ繧ｯ繝ｫ繝ｼ繝峨＠縲＋&#064;XXXX} 縺ｯ隗｣譫舌＠縺ｾ縺帙ｓ)
037     *
038     * 笳週ag螳夂ｾｩ??
039     *   &lt;og:datalist
040     *       id               笳九?TAG縲大?蜉帛?陬懊ｒ陦ｨ遉ｺ縺吶ｋ繝輔か繝ｼ繝?? list 螻樊?縺ｫ險ｭ螳壹☆繧?id (蠢??)
041     *       caseKey            縲慎AG縲代％縺ｮ繧ｿ繧ｰ閾ｪ菴薙ｒ蛻ｩ逕ｨ縺吶ｋ縺九←縺?°縺ｮ譚｡莉ｶ繧ｭ繝ｼ繧呈欠螳壹＠縺ｾ縺?蛻晄悄蛟､:null)
042     *       caseVal            縲慎AG縲代％縺ｮ繧ｿ繧ｰ閾ｪ菴薙ｒ蛻ｩ逕ｨ縺吶ｋ縺九←縺?°縺ｮ譚｡莉ｶ蛟､繧呈欠螳壹＠縺ｾ縺?蛻晄悄蛟､:null)
043     *       caseNN             縲慎AG縲第欠螳壹?蛟､縺後?null/繧ｼ繝ｭ譁?ｭ怜? 縺ｧ縺ｪ縺??蜷?Not Null=NN)縺ｯ縲√％縺ｮ繧ｿ繧ｰ縺ｯ菴ｿ逕ｨ縺輔ｌ縺ｾ縺?蛻晄悄蛟､:true)
044     *       caseNull           縲慎AG縲第欠螳壹?蛟､縺後?null/繧ｼ繝ｭ譁?ｭ怜? 縺ｮ蝣ｴ蜷医?縲√％縺ｮ繧ｿ繧ｰ縺ｯ菴ｿ逕ｨ縺輔ｌ縺ｾ縺?蛻晄悄蛟､:true)
045     *       debug              縲慎AG縲代ョ繝舌ャ繧ｰ諠??繧貞?蜉帙☆繧九°縺ｩ縺?°[true/false]繧呈欠螳壹＠縺ｾ縺?蛻晄悄蛟､:false)
046     *   &gt;   ... Body ...
047     *   &lt;/og:datalist&gt;
048     *
049     * 笳丈ｽｿ逕ｨ萓?
050     * &lt;og:input type="text" name="yourarea" autocomplete="on" list="tokyo" /&gt;
051     *
052     *  &lt;og:datalist id="tokyo" &gt;
053     *      &lt;og:option value="貂玖ｰｷ" /&gt;
054     *      &lt;og:option value="譁ｰ螳ｿ" /&gt;
055     *      &lt;og:option value="豎?｢? /&gt;
056     *  &lt;/og:datalist&gt;&lt;
057     *
058     * @og.group 縲食TML5縲鷹∈謚槭ョ繝ｼ繧ｿ蛻ｶ蠕｡
059     * @og.rev 5.7.1.0 (2013/12/06) 譁ｰ隕剰ｿｽ蜉?
060     *
061     * @version  6.0
062     * @author       Kazuhiko Hasegawa
063     * @since    JDK5.0,
064     */
065    public class DatalistTag extends CommonTagSupport implements OptionAncestorIF {
066            //* 縺薙?繝励Ο繧ｰ繝ｩ繝??VERSION譁?ｭ怜?繧定ｨｭ螳壹＠縺ｾ縺吶?       {@value} */
067            private static final String VERSION = "5.7.1.0 (2013/12/06)" ;
068    
069            private static final long serialVersionUID = 571020131206L ;
070    
071            private transient Options option        = new Options();
072    
073            private String id       = null;         // 繝輔か繝ｼ繝?→髢｢騾｣莉倥￠繧喫d
074    
075            /**
076             * Taglib縺ｮ髢句ｧ九ち繧ｰ縺瑚ｦ九▽縺九▲縺溘→縺阪↓蜃ｦ逅?☆繧?doStartTag() 繧?繧ｪ繝ｼ繝舌?繝ｩ繧､繝峨＠縺ｾ縺吶?
077             *
078             * @return      蠕檎ｶ壼?逅??謖?､ｺ( EVAL_BODY_INCLUDE )
079             */
080            @Override
081            public int doStartTag() {
082                    if( useTag() ) {
083                            return( EVAL_BODY_INCLUDE );    // Body 繧､繝ｳ繧ｯ繝ｫ繝ｼ繝? extends TagSupport 譎?
084                    }
085                    return ( SKIP_BODY );                           // Body 繧定ｩ穂ｾ｡縺励↑縺?
086            }
087    
088            /**
089             * Taglib縺ｮ邨ゆｺ?ち繧ｰ縺瑚ｦ九▽縺九▲縺溘→縺阪↓蜃ｦ逅?☆繧?doEndTag() 繧?繧ｪ繝ｼ繝舌?繝ｩ繧､繝峨＠縺ｾ縺吶?
090             *
091             * @return      蠕檎ｶ壼?逅?
092             */
093            @Override
094            public int doEndTag() {
095                    debugPrint();           // 4.0.0 (2005/02/28)
096                    // 5.2.2.0 (2010/11/01) caseKey 縲…aseVal 螻樊?蟇ｾ蠢?
097                    if( useTag() ) {
098                            StringBuilder rtn = new StringBuilder( HybsSystem.BUFFER_MIDDLE );
099                            // display:none 縺ｯ縲‥atalist 縺ｮ option縺ｮBODY驛ｨ縺後?HTML5 莉･螟悶〒縺ｯ陦ｨ遉ｺ縺輔ｌ縺ｦ縺励∪縺?◆繧√?
100                            rtn.append("<div style=\"display:none;\">" );
101                            rtn.append("<datalist id=\"").append( id ).append( "\" >" );
102                            rtn.append( option.getOption() );
103                            rtn.append( "</datalist>" );
104                            rtn.append( "</div>" );
105    
106                            jspPrint( rtn.toString() );
107                    }
108                    return(EVAL_PAGE);
109            }
110    
111            /**
112             * 繧ｿ繧ｰ繝ｪ繝悶が繝悶ず繧ｧ繧ｯ繝医ｒ繝ｪ繝ｪ繝ｼ繧ｹ縺励∪縺吶?
113             * 繧ｭ繝｣繝?す繝･縺輔ｌ縺ｦ蜀榊茜逕ｨ縺輔ｌ繧九?縺ｧ縲√ヵ繧｣繝ｼ繝ｫ繝峨?蛻晄悄險ｭ螳壹ｒ陦後＞縺ｾ縺吶?
114             *
115             */
116            @Override
117            protected void release2() {
118                    super.release2();
119                    option  = new Options();
120                    id              = null;
121            }
122    
123            /**
124             * 繝??繧ｿ繝ｪ繧ｹ繝医?驕ｸ謚樣?逶ｮ繧定ｿｽ蜉?＠縺ｾ縺吶?
125             *
126             * datalist 繧ｿ繧ｰ縺ｮBODY隕∫ｴ?? OptionTag 繧医ｊ繧｢繧ｯ繧ｻ繧ｹ縺輔ｌ縺ｾ縺吶?
127             *
128             * @param       opt      繧ｪ繝励す繝ｧ繝ｳ繧ｿ繧ｰ譁?ｭ怜?
129             */
130            public void addOption( final String opt ) {
131                    option.add( opt );
132            }
133    
134            /**
135             * 縲食TML縲題ｦ∫ｴ?↓蟇ｾ縺励※蝗ｺ譛峨?蜷榊燕(id)繧偵▽縺代ｋ蝣ｴ蜷医↓險ｭ螳壹＠縺ｾ縺吶?
136             *
137             * @og.tag
138             * 繝??繧ｿ繝ｪ繧ｹ繝?縺ｮ id 螻樊?縺ｯ縲√ヵ繧ｩ繝ｼ繝?? list 螻樊?縺ｨ蜷後§繧ｭ繝ｼ繧呈欠螳壹☆繧倶ｺ九〒髢｢騾｣莉倥￠縺励∪縺吶?
139             *
140             * @param   id 蝗ｺ譛峨?蜷榊燕
141             */
142            @Override
143            public void setId( final String id ) {
144                    this.id = nval( getRequestParameter( id ), null );
145            }
146    
147            /**
148             * 蛟､繧貞､夜Κ縺九ｉ蜿悶ｊ蜃ｺ縺励∪縺吶?
149             *
150             * OptionTag 縺ｧ縲」alue 繧貞叙繧雁?縺励※縲∝?驛ｨ縺ｮ蛟､縺ｨ蜷後§蝣ｴ蜷医?縲?∈謚樒憾諷九↓縺励∪縺吶?
151             *
152             * @og.rev 3.5.4.0 (2003/11/25) 譁ｰ隕丈ｽ懈?
153             *
154             * @return      蜀?Κ縺ｫ險ｭ螳壹＆繧後◆蛟､
155             */
156            public String getValue() {
157                    // 縺薙％縺ｧ縺ｯ縲∽ｽ輔ｂ縺励∪縺帙ｓ縲?
158                    return null;
159            }
160    
161            /**
162             * 隍?焚驕ｸ謚槫庄閭ｽ譎ゅ↓蜈ｨ驕ｸ謚槭ｒ險ｭ螳壹☆繧九°縺ｩ縺?°繧定ｿ斐＠縺ｾ縺吶?
163             *
164             * 縺薙ｌ縺ｯ縲∽ｸ贋ｽ榊?繧悟ｭ舌?繧ｿ繧ｰ縺ｮ OptionTag 縺ｧ縲［ultipleAll 繧貞叙繧雁?縺励※縲?
165             * true 縺ｧ縺ゅｌ縺ｰ縲∝?驕ｸ謚槭↓險ｭ螳壹＠縺ｾ縺吶?
166             *
167             * @og.rev 3.8.0.9 (2005/10/17) 譁ｰ隕丈ｽ懈?
168             *
169             * @return      蜈ｨ驕ｸ謚?true / 騾壼ｸｸ:false
170             */
171            public boolean isMultipleAll() {
172                    // 縺薙％縺ｧ縺ｯ縲∽ｽ輔ｂ縺励∪縺帙ｓ縲?
173                    return false;
174            }
175    
176            /**
177             * 繝代Λ繝｡繝ｼ繧ｿ繝ｼ螟画鋤({&#064;XXXX}縺ｮ鄂ｮ縺肴鋤縺医ｒ縺励↑縺?憾諷九?繝代Λ繝｡繝ｼ繧ｿ繝ｼ繧偵そ繝?ヨ縺励∪縺吶?
178             *
179             * @og.rev 5.1.7.0 (2010/06/01) 譁ｰ隕丈ｽ懈?(蜍慕噪繝励Ν繝?え繝ｳ螳溯｣?ｦ狗峩縺?
180             * @og.rev 5.5.4.0 (2012/07/02) 莠育ｴ?ｪ槫ｯｾ蠢?
181             *
182             * @param   param 繝代Λ繝｡繝ｼ繧ｿ繝ｼ
183             */
184            public void setRawParam( final String param ) {
185                    // 縺薙％縺ｧ縺ｯ縲∽ｽ輔ｂ縺励∪縺帙ｓ縲?
186            }
187    
188            /**
189             * 繧ｷ繝ｪ繧｢繝ｩ繧､繧ｺ逕ｨ縺ｮ繧ｫ繧ｹ繧ｿ繝?す繝ｪ繧｢繝ｩ繧､繧ｺ譖ｸ縺崎ｾｼ縺ｿ繝｡繧ｽ繝?ラ
190             *
191             * @serialData 荳?Κ縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医?縲√す繝ｪ繧｢繝ｩ繧､繧ｺ縺輔ｌ縺ｾ縺帙ｓ縲?
192             *
193             * @param       strm    ObjectOutputStream繧ｪ繝悶ず繧ｧ繧ｯ繝?
194             * @throws IOException  繧ｷ繝ｪ繧｢繝ｩ繧､繧ｺ縺ｫ髢｢縺吶ｋ蜈･蜃ｺ蜉帙お繝ｩ繝ｼ縺檎匱逕溘＠縺溷?蜷?
195             */
196            private void writeObject( final ObjectOutputStream strm ) throws IOException {
197                    strm.defaultWriteObject();
198            }
199    
200            /**
201             * 繧ｷ繝ｪ繧｢繝ｩ繧､繧ｺ逕ｨ縺ｮ繧ｫ繧ｹ繧ｿ繝?す繝ｪ繧｢繝ｩ繧､繧ｺ隱ｭ縺ｿ霎ｼ縺ｿ繝｡繧ｽ繝?ラ
202             *
203             * 縺薙％縺ｧ縺ｯ縲》ransient 螳｣險?＆繧後◆蜀?Κ螟画焚縺ｮ蜀??蛻晄悄蛹悶′蠢?ｦ√↑繝輔ぅ繝ｼ繝ｫ繝峨?縺ｿ險ｭ螳壹＠縺ｾ縺吶?
204             *
205             * @serialData 荳?Κ縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医?縲√す繝ｪ繧｢繝ｩ繧､繧ｺ縺輔ｌ縺ｾ縺帙ｓ縲?
206             *
207             * @param       strm    ObjectInputStream繧ｪ繝悶ず繧ｧ繧ｯ繝?
208             * @see #release2()
209             * @throws IOException  繧ｷ繝ｪ繧｢繝ｩ繧､繧ｺ縺ｫ髢｢縺吶ｋ蜈･蜃ｺ蜉帙お繝ｩ繝ｼ縺檎匱逕溘＠縺溷?蜷?
210             * @throws ClassNotFoundException       繧ｯ繝ｩ繧ｹ繧定ｦ九▽縺代ｋ縺薙→縺後〒縺阪↑縺九▲縺溷?蜷?
211             */
212            private void readObject( final ObjectInputStream strm ) throws IOException , ClassNotFoundException {
213                    strm.defaultReadObject();
214                    option = new Options();
215            }
216    
217            /**
218             * 縺薙?繧ｪ繝悶ず繧ｧ繧ｯ繝医?譁?ｭ怜?陦ｨ迴ｾ繧定ｿ斐＠縺ｾ縺吶?
219             * 蝓ｺ譛ｬ逧?↓繝?ヰ繝?げ逶ｮ逧?↓菴ｿ逕ｨ縺励∪縺吶?
220             *
221             * @return 縺薙?繧ｯ繝ｩ繧ｹ縺ｮ譁?ｭ怜?陦ｨ迴ｾ
222             */
223            @Override
224            public String toString() {
225                    return org.opengion.fukurou.util.ToString.title( this.getClass().getName() )
226                                    .println( "VERSION"             ,VERSION                )
227                                    .println( "id"                  ,id                             )
228                                    .println( "Other..."    ,getAttributes().getAttribute() )
229                                    .fixForm().toString() ;
230            }
231    }