001/*
002 * Copyright (c) 2009 The openGion Project.
003 *
004 * Licensed under the Apache License, Version 2.0 (the "License");
005 * you may not use this file except in compliance with the License.
006 * You may obtain a copy of the License at
007 *
008 *     http://www.apache.org/licenses/LICENSE-2.0
009 *
010 * Unless required by applicable law or agreed to in writing, software
011 * distributed under the License is distributed on an "AS IS" BASIS,
012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
013 * either express or implied. See the License for the specific language
014 * governing permissions and limitations under the License.
015 */
016package org.opengion.hayabusa.taglib;
017
018import static org.opengion.fukurou.util.StringUtil.nval;
019
020import java.io.IOException;
021import java.io.ObjectInputStream;
022import java.io.ObjectOutputStream;
023
024import javax.mail.internet.MimeUtility;
025import javax.servlet.ServletException;
026import javax.servlet.http.HttpServletRequest;
027import javax.servlet.http.HttpServletResponse;
028
029import org.opengion.fukurou.security.HybsCryptography;
030import org.opengion.fukurou.util.LogWriter;
031import org.opengion.fukurou.util.StringUtil;
032import org.opengion.fukurou.util.XHTMLTag;
033import org.opengion.hayabusa.common.HybsSystem;
034import org.opengion.hayabusa.common.HybsSystemException;
035import org.opengion.hayabusa.db.DBTableModel;
036import org.opengion.hayabusa.resource.GUIInfo;
037
038/**
039 * 制御を別の画面にフォワードする場合に使用するタグです(通常は、entry.jsp で使用します)。
040 *
041 * フォワード時に、指定の引数をセットできます。
042 *
043 * @og.formSample
044 * ●形式:<og:forward page="…" gamenId="[…]" />
045 * ●body:なし
046 *
047 * ●Tag定義:
048 *   <og:forward
049 *       gamenId            【TAG】gamenId 属性を登録します
050 *       page             ○【TAG】転送先URLを指定します(必須)。
051 *       keys               【TAG】キーを CSV 形式でセットします
052 *       vals               【TAG】キーに対応する値を CSV 形式でセットします
053 *       dbkeys             【TAG】DBキーをCSV 形式でセットします
054 *       scope              【TAG】キャッシュする場合のスコープ[request/page/session/applicaton]を指定します(初期値:session)
055 *       useRedirect        【TAG】response.sendRedirect するかどうか[true/false]を指定します(初期値:false)
056 *       target             【TAG】サブミット先の文書を表示させるフレーム、またはウィンドウの名前を指定します
057 *       filename           【TAG】ファイル転送時にファイル名の別名を指定します(初期値:null)
058 *       noTransition       【TAG】(通常は使いません)画面遷移を行わない形式の登録方法を使用するかを指定します
059 *       useAjaxSubmit      【TAG】(通常は使いません)ajaxを利用したsubmitを利用するかどうかを指定します
060 *       redirectEncode     【TAG】(通常は使いません)useRedirect=true時に 日本語を含む転送先(page)をバイナリ変換するときのコード名[UTF-8/Windows-31J]など(初期値:null)
061 *       debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
062 *   />
063 *
064 * ●使用例
065 *       <og:forward
066 *          page          = "転送先URLを指定します(必須)。"
067 *          dbkeys        = "DBキーをCSV 形式でセットします。"
068 *          keys          = "キーを CSV 形式でセットします。"
069 *          vals          = "キーに対応する値を CSV 形式でセットします。"
070 *          scope         = "キャッシュする場合のスコープ(request,page,session,applicaton)を指定します(初期値:session)。"
071 *          gamenId       = "gamenId 属性を登録します。"
072 *          useRedirect   = "useRedirect 属性を登録します。"
073 *          filename      = "ファイル転送時にファイル名を指定する場合に設定します。"
074 *          target        = "taregt 属性を登録します。"
075 *          noTransition  = "実際にforwardせずに、id="forwardUrl"属性のbody部分に遷移先のURLを出力します。(画面遷移なしモード時に使用します)"
076 *       />
077 *
078 * @og.group 画面制御
079 *
080 * @version  4.0
081 * @author       Kazuhiko Hasegawa
082 * @since    JDK5.0,
083 */
084public class ForwardTag extends CommonTagSupport {
085        //* このプログラムのVERSION文字列を設定します。   {@value} */
086        private static final String VERSION = "5.7.4.1 (2014/03/14)" ;
087
088        private static final long serialVersionUID = 574120140314L ;
089
090        private transient DBTableModel  table   = null;
091        private String          tableId         = HybsSystem.TBL_MDL_KEY;
092        private String          page            = null;
093        private String          keys            = null;
094        private String          dbkeys          = null;
095        private String[]        vals            = null;
096        private String          gamenId         = null;         // 3.5.4.9 (2004/02/25) 追加
097        private boolean         useRedirect = false;    // 3.5.6.6 (2004/08/23) 追加
098        private String          target          = null;         // 3.8.0.4 (2005/08/08) 追加
099        private String          filename        = null;         // 4.0.0 (2005/11/30) 追加
100        private static final String             disposition = "inline"; // 固定
101        private boolean         noTransition= false;    // 4.3.3.0 (2008/10/01) 追加
102        private boolean         useAjaxSubmit           = false;        // 4.3.8.0 (2009/08/01) 追加
103//      private boolean         useEncodeRedirect       = true;         // 5.6.5.0 (2013/06/07) 追加、即廃止
104        private String          redirectEncode  = null;                 // 5.6.5.0 (2013/06/07) 追加
105        // urlCheck関係 5.10.11.0 (2019/05/03) 追加
106        private boolean useURLCheck = HybsSystem.sysBool( "LINK_URL_CHECK" );
107        private long            urlCheckTime= 1000*60*60*24;// 5.10.11.0 (2019/05/03)
108        private String          urlCheckCrypt = HybsSystem.sys( "URL_CHECK_CRYPT" );
109
110        /**
111         * Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
112         *
113         * @og.rev 2.1.0.0 (2002/10/11) 戻り値の先頭の "?" を追加しないように変更。
114         * @og.rev 3.0.1.3 (2003/03/11) 直接転送した場合の整合性を取る為の対応。
115         * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
116         * @og.rev 3.1.2.0 (2003/04/07) ソースコード中の固定値を、定義ファイルを使用するように変更する。
117         * @og.rev 3.5.4.9 (2004/02/25) gamenId を指定して、フォワードできるようにします。
118         * @og.rev 3.5.6.6 (2004/08/23) useRedirect 属性を追加します。
119         * @og.rev 4.3.3.0 (2008/10/01) noTransition 属性を追加します。
120         * @og.rev 4.3.7.1 (2009/06/08) target属性に絶対パス及び"_"で始まる予約語を指定できるようにします。
121         * @og.rev 4.3.8.0 (2009/08/01) useAjaxSubmit対応、noTransition値取得メソッド名変更
122         * @og.rev 5.0.0.4 (2009/10/01) 画面遷移なし登録で戻った際に最終行が選択されるバグを修正
123         * @og.rev 5.1.3.0 (2010/02/01) noTransition、ajaxSubmitのコントロールは、requestで行う。
124         * @og.rev 5.1.6.0 (2010/05/01) IE以外は、MIMEエンコードする。(RFC2231に従う)
125         * @og.rev 5.1.7.0 (2010/06/01) 画面IDをパラメーターに付加する。
126         * @og.rev 5.1.7.0 (2010/06/01) 遷移先がJSP以外の場合は、フォワードページのキャッシュをしない。
127         * @og.rev 5.1.8.0 (2010/07/01) httpが指定されていた場合に、自身の画面IDが付加されるバグを修正
128         * @og.rev 5.3.8.0 (2011/08/01) ファイル名指定でIEの場合、URLエンコードすると途中で切れるため(IE7のバグ)、Shift_JIS(WIndows-31J)で直接指定する。
129         * @og.rev 5.6.5.0 (2013/06/07) redirectEncode 属性を追加します。
130         * @og.rev 5.7.4.1 (2014/03/14) 日本語ファイル名が正しく処理できない件を修正(IE11のMSIE関連)
131         * @og.rev 5.9.29.0 (2018/01/30) Edge,safariの日本語ファイル名対応(RFC6266方式を併記)
132         * @og.rev 5.10.11.0 (2019/05/03) URLチェック対応を追加
133         *
134         * @return      後続処理の指示
135         */
136        @Override
137        public int doEndTag() {
138                debugPrint();           // 4.0.0 (2005/02/28)
139                // noTransition = isNoTransitionRequest() || noTransition; // 4.3.3.0 (2008/10/01) 追加
140//              noTransition = isNoTransitionSession() || noTransition; // 4.3.8.0 (2009/08/01) メソッド名変更
141//              useAjaxSubmit    = isAjaxSubmitSession() || useAjaxSubmit; // 4.3.8.0 (2009/08/01) 追加
142                noTransition = isNoTransitionRequest(); // 5.1.3.0 (2010/02/01)
143                useAjaxSubmit = isAjaxSubmitRequest(); // 5.1.3.0 (2010/02/01)
144
145                String urlEnc = getUrlEncode();
146                String fwdUrl = makeGamenLink();                // 3.5.4.9 (2004/02/25)
147
148                HttpServletResponse response = (HttpServletResponse)pageContext.getResponse();
149                try {
150                        String url = response.encodeRedirectURL( fwdUrl );      // 3.5.4.9 (2004/02/25)
151
152                        if( filename != null ) {
153                                // 5.1.6.0 (2010/05/01) IE以外は、MIMEエンコードする。(RFC2231に従う)
154//                              if( ( (HttpServletRequest)pageContext.getRequest() ).getHeader( "User-Agent" ).indexOf( "MSIE" ) == -1 ) {
155//                                      filename = MimeUtility.encodeWord( filename, "UTF-8", "B" );
156//                              }
157//                              else {
158//                                      // 5.3.8.0 (2011/08/01) IEの場合、URLエンコードすると途中で切れるため(IE7のバグ)、Shift_JIS(WIndows-31J)で直接指定する。
159////                                    filename = StringUtil.urlEncode( filename );
160//                                      filename = new String( filename.getBytes("Windows-31J"), "ISO-8859-1" );
161//                              }
162                                String newFilename        = filename;
163                                String newFilenameEnc = StringUtil.urlEncode( newFilename );  // 5.9.29.0 (2018/02/02)
164                                
165                                // 5.7.4.1 (2014/03/14) 日本語ファイル名が正しく処理できない件を修正(IE11のMSIE関連)
166                                // 条件を反転させた上でIE11対応を行う
167                                String reqHeader = ((HttpServletRequest)pageContext.getRequest()).getHeader( "User-Agent" );
168                                if( reqHeader.indexOf( "MSIE" ) >= 0 || reqHeader.indexOf( "Trident" ) >= 0 ) {
169                                        filename = new String( filename.getBytes("Windows-31J"), "ISO-8859-1" );
170                                }
171                                else {
172                                        filename = MimeUtility.encodeWord( filename, "UTF-8", "B" );
173                                }
174
175//                              (response).setHeader( "Content-Disposition",disposition + "; filename=\"" + filename + "\"" );
176                                (response).setHeader( "Content-disposition",disposition + "; filename=\"" + newFilename + "\"; "
177                                                + "filename*=UTF-8''" + newFilenameEnc ); // 5.9.29.0 (2018/02/02) RFC6266方式を併記
178                        }
179                        // 5.1.7.0 (2010/06/01) 画面IDをパラメーターに付加する。
180                        // 5.1.8.0 (2010/07/01) httpが指定されていた場合に、自身の画面IDが付加されるバグを修正
181                        else {
182//                              if( page.endsWith( ".jsp" ) ) {
183                                if( !page.startsWith( "http" ) && page.endsWith( ".jsp" ) ) {
184                                        if( keys == null || keys.length() == 0 || ( "," + keys + "," ).indexOf( ",GAMENID," ) < 0 ) {
185                                                if( gamenId != null && gamenId.length() > 0 ) {
186                                                        url = XHTMLTag.addUrlEncode( url, "GAMENID=" + gamenId );
187                                                }
188                                                // useRedirect=trueでGAMENIDを指定せず、../GF9100/index.jsp等と書かれている場合の対応
189                                                else if( !useRedirect ) {
190                                                        url = XHTMLTag.addUrlEncode( url, "GAMENID=" + getGUIInfoAttri( "KEY" ) );
191                                                }
192                                        }
193                                }
194                        }
195
196                        // 3.5.6.6 (2004/08/23) useRedirect 属性を追加
197                        String url2 = XHTMLTag.addUrlEncode( url , urlEnc );
198                        // 4.3.3.0 (2008/10/01) 追加
199                        // if( noTransition ) {
200                        if( noTransition || useAjaxSubmit ) { // 4.3.8.0 (2009/08/01) useAjaxSubmitと共用
201                                // 5.0.0.4 (2009/10/01)
202                                if( noTransition ) {
203                                        int selRow = nval( getRequestValue( "SEL_ROW" ),-1 );
204                                        if( selRow > 0 ) {
205                                                url2 = XHTMLTag.addUrlEncode( url2, "SEL_ROW=" + selRow );
206                                        }
207                                }
208                                if( useURLCheck ) { // 5.10.11.0 (2019/05/03) useURLCheck追加
209                                        url2 = addURLCheck(url2);
210                                }
211                                jspPrint( "<div id=\"noTransitionUrl\">" + url2 + "</div>" );
212                                jspPrint( "<div id=\"noTransitionTarget\">" + target + "</div>" );
213                        }
214                        
215                        // 3.8.0.4 (2005/08/08) target 属性を追加します。
216//                      else if( target != null ) {
217                        else if( target != null && target.length() > 0 ) {
218                                // 4.3.7.1 (2009/06/08)
219                                String src = null;
220                                if( useURLCheck ) { // 5.10.11.0 (2019/05/03) useURLCheck追加
221                                        url2 = addURLCheck(url2);
222                                }
223                                
224                                if( target.startsWith( "_b" ) ) { // "_blank"
225                                        src = "window.open(\"" + url2 + "\", \"_blank\") ";
226                                }
227                                else {
228                                        String frameTop = "";
229                                        if( target.indexOf('.') < 0 ) { frameTop = "top."; }
230                                        src = frameTop + target + ".location.href=\"" + url2 + "\"" + HybsSystem.CR;
231                                }
232//                              String script = "<script language=\"JavaScript\" ><!-- " + HybsSystem.CR
233                                String script = "<script type=\"text/javascript\" ><!-- " + HybsSystem.CR
234                                                                + src + HybsSystem.CR
235                                                        + "// --></script>" ;
236                                jspPrint( script );
237                        }
238                        else if( useRedirect ) {
239                                if( useURLCheck ) { // 5.10.11.0 (2019/05/03) useURLCheck追加
240                                        url2 = addURLCheck(url2);
241                                }
242                                // 5.6.5.0 (2013/06/07) redirectEncode 属性追加
243                                if( redirectEncode != null ) {
244                                        url2 = new String( url2.getBytes( redirectEncode ), "ISO-8859-1" );
245                                }
246                                response.sendRedirect( url2  );
247                        }
248                        else {
249                                pageContext.forward( url2 );
250                        }
251                } catch(IOException ex) {
252                        String errMsg = "フォワード/リダイレクトでIOエラーが発生しました。"
253                                                                + HybsSystem.CR
254                                                                + fwdUrl + "?" + urlEnc ;
255                        throw new HybsSystemException( errMsg,ex );             // 3.5.5.4 (2004/04/15) 引数の並び順変更
256                } catch( ServletException ex) {
257                        String errMsg = "フォワード/リダイレクトでServletエラーが発生しました。"
258                                                                + HybsSystem.CR
259                                                                + fwdUrl + "?" + urlEnc ;
260                        throw new HybsSystemException( errMsg,ex );             // 3.5.5.4 (2004/04/15) 引数の並び順変更
261                }
262
263                // 3.0.1.3 (2003/03/11) forward で直接転送した場合の整合性を取る為の対応。
264                // 5.1.7.0 (2010/06/01) 遷移先がJSP以外の場合は、フォワードページのキャッシュをしない。
265                if( fwdUrl != null && fwdUrl.endsWith( ".jsp" ) ) {
266                        setSessionAttribute( HybsSystem.FORWARD_PAGE_KEY, fwdUrl );     // 3.5.4.9 (2004/02/25)
267                }
268
269                return(SKIP_PAGE);              // ページの残りの処理を行わない。
270        }
271
272        /**
273         * タグリブオブジェクトをリリースします。
274         * キャッシュされて再利用されるので、フィールドの初期設定を行います。
275         *
276         * @og.rev 2.0.0.4 (2002/09/27) カスタムタグの release() メソッドを、追加
277         * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
278         * @og.rev 3.5.4.9 (2004/02/25) 画面ID属性(gamenId)を追加
279         * @og.rev 3.8.5.0 (2006/03/06) filename 属性を追加します。
280         * @og.rev 4.3.3.0 (2008/10/01) noTransition 属性を追加します。
281         * @og.rev 5.6.5.0 (2013/06/07) redirectEncode 属性を追加します。
282         * @og.rev 5.10.11.0 (2019/05/03) urlCheck対応
283         *
284         */
285        @Override
286        protected void release2() {
287                super.release2();
288                tableId         = HybsSystem.TBL_MDL_KEY;
289                page            = null;
290                keys            = null;
291                dbkeys          = null;
292                vals            = null;
293                table           = null;
294                gamenId         = null;
295                useRedirect = false;    // 3.5.6.6 (2004/08/23) 追加
296                target          = null;         // 3.8.0.4 (2005/08/08) 追加
297                filename        = null;
298                noTransition= false;    // 4.3.3.0 (2008/10/01) 追加
299                useAjaxSubmit           = false;        // 4.3.8.0 (2009/08/01) 追加
300                redirectEncode  = null;                 // 5.6.5.0 (2013/06/07) 追加
301                useURLCheck             = HybsSystem.sysBool( "LINK_URL_CHECK" ); // 5.10.11.0 (2019/05/03)
302        }
303
304        /**
305         * keys 属性 を元に、request情報より values の値を取り込む。
306         *
307         * keys属性は キー情報がカンマ区切りになっている為,ばらして
308         * values属性の配列に一つづつ設定していきます。
309         *
310         * @og.rev 3.1.7.0 (2003/05/02) 戻るボタン用のBACK_GAMENID を、引数に追加します。
311         * @og.rev 3.1.8.0 (2003/05/16) 戻るボタン用のBACK_GAMENID の自動登録を廃止します。
312         * @og.rev 4.0.0.0 (2005/01/31) getParameterRows() を使用するように変更
313         *
314         * @return      URLエンコードされた文字列
315         */
316        private String getUrlEncode() {
317                String[] dbkey = StringUtil.csv2Array( dbkeys );
318                String[] key   = StringUtil.csv2Array( keys );
319
320//              int dbCount = (dbkey != null) ? dbkey.length : 0 ;
321//              int count   = (key   != null) ? key.length   : 0 ;
322                int dbCount = dbkey.length;
323                int count   = key.length  ;
324
325                String[] allKey = new String[ dbCount + count ];
326                String[] allval = new String[ dbCount + count ];
327
328                int[] rowNo = getParameterRows();               // 4.0.0 (2005/01/31)
329                if( dbCount > 0 && dbkey[0] != null && dbkey[0].length() > 0 && rowNo.length > 0 ) {
330                        table = (DBTableModel)getObject( tableId );
331                        if( table != null ) {
332                                for( int i=0; i<dbCount; i++ ) {
333                                        allKey[i] = dbkey[i];
334                                        allval[i] = table.getValue(rowNo[0],table.getColumnNo( dbkey[i] ));
335                                }
336                        }
337                }
338
339                if( count > 0 ) {
340                        for( int i=0; i<count; i++ ) {
341                                allKey[i+dbCount] = key[i];
342                                allval[i+dbCount] = vals[i];
343                        }
344                }
345
346                return XHTMLTag.urlEncode( allKey,allval );
347        }
348
349        /**
350         * 【TAG】転送先URLを指定します。
351         *
352         * @og.tag 転送先URLを指定します。
353         *
354         * @param       url 転送先URL
355         */
356        public void setPage( final String url ) {
357                page = getRequestParameter( url );
358        }
359
360        /**
361         * 【TAG】DBキーをCSV 形式でセットします。
362         *
363         * @og.tag
364         * URI の引数にセットするキーを CSV 形式でセットします。
365         * ここの指定は,DBTableModel 上のデータを取り込みます。
366         *
367         * @param       key DBキー(CSV 形式)
368         */
369        public void setDbkeys( final String key ) {
370                dbkeys = getRequestParameter( key ) ;
371        }
372
373        /**
374         * 【TAG】キーを CSV 形式でセットします。
375         *
376         * @og.tag
377         * URI の引数にセットするキーを CSV 形式でセットします。
378         *
379         * @param       key キー(CSV 形式)
380         */
381        public void setKeys( final String key ) {
382                keys = getRequestParameter( key ) ;
383        }
384
385        /**
386         * 【TAG】キーに対応する値を CSV 形式でセットします。
387         *
388         * @og.tag
389         * URI の引数にセットする値を CSV 形式でセットします。
390         * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
391         * こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。
392         *
393         * @og.rev 3.5.6.2 (2004/07/05) CommonTagSupport#getCSVParameter を使用
394         *
395         * @param       val 値(CSV 形式)
396         */
397        public void setVals( final String val ) {
398                vals = getCSVParameter( val );
399
400                // 先に分解しないとデータ自身にカンマを持っている場合に分解をミスる。
401        }
402
403        /**
404         * 画面IDとpage から、フォワードするURLを作成します。
405         * page が null の場合は、index.jsp に転送されます。
406         *
407         * @og.rev 3.5.4.9 (2004/02/25) 新規追加
408         * @og.rev 3.5.5.0 (2004/03/12) URLを求めるのに、GUIInfo#getRealAddress() を使用する。
409         * @og.rev 4.0.0.0 (2005/01/31) GUIInfoの実アドレスのパラメータを考慮する。
410         *
411         * @return      フォワードするURL(転送先URL)
412         */
413        private String makeGamenLink() {
414                if( page == null ) { page = "index.jsp"; }
415
416                if( gamenId == null || gamenId.length() == 0 ) { return page; }
417
418                GUIInfo guiInfo = getGUIInfo( gamenId );
419                if( guiInfo == null ) { // 見つからない場合は、転送しない
420                        LogWriter.log( "Forward[" + gamenId + "]先にはアクセス不可です。" );
421                        return page;
422                }
423
424                String address = guiInfo.getRealAddress( page );
425                String link = getRequestParameter( address );
426
427                // Ver 4.0.0 (2007/06/12) gamenId を使用する場合は、useRedirect = true をセット
428                useRedirect = true;
429                return link;
430        }
431
432        /**
433         * 【TAG】gamenId 属性を登録します。
434         *
435         * @og.tag
436         * gamenId 属性は、画面IDをキーに、実アドレスを求めるのに使用します。
437         * 画面IDが指定された場合は、実アドレスに変換する。指定されない場合は、
438         * page 属性をそのままリダイレクトアドレスとします。
439         * gamenId を指定した場合は、このuseRedirect属性に関係なく、Redirect されます。
440         *
441         * @og.rev 3.5.4.9 (2004/02/25) 新規追加
442         *
443         * @param   id gamenId 属性
444         * @see         #setUseRedirect( String )
445         */
446        public void setGamenId( final String id ) {
447                gamenId = nval( getRequestParameter( id ),gamenId );
448        }
449
450        /**
451         * 【TAG】response.sendRedirect するかどうか[true/false]を指定します(初期値:false)。
452         *
453         * @og.tag
454         * useRedirect 属性は、URLの転送方式を指定できます。
455         * 通常は、pageContext.forward しますが、この属性に true を
456         * 設定すると、response.sendRedirect します。
457         * gamenId を指定した場合は、この属性に関係なく、Redirect されます。
458         * 初期値は、false (forward) です。
459         *
460         * @og.rev 3.5.6.6 (2004/08/23) 新規追加
461         *
462         * @param   flag useRedirect 属性 [false:forwrd/true:redirect]
463         * @see         #setGamenId( String )
464         */
465        public void setUseRedirect( final String flag ) {
466                useRedirect = nval( getRequestParameter( flag ),useRedirect );
467        }
468
469        /**
470         * 【TAG】サブミット先の文書を表示させるフレーム、またはウィンドウの名前を指定します。
471         *
472         * @og.tag サブミット先のフレーム名(ターゲット属性)を設定します。
473         *
474         * @og.rev 3.8.0.4 (2005/08/08) 新規追加
475         *
476         * @param       flag サブミット先の文書のフレーム名(ターゲット属性)
477         */
478        public void setTarget( final String flag ) {
479                target = nval( getRequestParameter( flag ),target );
480        }
481
482        /**
483         * 【TAG】ファイル転送時にファイル名の別名を指定します(初期値:null)。
484         *
485         * @og.tag
486         * ファイルを転送する場合に、オープンさせるファイル名を指定します。
487         * 指定しない場合は、フォラード前に呼び出されたアドレスがそのまま使用されます。
488         *
489         * @param   name ファイル名
490         */
491        public void setFilename( final String name ) {
492                filename = nval( getRequestParameter( name ),filename );
493        }
494
495        /**
496         * 【TAG】(通常は使いません)画面遷移を行わない形式の登録方法を使用するかを指定します。
497         *
498         * @og.tag
499         * 画面遷移なしの登録を行うかどうかを指定します。
500         * trueが指定された場合、forwardタグでは、実際の画面遷移は行わずに、forward先の
501         * URLを<div id="noTransitionUrl">[URL]</div>の形でHTMLとして出力し、JavaScript側で
502         * 実際の画面遷移を発生させます。target属性は<div id="noTransitionTarget">[TARGET]</div>で
503         * 出力されます。
504         *
505         * この値は、og:headタグで設定値、または前画面からの値を継承するため、通常、この属性ではセットしません。
506         *
507         * @og.rev 4.3.3.0 (2008/10/01) 新規追加
508         * @og.rev 5.1.3.0 (2010/02/01) noTransition、ajaxSubmitのコントロールは、requestで行う。
509         *
510         * @param   noTrnstn 画面遷移を行わない形式の登録方法を使用するか
511         */
512        public void setNoTransition( final String noTrnstn ) {
513//              noTransition = nval( getRequestParameter( noTrnstn ), noTransition );
514                setNoTransitionRequest( nval( getRequestParameter( noTrnstn ), isNoTransitionRequest() ) );
515        }
516
517        /**
518         * 【TAG】(通常は使いません)ajaxを利用したsubmitを利用するかどうかを指定します。
519         *
520         * @og.tag
521         * ajaxを利用したSubmit処理を行うかどうかを指定します。
522         * setNoTransitionをtrueにした場合と同様の処理を行います。
523         * (forwardせずにURLをDIVタグで出力する)
524         *
525         * この値は、og:headタグで設定値、または前画面からの値を継承するため、通常、この属性ではセットしません。
526         *
527         * @og.rev 4.3.8.0 (2009/08/01) 新規追加
528         * @og.rev 5.1.3.0 (2010/02/01) noTransition、ajaxSubmitのコントロールは、requestで行う。
529         *
530         * @param   ajaxSubmit ajaxを利用したsubmitを利用するかどうか
531         */
532        public void setUseAjaxSubmit( final String ajaxSubmit ) {
533//              useAjaxSubmit = nval( getRequestParameter( ajaxSubmit ), useAjaxSubmit );
534                setAjaxSubmitRequest( nval( getRequestParameter( ajaxSubmit ), isAjaxSubmitRequest() ) );
535        }
536
537        /**
538         * 【TAG】(通常は使いません)useRedirect=true時に 日本語を含む転送先(page)をバイナリ変換するときのコード名[UTF-8/Windows-31J]など(初期値:null)
539         *
540         * @og.tag
541         * 日本語ファイル名を持つ URL を useRedirect で転送する場合に、転送先(page)をバイナリ変換しないと、転送できないケースがあります。
542         * このあたりは、ブラウザにも依存するので、既存の処理に影響しない様に、このパラメータを使用する場合のみ
543         * 処理を実行します。
544         * IEでの日本語ファイル転送で、うまくいかない場合の、暫定処置です。
545         * IEの場合は、redirectEncode="UTF-8" で、日本語ファイルを転送できます。
546         * ただし、useRedirect=true時に filename 属性によるファイル名の書き換え処理はできませんので、ご注意ください。
547         * 初期値は、null で、バイナリエンコードしません。(互換性ありの状態です。)
548         *
549         * @og.rev 5.6.5.0 (2013/06/07) 新規追加
550         *
551         * @param   redEnc URL を 転送する場合に、日本語を含む転送先(page)をバイナリ変換するときのコード名
552         */
553        public void setRedirectEncode( final String redEnc ) {
554                redirectEncode = nval( getRequestParameter( redEnc ), redirectEncode );
555        }
556        
557        /**
558         * 【TAG】リンクアドレスにURLチェック用の確認キーを付加するかどうか[true/false]を指定します。
559         *
560         * @og.tag
561         * この属性は、URLCheckFilter(org.opengion.hayabusa.filter.URLCheckFilter)と合わせて使用します。
562         * trueが指定された場合、リンクURLのパラメーターに、URL確認用のパラメーターが出力されます。
563         * このパラメーターを、URLCheckFilterが復号化し、正式なアクセスであるかどうかの判定を行います。
564         *
565         * 初期値は、 システムリソースのLINK_URL_CHECK です。
566         *
567         * @og.rev 5.10.11.0 (2019/05/03) 新規追加
568         *
569         * @param       flag 暗号化するかかどうか [true:暗号化する/false:しない]
570         * @see org.opengion.hayabusa.filter.URLCheckFilter
571         */
572        public void setUseURLCheck( final String flag ) {
573                useURLCheck = nval( getRequestParameter( flag ),useURLCheck );
574        }
575
576        /**
577         * シリアライズ用のカスタムシリアライズ書き込みメソッド
578         *
579         * @og.rev 4.0.0.0 (2006/09/31) 新規追加
580         * @serialData 一部のオブジェクトは、シリアライズされません。
581         *
582         * @param       strm    ObjectOutputStreamオブジェクト
583         * @throws IOException  シリアライズに関する入出力エラーが発生した場合
584         */
585        private void writeObject( final ObjectOutputStream strm ) throws IOException {
586                strm.defaultWriteObject();
587        }
588
589        /**
590         * シリアライズ用のカスタムシリアライズ読み込みメソッド
591         *
592         * ここでは、transient 宣言された内部変数の内、初期化が必要なフィールドのみ設定します。
593         *
594         * @og.rev 4.0.0.0 (2006/09/31) 新規追加
595         * @serialData 一部のオブジェクトは、シリアライズされません。
596         *
597         * @param       strm    ObjectInputStreamオブジェクト
598         * @see #release2()
599         * @throws IOException  シリアライズに関する入出力エラーが発生した場合
600         * @throws ClassNotFoundException       クラスを見つけることができなかった場合
601         */
602        private void readObject( final ObjectInputStream strm ) throws IOException , ClassNotFoundException {
603                strm.defaultReadObject();
604        }
605        
606        /**
607         * urlCheckのパラメータを付加します。 
608         * 
609         * @param url 元のアドレス
610         * @return urlCheckを付加したアドレス
611         */
612        private String addURLCheck( final String url ) {
613                HybsCryptography criptCls = null;
614                if( urlCheckCrypt != null && urlCheckCrypt.length() > 0 ){
615                        criptCls = new HybsCryptography( urlCheckCrypt );
616                }
617                return XHTMLTag.addURLCheckKey( url, HybsSystem.URL_CHECK_KEY, getUser().getUserID(), System.currentTimeMillis() + urlCheckTime, criptCls );
618        }
619
620        /**
621         * このオブジェクトの文字列表現を返します。
622         * 基本的にデバッグ目的に使用します。
623         *
624         * @return このクラスの文字列表現
625         */
626        @Override
627        public String toString() {
628                return org.opengion.fukurou.util.ToString.title( this.getClass().getName() )
629                                .println( "VERSION"             ,VERSION        )
630                                .println( "tableId"             ,tableId        )
631                                .println( "page"                ,page           )
632                                .println( "keys"                ,keys           )
633                                .println( "dbkeys"              ,dbkeys         )
634                                .println( "vals"                ,vals           )
635                                .println( "gamenId"             ,gamenId        )
636                                .println( "useRedirect" ,useRedirect)
637                                .println( "target"              ,target         )
638                                .println( "filename"    ,filename       )
639                                .println( "disposition"         ,disposition    )
640                                .println( "noTransition"        ,noTransition   )
641                                .println( "useAjaxSubmit"       ,useAjaxSubmit  )
642                                .println( "redirectEncode"      ,redirectEncode )
643                                .println( "useURLCheck" ,useURLCheck    )
644                                .println( "Other..."    ,getAttributes().getAttribute() )
645                                .fixForm().toString() ;
646        }
647}