    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 */
    016package org.opengion.hayabusa.db;
    017
    018import org.opengion.hayabusa.common.HybsSystem;
    019import org.opengion.fukurou.util.LogWriter;
    020
    021/**
    022 * データのコード情報を取り扱うクラスです。
    023 *
    024 * 開始、終了、ステップの情報から、HTMLのメニューやリストを作成するための オプション
    025 * タグを作成したり、与えられたキーをもとに、チェック済みのオプションタグを作成したりします。
    026 *
    027 * ここでは、数字（連番）の自動生成を行います。パラメータで、開始、終了、ステップを指定します。
    028 * パラメータの初期値は、開始(1)、終了(10)、ステップ(1) です。
    029 *
    030 * 例：1,10,1    → 1,2,3,4,5,6,7,8,9,10 のプルダウン
    031 * 例：10,100,10 → 10,20,30,40,50,60,70,80,90,100 のプルダウン
    032 * 例：-5,5,1    → -5,-4,-3,-2,-1,0,1,2,3,4,5 のプルダウン
    033 * 例：5,-5,-2   → 5,3,1,-1,-3,-5 のプルダウン
    034 *
    035 * @og.group 選択データ制御
    036 * @og.rev 5.6.1.1 (2013/02/08) 新規追加
    037 *
    038 * @version  4.0
    039 * @author   Kazuhiko Hasegawa
    040 * @since    JDK5.0,
    041 */
    042// public class Selection_NUM implements Selection {
    043public class Selection_NUM extends Selection_NULL {
    044        private final String   CACHE ;
    045        private final String   ST_ED_STEP ;
    046
    047        /**
    048         * コンストラクター
    049         *
    050         * 引数は、開始、終了、ステップです。
    051         * パラメータの初期値は、開始(1)、終了(10)、ステップ(1) です。
    052         *
    053         * @param       editPrm 開始、終了、[ステップ]を表す引数(例：1,10,1)
    054         */
    055        public Selection_NUM( final String editPrm ) {
    056        //      if( param.length < 2 ) {
    057        //              String errMsg = "引数は、開始、終了、[ステップ] です。最低でも２個必要です。";
    058        //              throw new IllegalArgumentException( errMsg );
    059        //      }
    060
    061                String[] param = (editPrm == null) ? new String[0] : editPrm.split( "," ) ;
    062
    063                int start = (param.length > 0) ? Integer.parseInt( param[0].trim() ) : 1;
    064                int end   = (param.length > 1) ? Integer.parseInt( param[1].trim() ) : 10 ;
    065                int step  = (param.length > 2) ? Integer.parseInt( param[2].trim() ) : 1;
    066
    067                if( step == 0 ) {
    068                        String errMsg = "ステップ に ０ は指定できません。無限ループします。";
    069                        throw new IllegalArgumentException( errMsg );
    070                }
    071
    072                StringBuilder buf = new StringBuilder( HybsSystem.BUFFER_MIDDLE );
    073
    074                // ステップの正負による判定の違い。while( Math.signum( end-start ) * step >= 0.0 ) で、判る？
    075                // 終了条件は、含む(val<=end)
    076                int val  = start;
    077                int sign = ( step > 0 ) ? 1 : -1 ;      // ステップの符号。
    078                while( (end - val) * sign >= 0 ) {
    079                        buf.append( "<option value=\"" ).append( val ).append( "\"" );
    080                        buf.append( ">" ).append( val ).append( "</option>" );
    081                        val += step;
    082                }
    083
    084                CACHE = buf.toString();
    085                ST_ED_STEP = "Start=" + start + " , End=" + end + " , Step=" + step ;
    086        }
    087
    088        /**
    089         * 初期値が選択済みの 選択肢(オプション)を返します。
    090         * このオプションは、引数の値を初期値とするオプションタグを返します。
    091         * このメソッドでは、ラベル(短)が設定されている場合でも、これを使用せずに必ずラベル(長)を使用します。
    092         *
    093         * @og.rev 5.7.7.1 (2014/06/13) Selection_NULL を 継承するため、削除
    094         *
    095         * @param   selectValue  選択されている値
    096         * @param   seqFlag  シーケンスアクセス機能 [true:ON/false:OFF]
    097         *
    098         * @return  オプションタグ
    099         * @see     #getOption( String, boolean, boolean )
    100         */
    101//      public String getOption( final String selectValue,final boolean seqFlag ) {
    102//              return getOption( selectValue, seqFlag, false );
    103//      }
    104
    105        /**
    106         * 初期値が選択済みの 選択肢(オプション)を返します。
    107         * このオプションは、引数の値を初期値とするオプションタグを返します。
    108         * このメソッドでは、引数のuseShortLabelがtrueに指定された場合に、ラベル(短)をベースとした
    109         * ツールチップ表示を行います。
    110         *
    111         * @param   selectValue  選択されている値
    112         * @param   seqFlag  シーケンスアクセス機能 [true:ON/false:OFF]
    113         * @param   useShortLabel ラベル(短)をベースとしたオプション表示を行うかどうか。(未使用)
    114         *
    115         * @return  オプションタグ
    116         * @see     #getOption( String, boolean )
    117         */
    118        @Override
    119        public String getOption( final String selectValue,final boolean seqFlag, final boolean useShortLabel ) {
    120                // マッチするアドレスを探す。
    121                int selected = CACHE.indexOf( "\"" + selectValue + "\"" );
    122
    123                if( selected < 0 ) {
    124                        if( selectValue != null && selectValue.length() > 0 ) {
    125                                String errMsg = "数字範囲に存在しない値が指定されました。"
    126                                                        + " value=[" + selectValue + "]"
    127                                                        + HybsSystem.CR + ST_ED_STEP ;
    128                                LogWriter.log( errMsg );
    129                        }
    130                        return CACHE;
    131                }
    132                else {
    133                        // "値" 文字列の位置が、selected なので、値の文字数＋２までが、前半部分になる。
    134                        int indx = selected + selectValue.length() + 2 ;
    135
    136                        StringBuilder buf = new StringBuilder( HybsSystem.BUFFER_MIDDLE );
    137                        // 3.6.0.6 (2004/10/22) シーケンスアクセス機能を指定する seqFlag を導入
    138                        if( seqFlag ) {
    139                                buf.append( "<option value=\"" ).append( selectValue ).append( "\"" );
    140                        }
    141                        else {
    142                                buf.append( CACHE.substring( 0,indx ) );
    143                        }
    144                        buf.append( " selected=\"selected\"" );
    145                        buf.append( CACHE.substring( indx ) );
    146                        return buf.toString() ;
    147                }
    148        }
    149
    150        /**
    151         * 初期値が選択済みの 選択肢(オプション)を返します。
    152         * このオプションは、引数の値を初期値とするオプションタグを返します。
    153         * ※ このクラスでは実装されていません。
    154         *
    155         * @og.rev 2.1.0.1 (2002/10/17) 選択リストを、正方向にしか選べないようにする sequenceFlag を導入する
    156         * @og.rev 3.8.6.0 (2006/09/29) useLabel 属性 追加
    157         * @og.rev 5.7.7.1 (2014/06/13) Selection_NULL を 継承するため、削除
    158         *
    159         * @param   name         ラジオの name
    160         * @param   selectValue  選択されている値
    161         * @param   useLabel     ラベル表示の有無 [true:有/false:無]
    162         *
    163         * @return  オプションタグ
    164         */
    165//      public String getRadio( final String name,final String selectValue,final boolean useLabel ) {
    166//              String errMsg = "このクラスでは実装されていません。";
    167//              throw new UnsupportedOperationException( errMsg );
    168//      }
    169
    170        /**
    171         * 初期値が選択済みの 選択肢(オプション)を返します。
    172         * このオプションは、引数の値を初期値とするオプションタグを返します。
    173         * ※ このクラスでは実装されていません。
    174         *
    175         * @og.rev 5.7.7.1 (2014/06/13) Selection_NULL を 継承するため、削除
    176         *
    177         * @param   selectValue  選択されている値
    178         *
    179         * @return  オプションタグ
    180         */
    181//      public String getRadioLabel( final String selectValue ) {
    182//              String errMsg = "このクラスでは実装されていません。";
    183//              throw new UnsupportedOperationException( errMsg );
    184//      }
    185
    186        /**
    187         * 選択肢(value)に対するラベルを返します。
    188         * 選択肢(value)が、存在しなかった場合は、選択肢そのものを返します。
    189         * getValueLabel( XX ) は、getValueLabel( XX,false ) と同じです。
    190         *
    191         * @og.rev 5.7.7.1 (2014/06/13) Selection_NULL を 継承するため、削除
    192         *
    193         * @param   selectValue 選択肢の値
    194         *
    195         * @return  選択肢のラベル
    196         * @see     #getValueLabel( String,boolean )
    197         */
    198//      public String getValueLabel( final String selectValue ) {
    199//              return getValueLabel( selectValue,false );
    200//      }
    201
    202        /**
    203         * 選択肢(value)に対するラベルを返します。
    204         * 選択肢(value)が、存在しなかった場合は、選択肢そのものを返します。
    205         * このメソッドでは、短縮ラベルを返すかどうかを指定するフラグを指定します。
    206         * getValueLabel( XX,false ) は、getValueLabel( XX ) と同じです。
    207         *
    208         * @og.rev 4.0.0.0 (2005/11/30) を追加
    209         *
    210         * @param       selectValue     選択肢の値
    211         * @param       flag    短縮ラベルを [true:使用する/false:しない] (未使用)
    212         *
    213         * @return  選択肢のラベル
    214         * @see     #getValueLabel( String )
    215         */
    216        @Override
    217        public String getValueLabel( final String selectValue,final boolean flag ) {
    218                // あろうがなかろうが、選択肢そのものを返します。
    219                return selectValue;
    220        }
    221
    222        /**
    223         * マルチ・キーセレクトを使用するかどうかを返します(false固定)。
    224         * true：使用する。false:使用しない です。
    225         * ただし、実際に使用するかどうかは、HTML出力時に決めることが出来ます。
    226         * ここでは、USE_MULTI_KEY_SELECT が true で、USE_SIZE(=20)以上の場合に
    227         * true を返します。
    228         *
    229         * @og.rev 3.5.5.7 (2004/05/10) 新規作成
    230         *
    231         * @return  選択リストで、マルチ・キーセレクトを使用するかどうか(true:使用する) (false固定)
    232         */
    233        @Override
    234        public boolean useMultiSelect() {
    235                return true;
    236        }
    237
    238        /**
    239         * オブジェクトのキャッシュが時間切れかどうかを返します。
    240         * キャッシュが時間切れ(無効)であれば、true を、有効であれば、
    241         * false を返します。
    242         *
    243         * @og.rev 4.0.0.0 (2005/01/31) 新規作成
    244         * @og.rev 5.7.7.1 (2014/06/13) Selection_NULL を 継承するため、削除
    245         *
    246         * @return  キャッシュが時間切れなら true
    247         */
    248//      public boolean isTimeOver() {
    249//              return false;
    250//      }
    251}