uap/webapps/gf/src/org/opengion/plugin/column/DBType_YMDH.java

   1 /*
   2  * Copyright (c) 2009 The openGion Project.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *     http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
  13  * either express or implied. See the License for the specific language
  14  * governing permissions and limitations under the License.
  15  */
  16 package org.opengion.plugin.column;
  17
  18 import org.opengion.fukurou.system.DateSet;                                                     // 6.4.2.0 (2016/01/29)
  19 import org.opengion.fukurou.util.ErrorMessage;
  20 import org.opengion.fukurou.util.HybsDateUtil;
  21 import org.opengion.hayabusa.db.DBTypeCheckUtil;
  22
  23 import java.util.Calendar;
  24
  25 /**
  26  * 文字列の日付属性(年/月/日 時:分:秒)の半角の日付を扱う為の、カラム属性を定義します。
  27  *
  28  * yyyyMMddHHmmss に対応している必要があります。
  29  * ただし、日付の整合性チェックは行いませんが、valueAdd( String value )での
  30  * 日付の加算時には、正式な日付データにて加算します。
  31  *
  32  * タイプチェックとして、以下の条件を判定します。
  33  * ・文字列長は、直接計算で文字数との比較
  34  * ・日付使用文字チェック「('0' &gt; c || '9' &lt; c)以外」エラー
  35  * ・文字パラメータの 正規表現チェック
  36  *
  37  * @og.group データ属性
  38  *
  39  * @version  4.0
  40  * @author   Kazuhiko Hasegawa
  41  * @since    JDK5.0,
  42  */
  43 public class DBType_YMDH extends DBType_YMD {
  44         /** このプログラムのVERSION文字列を設定します。       {@value} */
  45         private static final String VERSION = "7.2.5.1 (2020/06/05)" ;
  46
  47         /**
  48          * デフォルトコンストラクター
  49          *
  50          * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
  51          */
  52         public DBType_YMDH() { super(); }               // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。
  53
  54         /**
  55          * String引数の文字列を＋１した文字列を返します。
  56          * ここでは、yyyyMMddHHmmss 形式のデータに、日を＋１します。
  57          *
  58          * 引数が null の場合と、ゼロ文字列("")の場合は、物理的初期設定値(String getDefault())
  59          * の値を返します。
  60          * それ以外の場合は、日付計算を行い、日を加算します。よって、年月日フォーマットに
  61          * 合わないデータを指定した場合は、エラーになりますので、ご注意ください。
  62          *
  63          * @og.rev 3.6.0.0 (2004/09/17) 日の加算ロジックの誤り修正。(roll ⇒ add)
  64          * @og.rev 5.5.7.2 (2012/10/09) HybsDateUtil を利用するように修正します。
  65          *
  66          * @param       value   String引数の文字列
  67          *
  68          * @return      String引数の文字列を＋１した文字列
  69          */
  70         @Override
  71         public String valueAdd( final String value ) {
  72                 if( value == null || value.isEmpty() ) { return getDefault(); }
  73
  74                 final Calendar cal = HybsDateUtil.getCalendar( value );
  75                 cal.add( Calendar.DATE, 1 );            // 日にちを１日加算します。
  76
  77                 return DateSet.getDate( cal.getTimeInMillis() , "yyyyMMddHHmmss" );
  78         }
  79
  80         /**
  81          * String引数の文字列に、第２引数に指定の文字列(数字、日付等)を加算して返します。
  82          *
  83          * ここでは、yyyyMMddHHmmss 形式のデータに、引数文の日を加算します。
  84          *
  85          * この YMDH は、引数に、日付単位を指定できます。単位は、yyyyMMddHHmmss 形式の
  86          * １文字を指定します。大文字、小文字も識別します。value="5M" とすれば、５か月、value="5m"
  87          * とすれば、５分 追加します。
  88          * 指定しない場合は、日を加算します。
  89          *
  90          * 引数が null の場合と、ゼロ文字列("")の場合は、物理的初期設定値(String getDefault())
  91          * の値を返します。
  92          * それ以外の場合は、日付計算を行い、日を加算します。よって、年月日フォーマットに
  93          * 合わないデータを指定した場合は、エラーになりますので、ご注意ください。
  94          *
  95          * @og.rev 5.6.0.3 (2012/01/24) ADD に、引数の値を加算する機能を追加します。
  96          * @og.rev 5.6.1.0 (2013/02/01) 加算する引数に、日付単位('y','M','d')を指定可能にします。
  97          *
  98          * @param   value  String引数
  99          * @param   add    加算する日付文字列
 100          *
 101          * @return  引数の文字列に、日付を加算します
 102          */
 103         @Override
 104         public String valueAdd( final String value,final String add ) {
 105                 // 6.4.1.1 (2016/01/16) PMD refactoring. A method should have only one exit point, and that should be the last statement in the method
 106                 return value == null || value.isEmpty() ? getDefault() : HybsDateUtil.getDatePlus( value,add,Calendar.DATE,"yyyyMMddHHmmss" );
 107         }
 108
 109         /**
 110          * エディターで編集されたデータを登録する場合に、データそのものを
 111          * 変換して、実登録データを作成します。
 112          * このメソッドでは、sizeX と無関係に １４ケタの YYYYMMDDHHMMS 形式の
 113          * 日付データにフォーマットに統一します。
 114          * 引数が null の場合と、ゼロ文字列("")の場合は、物理的初期設定値(String getDefault())
 115          * の値を返します。
 116          *
 117          * @og.rev 5.5.7.2 (2012/10/09) HybsDateUtil を利用するように修正します。
 118          * @og.rev 5.6.6.0 (2013/07/05) 日付の桁数範囲を、8-14 桁とします。
 119          *
 120          * @param       value   (一般に編集データとして登録されたデータ)
 121          * @return  修正後の文字列(一般にデータベースに登録するデータ)
 122          */
 123         @Override
 124         public String valueSet( final String value ) {
 125                 // 6.4.1.1 (2016/01/16) PMD refactoring. A method should have only one exit point, and that should be the last statement in the method
 126                 return value == null || value.isEmpty() ? getDefault() : HybsDateUtil.parseDate( value,8,14 );
 127         }
 128
 129         /**
 130          * データが登録可能かどうかをチェックします。
 131          * データがエラーの場合は、そのエラー内容を返します。
 132          *
 133          * @og.rev 5.6.0.3 (2012/01/24) 日付チェックの整合性まで含めたチェックを入れる。
 134          * @og.rev 7.2.5.1 (2020/06/05) 数値変換エラーの前にチェックを入れます。
 135          *
 136          * @param   key         キー
 137          * @param   value       値
 138          * @param   sizeX       整数部分の文字列の長さ
 139          * @param   sizeY       小数部分の文字列の長さ
 140          * @param   typeParam   dbType パラメータ(文字パラメータ)
 141          * @param   isStrict    厳密にチェックするかどうか[true:する/false:標準的]
 142          *
 143          * @return  エラー内容
 144          * @og.rtnNotNull
 145          */
 146         @Override
 147         public ErrorMessage valueCheck( final String key ,final String value ,
 148                                                                         final int sizeX ,final int sizeY ,final String typeParam ,final boolean isStrict) {
 149
 150                 final ErrorMessage msg = new ErrorMessage();
 151                 if( value == null || value.isEmpty() ) { return msg; }
 152
 153                 final int len = (sizeY == 0) ? sizeX : sizeX + sizeY + 1;
 154                 // 5.2.2.0 (2010/11/01) 厳密にチェック(isStrict=true)するフラグを追加
 155                 if( isStrict ) {
 156                         if( len != value.length() ) {
 157                                 // 文字列の長さが指定の長さと異なります。
 158                                 msg.addMessage( 0,ErrorMessage.NG,"ERR0011", key,value,
 159                                                                                 String.valueOf( value.length() ), String.valueOf( len ) );
 160                         }
 161                 }
 162                 else {
 163                         if( len < value.length() ) {
 164                                 // 文字列の長さが指定の長さよりも長いです。
 165                                 msg.addMessage( 0,ErrorMessage.NG,"ERR0006",key,value,
 166                                                                                 String.valueOf( value.length() ),String.valueOf( len ) );
 167                         }
 168                 }
 169
 170                 // 7.2.5.1 (2020/06/05) 文字の範囲チェックは、ymdFormatCheck の中で行っている。
 171 //              // 5.6.0.3 (2012/01/24) 文字の範囲チェック
 172 //              String check = DBTypeCheckUtil.rangeCheck( value, '0', '9' );
 173 //              if( check != null ) {
 174 //                      // 指定の文字以外の文字が使われています。
 175 //                      msg.addMessage( 0,ErrorMessage.NG,"ERR0009", key,check );
 176 //              }
 177
 178                 // 5.6.0.3 (2012/01/24) 日付文字の整合性チェック
 179                 // "0000","9999" で始まる日付は未条件許可。
 180                 String check = DBTypeCheckUtil.ymdFormatCheck( value );
 181                 if( check != null ) {
 182                         // 指定の文字以外の文字が使われています。
 183                         msg.addMessage( 0,ErrorMessage.NG,"ERR0009", key,check );
 184                 }
 185
 186                 // 3.6.0.0 (2004/09/22) dbType パラメータ(文字パラメータ)を使用したマッチチェック
 187                 check = DBTypeCheckUtil.matcheCheck( value,typeParam );
 188                 if( check != null ) {
 189                         // 指定の文字以外の文字が使われています。
 190                         msg.addMessage( 0,ErrorMessage.NG,"ERR0009", key,check );
 191                 }
 192
 193                 return msg;
 194         }
 195 }