    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 * ●形式：&lt;og:link href="…" &gt;  ...  &lt;/og:link &gt;
    044 * ●body：あり(EVAL_BODY_BUFFERED:BODYを評価し、{&#064;XXXX} を解析します)
    045 *
    046 * ●Tag定義：
    047 *   &lt;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 *   &gt;   ... Body ...
    104 *   &lt;/og:link&gt;
    105 *
    106 * ●使用例
    107 *    ・普通のリンク
    108 *        &lt;og:link gamenId="32ExcelIn" href="direct.jsp" keys="location,filename,modifyType" value="{&#064;GUI.ADDRESS},{&#064;GUI.ADDRESS}.xls,A"  target="RESULT" &gt;
    109 *            &lt;img src="{&#064;SYS.JSP}/image/insert.gif" alt="Excel Insert" /&gt;&lt;og:message lbl="MSG0057" /&gt;
    110 *        &lt;/og:link&gt;
    111 *
    112 *    ・検索結果テーブル内でのリンク
    113 *        &lt;og:viewLink command="{&#064;command}"&gt;
    114 *            &lt;og:link column="KMZ" gamenId="RK0251" href="index.jsp" target="CONTENTS"
    115 *                keys="KMZ,ORDER_BY,command" vals="[KMZ],'LKIS',NEW" /&gt;
    116 *        &lt;/og:viewLink&gt;
    117 *
    118 *    ・ダイレクトジャンプ(指定の画面へ直接飛ばす)URL
    119 *      gamenId を指定しなければこの画面へのURLを作成します。
    120 *      このURLは、その画面の index.jsp に直接ジャンプするためのURLです。
    121 *      この場合、useRequestCache="true" が初期値なので、必要なければ、false に設定願います。
    122 *        &lt;og:link useDirectJump="true" delKeys="pageSize"
    123 *                     keys="location,filename,modifyType" value="{&#064;GUI.ADDRESS},{&#064;GUI.ADDRESS}.xls,A" /&gt;
    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属性のＵＲＬへの自動セットを行うかどうかを決める属性( useGamenId )を追加。
    215         * @og.rev 3.1.8.0 (2003/05/16) 画面ＩＤが指定されたときのリンク情報作成方法を通常のリンク時にも適用する。
    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属性のＵＲＬへの自動セットを行うかどうかを決める属性( 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属性のＵＲＬへの自動セットを行うかどうかを決める属性( 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 ) ? "&amp;" : "&" ;
    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         * リンク先の画面ＩＤは、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         * 画面ＩＤとhref から、指定のＵＲＬを作成します。
    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属性のＵＲＬへの自動セットを行うかどうかを決める属性( useGamenId )を追加。
    642         * @og.rev 3.1.8.0 (2003/05/16) 画面ＩＤが指定されたときのリンク情報作成方法を通常のリンク時にも適用する。
    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&amp;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属性のＵＲＬへの自動セットを行うかどうかを決める属性( 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;)を、(&amp;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}