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.taglib; 017 018import org.opengion.hayabusa.common.HybsSystem; 019import org.opengion.hayabusa.resource.GUIInfo; 020import org.opengion.hayabusa.resource.RoleMode ; 021import org.opengion.hayabusa.db.DBLastSql; 022import org.opengion.fukurou.system.OgBuilder ; // 6.4.4.1 (2016/03/18) 023import org.opengion.fukurou.util.Attributes; 024import org.opengion.fukurou.util.XHTMLTag; 025import org.opengion.fukurou.util.StringUtil ; 026import org.opengion.fukurou.util.ToString; // 6.1.1.0 (2015/01/17) 027 028import static org.opengion.fukurou.util.StringUtil.nval ; 029 030/** 031 * ファイルアップロード/ダウンロードリンクを作成するタグです(通常は result_info.jsp に組込み)。 032 * 033 * 画面検索した結果を、ダウンロードしたり、アップロードする機能は、画面リソースの 034 * ロール制御で管理しています。 035 * ただし、デフォルトで、以下の制限が掛かっています。 036 * 037 * ファイルダウンロード 038 * ・command="NEW|RENEW|FIRST|LAST|PREV|NEXT|VIEW|RESET" のみ 039 * ファイルアップロード 040 * ・command="COPY|INSERT" のみ 041 * 042 * 5.7.8.1 (2014/07/18) 043 * addDownCmnd と、addUpldCmnd を指定すれば、ダウンロード、アップロードできる 044 * command を増やすことが可能です。 045 * 046 * また、typeDownload="true" にするとDownload 処理を行う為の前処理を実施します。 047 * Download 処理を行うには、指定の画面(呼び出し元)と、抜き出した時の 048 * DBTableModel がマッチしているか判定します。 049 * また、DBTableModel が存在しない、または、不備な場合(オーバーフロー)は、 050 * 最終SQLを実行する必要があり、そもそも、抜出処理が出来ない状態では、 051 * エラーを返す必要があります。 052 * それら、一連のDownload 処理を行うかどうかを指定します。 053 * true の場合、session の HybsSystem.DB_LAST_SQL_KEY に格納された 054 * DBLastSql オブジェクトを取得し、scope が request または、overflow が 055 * true の場合に、BODY部を実行します。(通常、queryタグを記述します。) 056 * query の出力先は、scope を request にします。 057 * それ以外は、tableId から取り出した DBTableModel を、scope = "request" 058 * に(アドレスのみ)コピーします。 059 * writeTable タグでは、scope = "request" から、DBTableModel を取り出します。 060 061 * @og.formSample 062 * ●形式:一般ユーザーが直接組み込むことはありません。 063 * ●body:あり(EVAL_BODY_BUFFERED:BODYを評価し、{@XXXX} を解析します) 064 * 065 * ●Tag定義: 066 * <og:fileUD 067 * command 【TAG】command を指定します 068 * downloadImg 【TAG】ダウンロード時のアイコンを指定します(初期値:"{@SYS.JSP}/image/fileDownload.gif") 069 * downloadJsp 【TAG】ダウンロード時の呼び出しJSPを指定します(初期値:"{@SYS.JSP}/common/fileDownload.jsp") 070 * uploadImg 【TAG】アップロード時のアイコンを指定します(初期値:"{@SYS.JSP}/image/fileUpload.gif") 071 * uploadJsp 【TAG】アップロード時の呼び出しJSPを指定します(初期値:"{@SYS.JSP}/common/fileUpload.jsp") 072 * imgWidth 【TAG】アイコン幅サイズ(px)を指定します(初期値:20px) 073 * imgHeight 【TAG】アイコン高さサイズ(px)を指定します(初期値:20px) 074 * filename 【TAG】ダウンロード時ファイル名を指定します(初期値:"{@GUI.LABEL}") 6.8.1.4 (2017/08/25) 拡張子はつけません。 075 * addDownCmnd 【TAG】ダウンロード時のコマンドを追加指定できます(初期値:null) 076 * addUpldCmnd 【TAG】アップロード時のコマンドを追加指定できます(初期値:null) 077 * roles 【TAG】ロールズをセットします 078 * target 【TAG】ダウンロード文書を表示させるフレーム、またはウィンドウの名前を指定します 079 * errorMsg 【TAG】ダウンロード出来ない場合のエラーメッセージIDを指定します(初期値:ERR0028) 080 * typeDownload 【TAG】Download 処理を行うかどうかを指定します(初期値:false) 081 * useEditLink 【TAG】編集リンク自体を出すかどうかどうか(初期値:true) 082 * editImg 【TAG】編集アイコンを指定します(初期値:"{@SYS.JSP}/image/edit.png") 083 * clmEdit 【TAG】編集時にカラム編集タブを表示するかどうか(初期値:true) 084 * debug 【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false) 085 * > ... Body ... 086 * </og:fileUD> 087 * 088 * ●使用例 089 * <og:fileUD command="{@command}" /> 090 * 091 * <og:fileUD 092 * command = command設定 (ダウンロード="NEW|RENEW|FIRST|LAST|PREV|NEXT|VIEW" 、 アップロード="COPY|INSERT") 093 * [ downloadImg ] = "{@SYS.JSP}/image/fileDownload.gif" ダウンロード時のアイコン 094 * [ downloadJsp ] = "{@SYS.JSP}/common/fileDownload.jsp" ダウンロード時の呼び出しJSP 095 * [ uploadImg ] = "{@SYS.JSP}/image/fileUpload.gif" アップロード時のアイコン 096 * [ uploadJsp ] = "{@SYS.JSP}/common/filePopup.jsp" アップロード時の呼び出しJSP 097 * [ imgWidth ] = "20px" アイコン幅サイズ(px) 098 * [ imgHeight ] = "20px" アイコン高さサイズ(px) 099 * [ filename ] = "{@GUI.LABEL}.xls" ダウンロード時ファイル名 100 * [ roles ] = "GE|DOC" アクセスロールズ 101 * [ target ] = "_blank" ダウンロードファイルを開くターゲット 102 * [ errorMsg ] = "ERR0042" エラーメッセージID 103 * [ typeDownload] = "false/true" Download 処理を行うかどうか(初期値:false) 104 * /> 105 * 106 * @og.group ファイルアップロード/ダウンロード 107 * 108 * @og.rev 4.3.0.0 (2008/07/04) 新規追加 109 * @og.rev 5.7.4.1 (2014/03/15) エラーメッセージ変更 110 * @og.rev 5.9.32.1 (2018/05/08) URLチェック対応 111 * 112 * @version 4.0 113 * @author Kazuhiko Hasegawa 114 * @since JDK5.0, 115 */ 116public class FileUDTag extends CommonTagSupport { 117 /** このプログラムのVERSION文字列を設定します。 {@value} */ 118 private static final String VERSION = "6.8.1.4 (2017/08/25)" ; 119 private static final long serialVersionUID = 681420170825L ; 120 121 private String sysJsp = HybsSystem.sys( "JSP" ); 122 123 private String command ; // ダウンロード="NEW|RENEW" 、アップロード="COPY|INSERT" 124 private String downloadImg = sysJsp + "/image/fileDownload.gif"; // ダウンロード時のアイコン 125 private String downloadJsp = sysJsp + "/common/fileDownload.jsp"; // ダウンロード時の呼び出しJSP 126 private String uploadImg = sysJsp + "/image/fileUpload.gif"; // アップロード時のアイコン 127 private String uploadJsp = sysJsp + "/common/filePopup.jsp"; // アップロード時の呼び出しJSP 128 private String imgWidth = "20px"; // アイコン幅サイズ(px) 129 private String imgHeight = "20px"; // アイコン高さサイズ(px) 130 private String filename ; // ダウンロード時ファイル名("{@GUI.LABEL}") 6.8.1.4 (2017/08/25) 拡張子はつけません。 131 private String roles ; // アクセスロールズ 132 private String target ; // ダウンロードファイルを開くターゲット 133 private String errorMsg = "ERR0042"; // 出力対象データが見つかりませんでした。再度検索して下さい。 5.7.4.1 (2014/03/15) 134 private boolean isError ; 135 private boolean typeDownload ; // Download 処理を行うかどうか(初期値:false) 136 private boolean isEdit = true; // 5.6.0.2 (2013/01/19) ロールのisEditとほぼ同等。clmEdit用。 137 private boolean useEditLink = true; // 5.7.5.0 (2014/04/04) 編集リンク自体を出すかどうかどうか(初期値:true) 138 139 private String addDownCmnd ; // 5.7.8.1 (2014/07/18) ダウンロード時のコマンドを追加 140 private String addUpldCmnd ; // 5.7.8.1 (2014/07/18) アップロード時のコマンドを追加 141 142 private static final String EDIT_GAMENID= "14_EDIT"; // 編集画面の画面ID 143 private String editImg = sysJsp + "/image/edit.png"; // 編集時のアイコン 144 145 // 5.9.32.1 (2018/05/08) URLチェック対応 146 private boolean useURLCheck = HybsSystem.sysBool( "USE_FILEUD_URL_CHECK" ); // Ver5 では、FILEUD_URL_CHECK 147 private static final long URL_CHECK_TIME = 1000*60*60*24; // 初期値:24時間(とりあえず固定値) 148 // private String urlCheckCrypt = HybsSystem.sys( "URL_CHECK_CRYPT" ); // 将来使用するかも 149 150 /** 151 * デフォルトコンストラクター 152 * 153 * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor. 154 */ 155 public FileUDTag() { super(); } // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。 156 157 /** 158 * Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。 159 * 160 * @og.rev 5.1.6.0 (2010/05/01) 画面項目並べ替え対応 161 * @og.rev 6.2.0.1 (2015/03/06) 画面IDのキーを"GAMENID" に統一します。 162 * 163 * @return 後続処理の指示(SKIP_BODY) 164 */ 165 @Override 166 public int doStartTag() { 167 168 if( typeDownload ) { 169 final DBLastSql lastSql = (DBLastSql)getSessionAttribute( HybsSystem.DB_LAST_SQL_KEY ); 170 if( lastSql != null ) { 171 final String guikey = getRequest().getParameter( "GAMENID" ); // 6.2.0.1 (2015/03/06) 画面IDのキーを"GAMENID" に統一します。 172 if( lastSql.isGuiMatch( guikey ) ) { 173 // view タグで仕込んだ clmNames を、Request 変数に設定します。 174 setRequestAttribute( "DB.CLM_NAMES" , lastSql.getClmNames() ); 175 // 5.1.6.0 (2010/05/01) 画面項目並べ替え対応 176 setRequestAttribute( "DB.VIEW_CLM_NAMES" , lastSql.getViewClmNames() ); 177 setRequestAttribute( "DB.VIEW_EDITABLE" , Boolean.toString( lastSql.isViewEditable() ) ); 178 179 // 6.3.9.0 (2015/11/06) Deeply nested if..then statements are hard to read (PMD) 180 if( lastSql.isRequest() && getUserInfo( "LASTSQL" ) != null ) { 181 return EVAL_BODY_BUFFERED ; // Body を評価する。( extends BodyTagSupport 時) 182 } 183 184 final String tableId = lastSql.getTableId(); 185 // セッションのDBTableModelを、そのまま、リクエストに入れているだけなので、実態は同じ。 186 setRequestAttribute( HybsSystem.TBL_MDL_KEY, getSessionAttribute( tableId ) ); 187 return SKIP_BODY ; // Body を評価しない 188 } 189 } 190 191 // 処理が実行できない場合、エラーを出力します。 192 jspPrint( getResource().getLabel( errorMsg ) ); 193 isError = true; 194 } 195 196 return SKIP_BODY ; // Body を評価しない 197 } 198 199 /** 200 * Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。 201 * 202 * @og.rev 4.3.0.1 (2008/08/11) callBack パラメータの設定漏れ修正、引数から見直し 203 * @og.rev 5.1.6.0 (2010/05/01) 帳票画面定義機能対応 204 * @og.rev 5.1.7.0 (2010/06/01) 進む・戻るボタンでもExcel出力ボタンを出す 205 * @og.rev 5.3.6.0 (2011/06/01) Edit機能見直し 206 * @og.rev 5.3.7.0 (2011/07/01) Excel取込で画面IDとアドレスが異なる場合にエラーとなるバグを修正 207 * @og.rev 5.3.7.0 (2011/07/01) 編集画面をリサイズできるように対応します。 208 * @og.rev 5.3.7.0 (2011/07/01) PL/SQLを利用した検索でファイルダウンロードが出来るように対応します。 209 * @og.rev 5.4.2.0 (2011/12/01) 画面リソースで画面編集機能のON/OFFを設定できるようにする。 210 * @og.rev 5.5.2.4 (2012/05/16) nullに対する冗長な比較 211 * @og.rev 5.5.5.2 (2012/08/20) 画面リソースのoモード対応 212 * @og.rev 5.5.6.2 (2012/09/24) makeTagのtarget対応 213 * @og.rev 5.6.0.2 (2013/01/19) editモードのisEditコントロール対応 214 * @og.rev 5.7.5.0 (2014/04/04) 編集リンク自体を出すかどうかどうか(初期値:true) 215 * @og.rev 5.7.8.1 (2014/07/18) command="RESET" 時に、ダウンロードリンクを表示 216 * @og.rev 5.7.8.1 (2014/07/18) addDownCmnd , addUpldCmndを追加 217 * @og.rev 6.2.0.1 (2015/03/06) 画面IDのキーを"GAMENID" に統一します。 218 * @og.rev 6.2.2.0 (2015/03/27) ファイルの拡張子を、".xls" から、システムリソースの TABLE_WRITER_EXCEL_TYPE に変更 219 * @og.rev 6.3.1.0 (2015/06/28) 4:個人設定可のリソースの取得方法に修正(バグFix)。TABLE_WRITER_EXCEL_TYPE 220 * @og.rev 6.3.4.0 (2015/08/01) 14_EDIT の指定で、フォルダではなく、index.jspまで指定します。 221 * @og.rev 6.4.4.1 (2016/03/18) StringBuilderの代わりに、OgBuilderを使用する。 222 * @og.rev 6.8.1.3 (2017/08/04) 日本語のeditNameが、ネイティブモードでHTTP400 エラーになる。・・・ 5.10.0.2 (2018/06/22) 223 * @og.rev 6.8.1.4 (2017/08/25) filename に、拡張子はつけません。 224 * @og.rev 5.9.32.1 (2018/05/11) makeTagに、URLチェック対応のための引数を追加 225 * 226 * @return 後続処理の指示 227 */ 228 @Override 229 public int doEndTag() { 230 debugPrint(); 231 232 if( isError ) { return SKIP_PAGE ; } // ページの残りの処理を行わない。 233 if( typeDownload ) { return EVAL_PAGE ; } // ページの残りを評価する。 234 235 boolean isDownload ; 236 // 5.7.8.1 (2014/07/18) command="RESET" 時に、ダウンロードリンクを表示 237 if( "NEW".equals( command ) || "RENEW".equals( command ) 238 || "FIRST".equals( command ) || "LAST".equals( command ) 239 || "PREV".equals( command ) || "NEXT".equals( command ) 240 || "VIEW".equals( command ) || "RESET".equals( command ) ) { 241 isDownload = true; 242 } 243 else if( "COPY".equals( command ) || "INSERT".equals( command ) ) { 244 isDownload = false; 245 } 246 // 5.7.8.1 (2014/07/18) addDownCmnd , addUpldCmndを追加 247 else if( addDownCmnd != null && addDownCmnd.equals( command ) ) { 248 isDownload = true; 249 } 250 else if( addUpldCmnd != null && addUpldCmnd.equals( command ) ) { 251 isDownload = false; 252 } 253 else { 254 return EVAL_PAGE ; 255 } 256 257 byte bitMode ; 258 // 6.4.1.1 (2016/01/16) PMD refactoring. Avoid if (x != y) ..; else ..; 259 if( roles == null ) { 260 final GUIInfo guiInfo = (GUIInfo)getSessionAttribute( HybsSystem.GUIINFO_KEY ); 261 bitMode = guiInfo.getBitMode(); 262 } 263 else { 264 final RoleMode roleMode = RoleMode.newInstance( roles ); 265 final RoleMode userRoleMode = getUser().getRoleMode(); 266 bitMode = userRoleMode.getAccessBitMode( roleMode ); 267 } 268 269 if( filename == null ) { 270 // 6.2.2.0 (2015/03/27) ファイルの拡張子を、".xls" から、システムリソースの TABLE_WRITER_EXCEL_TYPE に変更 271 // 6.3.1.0 (2015/06/28) 4:個人設定可のリソースの取得方法に修正(バグFix) 272 // 6.8.1.4 (2017/08/25) filename に、拡張子はつけません。 273 filename = getGUIInfoAttri( "LABEL" ); 274 } 275 final String guikey = getGUIInfoAttri( "KEY" ); // 4.3.0.1 (2008/08/11) 276 if( isDownload ) { 277 if( RoleMode.isDownload( bitMode ) ) { 278 // 4.3.0.1 (2008/08/11) callBack パラメータの設定漏れ修正、引数から見直し 279 // <og:link href="{@SYS.JSP}/common/fileDownload.jsp" target="_blank" useGamenId="false" 280 // keys="filename,h_clms" vals="{@GUI.LABEL}.xls,{@h_clms}" > 281 // 5.3.7.0 (2011/07/01) PL/SQLを利用した検索でファイルダウンロードが出来るように対応します。 282 // 6.2.0.1 (2015/03/06) 画面IDのキーを"GAMENID" に統一します。 283 final String href = downloadJsp + "?command=RENEW&GAMENID=" + guikey + "&filename=" + StringUtil.urlEncode( filename ) ; 284 285// jspPrint( makeTag( downloadImg,href,"Download File", target ) ); // 5.5.6.2 (2012/09/24) 286 jspPrint( makeTag( downloadImg,href,"Download File", target,true ) ); // 5.9.32.1 (2018/05/11) URLチェック対応 287 288 // 5.1.6.0 (2010/05/01) 帳票画面定義機能対応 289 // 5.3.6.0 (2011/06/01) Edit機能見直し 290 final GUIInfo editGui = getUser().getGUIInfo( EDIT_GAMENID ); 291 // 5.7.5.0 (2014/04/04) 編集リンク自体を出すかどうかどうか(初期値:true) 292 // 6.1.0.0 (2014/12/26) refactoring:Prefer StringBuffer over += for concatenating strings 293 if( editGui != null && useEditLink ) { 294 final String editName = getRequestValue( "editName" ); 295 296 final OgBuilder buf = new OgBuilder() 297 .append( "javascript:ogOpen('" , sysJsp ) // 前後に分断されるので、注意 298 .append( "/" , editGui.getAddress() ) // 6.3.4.0 (2015/08/01) 299 .append( "/index.jsp?command=NEW&GAMENID=" , guikey ) // 6.2.0.1 (2015/03/06) 画面IDのキーを"GAMENID" に統一します。 300 .appendIf( editName != null // 5.5.2.4 (2012/05/16) nullに対する冗長な比較 301 , "&editName=" , StringUtil.urlEncode( editName ) ) // 6.8.1.3 (2017/08/04) 日本語のeditNameが、ネイティブモードでHTTP400 エラーになる。 302 .appendIf( RoleMode.isEdit( bitMode ) && isEdit // 5.6.0.2(2013/01/09) 303 , "&edit=true" ) 304 .append( "&fullEdit=" , String.valueOf( RoleMode.isFullEdit( bitMode ) ) ) 305 .append( "',null,null,'width=800px,height=350px,top=350,left=100,resizable=yes',false);" ); 306 // 6.8.1.3 (2017/08/04) a href ではなく、a onClick にする。 307// final String editLink = makeTag( editImg,buf.toString(),"Edit",null ); 308 final String editLink = makeTag( editImg,buf.toString(),"Edit",null,false ); // 5.9.32.1 (2018/05/11) URLチェック対応 309 jspPrint( editLink.replace( "href","onClick" ) ); // 6.8.1.3 (2017/08/04) makeTag を修正したくなかった。 310 } 311 } 312 } 313 else { 314 if( RoleMode.isUpload( bitMode ) ) { 315 // 4.3.0.1 (2008/08/11) callBack パラメータの設定漏れ修正、引数から見直し 316 // <og:link href="{@SYS.JSP}/common/filePopup.jsp" keys="callBack" vals="{@GUI.KEY}/{@SESSION.JSPID}" > 317 318 final String jspId = (String)getSessionAttribute( "JSPID" ); 319 // 5.3.7.0 (2011/07/01) Excel取込で画面IDとアドレスが異なる場合にエラーとなるバグを修正 320 String callBack = getGUIInfoAttri( "ADDRESS" ) + "/" + jspId + "?GAMENID=" + guikey; 321 callBack = StringUtil.urlEncode( callBack ); 322 final String href = uploadJsp + "?callBack=" + callBack; 323 324// jspPrint( makeTag( uploadImg,href,"Upload File",target ) ); // 5.5.6.2 (2012/09/24) 325 jspPrint( makeTag( uploadImg,href,"Upload File",target,false ) ); // 5.9.32.1 (2018/05/11) URLチェック対応 326 } 327 } 328 329 return EVAL_PAGE ; 330 } 331 332 /** 333 * タグリブオブジェクトをリリースします。 334 * キャッシュされて再利用されるので、フィールドの初期設定を行います。 335 * 336 * @og.rev 5.7.4.1 (2014/03/15) エラーメッセージ変更 337 * @og.rev 5.7.5.0 (2014/04/04) useEditLink 追加 338 * @og.rev 5.7.8.1 (2014/07/18) addDownCmnd,addUpldCmnd 追加 339 * @og.rev 5.9.32.1 (2018/05/08) URLチェック対応 340 */ 341 @Override 342 protected void release2() { 343 super.release2(); 344 sysJsp = HybsSystem.sys( "JSP" ); 345 command = null; // ダウンロード="NEW|RENEW|FIRST|LAST|PREV|NEXT|VIEW|RESET" 、アップロード="COPY|INSERT" 346 downloadImg = sysJsp + "/image/fileDownload.gif"; // ダウンロード時のアイコン 347 downloadJsp = sysJsp + "/common/fileDownload.jsp"; // ダウンロード時の呼び出しJSP 348 uploadImg = sysJsp + "/image/fileUpload.gif"; // アップロード時のアイコン 349 uploadJsp = sysJsp + "/common/filePopup.jsp"; // アップロード時の呼び出しJSP 350 imgWidth = "20px"; // アイコン幅サイズ(px) 351 imgHeight = "20px"; // アイコン高さサイズ(px) 352 filename = null; // ダウンロード時ファイル名("{@GUI.LABEL}") 6.8.1.4 (2017/08/25) 拡張子はつけません。 353 roles = null; // アクセスロールズ 354 target = null; // ダウンロードファイルを開くターゲット 355 errorMsg = "ERR0042"; // 出力対象データが見つかりませんでした。再度検索して下さい。 5.7.4.0 (2014/03/15) 356 typeDownload = false; // Download 処理を行うかどうか(初期値:false) 357 isError = false; 358 editImg = sysJsp + "/image/edit.png"; // 編集時のアイコン 359 isEdit = true; // 5.6.0.2 (2013/01/19) 360 useEditLink = true; // 5.7.5.0 (2014/04/04) 追加 361 addDownCmnd = null; // 5.7.8.1 (2014/07/18) ダウンロード時のコマンドを追加 362 addUpldCmnd = null; // 5.7.8.1 (2014/07/18) アップロード時のコマンドを追加 363 useURLCheck = HybsSystem.sysBool( "USE_FILEUD_URL_CHECK" ); // 5.9.32.1 (2018/05/11) 364 // urlCheckCrypt = HybsSystem.sys( "URL_CHECK_CRYPT" ); // 5.9.32.1 (2018/05/11) 365 } 366 367 /** 368 * リンクを作成します。 369 * 370 * @og.rev 4.3.0.1 (2008/08/11) callBack パラメータの設定漏れ修正、引数から見直し 371 * @og.rev 5.5.6.2 (2012/09/24) tgt引数追加 372 * @og.rev 6.4.2.0 (2016/01/29) alt属性にtitle属性を追記。 373 * @og.rev 5.9.32.1 (2018/05/08) URLチェック対応 374 * 375 * @param imgsrc イメージソース 376 * @param href リンクのURL 377 * @param alt イメージの説明文書 378 * @param tgt HTMLのtarget 379 * @param useChk urlCheck対象 [true:useURLCheckの条件に応じて、チェック用URLを作成する。/false:常につけない] 380 * 381 * @return リンク文字列 382 * @og.rtnNotNull 383 */ 384// private String makeTag( final String imgsrc, final String href, final String alt, final String tgt ) { // 5.5.6.2 (2012/09/24) 385 private String makeTag( final String imgsrc, final String href, final String alt, final String tgt, final boolean useChk ) { // 5.9.32.1 (2018/05/08) 386 // linkのBODY部にセットするイメージタグの作成 387 // 6.1.1.0 (2015/01/17) Attributesの連結記述 388 final String img = XHTMLTag.img( 389 new Attributes() 390 .set( "width" , imgWidth ) 391 .set( "height" , imgHeight ) 392 .set( "src" , imgsrc ) 393 .set( "alt" , alt ) 394 .set( "title" , alt ) // 6.4.2.0 (2016/01/29) 395 ); 396 397 // 5.9.32.1 (2018/05/11) urlCheck 398 final String tag = useURLCheck && useChk 399 ? XHTMLTag.addURLCheckKey( href, HybsSystem.URL_CHECK_KEY, getUser().getUserID(), System.currentTimeMillis() + URL_CHECK_TIME ) 400 : href ; 401 402 // 6.1.1.0 (2015/01/17) Attributesの連結記述 403 return XHTMLTag.link( 404 new Attributes() 405// .set( "href" , href ) 406 .set( "href" , tag ) // 5.9.32.1 (2018/05/11) urlCheck 407 .set( "body" , img ) 408 .set( "target" , tgt ) // 5.5.6.2 (2012/09/24) 409 ); 410 } 411 412 /** 413 * 【TAG】command を指定します。 414 * 415 * @og.tag 416 * command を指定します。 417 * ダウンロードは、"NEW|RENEW|FIRST|LAST|PREV|NEXT|VIEW|RESET" のみ有効です。 418 * アップロードは、"COPY|INSERT" のみ有効です。 419 * それ以外のコマンドでは、アイコンは表示されません。 420 * 例えば、NEXT/PREV など。 421 * 422 * @param cmd コマンド [NEW/RENEW/FIRST/LAST/PREV/NEXT/VIEW/RESET/COPY/INSERT] 423 * @see #setAddDownCmnd( String ) 424 * @see #setAddUpldCmnd( String ) 425 * @see #setCommand( String ) 426 */ 427 public void setCommand( final String cmd ) { 428 command = nval( getRequestParameter( cmd ),command ); 429 } 430 431 /** 432 * 【TAG】ダウンロード時のアイコンを指定します(初期値:"{@SYS.JSP}/image/fileDownload.gif")。 433 * 434 * @og.tag 435 * ダウンロード時に表示されるアイコンを指定します。 436 * 初期値:"{@SYS.JSP}/image/fileDownload.gif" です。 437 * 438 * @param img ダウンロード時のアイコン 439 */ 440 public void setDownloadImg( final String img ) { 441 downloadImg = nval( getRequestParameter( img ),downloadImg ); 442 } 443 444 /** 445 * 【TAG】ダウンロード時の呼び出しJSPを指定します(初期値:"{@SYS.JSP}/common/fileDownload.jsp")。 446 * 447 * @og.tag 448 * ダウンロード時に呼び出されるJSPファイル名を指定します。 449 * 初期値:"{@SYS.JSP}/common/fileDownload.jsp" です。 450 * 451 * @param file ダウンロード時の呼び出しJSP 452 */ 453 public void setDownloadJsp( final String file ) { 454 downloadJsp = nval( getRequestParameter( file ),downloadJsp ); 455 } 456 457 /** 458 * 【TAG】アップロード時のアイコンを指定します(初期値:"{@SYS.JSP}/image/fileUpload.gif")。 459 * 460 * @og.tag 461 * アップロード時に表示されるアイコンを指定します。 462 * 初期値:"{@SYS.JSP}/image/fileUpload.gif" です。 463 * 464 * @param img アップロード時のアイコン 465 */ 466 public void setUploadImg( final String img ) { 467 uploadImg = nval( getRequestParameter( img ),uploadImg ); 468 } 469 470 /** 471 * 【TAG】アップロード時の呼び出しJSPを指定します(初期値:"{@SYS.JSP}/common/fileUpload.jsp")。 472 * 473 * @og.tag 474 * アップロード時に呼び出されるJSPファイル名を指定します。 475 * 初期値:"{@SYS.JSP}/common/fileUpload.jsp" です。 476 * 477 * @param file アップロード時の呼び出しJSP 478 */ 479 public void setUploadJsp( final String file ) { 480 uploadJsp = nval( getRequestParameter( file ),uploadJsp ); 481 } 482 483 /** 484 * 【TAG】アイコン幅サイズ(px)を指定します(初期値:20px)。 485 * 486 * @og.tag 487 * アップロード/ダウンロードのアイコンを表示する際の幅サイズ(px)を指定します。 488 * ファイルサイズは、アップロード/ダウンロード共通です。 489 * 初期値は、20px です。 490 * 491 * @param width アイコン幅サイズ(px) 492 */ 493 public void setImgWidth( final String width ) { 494 imgWidth = nval( getRequestParameter( width ),imgWidth ); 495 } 496 497 /** 498 * 【TAG】アイコン高さサイズ(px)を指定します(初期値:20px)。 499 * 500 * @og.tag 501 * アップロード/ダウンロードのアイコンを表示する際の高さサイズ(px)を指定します。 502 * ファイルサイズは、アップロード/ダウンロード共通です。 503 * 初期値は、20px です。 504 * 505 * @param height アイコン高さサイズ(px) 506 */ 507 public void setImgHeight( final String height ) { 508 imgHeight = nval( getRequestParameter( height ),imgHeight ); 509 } 510 511 /** 512 * 【TAG】ダウンロード時ファイル名を指定します(初期値:"{@GUI.LABEL}")。 513 * 514 * @og.tag 515 * ダウンロード時のファイル名を指定します 516 * 通常は、画面のラベル(言語対応)で、拡張子は付けません。ファイルの種類に応じて、拡張子を自動設定します。 517 * 518 * @og.rev 6.8.1.4 (2017/08/25) 拡張子はつけません。 519 * 520 * @param file ダウンロード時ファイル名 ("{@GUI.LABEL}") 521 */ 522 public void setFilename( final String file ) { 523 filename = nval( getRequestParameter( file ),filename ); 524 } 525 526 /** 527 * 【TAG】ロールズをセットします。 528 * 529 * @og.tag 530 * ここで指定したロールを元に、ユーザー毎のアクセス許可がチェックされます。 531 * アクセス許可されないと、表示されません。 532 * このロールを指定しない場合は、画面のロールが使用されます。 533 * 534 * @param rls パラメータ 535 */ 536 public void setRoles( final String rls ) { 537 roles = nval( getRequestParameter( rls ),roles ); 538 } 539 540 /** 541 * 【TAG】ダウンロード文書を表示させるフレーム、またはウィンドウの名前を指定します。 542 * 543 * @og.tag フレーム名(ターゲット属性)を設定します。 544 * 545 * @param name ダウンロード文書のフレーム名(ターゲット属性) 546 */ 547 public void setTarget( final String name ) { 548 target = nval( getRequestParameter( name ),target ); 549 } 550 551 /** 552 * 【TAG】Download 処理を行うかどうか[true:実行する/false:リンク作成]を指定します(初期値:false)。 553 * 554 * @og.tag 555 * Download 処理を行うには、指定の画面(呼び出し元)と、抜き出した時の 556 * DBTableModel がマッチしているか判定します。 557 * また、DBTableModel が存在しない、または、不備な場合(オーバーフロー)は、 558 * 最終SQLを実行する必要があり、そもそも、抜出処理が出来ない状態では、 559 * エラーを返す必要があります。 560 * それら、一連のDownload 処理を行うかどうかを指定します。 561 * true の場合、session の HybsSystem.DB_LAST_SQL_KEY に格納された 562 * DBLastSql オブジェクトを取得し、scope が request または、overflow が 563 * true の場合に、BODY部を実行します。(通常、queryタグを記述します。) 564 * query の出力先は、scope を request にします。 565 * それ以外は、tableId から取り出した DBTableModel を、scope = "request" 566 * に(アドレスのみ)コピーします。 567 * writeTable タグでは、scope="request" から、DBTableModel を取り出します。 568 * 569 * 初期値は、false(抜き出しでは無くリンク作成) です。 570 * 571 * @param type Download処理 [true:実行する/false:リンク作成] 572 */ 573 public void setTypeDownload( final String type ) { 574 typeDownload = nval( getRequestParameter( type ),typeDownload ); 575 } 576 577 /** 578 * 【TAG】ダウンロード出来ない場合のエラーメッセージIDを指定します(初期値:ERR0042)。 579 * 580 * @og.tag 581 * DBTableModel が、最後に作成された画面と、メモリ中の DBLastSql オブジェクトが 582 * 管理している情報が異なる場合は、ダウンロード出来ません。 583 * 同様に、DBLastSql オブジェクト 自身が作成されていない場合も出来ません。 584 * そのようなケースに表示するエラーメッセージのメッセージIDを指定します。 585 * 引数は、指定できません。 586 * 初期値は、『ERR0042:出力対象データが見つかりませんでした。再度検索して下さい。』 です。 587 * 588 * @param msg ダウンロード文書のフレーム名(ターゲット属性) 589 */ 590 public void setErrorMsg( final String msg ) { 591 errorMsg = nval( getRequestParameter( msg ),errorMsg ); 592 } 593 594 /** 595 * 【TAG】編集アイコンを指定します(初期値:"{@SYS.JSP}/image/edit.png")。 596 * 597 * @og.tag 598 * 編集アイコンを指定します。 599 * 初期値:"{@SYS.JSP}/image/edit.png" です。 600 * 601 * @og.rev 5.1.6.0 (2010/05/01) 新規追加 602 * 603 * @param img アップロード時のアイコン 604 */ 605 public void setEditImg( final String img ) { 606 editImg = nval( getRequestParameter( img ),editImg ); 607 } 608 609 /** 610 * 【TAG】Edit画面でカラム編集タブを出すかどうか[true:出す/false:出さない]設定します(初期値:true:出す)。 611 * 612 * @og.tag 613 * falseを指定するとカラム編集タブを出さない。 614 * 615 * @param type 編集タブ出力 [true:出す/false:出さない] 616 */ 617 public void setClmEdit( final String type ) { 618 isEdit = nval( getRequestParameter( type ),isEdit ); 619 } 620 621 /** 622 * 【TAG】Edit画面でカラム編集リンクを出力するかどうか[true:する/false:しない]設定します(初期値:true:する)。 623 * 624 * @og.tag 625 * falseを指定するとカラム編集リンクを出さない。 626 * 従来は、カラム編集画面の内、【表示項目設定】タブを表示しないだけでした。 627 * この設定は、RWMODE を、 ##d , ##u , ##f の場合にも同様の設定が可能です。 628 * カラム編集リンク自体を出さない機能は、現時点ではリソース設定できないため、 629 * タグのパラメータとして指定できるようにします。 630 * 基本的には、このパラメータはほとんど使われていないハズなので、 631 * 機能を置き換えます。 632 * 初期値は、カラム編集リンクを出力する(=true)です。 633 * 634 * @og.rev 5.7.5.0 (2014/04/04) 新規追加 635 * 636 * @param flag リンク出力 [true:する/false:しない] 637 * @see org.opengion.hayabusa.taglib.QueryButtonTag#setUseEditMenu(String) 638 */ 639 public void setUseEditLink( final String flag ) { 640 useEditLink = nval( getRequestParameter( flag ),useEditLink ); 641 } 642 643 /** 644 * 【TAG】ダウンロード時のコマンドを追加指定できます(初期値:null)。 645 * 646 * @og.tag 647 * ダウンロードリンクが表示される command は、 648 * "NEW|RENEW|FIRST|LAST|PREV|NEXT|VIEW|RESET" のみです。 649 * これ以外の command で、ダウンロードリンクを表示させたい場合は、 650 * この、addDownCmnd に、記述します。 651 * 初期値は、null(追加コマンドはない)です。 652 * 653 * @og.rev 5.7.8.1 (2014/07/18) 新規追加 654 * 655 * @param cmd 追加するコマンド 656 * @see #setCommand( String ) 657 */ 658 public void setAddDownCmnd( final String cmd ) { 659 addDownCmnd = nval( getRequestParameter( cmd ),addDownCmnd ); 660 } 661 662 /** 663 * 【TAG】アップロード時のコマンドを追加指定できます(初期値:null)。 664 * 665 * @og.tag 666 * アップロードリンクが表示される command は、"COPY|INSERT" のみです。 667 * これ以外の command で、アップロードリンクを表示させたい場合は、 668 * この、addUpldCmnd に、記述します。 669 * 初期値は、null(追加コマンドはない)です。 670 * 671 * @og.rev 5.7.8.1 (2014/07/18) 新規追加 672 * 673 * @param cmd 追加するコマンド 674 * @see #setCommand( String ) 675 */ 676 public void setAddUpldCmnd( final String cmd ) { 677 addUpldCmnd = nval( getRequestParameter( cmd ),addUpldCmnd ); 678 } 679 680 /** 681 * 【TAG】リンクアドレスにURLチェック用の確認キーを付加するかどうか[true/false]を指定します。 682 * 683 * @og.tag 684 * この属性は、URLCheckFilter(org.opengion.hayabusa.filter.URLCheckFilter)と合わせて使用します。 685 * trueが指定された場合、リンクURLのパラメーターに、URL確認用のパラメーターが出力されます。 686 * このパラメーターを、URLCheckFilterが復号化し、正式なアクセスであるかどうかの判定を行います。 687 * 688 * この属性はjsp/fileDownloadに対してチェックをかける場合にtrueにする必要があります。 689 * 通常はシステムリソースのFILEUD_URL_CHECKで設定します。 690 * 691 * 初期値は、 "false"(確認キーを出力しない) です。 692 * 693 * @og.rev 5.9.32.1 (2018/05/08) 追加 694 * 695 * @param flag 暗号化するかかどうか [true:暗号化する/false:しない] 696 * @see org.opengion.hayabusa.filter.URLCheckFilter 697 */ 698 public void setUseURLCheck( final String flag ) { 699 useURLCheck = nval( getRequestParameter( flag ),useURLCheck ); 700 } 701 702 /** 703 * このオブジェクトの文字列表現を返します。 704 * 基本的にデバッグ目的に使用します。 705 * 706 * @return このクラスの文字列表現 707 * @og.rtnNotNull 708 */ 709 @Override 710 public String toString() { 711 return ToString.title( this.getClass().getName() ) 712 .println( "VERSION" ,VERSION ) 713 .println( "command" ,command ) 714 .println( "downloadImg" ,downloadImg ) 715 .println( "downloadJsp" ,downloadJsp ) 716 .println( "uploadImg" ,uploadImg ) 717 .println( "uploadJsp" ,uploadJsp ) 718 .println( "imgWidth" ,imgWidth ) 719 .println( "imgHeight" ,imgHeight ) 720 .println( "filename" ,filename ) 721 .println( "roles" ,roles ) 722 .println( "target" ,target ) 723 .println( "Other..." ,getAttributes().getAttribute() ) 724 .fixForm().toString() ; 725 } 726}