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 }