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.hayabusa.common.HybsSystem; 019import org.opengion.hayabusa.db.AbstractEditor; 020import org.opengion.hayabusa.db.CellEditor; 021import org.opengion.hayabusa.db.DBColumn; 022import org.opengion.fukurou.util.XHTMLTag; 023import org.opengion.fukurou.util.TagBuffer; 024import org.opengion.fukurou.util.StringUtil; // 8.5.4.2 (2024/01/12) import static … を個別に記述 025 026// import static org.opengion.fukurou.util.StringUtil.isNull; // 6.1.1.0 (2015/01/17) 027 028/** 029 * HM ｴﾃﾞｨﾀｰは、ｶﾗﾑのﾃﾞｰﾀを時分編集する場合に使用するｸﾗｽです。 030 * 選択用ﾋﾟｯｶｰが付属します。 031 * 032 * 編集ﾊﾟﾗﾒｰﾀは、starthour , endhour , minutedivisions , showminutes の順に、 033 * CSV形式で与えます。 034 * 変数の数が少ない場合は、初期値が設定されます。 035 * 初期値は、starthour="6" endhour="20" minutedivisions="4" showminutes="true" です。 036 * 037 * ex) 6,19,4,true 038 * starthour ：ﾋﾟｯｶｰの開始時間(0-23) 039 * endhour ：ﾋﾟｯｶｰの終了時間(0-23) 040 * minutedivisions ：単位｢分｣の分割数。4なら15分単位。(2-60) 041 * showminutes ：分ﾋﾟｯｶｰの表示(true/false) 042 * usesecond ：秒付き(6桁、秒は00固定)で値を返すかどうか(true/false) 043 * layout ：表示の縦横(vertical/horizon) 044 * 045 * このｴﾃﾞｨﾀはeventColumnに対応していません。 046 * 047 * ｶﾗﾑの表示に必要な属性は、DBColumn ｵﾌﾞｼﾞｪｸﾄ より取り出します。 048 * このｸﾗｽは、DBColumn ｵﾌﾞｼﾞｪｸﾄ毎に1つ作成されます。 049 * 050 * @og.rev 5.6.5.2 (2013/06/21) 新規作成 051 * @og.rev 5.9.12.3 (2016/09/23) usesecond追加 052 * @og.rev 5.9.17.2 (2017/02/17) layout追加 053 * @og.rev 7.3.2.3 (2021/04/09) ｼｽﾃﾑ定数のICON_DIRやIMAGE_DIRを使用します。 054 * 055 * @og.group ﾃﾞｰﾀ編集 056 * 057 * @version 5.0 058 * @author Takahashi Masakazu 059 * @since JDK6.0, 060 */ 061public class Editor_HM extends AbstractEditor { 062 /** このﾌﾟﾛｸﾞﾗﾑのVERSION文字列を設定します。 {@value} */ 063 private static final String VERSION = "8.5.4.1 (2023/12/22)" ; 064 065 /** 7.3.2.3 (2021/04/09) ｼｽﾃﾑ定数のICON_DIRやIMAGE_DIRを使用します。 */ 066 private static final String JSP_ICON = HybsSystem.sys( "JSP_ICON" ) ; 067 068// private static final String PIC1 = "<img src=\"../image/clock.png\" class=\"clockpick\" valuefield=\""; // altは付けない 069 private static final String PIC1 = "<img src=\"" + JSP_ICON + "/clock.png\" class=\"clockpick\" valuefield=\""; // altは付けない 070 071 // 7.0.1.0 (2018/10/15) XHTML → HTML5 対応(空要素の、"／＞" 止めを、"＞" に変更します)。 072// private static final String PIC2 = " />"; 073 private static final String PIC2 = " >"; // 7.0.1.0 (2018/10/15) 074 075 // 6.9.8.0 (2018/05/28) 賛否両論:前のﾀｸﾞの終了属性を、入れておく事で、文字列連結数を減らす。(属性の飛ばしがないので、良しとします。) 076 private static final String OPT1 = "starthour=\""; 077// private static final String OPT2 = "endhour=\""; 078// private static final String OPT3 = "minutedivisions=\""; 079// private static final String OPT4 = "showminutes=\""; 080// private static final String OPT5 = "usesecond=\""; // 5.9.12.3 (2016/09/23) 081// private static final String OPT6 = "layout=\""; // 5.9.17.2 (2017/02/17) 082 private static final String OPT2 = "\" endhour=\""; 083 private static final String OPT3 = "\" minutedivisions=\""; 084 private static final String OPT4 = "\" showminutes=\""; 085 private static final String OPT5 = "\" usesecond=\""; // 5.9.12.3 (2016/09/23) 086 private static final String OPT6 = "\" layout=\""; // 5.9.17.2 (2017/02/17) 087 private static final String END_ATTR = "\" "; 088 089// private final String options; 090 private final String endTag; // 6.9.8.0 (2018/05/28) END_ATTR + options + PIC2 を、ｺﾝｽﾄﾗｸﾀｰで行う。 091 092 /** 6.9.8.0 (2018/05/28) disabled 時に、時間ﾋﾟｯｶｰを出さない対応 */ 093 private final boolean disabled ; 094 095 /** 096 * ﾃﾞﾌｫﾙﾄｺﾝｽﾄﾗｸﾀｰ。 097 * このｺﾝｽﾄﾗｸﾀｰで、基本ｵﾌﾞｼﾞｪｸﾄを作成します。 098 * 099 * @og.rev 6.9.8.0 (2018/05/28) disabled 時に、時間ﾋﾟｯｶｰを出さない対応 100 */ 101 public Editor_HM() { 102 super(); // 6.4.1.1 (2016/01/16) PMD refactoring. It is a good practice to call super() in a constructor 103 // 4.3.4.4 (2009/01/01) 104// options = null; // 6.9.8.0 (2018/05/28) options は、endTag に、入れておく。 105 disabled = false; // 6.9.8.0 (2018/05/28) disabled 時に、時間ﾋﾟｯｶｰを出さない対応 106 endTag = null; // 6.9.8.0 (2018/05/28) endTag は、disabled="false" なので、何でも良い。 107 } 108 109 /** 110 * DBColumnｵﾌﾞｼﾞｪｸﾄを指定したprivateｺﾝｽﾄﾗｸﾀｰ。 111 * 112 * @og.rev 6.9.8.0 (2018/05/28) disabled 時に、時間ﾋﾟｯｶｰを出さない対応 113 * 114 * @param clm DBColumnｵﾌﾞｼﾞｪｸﾄ 115 */ 116 private Editor_HM( final DBColumn clm ) { 117 super( clm ); 118 // 6.9.8.0 (2018/05/28) END_ATTR + options + PIC2 を、ｺﾝｽﾄﾗｸﾀｰで行う。 119// options = createOptions( clm.getEditorParam() ); 120 tagBuffer.add( XHTMLTag.inputAttri( attributes ) ); 121 122 disabled = "disabled".equalsIgnoreCase( attributes.get( "disabled" ) ); // 6.9.8.0 (2018/05/28) disabled対応 123 endTag = disabled ? null 124 : (END_ATTR + createOptions( clm.getEditorParam() ) + PIC2) ; // 6.9.8.0 (2018/05/28) options対応 125 } 126 127 /** 128 * 各ｵﾌﾞｼﾞｪｸﾄから自分のｲﾝｽﾀﾝｽを返します。 129 * 自分自身をｷｬｯｼｭするのか、新たに作成するのかは、各ｻﾌﾞｸﾗｽの実装に 130 * まかされます。 131 * 132 * @param clm DBColumnｵﾌﾞｼﾞｪｸﾄ 133 * 134 * @return CellEditorｵﾌﾞｼﾞｪｸﾄ 135 * @og.rtnNotNull 136 */ 137 public CellEditor newInstance( final DBColumn clm ) { 138 return new Editor_HM( clm ); 139 } 140 141 /** 142 * ﾃﾞｰﾀの編集用文字列を返します。 143 * 144 * @og.rev 6.9.8.0 (2018/05/28) disabled 時に、時間ﾋﾟｯｶｰを出さない対応 145 * @og.rev 8.0.3.0 (2021/12/17) ｲﾒｰｼﾞにname属性を付けるため、spanﾀｸﾞで囲います。 146 * @og.rev 8.5.4.1 (2023/12/22) HTML5廃止対応(8.0.3.0 (2021/12/17)の対応が無くても正常に動作するので削除) 147 * 148 * @param value 入力値 149 * 150 * @return ﾃﾞｰﾀの編集用文字列 151 * @og.rtnNotNull 152 */ 153 @Override 154 public String getValue( final String value ) { 155 // 8.5.5.1 (2024/02/29) PMD 7.0.0 OnlyOneReturn メソッドには終了ポイントが 1 つだけ必要 156 // 6.1.1.0 (2015/01/17) TagBufferの連結記述 157// final String tag = new TagBuffer( "input" ) 158 String tag = new TagBuffer( "input" ) 159 .add( "name" , name ) 160 // 8.5.4.2 (2024/01/12) import static … を個別に記述 161 .add( "id" , name , StringUtil.isNull( attributes.get( "id" ) ) ) // 4.3.7.2 (2009/06/15) 162 .add( "value" , value ) 163 .add( "size" , size1 ) 164 .add( tagBuffer.makeTag() ) 165 .makeTag(); 166 167// return tag + PIC1 + name + END_ATTR + options + PIC2 ; 168// return disabled ? tag // 6.9.8.0 (2018/05/28) disabled 時に、時間ﾋﾟｯｶｰを出さない対応 169// : tag + PIC1 + name + endTag ; // 6.9.8.0 (2018/05/28) END_ATTR + options + PIC2 を、ｺﾝｽﾄﾗｸﾀｰで行う。 170 171 // 8.5.5.1 (2024/02/29) PMD 7.0.0 OnlyOneReturn メソッドには終了ポイントが 1 つだけ必要 172 // 8.0.3.0 (2021/12/17) 173// if( disabled ) { 174// return tag; 175// } else { 176 if( !disabled ) { 177// final StringBuilder buf = new StringBuilder(BUFFER_MIDDLE) 178 tag = new StringBuilder(BUFFER_MIDDLE) 179 .append( tag ) 180// .append( "<span name=\"img" ).append( name ).append( "\">" ) // 8.0.3.0 (2021/12/17) 8.5.4.1 (2023/12/22) Delete 181 .append( PIC1 ) 182 .append( name ) 183 .append( endTag ) 184// .append( "</span>" ); // 8.0.3.0 (2021/12/17) 8.5.4.1 (2023/12/22) Delete 185 .toString(); 186// return buf.toString(); 187 } 188 return tag; 189 } 190 191 /** 192 * name属性を変えた、ﾃﾞｰﾀ表示/編集用のHTML文字列を作成します。 193 * ﾃｰﾌﾞﾙ上の name に 行番号を付加して、名前_行番号 で登録するｷｰを作成し、 194 * ﾘｸｴｽﾄ情報を1つ毎のﾌｨｰﾙﾄﾞで処理できます。 195 * 196 * @og.rev 6.9.8.0 (2018/05/28) disabled 時に、時間ﾋﾟｯｶｰを出さない対応 197 * @og.rev 8.0.3.0 (2021/12/17) ｲﾒｰｼﾞにname属性を付けるため、spanﾀｸﾞで囲います。 198 * @og.rev 8.5.4.1 (2023/12/22) HTML5廃止対応(8.0.3.0 (2021/12/17)の対応が無くても正常に動作するので削除) 199 * 200 * @param row 行番号 201 * @param value 入力値 202 * 203 * @return ﾃﾞｰﾀ表示/編集用の文字列 204 * @og.rtnNotNull 205 */ 206 @Override 207 public String getValue( final int row,final String value ) { 208 final String name2 = name + HybsSystem.JOINT_STRING + row ; 209 210 // 8.5.5.1 (2024/02/29) PMD 7.0.0 OnlyOneReturn メソッドには終了ポイントが 1 つだけ必要 211 // 6.1.1.0 (2015/01/17) TagBufferの連結記述 212// final String tag = new TagBuffer( "input" ) 213 String tag = new TagBuffer( "input" ) 214 .add( "name" , name2 ) 215 // 8.5.4.2 (2024/01/12) import static … を個別に記述 216 .add( "id" , name2 , StringUtil.isNull( attributes.get( "id" ) ) ) // 4.3.7.2 (2009/06/15) 217 .add( "value" , value ) 218 .add( "size" , size2 ) 219 .add( tagBuffer.makeTag() ) 220 .makeTag( row,value ); 221 222// return tag + PIC1 + name2 + END_ATTR + options + PIC2 ; 223// return disabled ? tag // 6.9.8.0 (2018/05/28) disabled 時に、時間ﾋﾟｯｶｰを出さない対応 224// : tag + PIC1 + name2 + endTag ; // 6.9.8.0 (2018/05/28) END_ATTR + options + PIC2 を、ｺﾝｽﾄﾗｸﾀｰで行う。 225 226 227 // 8.5.5.1 (2024/02/29) PMD 7.0.0 OnlyOneReturn メソッドには終了ポイントが 1 つだけ必要 228 // 8.0.3.0 (2021/12/17) 229// if( disabled ) { 230// return tag; 231// } else { 232 if( !disabled ) { 233// final StringBuilder buf = new StringBuilder(BUFFER_MIDDLE) 234 tag = new StringBuilder(BUFFER_MIDDLE) 235 .append( tag ) 236// .append( "<span name=\"img" ).append( name2 ).append( "\">" ) // 8.0.3.0 (2021/12/17) 8.5.4.1 (2023/12/22) Delete 237 .append( PIC1 ) 238 .append( name2 ) 239 .append( endTag ) 240// .append( "</span>" ); // 8.0.3.0 (2021/12/17) 8.5.4.1 (2023/12/22) Delete 241 .toString(); 242// return buf.toString(); 243 } 244 return tag; 245 } 246 247 /** 248 * 編集ﾊﾟﾗﾒｰﾀから、ｵﾌﾟｼｮﾝ文字列を作成します。 249 * 編集ﾊﾟﾗﾒｰﾀは、starthour , endhour , minutedivisions , showminutes の順に、 250 * CSV形式で与えます。 251 * 変数の数が少ない場合は、初期値が設定されます。 252 * 初期値は、starthour="6" endhour="20" minutedivisions="4" showminutes="true" です。 253 * 254 * @og.rev 5.9.12.3 (2016/09/23) usesecond対応 255 * @og.rev 5.9.17.2 (2017/02/15) layout対応 256 * @og.rev 6.9.8.0 (2018/05/28) 賛否両論:前のﾀｸﾞの終了属性を、入れておく事で、文字列連結数を減らす。(属性の飛ばしがないので、良しとします。) 257 * 258 * @param editPrm 編集ﾊﾟﾗﾒｰﾀ 259 * 260 * @return ﾊﾟﾗﾒｰﾀのｵﾌﾟｼｮﾝ文字列 261 * @og.rtnNotNull 262 */ 263 private String createOptions( final String editPrm ){ 264 if( editPrm == null ) { return "" ;} 265 266 // 6.0.2.5 (2014/10/31) null でないことがわかっている値の冗長な null ﾁｪｯｸがあります。 267 final String[] param = editPrm.split( "," ) ; 268 final String start = param.length > 0 ? param[0].trim() : "6" ; 269 final String end = param.length > 1 ? param[1].trim() : "20" ; 270 final String step = param.length > 2 ? param[2].trim() : "4" ; 271 final String min = param.length > 3 ? param[3].trim() : "true" ; 272 final String sec = param.length > 4 ? param[4].trim() : "false" ; // 5.9.12.3 (2016/09/23) 273 final String layout = param.length > 5 ? param[5].trim() : "vertical" ; // 5.9.17.2 (2017/02/15) 274 275// return OPT1 + start + END_ATTR + OPT2 + end + END_ATTR + OPT3 + step + END_ATTR + OPT4 + min + END_ATTR + OPT5 + sec + END_ATTR + OPT6 + layout + END_ATTR; // 5.9.12.3 (2016/09/23) 276 return OPT1 + start + OPT2 + end + OPT3 + step + OPT4 + min + OPT5 + sec + OPT6 + layout + END_ATTR; // 6.9.8.0 (2018/05/28) 277 } 278}