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.plugin.column; 017 018import org.opengion.fukurou.util.ErrorMessage; 019import org.opengion.fukurou.util.HybsDateUtil; 020import org.opengion.hayabusa.db.DBTypeCheckUtil; 021 022/** 023 * 文字列の日付属性(年/月)の半角の日付を扱う為の、カラム属性を定義します。 024 * 025 * yyyyMM に対応している必要があります。 026 * "000000" と、"999999" は、常に許可になります。 027 * ただし、日付の整合性チェックは行いませんが、valueAdd( String value )による 028 * 日付(月)の加算時には、0000XX と 9999XX は、加算されず、それ以外は、 029 * 正式な日付で加算されます。 030 * 031 * タイプチェックとして、以下の条件を判定します。 032 * ・文字列長は、直接計算で文字数との比較 033 * ・日付使用文字チェック「('0' > c || '9' < c)以外」エラー 034 * ・文字パラメータの 正規表現チェック 035 * 036 * @og.rev 3.6.0.0 (2004/09/17) 新規作成 037 * @og.group データ属性 038 * 039 * @version 4.0 040 * @author Kazuhiko Hasegawa 041 * @since JDK5.0, 042 */ 043public class DBType_YM extends DBType_YMD { 044 /** このプログラムのVERSION文字列を設定します。 {@value} */ 045 private static final String VERSION = "6.4.2.0 (2016/01/29)" ; 046 047 /** 048 * デフォルトコンストラクター 049 * 050 * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor. 051 */ 052 public DBType_YM() { super(); } // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。 053 054 /** 055 * String引数の文字列を+1した文字列を返します。 056 * ここでは、yyyyMM 形式のデータに、+1 するので、月を+1します。 057 * 058 * 0000XX と、9999XX は、引数の値そのままを返します。 059 * 引数が null の場合と、ゼロ文字列("")の場合は,物理的初期設定値(String getDefault()) 060 * の値を返します。 061 * それ以外の場合は、日付計算を行い、月を加算します。よって、年月フォーマットに 062 * 合わないデータを指定した場合は、エラーになりますので、ご注意ください。 063 * 064 * @og.rev 5.5.7.2 (2012/10/09) HybsDateUtil を利用するように修正します。 065 * 066 * @param value String引数の文字列 067 * 068 * @return String引数の文字列を+1した文字列 069 */ 070 @Override 071 public String valueAdd( final String value ) { 072 // 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 073 return value == null || value.isEmpty() 074 ? getDefault() 075 : value.startsWith( "0000" ) || value.startsWith( "9999" ) 076 ? value 077 : HybsDateUtil.getMonthPlus( value , 1 ); 078 079 } 080 081 /** 082 * String引数の文字列に、第2引数に指定の文字列(数字、日付等)を加算して返します。 083 * 084 * ここでは、yyyyMM 形式のデータに、月を加算します。 085 * 0000XX と、9999XX は、引数の値そのままを返します。 086 * 引数が null の場合と、ゼロ文字列("")の場合は,物理的初期設定値(String getDefault()) 087 * の値を返します。 088 * それ以外の場合は、日付計算を行い、月を加算します。よって、年月フォーマットに 089 * 合わないデータを指定した場合は、エラーになりますので、ご注意ください。 090 * 091 * @og.rev 5.6.0.3 (2012/01/24) ADD に、引数の値を加算する機能を追加します。 092 * 093 * @param value String引数 094 * @param add 加算する月文字列 095 * 096 * @return 引数の文字列に月を加算します。 097 */ 098 @Override 099 public String valueAdd( final String value,final String add ) { 100 if( value == null || value.isEmpty() ) { return getDefault(); } 101 if( value.startsWith( "0000" ) || value.startsWith( "9999" ) ) { return value; } // 特別な値 102 103 // 6.3.9.1 (2015/11/27) Found 'DD'-anomaly for variable(PMD) 104 // 6.4.1.1 (2016/01/16) PMD refactoring. Avoid if (x != y) ..; else ..; 105 final int addSu = add == null || add.isEmpty() ? 1 : Integer.parseInt( add ) ; // 6.3.9.1 (2015/11/27) 106 107 return HybsDateUtil.getMonthPlus( value , addSu ); 108 } 109 110 /** 111 * エディターで編集されたデータを登録する場合に、データそのものを 112 * 変換して、実登録データを作成します。 113 * 例えば,大文字のみのフィールドなら、大文字化します。 114 * 実登録データの作成は、DBType オブジェクトを利用しますので, 115 * これと Editor とがアンマッチの場合は、うまくデータ変換 116 * されない可能性がありますので、注意願います。 117 * 118 * @og.rev 5.5.7.2 (2012/10/09) HybsDateUtil を利用するように修正します。 119 * @og.rev 5.6.6.0 (2013/07/05) parseDate を改造し、日付の桁数指定を厳密に判定します。 120 * 121 * @param value (一般に編集データとして登録されたデータ) 122 * @return 修正後の文字列(一般にデータベースに登録するデータ) 123 */ 124 @Override 125 public String valueSet( final String value ) { 126 // 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 127 return value == null || value.isEmpty() ? getDefault() : HybsDateUtil.parseDate( value , 6 ); 128 129 } 130 131 /** 132 * データが登録可能かどうかをチェックします。 133 * データがエラーの場合は、そのエラー内容を返します。 134 * "000000" と、"999999" は、常に許可になります。 135 * 136 * @og.rev 5.6.0.3 (2012/01/24) 日付チェックの整合性まで含めたチェックを入れる。 137 * 138 * @param key キー 139 * @param value 値 140 * @param sizeX 整数部分の文字列の長さ 141 * @param sizeY 小数部分の文字列の長さ 142 * @param typeParam dbType パラメータ(文字パラメータ) 143 * @param isStrict 厳密にチェックするかどうか[true:する/false:標準的] 144 * 145 * @return エラー内容 146 * @og.rtnNotNull 147 */ 148 @Override 149 public ErrorMessage valueCheck( final String key ,final String value , 150 final int sizeX ,final int sizeY ,final String typeParam ,final boolean isStrict) { 151 152 final ErrorMessage msg = new ErrorMessage(); 153 if( value == null || value.isEmpty() ) { return msg; } 154 155 final int len = (sizeY == 0) ? sizeX : sizeX + sizeY + 1; 156 // 厳密に一致しないとエラーとする。 157 if( len != value.length() ) { 158 // 文字列の長さが指定の長さと異なります。 159 msg.addMessage( 0,ErrorMessage.NG,"ERR0011", key,value, 160 String.valueOf( value.length() ), String.valueOf( len ) ); 161 } 162 163 // 5.6.0.3 (2012/01/24) 文字の範囲チェック 164 String check = DBTypeCheckUtil.rangeCheck( value, '0', '9' ); 165 if( check != null ) { 166 // 指定の文字以外の文字が使われています。 167 msg.addMessage( 0,ErrorMessage.NG,"ERR0009", key,check ); 168 } 169 170 // 5.6.0.3 (2012/01/24) 日付文字の整合性チェック 171 // "0000","9999" で始まる日付は未条件許可。 172 check = DBTypeCheckUtil.ymdFormatCheck( value ); 173 if( check != null ) { 174 // 指定の文字以外の文字が使われています。 175 msg.addMessage( 0,ErrorMessage.NG,"ERR0009", key,check ); 176 } 177 178 // 3.6.0.0 (2004/09/22) dbType パラメータ(文字パラメータ)を使用したマッチチェック 179 check = DBTypeCheckUtil.matcheCheck( value,typeParam ); 180 if( check != null ) { 181 // 指定の文字以外の文字が使われています。 182 msg.addMessage( 0,ErrorMessage.NG,"ERR0009", key,check ); 183 } 184 185 return msg; 186 } 187}