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