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 static org.opengion.fukurou.util.StringUtil.nval; 019 020import java.io.File; 021import java.util.ArrayList; 022import java.util.Calendar; 023import java.util.GregorianCalendar; 024import java.util.HashMap; 025import java.util.Map; 026 027import javax.servlet.http.HttpServletRequest; 028 029import org.opengion.fukurou.security.HybsCryptography; 030import org.opengion.fukurou.util.StringUtil; 031import org.opengion.fukurou.util.XHTMLTag; 032import org.opengion.hayabusa.common.HybsSystem; 033import org.opengion.hayabusa.common.HybsSystemException; 034import org.opengion.hayabusa.html.CreateToken; 035import org.opengion.hayabusa.html.ViewForm; 036import org.opengion.hayabusa.resource.GUIInfo; 037import org.opengion.hayabusa.resource.URLXfer; 038 039/** 040 * HTML のaタグと同等のリンクを作成するHTML拡張タグです。 041 * 042 * @og.formSample 043 * ●形式:<og:link href="…" > ... </og:link > 044 * ●body:あり(EVAL_BODY_BUFFERED:BODYを評価し、{@XXXX} を解析します) 045 * 046 * ●Tag定義: 047 * <og:link 048 * type 【HTML】リンク先のMIMEタイプを指定します 049 * name 【HTML】この要素をリンクの対象とするための名前を指定します(HTML5より廃止) 050 * gamenId 【TAG】画面ID属性を登録します 051 * useGamenId 【TAG】GAMENID,BACK_GAMENID 属性を付加するかどうか[true/false]を設定します(初期値:true) 052 * column 【TAG】リンクをつけたいカラムを指定します(ViewLink タグと併用) 053 * keys 【TAG】リンク先に渡すキーをCSV形式で複数指定します 054 * vals 【TAG】リンク先に渡す値をCSV形式で複数指定します 055 * onLink 【TAG】リンクを張る(true or 1)/張らない(false or 0)の設定を指定します(初期値:true) 056 * markList 【TAG】処理するマークを、"|"区切りの文字列で指定します 057 * href 【HTML】リンク先のURLを指定します 058 * target 【HTML】リンク先の表示ターゲットを指定します 059 * caseKey 【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null) 060 * caseVal 【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null) 061 * caseNN 【TAG】指定の値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます(初期値:true) 062 * caseNull 【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます(初期値:true) 063 * lbl 【TAG】ラベルリソースのラベルIDを指定します 064 * xlink 【TAG】href ではなく、xlink:href を使用するかどうか[true/false]を指定します(初期値:false) 065 * fileCheck 【TAG】ファイルの存在チェックを行うかどうか[true/false]を指定します(初期値:false) 066 * filePath 【TAG】アドレスにファイルのディレクトリ直接のアドレスを指定するかどうか[true/false]設定します(初期値:false) 067 * hreflang 【HTML】リンク先の基本となる言語コードを指定します 068 * rel 【HTML】この文書から見た、href属性で指定されるリンク先との関係を指定します 069 * rev 【HTML】href属性で指定されるリンク先から見た、この文書との関係をしてします 070 * charset 【HTML】リンク先の文字コードセットを指定します 071 * shape 【HTML】リンクボタンの形状(イメージマップ rect/circle/poly/default)を指定します 072 * coords 【HTML】リンクボタンの座標を指定します 073 * id 【HTML】要素に対して固有の名前(id)をつける場合に設定します 074 * lang 【HTML】要素の内容と他の属性値の言語(lang,xml:lang)を指定します 075 * dir 【HTML】文字表記の方向(dir)を指定します 076 * title 【HTML】要素に対する補足的情報(title)を設定します 077 * style 【HTML】この要素に対して適用させるスタイルシート(style)を設定します 078 * tabindex 【HTML】タブの移動順(tabindex)を指定します(0 〜 32767) 079 * accesskey 【HTML】アクセスキー(alt+キーで直接指定)を割り当てます 080 * clazz 【HTML】要素に対して class 属性を設定します 081 * language 【TAG】タグ内部で使用する言語コード[ja/en/zh/…]を指定します 082 * useDirectJump 【TAG】ダイレクトジャンプを使用するかどうか[true/false]を指定します(初期値:false) 083 * useRequestCache 【TAG】リクエストキャッシュ情報を使用するかどうか[true/false]を指定します(初期値:true) 084 * hrefOnly 【TAG】リンク(アンカータグ)ではなく、href 属性をそのまま返すかどうか[true/false]を指定します(初期値:false) 085 * hrefTarget 【TAG】リンク(アンカータグ)ではなく、href 属性と、target属性を キーも含めて返すかどうか[true/false]を指定します(初期値:false) 086 * delKeys 【TAG】リクエストキャッシュ情報使用時に使用しない(削除する)キーをCSV形式で複数指定します 087 * onClick 【HTML】JavaScriptのイベント onClick を設定します(例:onClick="renew('query.jsp','QUERY');") 088 * onBlur 【HTML】JavaScriptのイベント onBlur を設定します(例:onBlur="this.value=value.toUpperCase();") 089 * onFocus 【HTML】JavaScriptのイベント onFocus を設定します 090 * ondblClick 【HTML】JavaScriptのイベント ondblClick を設定します 091 * onMouseDown 【HTML】JavaScriptのイベント onMouseDown を設定します 092 * onMouseUp 【HTML】JavaScriptのイベント onMouseUp を設定します 093 * onMouseMove 【HTML】JavaScriptのイベント onMouseMove を設定します 094 * onMouseOut 【HTML】JavaScriptのイベント onMouseOut を設定します 095 * onMouseOver 【HTML】JavaScriptのイベント onMouseOver を設定します 096 * roles 【TAG】ロールをセットします 097 * useURLCheck 【TAG】リンクアドレスにURLチェック用の確認キーを付加するかどうか[true/false]を指定します(初期値:false) 098 * urlCheckUser 【TAG】URLチェック用の確認キーに対して、リンクを開くことのできるユーザーIDを指定します(初期値:ログインユーザー) 099 * urlCheckTime 【TAG】URLチェック用の確認キーに対して、リンクの有効期限を指定します(初期値:60分) 100 * urlCheckCrypt 【TAG】URLチェックの暗号化キーを指定します。受け側に依存します。未指定の場合はデフォルトの値が利用されます。 101 * extTocken 【TAG】利用するCreateTokenプラグイン名を設定します 102 * debug 【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false) 103 * > ... Body ... 104 * </og:link> 105 * 106 * ●使用例 107 * ・普通のリンク 108 * <og:link gamenId="32ExcelIn" href="direct.jsp" keys="location,filename,modifyType" value="{@GUI.ADDRESS},{@GUI.ADDRESS}.xls,A" target="RESULT" > 109 * <img src="{@SYS.JSP}/image/insert.gif" alt="Excel Insert" /><og:message lbl="MSG0057" /> 110 * </og:link> 111 * 112 * ・検索結果テーブル内でのリンク 113 * <og:viewLink command="{@command}"> 114 * <og:link column="KMZ" gamenId="RK0251" href="index.jsp" target="CONTENTS" 115 * keys="KMZ,ORDER_BY,command" vals="[KMZ],'LKIS',NEW" /> 116 * </og:viewLink> 117 * 118 * ・ダイレクトジャンプ(指定の画面へ直接飛ばす)URL 119 * gamenId を指定しなければこの画面へのURLを作成します。 120 * このURLは、その画面の index.jsp に直接ジャンプするためのURLです。 121 * この場合、useRequestCache="true" が初期値なので、必要なければ、false に設定願います。 122 * <og:link useDirectJump="true" delKeys="pageSize" 123 * keys="location,filename,modifyType" value="{@GUI.ADDRESS},{@GUI.ADDRESS}.xls,A" /> 124 * @og.group 画面表示 125 * 126 * @version 4.0 127 * @author Kazuhiko Hasegawa 128 * @since JDK5.0, 129 */ 130public class LinkTag extends HTMLTagSupport { 131 //* このプログラムのVERSION文字列を設定します。 {@value} */ 132 private static final String VERSION = "5.7.1.2 (2013/12/20)" ; 133 134 private static final long serialVersionUID = 571220131220L ; 135 136 private String column = null; 137 private String onLink = "true"; // true または 1 138 private boolean fileCheck = false; 139 private boolean filePath = false; 140 private String baseURL = HybsSystem.sys( "FILE_URL" ); 141 private String fileURL = baseURL; 142 private String gamenId = null; 143 private boolean useGamenId = true; 144 // 3.5.2.0 (2003/10/20) 145 private String markList = "true|TRUE|1"; // true または 1 146 private boolean xlink = false; // 3.5.5.0 (2004/03/12) 147 private boolean useDirectJump = false; // 3.7.1.0 (2005/04/26) 148 private boolean useRequestCache = true; // 3.7.1.0 (2005/04/26) 149 private int validDuration = -1; 150 private boolean hrefOnly = false; // 4.0.0 (2005/11/30) 151 private boolean hrefTarget = false; // 5.5.5.6 (2012/08/31) 152 153 private String[] keys = null; // 3.5.6.2 (2004/07/05) 154 private String[] vals = null; // 3.5.6.2 (2004/07/05) 155 private String[] delKeys = null; // 3.7.1.0 (2005/04/26) 156// private boolean useURLCheck = false; // 4.3.7.0 (2009/06/01) 157 private boolean useURLCheck = HybsSystem.sysBool( "LINK_URL_CHECK" ); // 5.10.11.0 (2019/05/03) システムリソースに変更 158 private String urlCheckUser= null; // 4.3.7.0 (2009/06/01) 159 private long urlCheckTime= 1000*60*60*24;// 4.3.7.0 (2009/06/01) 160 private String urlCheckCrypt = HybsSystem.sys( "URL_CHECK_CRYPT" ); // 5.8.8.0 (2015/06/05) 5.9.32.1 (2018/05/09) urlCheckCrypt初期値をシステムリソースから取得に変更 161 162 private String extToken = null; // 5.8.2.1 (2014/12/13) 163 private ArrayList<CreateToken> ctArray = null; 164 165 /** 166 * Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。 167 * 168 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。ボディが存在する場合のみボディが呼ばれる対応。 169 * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応 170 * @og.rev 5.7.1.2 (2013/12/20) msg ⇒ msglbl 変更 171 * 172 * @return 後続処理の指示( EVAL_BODY_BUFFERED ) 173 */ 174 @Override 175 public int doStartTag() { 176 // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応 177 if( useTag() ) { 178// String msg = getMsglbl(); 179// if( msg == null && column != null ) { msg = "[" + column + "]"; } 180// set( "body",msg ); 181 String msglbl = getMsglbl(); // 5.7.1.2 (2013/12/20) msg ⇒ msglbl 変更 182 if( msglbl == null && column != null ) { msglbl = "[" + column + "]"; } 183 set( "body",msglbl ); 184 return( EVAL_BODY_BUFFERED ); // Body を評価する。( extends BodyTagSupport 時) 185 } 186 return ( SKIP_BODY ); // Body を評価しない 187 } 188 189 /** 190 * Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。 191 * 192 * @og.rev 3.1.1.0 (2003/03/28) ボディの内容を取得する処理を、CommonTagSupport で行う。 193 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。ボディが存在する場合のみボディが呼ばれる対応。 194 * 195 * @return 後続処理の指示(SKIP_BODY) 196 */ 197 @Override 198 public int doAfterBody() { 199 String label = getBodyString(); 200 201 if( label != null && label.length() > 0 ) { 202 set( "body",label ); 203 } 204 205 return(SKIP_BODY); 206 } 207 208 /** 209 * Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。 210 * 211 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。 212 * @og.rev 3.1.2.0 (2003/04/07) リンク指定時に、画面IDを渡して、実アドレスを求める事ができる様にする。 213 * @og.rev 3.1.7.0 (2003/05/02) 戻るボタン用のBACK_GAMENID を、引数に追加します。 214 * @og.rev 3.1.8.0 (2003/05/16) GAMENID属性のURLへの自動セットを行うかどうかを決める属性( useGamenId )を追加。 215 * @og.rev 3.1.8.0 (2003/05/16) 画面IDが指定されたときのリンク情報作成方法を通常のリンク時にも適用する。 216 * @og.rev 3.1.8.0 (2003/05/16) 画面のロールに応じて、リンクを張る/張らないを自動判断する。 217 * @og.rev 3.5.2.0 (2003/10/20) markList属性を追加 218 * @og.rev 3.5.5.0 (2004/03/12) xlink属性をAttributeオブジェクトに追加 219 * @og.rev 3.5.6.2 (2004/07/05) makeTag() の処理範囲変更、viewlink へのパラメータ変更。 220 * @og.rev 3.7.1.0 (2005/04/26) ダイレクトジャンプリンク機能を追加 221 * @og.rev 4.0.0.0 (2005/11/30) roles 属性の追加 222 * @og.rev 4.0.0.0 (2005/08/31) 同一カラムの複数登録を許可します。 223 * @og.rev 4.3.0.0 (2008/07/04) ロールモードマルチ対応 224 * @og.rev 4.3.7.1 (2009/06/08) URLチェック機能対応 225 * @og.rev 4.3.7.4 (2009/07/01) 循環参照を解消 226 * @og.rev 4.3.8.0 (2009/08/01) ユーザーIDの外部設定に対応 227 * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応 228 * @og.rev 5.8.2.1 (2014/12/14) トークンプラグイン対応 229 * @og.rev 5.8.8.0 (2015/06/05) urlCheckCrypt対応 230 * @og.rev 5.10.12.2 (2019/06/21) ViewLinkTag経由の判定 231 * 232 * @return 後続処理の指示 233 */ 234 @Override 235 public int doEndTag() { 236 debugPrint(); // 4.0.0 (2005/02/28) 237 // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応 238 if( !useTag() ) { return(EVAL_PAGE); } 239 240 // 3.1.8.0 (2003/05/16) GAMENID属性のURLへの自動セットを行うかどうかを決める属性( useGamenId )を追加。 241 // 4.0.0 (2005/11/30) 指定のロールが、アクセス許可の場合は、出力します。 242 String roles = get( "roles" ); 243// if( roles != null && ! getUser().isAccess( roles ) ) { 244// return(EVAL_PAGE); 245// } 246 // 4.3.0.0 (2008/07/04) ロールモードマルチ対応 247 if( ! getUser().isAccess( roles ) ) { 248 return(EVAL_PAGE); 249 } 250 251 // 4.3.7.1 (2009/06/08) 252 if( useURLCheck ) { 253 // 4.3.8.0 (2009/08/01) 254// urlCheckUser = getUser().getUserID(); 255 urlCheckUser = nval( urlCheckUser, getUser().getUserID() ); 256 } 257 258 ViewLinkTag viewlink = (ViewLinkTag)findAncestorWithClass( this,ViewLinkTag.class ); 259 if( viewlink != null ) { 260 if( isGamenCheck() ) { set( "onLink", onLink ); } 261 else { set( "onLink", "false" ); } 262 // 4.3.7.1 (2009/06/08) 263 if( useURLCheck ) { 264 set( "useURLCheck", "true" ); 265 set( "urlCheckUser", urlCheckUser ); 266 set( "urlCheckTime", String.valueOf( System.currentTimeMillis() + urlCheckTime ) ); 267 set( "urlCheckCrypt", urlCheckCrypt); // 5.8.8.0 (2015/06/05) 268 } 269 set( "markList",markList ); 270 set( "linkFormat",makeTag() ); // 3.5.6.2 (2004/07/05) 271 // 4.0.0 (2005/08/31) 同一カラムの複数登録を許可します。 272 set( "column",column ); 273 set( "extToken", extToken); // 5.8.2.1 (2014/12/13) 274 viewlink.addAttribute( getAttributes() ); 275 } 276 // 3.7.1.0 (2005/04/26) ダイレクトジャンプリンク機能を追加 277 // 画面の利用権限有無などは調査不要 278 else if( useDirectJump ) { 279 jspPrint( makeDirectLink() ); 280 } 281 else { 282 if( isFileCheck() && isGamenCheck() && markList.indexOf( onLink ) >= 0 ) { 283 // 3.5.6.2 (2004/07/05) makeTag() より移動 284 if( filePath ) { 285 String furl = get( "href" ); 286 287 fileURL = StringUtil.urlAppend( baseURL,furl ); 288 String filename = HybsSystem.url2dir( fileURL ); 289 290 set( "href",filename ); 291 } 292 293 // 4.3.7.1 (2009/06/08) 294 String tag = makeTag( false ); // 5.10.12.2 (2019/06/21) falseを入れる 295 if( useURLCheck ) { 296 // 5.8.8.0 (2015/06/05) urlCheckCrypt対応 297 HybsCryptography criptCls = null; 298 if( urlCheckCrypt != null && urlCheckCrypt.length() > 0 ){ 299 criptCls = new HybsCryptography( urlCheckCrypt ); 300 } 301 302 if( hrefOnly ) { 303 // 4.3.7.4 (2009/07/01) 循環参照を解消 304// tag = XHTMLTag.addURLCheckKey( tag, HybsSystem.URL_CHECK_KEY, getUser().getUserID(), System.currentTimeMillis() + urlCheckTime ); 305 tag = XHTMLTag.addURLCheckKey( tag, HybsSystem.URL_CHECK_KEY, getUser().getUserID(), System.currentTimeMillis() + urlCheckTime, criptCls ); // 5.8.8.0 306 } 307 else { 308 // 4.3.7.4 (2009/07/01) 循環参照を解消 309// tag = XHTMLTag.embedURLCheckKey( tag, HybsSystem.URL_CHECK_KEY, getUser().getUserID(), System.currentTimeMillis() + urlCheckTime ); 310 tag = XHTMLTag.embedURLCheckKey( tag, HybsSystem.URL_CHECK_KEY, getUser().getUserID(), System.currentTimeMillis() + urlCheckTime, criptCls );// 5.8.8.0 311 } 312 } 313 314 // 5.8.2.1 (2014/12/14) URLトークンプラグイン 315 if( ctArray != null && ctArray.size() > 0 ){ 316 for( CreateToken ct : ctArray){ 317 if( hrefOnly ){ 318 tag = ct.generateURL( tag, System.currentTimeMillis() + urlCheckTime, null ); 319 } 320 else{ 321 tag = ct.embedToken( tag, System.currentTimeMillis() + urlCheckTime, null ); 322 } 323 } 324 } 325 jspPrint( tag ); 326// jspPrint( makeTag() ); 327 } 328 } 329 330 return(EVAL_PAGE); 331 } 332 333 /** 334 * タグリブオブジェクトをリリースします。 335 * キャッシュされて再利用されるので、フィールドの初期設定を行います。 336 * 337 * @og.rev 2.0.0.4 (2002/09/27) カスタムタグの release() メソッドを、追加 338 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。 339 * @og.rev 3.1.2.0 (2003/04/07) リンク指定時に、画面IDを渡して、実アドレスを求める事ができる様にする。 340 * @og.rev 3.1.8.0 (2003/05/16) GAMENID属性のURLへの自動セットを行うかどうかを決める属性( useGamenId )を追加。 341 * @og.rev 3.5.2.0 (2003/10/20) markList属性を追加 342 * @og.rev 3.5.5.0 (2004/03/12) xlink属性を追加 343 * @og.rev 3.5.6.2 (2004/07/05) keys , vals属性を追加 344 * @og.rev 3.7.1.0 (2005/04/26) useDirectJump , useRequestCache , delKeys 属性を追加 345 * @og.rev 4.0.0.0 (2005/09/30) validDuration 属性を追加 346 * @og.rev 4.3.7.0 (2009/06/01) useURLCheck属性を追加 347 * @og.rev 5.5.5.6 (2012/08/31) hrefTarget属性を追加 348 * @og.rev 5.8.2.1 (2014/12/14) トークンプラグイン対応(extToken,ctArray属性を追加) 349 * @og.rev 5.8.8.0 (2015/06/05) urlCheckCrypt追加 350 * @og.rev 5.9.32.1 (2018/05/09) urlCheckCrypt初期値をシステムリソースから取得に変更 351 * @og.rev 5.10.11.0 (2019/05/03) useURLCheck属性をシステムリソースから取得に変更 352 * 353 */ 354 @Override 355 protected void release2() { 356 super.release2(); 357 column = null; 358 onLink = "true"; // true または 1 359 markList = "true|TRUE|1"; // 3.5.2.0 (2003/10/20) 360 fileCheck = false; 361 filePath = false; 362 baseURL = HybsSystem.sys( "FILE_URL" ); 363 fileURL = baseURL; 364 gamenId = null; 365 useGamenId = true; 366 xlink = false; // 3.5.5.0 (2004/03/12) 367 keys = null; // 3.5.6.2 (2004/07/05) 368 vals = null; // 3.5.6.2 (2004/07/05) 369 useDirectJump = false; // 3.7.1.0 (2005/04/26) 370 useRequestCache = true; // 3.7.1.0 (2005/04/26) 371 delKeys = null; // 3.7.1.0 (2005/04/26) 372 validDuration = -1; 373 hrefOnly = false; // 4.0.0 (2005/11/30) 374 hrefTarget = false; // 5.5.5.6 (2012/08/31) 375// useURLCheck = false; // 4.3.7.0 (2009/06/01) 376 useURLCheck = HybsSystem.sysBool( "LINK_URL_CHECK" ); // 5.10.11.0 (2019/05/03) 377 urlCheckUser = null; // 4.3.7.0 (2009/06/01) 378 urlCheckTime = 1000*60*60*24; // 4.3.7.0 (2009/06/01) 379 extToken = null; // 5.8.2.1 (2014/12/14) 380 ctArray = null; // 5.8.2.1 (2014/12/14) 381// urlCheckCrypt = null; // 5.8.8.0 (2015/06/05) 382 urlCheckCrypt = HybsSystem.sys( "URL_CHECK_CRYPT" ); // 5.9.32.1 (2018/05/11) 383 } 384 385 /** 386 * リンクを作成します。 387 * 388 * これは、HTMLTagSupportのmakeTag()のオーバーライド用のメソッドです。 389 * ViewLinkTag経由の場合は、引数 true で、独自のメソッドを呼び出します。 390 * これは、戻り行番号( BACK_ROW={I} )が、処理されないため、IE上でエラーが発生するのを 391 * 避けるためです。 392 * 393 * @og.rev 5.10.12.3 (2019/06/21) 6.7.3.0対応の移植。Override用のメソッドを用意しておきます。 394 * 395 * @return リンクタグ文字列 396 * @og.rtnNotNull 397 */ 398 @Override 399 protected String makeTag() { 400 return makeTag( true ); // 互換性。ViewLinkTag経由の場合 401 } 402 403 /** 404 * リンクを作成します。 405 * 406 * @og.rev 3.5.5.0 (2004/03/12) xlink 属性に応じたリンク文字を作成します。 407 * @og.rev 3.5.6.2 (2004/07/05) XHTMLTag の変換値のみを返す様に変更。 408 * @og.rev 3.7.0.3 (2005/03/01) リンク作成時に行番号を引数に追加する。 409 * @og.rev 4.0.0.0 (2005/11/30) href 属性のみを返します。 410 * @og.rev 4.0.1.0 (2007/12/17) BACK_ADDRESSの追加 411 * @og.rev 4.3.3.5 (2008/11/08) サーバーアドレスを取得する際に、リクエストから取得するように変更します。 412 * @og.rev 4.3.7.0 (2009/06/01) URLチェック機能対応 413 * @og.rev 4.3.7.1 (2009/06/08) ↑の実装を#doEndTagに移動 414 * @og.rev 5.5.5.6 (2012/08/31) 「href="*******" target="******"」 という キー付きの文字列を作成 415 * @og.rev 5.10.12.3 (2019/06/21) ViewLinkTag経由の判定を入れる 416 * 417 * @return リンクタグ文字列 418 */ 419 protected String makeTag( final boolean useViewLink ) { 420 421 makeGamenLink(); // 3.5.6.2 (2004/07/05) 422 if( get( "body" ) == null ) { set( "body" , get( "href" ) ); } 423 424 // xlink と通常の link では、URL接続文字が異なる。 425 String sep = ( xlink ) ? "&" : "&" ; 426 427 String urlEnc = XHTMLTag.urlEncode( keys,vals,sep ); 428 // 3.5.6.2 (2004/07/05) addBackGamenId() メソッドの内容を移動 429 if( useGamenId ) { 430 String backGamenId = getGUIInfoAttri( "KEY" ); // 4.0.0 (2005/01/31) 431 432 //urlEnc += sep + "BACK_ROW={I}" + sep + "BACK_GAMENID=" + backGamenId ; // 3.7.0.3 (2005/03/01) 433 if( useViewLink ) { // 5.10.12.3 (2019/06/21) 分離 434 urlEnc += sep + "BACK_ROW={I}"; 435 } 436 urlEnc += sep + "BACK_GAMENID=" + backGamenId ; 437 // 4.0.1.0 (2007/12/17) gamenIdがある場合はbackAddressを付加する。(BackGamenTagではこれで戻る) 438 String guiAddress = getGUIInfoAttri( "ADDRESS" ); 439 // 4.3.3.5 (2008/11/08) サーバーアドレスを取得する際に、リクエストから取得するように変更します。 440 String backAddress = getContextURL() + guiAddress + "/index.jsp"; 441 urlEnc += sep + "BACK_ADDRESS=" + backAddress; 442 443 if( gamenId != null && gamenId.length() > 0 ) { 444 urlEnc += sep + "GAMENID=" + gamenId ; 445 } 446 } 447 448 // 4.0.0 (2005/11/30) href 属性のみを返します。 449 if( hrefOnly ) { 450 return XHTMLTag.addUrlEncode( get( "href" ),urlEnc,sep ); 451 } 452 453 // 5.5.5.6 (2012/08/31) 「href="*******" target="******"」 という キー付きの文字列を作成 454 if( hrefTarget ) { 455 StringBuilder hrefTemp = new StringBuilder( HybsSystem.BUFFER_MIDDLE ); 456 457 hrefTemp.append( "href=\"" ).append( XHTMLTag.addUrlEncode( get( "href" ),urlEnc,sep ) ).append( "\"" ); 458 459 String target = get( "target" ) ; 460 if( target != null && !target.isEmpty() ) { 461 hrefTemp.append( " target=\"" ).append( target ).append( "\"" ); 462 } 463 464 return hrefTemp.toString() ; 465 } 466 467 if( xlink ) { 468 return XHTMLTag.xlink( getAttributes(),urlEnc ) ; 469 } 470 else { 471 return XHTMLTag.link( getAttributes(),urlEnc ) ; 472 } 473 } 474 475 /** 476 * ダイレクトジャンプリンクを作成します。 477 * 478 * gamenId を指定しなければ、この画面が指定されたと考えます。 479 * target を指定しなければ、"_blank" を指定します。 480 * msg がなければ(または、BODY部が空の場合)、画面名にこのリンクを作成します。 481 * 482 * @og.rev 3.7.1.0 (2005/04/26) 新規追加 483 * @og.rev 4.0.0.0 (2005/09/30) リンク文字列をハッシュ化します。 484 * @og.rev 4.3.3.5 (2008/11/08) サーバーアドレスを取得する際に、リクエストから取得するように変更します。 485 * 486 * @return ダイレクトジャンプリンク文字列 487 */ 488 private String makeDirectLink() { 489 490 // gamenId を指定しなければ、この画面が指定されたと考えます。 491 if( gamenId == null ) { 492 gamenId = getGUIInfoAttri( "KEY" ); 493 } 494 495 // キャッシュ情報と keys,vals情報を設定します。 496 if( useRequestCache ) { makeRequestCache2Vals( gamenId ); } 497 String urlEnc = XHTMLTag.urlEncode( keys,vals ); 498 urlEnc = urlEnc + "&GAMENID=" + gamenId ; 499 500 String href = get( "href" ); 501 if( href == null || href.length() == 0 ) { 502 // 4.3.3.5 (2008/11/08) サーバーアドレスを取得する際に、リクエストから取得するように変更します。 503// href = sys( "CONTEXT_URL" ) + "jsp/index.jsp" ; 504 href = getContextURL() + "index.jsp" ; 505 } 506 507 String redirectURL = href + "?" + urlEnc ; 508 String name = getGUIInfoAttri( "LNAME" ); 509 510 String validDate = null; // 設定されない場合は、無制限 511 if( validDuration != 0 ) { 512 if( validDuration < 0 ) { // マイナスの場合は、初期値が使われます。 513 validDuration = sysInt( "LINK_VALID_DURATION_DAYS" ); 514 } 515 // ミリ秒 秒 時間 516 long nowTime = System.currentTimeMillis() + 1000L * 3600L * 24L * validDuration ; 517 validDate = HybsSystem.getDate( nowTime,"yyyyMMdd" ); 518 } 519 String userid = getUser().getUserID(); 520 521 URLXfer xfer = new URLXfer(); 522 // redirectURL,name,validDate,userid 523 return xfer.getRandomURL( redirectURL,name,validDate,userid ); 524 } 525 526 /** 527 * リクエストキャッシュ情報を加味した keys,vals を再作成します。 528 * このメソッドは、ダイレクトジャンプ時のみ有効です。 529 * 530 * リクエスト情報のMapを取り出します。そのとき、keys,vals を優先して 531 * 設定します。 532 * 533 * @og.rev 3.7.1.0 (2005/04/26) 新規追加 534 * 535 * @param gamenId 画面ID(リクエストキャッシュの取り出しキー) 536 */ 537 @SuppressWarnings(value={"unchecked"}) 538 private void makeRequestCache2Vals( final String gamenId ) { 539 Map<String,String[]> cache = new HashMap<String,String[]>(); 540 541 String cacheKey = HybsSystem.REQ_CACHE_KEY + gamenId ; 542 Map<String,String[]> map = (Map<String,String[]>)getSessionAttribute( cacheKey ); 543 if( map != null ) { cache.putAll( map ); } 544 545 if( keys != null ) { 546 for( int i=0; i<keys.length; i++ ) { 547 // keys,vals をキャッシュに上書き( キャッシュは、文字列配列) 548 String[] temp = new String[] { vals[i] } ; 549 cache.put( keys[i],temp ); 550 } 551 } 552 553 // ダイレクトジャンプするための画面IDは、別途設定するため、削除しておきます。 554 cache.remove( "GAMENID" ); 555 556 // 使用しないキーを、削除しておきます。 557 if( delKeys != null ) { 558 for( int i=0; i<delKeys.length; i++ ) { 559 cache.remove( delKeys[i] ); 560 } 561 } 562 563 // マップキーを取得。キャッシュ値は、String[] なので、複数キー登録する。 564 String[] cKeys = cache.keySet().toArray( new String[cache.size()] ); 565 566 ArrayList<String> v_keys = new ArrayList<String>(); 567 ArrayList<String> v_vals = new ArrayList<String>(); 568 for( int i=0; i<cKeys.length; i++ ) { 569 String kk = cKeys[i]; 570 String[] vv = cache.get( kk ); 571 if( vv != null ) { 572 for( int j=0; j<vv.length; j++ ) { 573 v_keys.add( kk ); 574 v_vals.add( vv[j] ); 575 } 576 } 577 } 578 579 keys = v_keys.toArray( new String[v_keys.size()] ); 580 vals = v_vals.toArray( new String[v_vals.size()] ); 581 } 582 583 /** 584 * ファイルの存在チェックを行います。 585 * 586 * 実ファイルは、URL(httpの引数)より、変換して求めます。 587 * 588 * @og.rev 3.1.8.0 (2003/05/16) 画面のロールに応じて、リンクを張る/張らないを自動判断する。 589 * 590 * @return ファイルが存在する(true)/存在しない(false) 591 */ 592 private boolean isFileCheck() { 593 boolean rtn = true; 594 595 if( fileCheck ) { 596 File file = null; 597 598 String url = get( "href" ); 599 if( url != null ) { 600 String fin = HybsSystem.url2dir( url ); 601 file = new File( fin ); 602 } 603 rtn = ( file != null && file.exists() ); 604 } 605 606 return rtn ; 607 } 608 609 /** 610 * リンク先の画面のロールに応じて、リンクを張る/張らないを自動判断を行います。 611 * 612 * リンク先の画面IDは、gamenId 属性で指定してください。それ以外のリンクは、 613 * 自動判断できません。 614 * link タグ単独の場合に、画面にアクセスできない場合は、メッセージも表示されません。 615 * viewLink タグを利用される場合は、リンクのON/OFF で制御します。 616 * 617 * @og.rev 3.1.8.0 (2003/05/16) 画面のロールに応じて、リンクを張る/張らないを自動判断する。 618 * @og.rev 4.0.0.0 (2005/01/31) GUIオブジェクトがマップに無ければ、アクセスできない。 619 * 620 * @return 画面アクセス許可する(true)/許可しない(false) 621 */ 622 private boolean isGamenCheck() { 623 boolean rtn = true; 624 625 if( gamenId != null ) { 626 GUIInfo guiInfo = getGUIInfo( gamenId ); // 4.0.0 (2005/01/31) 627 628 // 4.0.0 (2005/01/31) ユーザー毎にアクセスできるGUIが設定されている為 629 // 存在しなければ、アクセス不可ということ。 630 if( guiInfo == null ) { rtn = false; } 631 } 632 633 return rtn ; 634 } 635 636 /** 637 * 画面IDとhref から、指定のURLを作成します。 638 * 639 * @og.rev 3.1.2.0 (2003/04/07) リンク指定時に、画面IDを渡して、実アドレスを求める事ができる様にする。 640 * @og.rev 3.1.8.0 (2003/05/16) リンク作成時に、kyes/values が null の時の処理の修正。 641 * @og.rev 3.1.8.0 (2003/05/16) GAMENID属性のURLへの自動セットを行うかどうかを決める属性( useGamenId )を追加。 642 * @og.rev 3.1.8.0 (2003/05/16) 画面IDが指定されたときのリンク情報作成方法を通常のリンク時にも適用する。 643 * @og.rev 3.5.5.0 (2004/03/12) URLを求めるのに、GUIInfo#getRealAddress() を使用する。 644 * @og.rev 4.0.0.0 (2005/01/31) GUIInfoの実アドレスのパラメータを考慮する。 645 * 646 */ 647 private void makeGamenLink() { 648 if( gamenId == null || gamenId.length() == 0 ) { return ; } // 4.0.0 (2005/11/30) 649 650 GUIInfo guiInfo = getGUIInfo( gamenId ); // 4.0.0 (2005/01/31) 651 if( guiInfo == null ) { return ; } // 見つからない場合は、アクセス不可 652 653 String address = guiInfo.getRealAddress( get( "href" ) ); 654 String url = getRequestParameter( address ); 655 set( "href",url ); 656 657 String label = guiInfo.getLabel(); 658 if( get( "title" ) == null ) { 659 set( "title","To:" + label ); 660 } 661 if( get( "body" ) == null ) { 662 set( "body",label ); 663 } 664 } 665 666 /** 667 * リクエストからサーバーアドレス(例:http://hn5120:8824/ver4/jsp/)を取得します。 668 * 669 * @og.rev 4.3.3.5 (2008/11/08) 新規追加。 670 * @og.rev 5.4.3.8 (2011/01/24) プロトコルhttps対応 671 * 672 * @return サーバーアドレス文字列 673 */ 674 private String getContextURL() { 675 StringBuilder link = new StringBuilder( HybsSystem.BUFFER_MIDDLE ); 676 HttpServletRequest request = (HttpServletRequest) getRequest(); 677 //link.append( "http://" ); 678 link.append( request.getScheme() ).append( "://" ); // 5.4.3.8 679 link.append( request.getServerName() ).append( ":" ); 680 link.append( request.getServerPort() ); 681 link.append( request.getContextPath() ); 682 link.append( "/jsp/" ); 683 return link.toString(); 684 } 685 686 /** 687 * 【HTML】リンク先のMIMEタイプを指定します。 688 * 689 * @og.tag リンク先のMIMEタイプを指定します。 690 * 691 * @param type MIMEタイプ 692 */ 693 public void setType( final String type ) { 694 set( "type",getRequestParameter( type ) ); 695 } 696 697 /** 698 * 【HTML】この要素をリンクの対象とするための名前を指定します。 699 * 700 * @og.tag この要素をリンクの対象とするための名前を指定します。 701 * 702 * ※ HTML5では、a要素のname属性は廃止されています。 703 * HTML4.01におけるname属性は、ウェブページ内の特定個所に名前を付けて、 704 * ページ内リンクを作成する際などに使用していました。 HTML5で同様の 705 * 機能を作成する場合にはid属性を使用します。 id属性は、ひとつの 706 * 文書の中では重複して同じ名前を付けることはできないので、 707 * ウェブページ内の場所を一意に特定できます。 708 * 709 * @param name 名前 710 * @see <a href="http://www.htmq.com/html5/a.shtml">a</a> 711 */ 712 public void setName( final String name ) { 713 set( "name",getRequestParameter( name ) ); 714 } 715 716 /** 717 * 【TAG】リンクをつけたいカラムを指定します(ViewLink タグと併用)。 718 * 719 * @og.tag 720 * このカラム名のTableModelに対して、 ViewLink タグが存在する場合は, 721 * リンクを張ります。 722 * 723 * @param clm カラム 724 */ 725 public void setColumn( final String clm ) { 726 this.column = getRequestParameter( clm ); 727 } 728 729 /** 730 * 【HTML】リンク先のURLを指定します。 731 * 732 * @og.tag リンク先のURLを指定します。 733 * 734 * @param href リンク先のURL 735 */ 736 public void setHref( final String href ) { 737 set( "href",getRequestParameter( href ) ); 738 } 739 740 /** 741 * 【HTML】リンク先の基本となる言語コードを指定します。 742 * 743 * @og.tag リンク先の基本となる言語コードを指定します。 744 * 745 * @param hreflang 言語コード 746 */ 747 public void setHreflang( final String hreflang ) { 748 set( "hreflang",getRequestParameter( hreflang ) ); 749 } 750 751 /** 752 * 【HTML】この文書から見た、href属性で指定されるリンク先との関係を指定します。 753 * 754 * @og.tag この文書から見た、href属性で指定されるリンク先との関係を指定します。 755 * 756 * @param rel リンク先との関係 757 */ 758 public void setRel( final String rel ) { 759 set( "rel",getRequestParameter( rel ) ); 760 } 761 762 /** 763 * 【HTML】href属性で指定されるリンク先から見た、この文書との関係をしてします。 764 * 765 * @og.tag href属性で指定されるリンク先から見た、この文書との関係をしてします。 766 * 767 * @param rev リンク先から見たこの文書との関係 768 */ 769 public void setRev( final String rev ) { 770 set( "rev",getRequestParameter( rev ) ); 771 } 772 773 /** 774 * 【HTML】リンク先の文字コードセットを指定します。 775 * 776 * @og.tag リンク先の文字コードセットを指定します。 777 * 778 * @param charset 文字コードセット 779 */ 780 public void setCharset( final String charset ) { 781 set( "charset",getRequestParameter( charset ) ); 782 } 783 784 /** 785 * 【HTML】リンク先の表示ターゲットを指定します。 786 * 787 * @og.tag リンク先の文書を表示させるフレーム、またはウィンドウの名前を指定します。 788 * 789 * @param target ターゲット 790 */ 791 public void setTarget( final String target ) { 792 set( "target",getRequestParameter( target ) ); 793 } 794 795 /** 796 * 【HTML】リンクボタンの形状(イメージマップ rect/circle/poly/default)を指定します。 797 * 798 * @og.tag リンクボタンの形状(イメージマップ rect/circle/poly/default)を指定します。 799 * 800 * @param shape 形状(イメージマップ rect/circle/poly/default) 801 */ 802 public void setShape( final String shape ) { 803 set( "shape",getRequestParameter( shape ) ); 804 } 805 806 /** 807 * 【HTML】リンクボタンの座標を指定します。 808 * 809 * @og.tag 810 * coords セット 811 * 812 * @param coords リンクボタンの座標 813 */ 814 public void setCoords( final String coords ) { 815 set( "coords",getRequestParameter( coords ) ); 816 } 817 818 /** 819 * 【TAG】リンク先に渡すキーをCSV形式で複数指定します。 820 * 821 * @og.tag リンク先に渡すキーを指定します。 822 * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。 823 * こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。 824 * 825 * @og.rev 3.5.6.2 (2004/07/05) CommonTagSupport#getCSVParameter を使用 826 * 827 * @param key キー(CSV形式) 828 */ 829 public void setKeys( final String key ) { 830 keys = getCSVParameter( key ); 831 } 832 833// /** 834// * 【廃止】リンク先に渡す値をCSV形式で複数指定します。 835// * 836// * @og.tag リンク先に渡す値を指定します。 837// * 838// * @og.rev 3.5.6.2 (2004/07/05) 廃止します。 839// * @og.rev 4.0.0.0 (2007/06/18) 廃止 840// * 841// * @param value 値(CSV形式) 842// * @deprecated vals 属性を使用してください。 843// */ 844// @Deprecated public void setValue( final String value ) { 845// setVals( value ); 846// } 847 848 /** 849 * 【TAG】リンク先に渡す値をCSV形式で複数指定します。 850 * 851 * @og.tag リンク先に渡す値を指定します。 852 * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。 853 * こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。 854 * 855 * @og.rev 3.5.6.2 (2004/07/05) CommonTagSupport#getCSVParameter を使用 856 * 857 * @param val 値(CSV形式) 858 */ 859 public void setVals( final String val ) { 860 vals = getCSVParameter( val ); 861 } 862 863 /** 864 * 【TAG】リンクを張る(true or 1)/張らない(false or 0)の設定を指定します(初期値:true)。 865 * 866 * @og.tag 867 * リンクを張る場合は、"true"(または "1") リンクを張らない 868 * 場合は, "true以外"(または "0")をセットします。 869 * 初期値は、 "true"(リンクを張る)です。 870 * さらに、[カラム名] で、動的にカラムの値で、リンクを張る、張らないを 871 * 選ぶ事が可能になります。値は、"true"(または "1") で、マークします。 872 * 追記 3.5.2.0 (2003/10/20):markList属性に、処理対象文字列郡を指定できます。 873 * これにより、リンクを処理するかどうかの判断が、true,1 以外にも使用できるようになりました。 874 * 875 * @og.rev 3.5.2.0 (2003/10/20) markList属性を追加 876 * 877 * @param flag リンクの設定[true,1:リンクを張る/true,1以外:リンクを張らない] 878 */ 879 public void setOnLink( final String flag ) { 880 onLink = nval( getRequestParameter( flag ),onLink ); 881 } 882 883 /** 884 * 【TAG】ファイルの存在チェックを行うかどうか[true/false]を指定します(初期値:false)。 885 * 886 * @og.tag 887 * "true"の場合は、ファイルの存在チェックを行い、ファイルがあれば 888 * リンクを張ります。ファイルが存在しない場合は, 何も表示されません。 889 * 初期値は、 "false"(ファイルチェックを行わない)です。 890 * 注意:現状、viewLink タグからの使用は出来ませんので、ご了承願います。 891 * 892 * @param flag 存在チェック[true:行う/false:行わない]) 893 */ 894 public void setFileCheck( final String flag ) { 895 fileCheck = nval( getRequestParameter( flag ),fileCheck ); 896 } 897 898 /** 899 * 【TAG】アドレスにファイルのディレクトリ直接のアドレスを指定するかどうか[true/false]設定します(初期値:false)。 900 * 901 * @og.tag 902 * "true"の場合は、ファイルの物理ディレクトリをリンクします。 903 * 初期値は、 "false"(ファイルの直接アドレスを行わない)です。 904 * 905 * @param flag ファイルのディレクトリ直接のアドレスの指定[true:直接アドレス/その他:通常のURL] 906 */ 907 public void setFilePath( final String flag ) { 908 filePath = nval( getRequestParameter( flag ),filePath ); 909 } 910 911 /** 912 * 【TAG】画面ID属性を登録します。 913 * 914 * @og.tag 915 * gamenId 属性は、画面IDをキーに、実アドレスを求めるのに使用します。 916 * 画面IDが指定された場合は、実アドレスに変換する。指定されない場合は、 917 * href 属性をそのままリンク情報を作成します。 918 * 画面IDを指定する場合の href は、JSPファイル名(例えば、index.jsp 等)です。 919 * 920 * @og.rev 3.1.2.0 (2003/04/07) リンク指定時に、画面IDを渡して、実アドレスを求める事ができる様にする。 921 * 922 * @param id 画面ID属性 923 */ 924 public void setGamenId( final String id ) { 925 gamenId = nval( getRequestParameter( id ),gamenId ); 926 } 927 928 /** 929 * 【TAG】GAMENID,BACK_GAMENID 属性を付加するかどうか[true/false]を設定します(初期値:true)。 930 * 931 * @og.tag 932 * "true"の場合は、GAMENID,BACK_GAMENID 属性を href に追加します。(?KEY1=VAL1&KEY2=VAL2・・・) 933 * "false"の場合は、付加しません。 934 * JavaScript や、通常のファイル( .html や .pdf 等)に、GAMENID,BACK_GAMENID 属性を付けないように 935 * する事が出来ます。 936 * 初期値は、 "true"(GAMENID,BACK_GAMENID 属性を href に追加する)です。 937 * 938 * @og.rev 3.1.8.0 (2003/05/16) GAMENID属性のURLへの自動セットを行うかどうかを決める属性( useGamenId )を追加。 939 * 940 * @param flag BACK_GAMENID 属性を付加するかどうか[true:追加する/その他:追加しない] 941 */ 942 public void setUseGamenId( final String flag ) { 943 useGamenId = nval( getRequestParameter( flag ),useGamenId ); 944 } 945 946 /** 947 * 【TAG】処理するマークを、"|"区切りの文字列で指定します。 948 * 949 * @og.tag 950 * markListで与えられた文字列に、onLink文字列(大文字/小文字の区別あり)が 951 * 含まれていれば、処理します。 952 * 例えば、"A","B","C" という文字列が、onLink で指定された 953 * 場合に処理するようにしたい場合は、"A|B|C" をセットします。 954 * markList には、[カラム名]指定が可能です。 955 * 初期値は、 "true|TRUE|1"です。 956 * 957 * @og.rev 3.5.2.0 (2003/10/20) 新規追加 958 * 959 * @param list 処理するマーク(indexOf による含む/含まない判定) 960 */ 961 public void setMarkList( final String list ) { 962 markList = nval( getRequestParameter( list ),markList ); 963 } 964 965 /** 966 * 【TAG】href ではなく、xlink:href を使用するかどうか[true/false]を指定します(初期値:false)。 967 * 968 * @og.tag 969 * xlink:href 属性は、XMLでのリンクを指定します。その場合、href 属性で指定した 970 * 内容は、xlink:href に置き換えられます。 971 * また、URL文字列の接続文字列(&)を、(&amp;)で接続します。これは、xlink として、 972 * XMLファイルに埋め込む場合に、置き換えが必要な為です。 973 * 初期値は、 "false"(通常の href) です。 974 * 975 * @og.rev 3.5.5.0 (2004/03/12) 新規追加 976 * 977 * @param lnk XMLリンクを使用するかどうか[true:使用する/false:使用しない] 978 */ 979 public void setXlink( final String lnk ) { 980 xlink = nval( getRequestParameter( lnk ),xlink ); 981 } 982 983 /** 984 * 【TAG】ダイレクトジャンプを使用するかどうか[true/false]を指定します(初期値:false)。 985 * 986 * @og.tag 987 * ダイレクトジャンプ(指定の画面へ直接飛ばす)は、簡易ワークフロー的に、画面への 988 * リンクを作成する場合に使用します。一般には、メール本文に記述して、指定の画面まで 989 * 直接飛ばす場合に使用します。 990 * このリンクは、その画面の index.jsp に直接ジャンプします。 991 * 992 * gamenId を指定しなければ、この画面が指定されたと考えます。 993 * target を指定しなければ、"_blank" を指定します。 994 * msg がなければ(または、BODY部が空の場合)、画面名にこのリンクを作成します。 995 * 初期値は、 "false"(使用しない) です。 996 * 997 * @og.rev 3.7.1.0 (2005/04/26) 新規追加 998 * 999 * @param directJump ダイレクトジャンプを使用するかどうか[true:使用する/false:使用しない] 1000 */ 1001 public void setUseDirectJump( final String directJump ) { 1002 useDirectJump = nval( getRequestParameter( directJump ),useDirectJump ); 1003 } 1004 1005 /** 1006 * 【TAG】リクエストキャッシュ情報を使用するかどうか[true/false]を指定します(初期値:true)。 1007 * 1008 * @og.tag 1009 * リクエストキャッシュ情報は、戻るリンクで画面を差表示(command=RENEW)する場合に 1010 * 最後に検索に利用された情報をキャッシュしておき、再利用する場合に利用する値です。 1011 * ダイレクトジャンプ機能(useDirectJum=true)の場合のみ有効です。 1012 * 戻るリンクによる再表示は、各画面自身が持っている情報を利用しますが、 1013 * ダイレクトジャンプ等で、すでにキャッシュが存在していない(セッションが異なっている) 1014 * 場合に、リンク情報に直接紐付けて、再検索させる必要がある場合に利用します。 1015 * このキャッシュは、keys,vals による値の再設定で、書き換えることが可能です。 1016 * 1017 * 初期値は、 "true"(使用する) です。 1018 * 1019 * @og.rev 3.7.1.0 (2005/04/26) 新規追加 1020 * 1021 * @param useCache リクエストキャッシュ情報を使用するかどうか[true:使用する/false:使用しない] 1022 */ 1023 public void setUseRequestCache( final String useCache ) { 1024 useRequestCache = nval( getRequestParameter( useCache ),useRequestCache ); 1025 } 1026 1027 /** 1028 * 【TAG】リクエストキャッシュ情報使用時に使用しない(削除する)キーをCSV形式で複数指定します。 1029 * 1030 * @og.tag 1031 * リクエストキャッシュ情報には、一般に検索時に使用されたすべての引数が 1032 * 使用されます。この引数を、転送先画面では、使用しないケースがあり、その場合に、 1033 * 指定のキー情報を、削除します。 1034 * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。 1035 * こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。 1036 * 1037 * @og.rev 3.7.1.0 (2005/04/26) 新規追加 1038 * 1039 * @param key 使用しない(削除する)キーをCSV形式で複数指定 1040 */ 1041 public void setDelKeys( final String key ) { 1042 delKeys = getCSVParameter( key ); 1043 } 1044 1045 /** 1046 * 【TAG】ダイレクトジャンプリンク時のハッシュ化されたURLの有効期間を日数を指定します 1047 * (初期値:LINK_VALID_DURATION_DAYS[={@og.value org.opengion.hayabusa.common.SystemData#LINK_VALID_DURATION_DAYS}])。 1048 * 1049 * @og.tag 1050 * ダイレクトジャンプリンクの引数を作成する場合、有効期限を指定できます。 1051 * ここでは、設定時刻からの有効期間を日数指定します。 1052 * 実際には、GE17のvalidDateカラムに設定される、日付と現在日を比較して、 1053 * 有効かどうかを判断します。 1054 * ゼロが指定された場合は、制限なしに設定されます。マイナスの場合は、初期値が使われます。 1055 * (初期値:ユーザー定数のLINK_VALID_DURATION_DAYS[={@og.value org.opengion.hayabusa.common.SystemData#LINK_VALID_DURATION_DAYS}])。 1056 * 1057 * @og.rev 4.0.0.0 (2005/09/30) 新規追加 1058 * 1059 * @param validDura URLの有効期間日数 1060 * @see org.opengion.hayabusa.common.SystemData#LINK_VALID_DURATION_DAYS 1061 */ 1062 public void setValidDuration( final String validDura ) { 1063 validDuration = nval( getRequestParameter( validDura ),validDuration ); 1064 } 1065 1066 /** 1067 * 【TAG】リンク(アンカータグ)ではなく、href 属性をそのまま返すかどうか[true/false]を指定します(初期値:false)。 1068 * 1069 * @og.tag 1070 * 通常のリンクは、アンカータグ(aタグ)の状態で出力されます。その場合、HTML上では 1071 * リンクとして表示されます。このフラグをtrue にセットすると、リンク文字列 1072 * そのものが出力されます。これは、リンク文字列を作成してDBに登録する場合などに 1073 * 使用します。 1074 * 1075 * 初期値は、 "false"(リンク) です。 1076 * 1077 * @og.rev 4.0.0.0 (2005/11/30) 新規追加 1078 * 1079 * @param flag href 属性をそのまま返すかどうか(true:href属性/false:リンク) 1080 */ 1081 public void setHrefOnly( final String flag ) { 1082 hrefOnly = nval( getRequestParameter( flag ),hrefOnly ); 1083 } 1084 1085 /** 1086 * 【TAG】リンク(アンカータグ)ではなく、href 属性と、target属性を キーも含めて返すかどうか[true/false]を指定します(初期値:false)。 1087 * 1088 * @og.tag 1089 * 内容的には、hrefOnly と類似の機能で、アンカータグ(aタグ)の出力ではなく、href 属性と、 1090 * target属性を キーも含めて作成します。 1091 * 「href="*******" target="******"」 という形式になります。 1092 * これは、クリッカブルマップ等の href 属性と target属性の両方を使用するようなケースで使います。 1093 * また、onLink、markList を使ったリンク作成可否の処理をおこなった場合、通常であれば、 1094 * 指定のカラムの値が取得できますが、その場合は、先頭文字列が、href かどうかを判定することで、 1095 * リンク作成可否の判断が可能です。 1096 * 逆に言えば、この属性を true にセットした場合は、先頭文字列が、href で始まることが保障されます。 1097 * hrefOnly = true と同時に設定した場合は、hrefOnly が優先されます。 1098 * 1099 * 初期値は、 "false"(リンク) です。 1100 * 1101 * @og.rev 5.5.5.6 (2012/08/31) 新規追加 1102 * 1103 * @param flag 「href="*******" target="******"」 という形式をそのまま返すかどうか(true:href,target属性/false:リンク) 1104 */ 1105 public void setHrefTarget( final String flag ) { 1106 hrefTarget = nval( getRequestParameter( flag ),hrefTarget ); 1107 } 1108 1109 /** 1110 * 【TAG】リンクアドレスにURLチェック用の確認キーを付加するかどうか[true/false]を指定します(初期値:false)。 1111 * 1112 * @og.tag 1113 * この属性は、URLCheckFilter(org.opengion.hayabusa.filter.URLCheckFilter)と合わせて使用します。 1114 * trueが指定された場合、リンクURLのパラメーターに、URL確認用のパラメーターが出力されます。 1115 * このパラメーターを、URLCheckFilterが復号化し、正式なアクセスであるかどうかの判定を行います。 1116 * 1117 * 初期値は、 システムリソースのLINK_URL_CHECK です。 1118 * 1119 * @og.rev 4.3.7.0 (2009/06/01) 新規追加 1120 * 1121 * @param flag 暗号化するかかどうか [true:暗号化する/false:しない] 1122 * @see org.opengion.hayabusa.filter.URLCheckFilter 1123 */ 1124 public void setUseURLCheck( final String flag ) { 1125 useURLCheck = nval( getRequestParameter( flag ),useURLCheck ); 1126 } 1127 1128 /** 1129 * 【TAG】URLチェック用の確認キーに対して、リンクを開くことのできるユーザーIDを指定します(初期値:ログインユーザー)。 1130 * 1131 * @og.tag 1132 * URLチェック用の確認キーに対して、リンクを開くことのできるユーザーIDを 1133 * カンマ区切りで指定します。 1134 * "*"が指定された場合、ユーザーチェックは行われません。 1135 * 1136 * 初期値は、 ログインユーザーです。 1137 * 1138 * @og.rev 4.3.8.0 (2009/08/01) 新規追加 1139 * 1140 * @param user リンクにアクセス可能なユーザー一覧 1141 */ 1142 public void setUrlCheckUser( final String user ) { 1143 urlCheckUser = nval( getRequestParameter( user ),urlCheckUser ); 1144 } 1145 1146 /** 1147 * 【TAG】外部(プラグイン)のトークンを利用する場合にプラグインを指定します。 1148 * 1149 * @og.tag 1150 * プラグインの名前を指定する事で、該当のCreateTokenを利用して 1151 * URLに対してトークンを付与します。 1152 * (CreatetToken_xxxのxxxを指定します) 1153 * 1154 * カンマ区切りを分解して、プラグインを配列として持ちます。 1155 * 適応は前から順番に行います。 1156 * 1157 * @og.rev 5.8.2.1 (2014/12/13) 新規追加 1158 * 1159 * @param name 利用するCreateTokenプラグイン 1160 */ 1161 public void setExtToken( final String name ) { 1162 extToken = nval( getRequestParameter( name ),extToken ); 1163 ctArray = new ArrayList<CreateToken>(); 1164 1165 if( extToken != null && extToken.length() > 0 ){ 1166 String[] tokens = StringUtil.csv2Array( extToken ); 1167 for( String tk :tokens ){ 1168 String cls = HybsSystem.sys( "CreateToken_" + tk ) ; 1169 CreateToken ct = (CreateToken)HybsSystem.newInstance( cls ); 1170 ctArray.add( ct ); 1171 } 1172 } 1173 } 1174 1175 /** 1176 * 【TAG】URLチェック用の確認キーに対して、リンクの有効期限を指定します(初期値:60分)。 1177 * 1178 * @og.tag 1179 * URLチェック用の確認キーに対して、リンクが生成されてからの有効期限を分単位で設定します。 1180 * 属性値の先頭に'D'をつけることで、日付指定を行うことができます。 1181 * (D20090612 ⇒ 20090612まで(当日を含む)は有効) 1182 * 1183 * 初期値は、現在時間を基準として+ "1440"(1日) です。 1184 * 1185 * @og.rev 4.3.8.0 (2009/08/01) 新規追加 1186 * 1187 * @param time リンクの有効期限(分) 1188 */ 1189 public void setUrlCheckTime( final String time ) { 1190 String tm = getRequestParameter( time ); 1191 1192 if( tm != null && tm.length() > 0 && tm.charAt( 0 ) == 'D' ) { 1193 if( tm.length() < 9 ) { 1194 String errMsg = "urlCheckTime属性の日付はYYYYMMDD形式で指定して下さい。" 1195 + " 値=" + tm ; // 5.1.8.0 (2010/07/01) errMsg 修正 1196 throw new HybsSystemException( errMsg ); 1197 } 1198 Calendar cal = new GregorianCalendar( 1199 Integer.valueOf( tm.substring( 1, 5 ) ) 1200 ,Integer.valueOf( tm.substring( 5, 7 ) ) - 1 1201 ,Integer.valueOf( tm.substring( 7, 9 ) ) ); 1202 urlCheckTime = cal.getTimeInMillis() + (long)1000 * 60 * 60 * 24 - System.currentTimeMillis(); 1203 } 1204 else { 1205 urlCheckTime = nval( tm, (long)60*24 ) * 1000 * 60; 1206 } 1207 } 1208 1209 /** 1210 * 【TAG】URLチェック用の暗号化キーを指定します(初期値:デフォルト)。 1211 * 1212 * @og.tag 1213 * URLチェックに利用される暗号化のキーをしています。 1214 * 受け側の設定(URL_CHECK_CRYPT)に合わせてください。 1215 * 1216 * 未指定の場合は標準が利用されます。 1217 * (システムリソースURL_CHECK_CRYPTが設定されている場合はそちらを利用) 1218 * 1219 * @og.rev 5.8.8.0 (2015/06/05) 新規追加 1220 * 1221 * @param crypt 暗号化キー 1222 */ 1223 public void setUrlCheckCrypt( final String crypt ) { 1224 urlCheckCrypt = nval( getRequestParameter( crypt ),urlCheckCrypt ); 1225 } 1226 1227 /** 1228 * このオブジェクトの文字列表現を返します。 1229 * 基本的にデバッグ目的に使用します。 1230 * 1231 * @return このクラスの文字列表現 1232 */ 1233 @Override 1234 public String toString() { 1235 return org.opengion.fukurou.util.ToString.title( this.getClass().getName() ) 1236 .println( "VERSION" ,VERSION ) 1237 .println( "column" ,column ) 1238 .println( "onLink" ,onLink ) 1239 .println( "fileCheck" ,fileCheck ) 1240 .println( "filePath" ,filePath ) 1241 .println( "baseURL" ,baseURL ) 1242 .println( "fileURL" ,fileURL ) 1243 .println( "gamenId" ,gamenId ) 1244 .println( "useGamenId" ,useGamenId ) 1245 .println( "markList" ,markList ) 1246 .println( "xlink" ,xlink ) 1247 .println( "useDirectJump" ,useDirectJump ) 1248 .println( "useRequestCache" ,useRequestCache) 1249 .println( "hrefOnly" ,hrefOnly ) 1250 .println( "hrefTarget" ,hrefTarget ) // 5.5.5.6 (2012/08/31) 1251 .println( "validDuration" ,validDuration ) 1252 .println( "keys" ,keys ) 1253 .println( "vals" ,vals ) 1254 .println( "delKeys" ,delKeys ) 1255 .println( "useURLCheck" ,useURLCheck ) 1256 .println( "urlCheckUser" ,urlCheckUser ) 1257 .println( "urlCheckTime" ,urlCheckTime ) 1258 .println( "Other..." ,getAttributes().getAttribute() ) 1259 .fixForm().toString() ; 1260 } 1261}