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.db;
017    
018    /**
019     * ãƒ??ã‚¿ã®ã‚³ãƒ¼ãƒ‰æƒ…報をå–り扱ã??通インターフェースã§ã™ã?
020     *
021     * コードã?キーã¨ãƒ©ãƒ™ãƒ«ã®æƒ??ã‹ã‚‰ã€HTMLã®ãƒ¡ãƒ‹ãƒ¥ãƒ¼ã‚?ƒªã‚¹ãƒˆã‚’作æ?ã™ã‚‹ãŸã‚㮠オプション
022     * タグを作æ?ã—ãŸã‚Šã?与ãˆã‚‰ã‚ŒãŸã‚­ãƒ¼ã‚’ã‚‚ã¨ã«ã€ãƒã‚§ãƒ?‚¯æ¸ˆã¿ã®ã‚ªãƒ—ションタグを作æ?ã—ãŸã‚?
023     * ã—ã¾ã™ã?
024     *
025     * @og.group é¸æŠžãƒ‡ãƒ¼ã‚¿åˆ¶å¾¡
026     *
027     * @version  4.0
028     * @author   Kazuhiko Hasegawa
029     * @since    JDK5.0,
030     */
031    public interface Selection {
032            static final String NO_VALUE_OPTION = "<option value=\"\" ></option>" ;     // 3.5.5.7 (2004/05/10)
033    
034            /**
035             * åˆæœŸå€¤ãŒé¸æŠžæ¸ˆã¿ã® é¸æŠžè‚¢(オプション)ã‚’è¿”ã—ã¾ã™ã?
036             * ã“ã?オプションã¯ã€å¼•æ•°ã®å€¤ã‚’å?期å?ã¨ã™ã‚‹ã‚ªãƒ—ションタグを返ã—ã¾ã™ã?
037             * ã“ã?メソãƒ?ƒ‰ã§ã¯ã€ãƒ©ãƒ™ãƒ«(短)ãŒè¨­å®šã•れã¦ã?‚‹å ´åˆã§ã‚‚ã?ã“れを使用ã›ãšã«å¿?šãƒ©ãƒ™ãƒ«(é•·)を使用ã—ã¾ã™ã?
038             *
039             * @og.rev 3.6.0.6 (2004/10/22) シーケンスアクセス機è?を指定ã™ã‚?seqFlag ã‚’å°Žå?
040             *
041             * @param   selectValue  é¸æŠžã•れã¦ã?‚‹å€¤
042             * @param   seqFlag  シーケンスアクセス機è? [true:ON/false:OFF]
043             *
044             * @return  オプションタグ
045             */
046            String getOption( String selectValue,boolean seqFlag ) ;
047    
048            /**
049             * åˆæœŸå€¤ãŒé¸æŠžæ¸ˆã¿ã® é¸æŠžè‚¢(オプション)ã‚’è¿”ã—ã¾ã™ã?
050             * ã“ã?オプションã¯ã€å¼•æ•°ã®å€¤ã‚’å?期å?ã¨ã™ã‚‹ã‚ªãƒ—ションタグを返ã—ã¾ã™ã?
051             * ã“ã?メソãƒ?ƒ‰ã§ã¯ã€å¼•æ•°ã®useShortLabelãŒtrueã«æŒ?®šã•れãŸå ´åˆã«ã€ãƒ©ãƒ™ãƒ«(短)ã‚’ã?ースã¨ã—ãŸ
052             * ãƒ??ルãƒãƒƒãƒ—表示を行ã„ã¾ã™ã?
053             *
054             * @og.rev 5.1.3.0 (2010/02/01) 追�
055             *
056             * @param   selectValue  é¸æŠžã•れã¦ã?‚‹å€¤
057             * @param   seqFlag  シーケンスアクセス機è? [true:ON/false:OFF]
058             * @param   useShortLabel ラベル(短)ã‚’ã?ースã¨ã—ãŸã‚ªãƒ—ション表示を行ã†ã‹ã©ã?‹ã€?
059             *
060             * @return  オプションタグ
061             */
062            String getOption( String selectValue,boolean seqFlag, boolean useShortLabel ) ;
063    
064            /**
065             * é¸æŠžè‚¢(value)ã«å¯¾ã™ã‚‹ãƒ©ãƒ™ãƒ«ã‚’è¿”ã—ã¾ã™ã?
066             * é¸æŠžè‚¢(value)ãŒã?存在ã—ãªã‹ã£ãŸå?åˆã?ã€?¸æŠžè‚¢ãã?ã‚‚ã?ã‚’è¿”ã—ã¾ã™ã?
067             * getValueLabel( XX ) ã¯ã€getValueLabel( XX,false ) ã¨åŒã˜ã§ã™ã?
068             *
069             * @param   selectValue é¸æŠžè‚¢ã®å€¤
070             *
071             * @return  é¸æŠžè‚¢ã®ãƒ©ãƒ™ãƒ«
072             * @see     #getValueLabel( String,boolean )
073             */
074            String getValueLabel( String selectValue ) ;
075    
076            /**
077             * é¸æŠžè‚¢(value)ã«å¯¾ã™ã‚‹ãƒ©ãƒ™ãƒ«ã‚’è¿”ã—ã¾ã™ã?
078             * é¸æŠžè‚¢(value)ãŒã?存在ã—ãªã‹ã£ãŸå?åˆã?ã€?¸æŠžè‚¢ãã?ã‚‚ã?ã‚’è¿”ã—ã¾ã™ã?
079             * ã“ã?メソãƒ?ƒ‰ã§ã¯ã€çŸ­ç¸®ãƒ©ãƒ™ãƒ«ã‚’è¿”ã™ã‹ã©ã?‹ã‚’指定ã™ã‚‹ãƒ•ラグを指定ã—ã¾ã™ã?
080             * getValueLabel( XX,false ) ã¯ã€getValueLabel( XX ) ã¨åŒã˜ã§ã™ã?
081             *
082             * @og.rev 4.0.0.0 (2005/11/30) を追�
083             *
084             * @param       selectValue     é¸æŠžè‚¢ã®å€¤
085             * @param       flag    短縮ラベル使用有無 [true:使用ã™ã‚‹/false:ã—ãªã„]
086             *
087             * @return  é¸æŠžè‚¢ã®ãƒ©ãƒ™ãƒ«
088             * @see     #getValueLabel( String )
089             */
090            String getValueLabel( String selectValue,boolean flag ) ;
091    
092            /**
093             * åˆæœŸå€¤ãŒé¸æŠžæ¸ˆã¿ã® é¸æŠžè‚¢(ラジオボタン)ã‚’è¿”ã—ã¾ã™ã?
094             * ã“ã?ラジオボタンã¯ã€å¼•æ•°ã®å€¤ã‚’å?期å?ã¨ã™ã‚‹ãƒ©ã‚¸ã‚ªãƒœã‚¿ãƒ³ã‚¿ã‚°ã‚’è¿”ã—ã¾ã™ã?
095             *
096             * @og.rev 3.5.1.0 (2003/10/03) æ–°è¦ä½œæ?
097             * @og.rev 3.8.6.0 (2006/09/29) useLabel 属æ? 追åŠ?
098             *
099             * @param   name  name属æ?ã«ãªã‚‹ã‚­ãƒ¼æ–?­—å?
100             * @param   selectValue  é¸æŠžã•れã¦ã?‚‹å€¤
101             * @param   useLabel     ãƒ©ãƒ™ãƒ«è¡¨ç¤ºã®æœ‰ç„¡ [true:æœ?false:ç„¡]
102             *
103             * @return  ラジオボタンタグ
104             */
105            String getRadio( String name, String selectValue, boolean useLabel ) ;
106    
107            /**
108             * é¸æŠžè‚¢(value)ã«å¯¾ã™ã‚‹ãƒ©ãƒ™ãƒ«ã‚’è¿”ã—ã¾ã™ã?
109             * é¸æŠžè‚¢(value)ãŒã?存在ã—ãªã‹ã£ãŸå?åˆã?ã€?¸æŠžè‚¢ãã?ã‚‚ã?ã‚’è¿”ã—ã¾ã™ã?
110             *
111             * @og.rev 3.8.6.0 (2006/09/29) æ–°è¦ä½œæ?
112             *
113             * @param   selectValue é¸æŠžè‚¢ã®å€¤
114             *
115             * @return  é¸æŠžè‚¢ã®ãƒ©ãƒ™ãƒ«
116             */
117            String getRadioLabel( String selectValue ) ;
118    
119            /**
120             * マルãƒã?キーセレクトを使用ã™ã‚‹ã‹ã©ã?‹ã‚’è¿”ã—ã¾ã™ã?
121             * true?šä½¿ç”¨ã™ã‚‹ã€‚false:使用ã—ãªã?ã§ã™ã?
122             * ãŸã ã—ã?実際ã«ä½¿ç”¨ã™ã‚‹ã‹ã©ã?‹ã¯ã€HTMLå‡ºåŠ›æ™‚ã«æ±ºã‚ã‚‹ã“ã¨ãŒå?æ¥ã¾ã™ã?
123             * ã“ã“ã§ã¯ã€USE_MULTI_KEY_SELECT ã?true ã§ã€USE_SIZE(=20)以上ã?å ´åˆã«
124             * true ã‚’è¿”ã—ã¾ã™ã?
125             *
126             * @og.rev 3.5.5.7 (2004/05/10) æ–°è¦ä½œæ?
127             *
128             * @return  é¸æŠžãƒªã‚¹ãƒˆã§ã€ã?ルãƒã?キーセレクトを使用ã™ã‚‹ã‹ã©ã?‹(true:使用ã™ã‚‹)
129             */
130            boolean useMultiSelect() ;
131    
132            /**
133             * オブジェクトã?キャãƒ?‚·ãƒ¥ãŒæ™‚é–“å?れã‹ã©ã?‹ã‚’è¿”ã—ã¾ã™ã?
134             * キャãƒ?‚·ãƒ¥ãŒæ™‚é–“å?ã‚?無効)ã§ã‚れã°ã€true ã‚’ã?有効ã§ã‚れã°ã€?
135             * false ã‚’è¿”ã—ã¾ã™ã?
136             *
137             * @og.rev 4.0.0.0 (2005/01/31) æ–°è¦ä½œæ?
138             *
139             * @return  キャãƒ?‚·ãƒ¥ãŒæ™‚é–“å?れãªã‚?true
140             */
141            boolean isTimeOver() ;
142    }