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
018// import org.opengion.fukurou.system.LogWriter;
019import static org.opengion.fukurou.system.HybsConst.CR ;                                // 6.1.0.0 (2014/12/26)
020import static org.opengion.fukurou.system.HybsConst.BUFFER_MIDDLE;      // 6.1.0.0 (2014/12/26) refactoring
021
022/**
023 * データのコード情報を取り扱うクラスです。
024 *
025 * 開始、終了、ステップの情報から、HTMLのメニューやリストを作成するための オプション
026 * タグを作成したり、与えられたキーをもとに、チェック済みのオプションタグを作成したりします。
027 *
028 * ここでは、数字(連番)の自動生成を行います。パラメータで、開始、終了、ステップを指定します。
029 * パラメータの初期値は、開始(1)、終了(10)、ステップ(1)、小数(null) です。
030 *
031 * 例:1,10,1     → 1,2,3,4,5,6,7,8,9,10 のプルダウン
032 * 例:10,100,10  → 10,20,30,40,50,60,70,80,90,100 のプルダウン
033 * 例:-5,5,1     → -5,-4,-3,-2,-1,0,1,2,3,4,5 のプルダウン
034 * 例:5,-5,-2    → 5,3,1,-1,-3,-5 のプルダウン
035 * 例:1,10,1,0.1 → 0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9,1.0 のプルダウン
036 *
037 * 7.0.0.1 (2018/10/09) 小数対応(特殊な方法)
038 *   開始、終了や、ステップに小数を指定したいと思いますが、数値と文字列の変換や、誤差処理など
039 *   結構ややこしいので、第4の引数で、倍率というのを指定するようにします。
040 *   これは、0.1 か、0.01 ぐらいしか指定しないので、あくまで、この値が使用されたときだけ、小数扱いします。
041 *
042 * @og.group 選択データ制御
043 * @og.rev 5.6.1.1 (2013/02/08) 新規追加
044 * @og.rev 7.0.0.1 (2018/10/09) 小数対応(特殊な方法)
045 * @og.rev 8.5.6.1 (2024/03/29) 継承で使えるように、一部修正します。
046 *
047 * @version  4.0
048 * @author   Kazuhiko Hasegawa
049 * @since    JDK5.0,
050 */
051// 8.5.5.1 (2024/02/29) spotbugs CT_CONSTRUCTOR_THROW(コンストラクタで、Excweptionを出さない) class を final にすれば、警告は消える。
052// public class Selection_NUM extends Selection_NULL {
053public final class Selection_NUM extends Selection_NULL {
054//      private final String    CACHE ;                 // 8.5.6.1 (2024/03/29) 親クラスで定義
055//      private final String    ST_ED_STEP ;    // 8.5.6.1 (2024/03/29) 未使用なので削除
056
057        /**
058         * コンストラクター
059         *
060         * 引数は、開始、終了、ステップです。
061         * パラメータの初期値は、開始(1)、終了(10)、ステップ(1) です。
062         *
063         * @og.rev 6.2.6.0 (2015/06/19) type別Selectionの場合、ラベルリソースを使用する為、言語を引数で渡す。
064         * @og.rev 6.3.4.0 (2015/08/01) Selection_NUM の引数から、lang 属性を削除します。
065         * @og.rev 7.0.0.1 (2018/10/09) 小数対応(特殊な方法)  ⇒ 7.3.1.1 (2021/02/25) 廃止
066         * @og.rev 7.3.1.1 (2021/02/25) ゼロ埋めや少数フォーマットを自動判定する。
067         *
068         * @param       editPrm 開始、終了、[ステップ]を表す引数(例:1,10,1)
069         */
070        public Selection_NUM( final String editPrm ) {
071//              super();                                // 6.4.1.1 (2016/01/16) PMD refactoring. It is a good practice to call super() in a constructor
072                super( editPrm );               // 8.5.6.1 (2024/03/29) 継承親で、引数付きコンストラクタで初期設定されます。
073        //      if( param.length < 2 ) {
074        //              final String errMsg = "引数は、開始、終了、[ステップ] です。最低でも2個必要です。";
075        //              throw new IllegalArgumentException( errMsg );
076        //      }
077
078                final String[] param = editPrm == null ? new String[0] : editPrm.split( "," ) ;
079
080                final String stpStr = param.length > 2 ? param[2].trim() : "1" ;
081
082//              final int step = param.length > 2 ? Integer.parseInt( param[2].trim() ) : 1;
083//              if( step == 0 ) {
084                if( "0".equals(stpStr) ) {
085                        final String errMsg = "ステップ に 0 は指定できません。無限ループします。";
086                        throw new IllegalArgumentException( errMsg );
087                }
088                final float step =Float.parseFloat( stpStr );
089
090                final String stStr  = param.length > 0 ? param[0].trim() : "1" ;
091                final String edStr  = param.length > 1 ? param[1].trim() : "10" ;
092                final float start = Float.parseFloat( stStr );
093                final float end   = Float.parseFloat( edStr );
094
095                // 7.3.1.1 (2021/02/25) ゼロ埋めや少数フォーマットを自動判定する。
096
097                String numFmt = "%.0f" ;                                                // デフォルトは整数
098                if( stStr.length() > 1 && stStr.charAt(0) == '0' ) {
099                        if( stStr.charAt(1) == '.' ) {                          // 少数フォーマット
100                                numFmt = "%." + (stStr.length()-2) + "f" ;
101                        }
102                        else {
103                                numFmt = "%0" + stStr.length() + ".0f" ;
104                        }
105                }
106
107//              final int start = param.length > 0 ? Integer.parseInt( param[0].trim() ) : 1;
108//              final int end   = param.length > 1 ? Integer.parseInt( param[1].trim() ) : 10 ;
109
110//              // 7.0.0.1 (2018/10/09) 小数対応(特殊な方法)
111//              final boolean isFloat = param.length > 3;
112//              final double  deci    = isFloat ? Double.parseDouble( param[3].trim() ) : 0d ;                          // isFloat が false の場合は、どうせ使わない。
113//              final String  fmt     = isFloat ? ( "0.1".equals( param[3].trim() ) ? "%.1f" : "%.2f" ) : null;
114
115                final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE );
116
117                // ステップの正負による判定の違い。while( Math.signum( end-start ) * step >= 0.0 ) で、判る?
118                // 終了条件は、含む(val<=end)
119//              int val  = start;
120                float val  = start;
121                final int sign = step > 0 ? 1 : -1 ;    // ステップの符号。
122                int   cnt = 1;
123                while( (end - val) * sign >= 0.0 ) {    // 開始-終了 ともに含む
124//                      final String val2 = isFloat ? String.format( fmt , val * deci ) : Integer.toString( val ) ;             // 7.0.0.1 (2018/10/09) 小数対応(特殊な方法)
125                        final String val2 = String.format( numFmt , val );                              // 7.3.1.1 (2021/02/25) ゼロ埋めや少数フォーマットを自動判定する。
126                        buf.append( "<option value=\"" ).append( val2 )
127                                .append( "\">" ).append( val2 ).append( "</option>" );          // 6.0.2.5 (2014/10/31) char を append する。
128                        val = start + step * cnt++;                             //
129                }
130
131                cache = buf.toString();                                         // 8.5.6.1 (2024/03/29) super.cache
132//              // 8.5.6.1 (2024/03/29) 未使用なので削除
133//              ST_ED_STEP = "Start=" + start + " , End=" + end + " , Step=" + step ;
134        }
135
136//      /**
137//       * 初期値が選択済みの 選択肢(オプション)を返します。
138//       * このオプションは、引数の値を初期値とするオプションタグを返します。
139//       * このメソッドでは、引数のuseShortLabelがtrueに指定された場合に、ラベル(短)をベースとした
140//       * ツールチップ表示を行います。
141//       *
142//       * @og.rev 8.5.6.1 (2024/03/29) 継承元と同じなので削除
143//       *
144//       * @param   selectValue  選択されている値
145//       * @param   seqFlag  シーケンスアクセス機能 [true:ON/false:OFF]
146//       * @param   useShortLabel ラベル(短)をベースとしたオプション表示を行うかどうか。(未使用)
147//       *
148//       * @return  オプションタグ
149//       * @og.rtnNotNull
150//       */
151//      @Override
152//      public String getOption( final String selectValue,final boolean seqFlag, final boolean useShortLabel ) {
153//              // マッチするアドレスを探す。
154//              final int selected = CACHE.indexOf( "\"" + selectValue + "\"" );
155//
156//              // 8.5.5.1 (2024/02/29) PMD 7.0.0 OnlyOneReturn メソッドには終了ポイントが 1 つだけ必要
157//              final String rtn;
158//              if( selected < 0 ) {
159//                      if( selectValue != null && selectValue.length() > 0 ) {
160//                              final String errMsg = "数字範囲に存在しない値が指定されました。"
161//                                                      + " value=[" + selectValue + "]"
162//                                                      + CR + ST_ED_STEP ;
163//                              LogWriter.log( errMsg );
164//                      }
165////                    return CACHE;
166//                      rtn = CACHE;
167//              }
168//              else {
169//                      // "値" 文字列の位置が、selected なので、値の文字数+2までが、前半部分になる。
170//                      final int indx = selected + selectValue.length() + 2 ;
171//
172//                      final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE );
173//                      // 3.6.0.6 (2004/10/22) シーケンスアクセス機能を指定する seqFlag を導入
174//                      if( seqFlag ) {
175//                              buf.append( "<option value=\"" ).append( selectValue ).append( '"' );           // 6.0.2.5 (2014/10/31) char を append する。
176//                      }
177//                      else {
178//                              buf.append( CACHE.substring( 0,indx ) );
179//                      }
180//                      buf.append( " selected=\"selected\"" )
181//                              .append( CACHE.substring( indx ) );
182////                    return buf.toString() ;
183//                      rtn = buf.toString() ;
184//              }
185//              return rtn;
186//      }
187
188        /**
189         * 選択肢(value)に対するラベルを返します。
190         * 選択肢(value)が、存在しなかった場合は、選択肢そのものを返します。
191         * このメソッドでは、短縮ラベルを返すかどうかを指定するフラグを指定します。
192         * getValueLabel( XX,false ) は、getValueLabel( XX ) と同じです。
193         *
194         * @og.rev 4.0.0.0 (2005/11/30) を追加
195         *
196         * @param       selectValue     選択肢の値
197         * @param       isSLbl  短縮ラベルを [true:使用する/false:しない] (未使用)
198         *
199         * @return  選択肢のラベル
200         * @see     #getValueLabel( String )
201         */
202        @Override
203        public String getValueLabel( final String selectValue,final boolean isSLbl ) {
204                // あろうがなかろうが、選択肢そのものを返します。
205                return selectValue;
206        }
207}