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