    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 org.opengion.hayabusa.common.HybsSystem;
    019import org.opengion.hayabusa.resource.GUIInfo;
    020import org.opengion.hayabusa.resource.RoleMode ;
    021import org.opengion.hayabusa.db.DBLastSql;
    022import org.opengion.fukurou.system.OgBuilder ;                          // 6.4.4.1 (2016/03/18)
    023import org.opengion.fukurou.util.Attributes;
    024import org.opengion.fukurou.util.XHTMLTag;
    025import org.opengion.fukurou.util.StringUtil ;
    026import org.opengion.fukurou.util.ToString;                                      // 6.1.1.0 (2015/01/17)
    027
    028import static org.opengion.fukurou.util.StringUtil.nval ;
    029
    030/**
    031 * ファイルアップロード/ダウンロードリンクを作成するタグです(通常は result_info.jsp に組込み)。
    032 *
    033 * 画面検索した結果を、ダウンロードしたり、アップロードする機能は、画面リソースの
    034 * ロール制御で管理しています。
    035 * ただし、デフォルトで、以下の制限が掛かっています。
    036 *
    037 * ファイルダウンロード
    038 *   ・command="NEW|RENEW|FIRST|LAST|PREV|NEXT|VIEW|RESET" のみ
    039 * ファイルアップロード
    040 *   ・command="COPY|INSERT" のみ
    041 *
    042 * 5.7.8.1 (2014/07/18)
    043 *  addDownCmnd と、addUpldCmnd を指定すれば、ダウンロード、アップロードできる
    044 *  command を増やすことが可能です。
    045 *
    046 * また、typeDownload="true" にするとDownload 処理を行う為の前処理を実施します。
    047 * Download 処理を行うには、指定の画面(呼び出し元)と、抜き出した時の
    048 * DBTableModel がマッチしているか判定します。
    049 * また、DBTableModel が存在しない、または、不備な場合(オーバーフロー)は、
    050 * 最終SQLを実行する必要があり、そもそも、抜出処理が出来ない状態では、
    051 * エラーを返す必要があります。
    052 * それら、一連のDownload 処理を行うかどうかを指定します。
    053 * true の場合、session の HybsSystem.DB_LAST_SQL_KEY に格納された
    054 * DBLastSql オブジェクトを取得し、scope が request または、overflow が
    055 * true の場合に、BODY部を実行します。(通常、queryタグを記述します。)
    056 * query の出力先は、scope を request にします。
    057 * それ以外は、tableId から取り出した DBTableModel を、scope = "request"
    058 * に(アドレスのみ)コピーします。
    059 * writeTable タグでは、scope = "request" から、DBTableModel を取り出します。
    060
    061 * @og.formSample
    062 * ●形式：一般ユーザーが直接組み込むことはありません。
    063 * ●body：あり(EVAL_BODY_BUFFERED:BODYを評価し、{&#064;XXXX} を解析します)
    064 *
    065 * ●Tag定義：
    066 *   &lt;og:fileUD
    067 *       command            【TAG】command を指定します
    068 *       downloadImg        【TAG】ダウンロード時のアイコンを指定します(初期値:"{&#064;SYS.JSP}/image/fileDownload.gif")
    069 *       downloadJsp        【TAG】ダウンロード時の呼び出しJSPを指定します(初期値:"{&#064;SYS.JSP}/common/fileDownload.jsp")
    070 *       uploadImg          【TAG】アップロード時のアイコンを指定します(初期値:"{&#064;SYS.JSP}/image/fileUpload.gif")
    071 *       uploadJsp          【TAG】アップロード時の呼び出しJSPを指定します(初期値:"{&#064;SYS.JSP}/common/fileUpload.jsp")
    072 *       imgWidth           【TAG】アイコン幅サイズ(px)を指定します(初期値:20px)
    073 *       imgHeight          【TAG】アイコン高さサイズ(px)を指定します(初期値:20px)
    074 *       filename           【TAG】ダウンロード時ファイル名を指定します(初期値:"{&#064;GUI.LABEL}")  6.8.1.4 (2017/08/25) 拡張子はつけません。
    075 *       addDownCmnd        【TAG】ダウンロード時のコマンドを追加指定できます(初期値:null)
    076 *       addUpldCmnd        【TAG】アップロード時のコマンドを追加指定できます(初期値:null)
    077 *       roles              【TAG】ロールズをセットします
    078 *       target             【TAG】ダウンロード文書を表示させるフレーム、またはウィンドウの名前を指定します
    079 *       errorMsg           【TAG】ダウンロード出来ない場合のエラーメッセージIDを指定します(初期値:ERR0028)
    080 *       typeDownload       【TAG】Download 処理を行うかどうかを指定します(初期値:false)
    081 *       useEditLink        【TAG】編集リンク自体を出すかどうかどうか(初期値:true)
    082 *       editImg            【TAG】編集アイコンを指定します(初期値:"{&#064;SYS.JSP}/image/edit.png")
    083 *       clmEdit            【TAG】編集時にカラム編集タブを表示するかどうか(初期値:true)
    084 *       debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
    085 *   &gt;   ... Body ...
    086 *   &lt;/og:fileUD&gt;
    087 *
    088 * ●使用例
    089 *     &lt;og:fileUD command="{&#064;command}" /&gt;
    090 *
    091 *     &lt;og:fileUD
    092 *         command        = command設定 (ダウンロード="NEW|RENEW|FIRST|LAST|PREV|NEXT|VIEW" 、   アップロード="COPY|INSERT")
    093 *       [ downloadImg ]  = "{&#064;SYS.JSP}/image/fileDownload.gif"   ダウンロード時のアイコン
    094 *       [ downloadJsp ]  = "{&#064;SYS.JSP}/common/fileDownload.jsp"  ダウンロード時の呼び出しJSP
    095 *       [ uploadImg   ]  = "{&#064;SYS.JSP}/image/fileUpload.gif"     アップロード時のアイコン
    096 *       [ uploadJsp   ]  = "{&#064;SYS.JSP}/common/filePopup.jsp"     アップロード時の呼び出しJSP
    097 *       [ imgWidth    ]  = "20px"                                アイコン幅サイズ(px)
    098 *       [ imgHeight   ]  = "20px"                                アイコン高さサイズ(px)
    099 *       [ filename    ]  = "{&#064;GUI.LABEL}.xls"               ダウンロード時ファイル名
    100 *       [ roles       ]  = "GE|DOC"                              アクセスロールズ
    101 *       [ target      ]  = "_blank"                              ダウンロードファイルを開くターゲット
    102 *       [ errorMsg    ]  = "ERR0042"                             エラーメッセージID
    103 *       [ typeDownload]  = "false/true"                          Download 処理を行うかどうか(初期値:false)
    104 *     /&gt;
    105 *
    106 * @og.group ファイルアップロード/ダウンロード
    107 *
    108 * @og.rev 4.3.0.0 (2008/07/04) 新規追加
    109 * @og.rev 5.7.4.1 (2014/03/15) エラーメッセージ変更
    110 * @og.rev 5.9.32.1 (2018/05/08) URLチェック対応
    111 *
    112 * @version  4.0
    113 * @author       Kazuhiko Hasegawa
    114 * @since    JDK5.0,
    115 */
    116public class FileUDTag extends CommonTagSupport {
    117        /** このプログラムのVERSION文字列を設定します。   {@value} */
    118        private static final String VERSION = "6.8.1.4 (2017/08/25)" ;
    119        private static final long serialVersionUID = 681420170825L ;
    120
    121        private String  sysJsp                  = HybsSystem.sys( "JSP" );
    122
    123        private String  command                 ;                       // ダウンロード="NEW|RENEW" 、アップロード="COPY|INSERT"
    124        private String  downloadImg             = sysJsp + "/image/fileDownload.gif";   // ダウンロード時のアイコン
    125        private String  downloadJsp             = sysJsp + "/common/fileDownload.jsp";  // ダウンロード時の呼び出しJSP
    126        private String  uploadImg               = sysJsp + "/image/fileUpload.gif";             // アップロード時のアイコン
    127        private String  uploadJsp               = sysJsp + "/common/filePopup.jsp";             // アップロード時の呼び出しJSP
    128        private String  imgWidth                = "20px";                                       // アイコン幅サイズ(px)
    129        private String  imgHeight               = "20px";                                       // アイコン高さサイズ(px)
    130        private String  filename                ;                                                       // ダウンロード時ファイル名("{@GUI.LABEL}")  6.8.1.4 (2017/08/25) 拡張子はつけません。
    131        private String  roles                   ;                                                       // アクセスロールズ
    132        private String  target                  ;                                                       // ダウンロードファイルを開くターゲット
    133        private String  errorMsg                = "ERR0042";                            // 出力対象データが見つかりませんでした。再度検索して下さい。 5.7.4.1 (2014/03/15)
    134        private boolean isError                 ;
    135        private boolean typeDownload    ;                                                       // Download 処理を行うかどうか(初期値:false)
    136        private boolean isEdit                  = true;                                         // 5.6.0.2 (2013/01/19) ロールのisEditとほぼ同等。clmEdit用。
    137        private boolean useEditLink             = true;                                         // 5.7.5.0 (2014/04/04) 編集リンク自体を出すかどうかどうか(初期値:true)
    138
    139        private String  addDownCmnd             ;                                                       // 5.7.8.1 (2014/07/18) ダウンロード時のコマンドを追加
    140        private String  addUpldCmnd             ;                                                       // 5.7.8.1 (2014/07/18) アップロード時のコマンドを追加
    141
    142        private static final String     EDIT_GAMENID= "14_EDIT";                                        // 編集画面の画面ID
    143        private String  editImg                 = sysJsp + "/image/edit.png";   // 編集時のアイコン
    144
    145        // 5.9.32.1 (2018/05/08) URLチェック対応
    146        private boolean useURLCheck             =  HybsSystem.sysBool( "USE_FILEUD_URL_CHECK" );        // Ver5 では、FILEUD_URL_CHECK
    147        private static final long       URL_CHECK_TIME  = 1000*60*60*24;                        // 初期値：２４時間(とりあえず固定値)
    148        private String  urlCheckCrypt   = HybsSystem.sys( "URL_CHECK_CRYPT" );
    149
    150        /**
    151         * デフォルトコンストラクター
    152         *
    153         * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
    154         */
    155        public FileUDTag() { super(); }         // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。
    156
    157        /**
    158         * Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
    159         *
    160         * @og.rev 5.1.6.0 (2010/05/01) 画面項目並べ替え対応
    161         * @og.rev 6.2.0.1 (2015/03/06) 画面IDのキーを"GAMENID" に統一します。
    162         *
    163         * @return      後続処理の指示(SKIP_BODY)
    164         */
    165        @Override
    166        public int doStartTag() {
    167
    168                if( typeDownload ) {
    169                        final DBLastSql lastSql = (DBLastSql)getSessionAttribute( HybsSystem.DB_LAST_SQL_KEY );
    170                        if( lastSql != null ) {
    171                                final String guikey = getRequest().getParameter( "GAMENID" );           // 6.2.0.1 (2015/03/06) 画面IDのキーを"GAMENID" に統一します。
    172                                if( lastSql.isGuiMatch( guikey ) ) {
    173                                        // view タグで仕込んだ clmNames を、Request 変数に設定します。
    174                                        setRequestAttribute( "DB.CLM_NAMES"                     , lastSql.getClmNames() );
    175                                        // 5.1.6.0 (2010/05/01) 画面項目並べ替え対応
    176                                        setRequestAttribute( "DB.VIEW_CLM_NAMES"        , lastSql.getViewClmNames() );
    177                                        setRequestAttribute( "DB.VIEW_EDITABLE"         , Boolean.toString( lastSql.isViewEditable() ) );
    178
    179                                        // 6.3.9.0 (2015/11/06) Deeply nested if..then statements are hard to read (PMD)
    180                                        if( lastSql.isRequest() && getUserInfo( "LASTSQL" ) != null ) {
    181                                                return EVAL_BODY_BUFFERED ;             // Body を評価する。( extends BodyTagSupport 時)
    182                                        }
    183
    184                                        final String tableId = lastSql.getTableId();
    185                                        // セッションのDBTableModelを、そのまま、リクエストに入れているだけなので、実態は同じ。
    186                                        setRequestAttribute( HybsSystem.TBL_MDL_KEY, getSessionAttribute( tableId ) );
    187                                        return SKIP_BODY ;                                      // Body を評価しない
    188                                }
    189                        }
    190
    191                        // 処理が実行できない場合、エラーを出力します。
    192                        jspPrint( getResource().getLabel( errorMsg ) );
    193                        isError = true;
    194                }
    195
    196                return SKIP_BODY ;                              // Body を評価しない
    197        }
    198
    199        /**
    200         * Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
    201         *
    202         * @og.rev 4.3.0.1 (2008/08/11) callBack パラメータの設定漏れ修正、引数から見直し
    203         * @og.rev 5.1.6.0 (2010/05/01) 帳票画面定義機能対応
    204         * @og.rev 5.1.7.0 (2010/06/01) 進む・戻るボタンでもExcel出力ボタンを出す
    205         * @og.rev 5.3.6.0 (2011/06/01) Edit機能見直し
    206         * @og.rev 5.3.7.0 (2011/07/01) Excel取込で画面IDとアドレスが異なる場合にエラーとなるバグを修正
    207         * @og.rev 5.3.7.0 (2011/07/01) 編集画面をリサイズできるように対応します。
    208         * @og.rev 5.3.7.0 (2011/07/01) PL/SQLを利用した検索でファイルダウンロードが出来るように対応します。
    209         * @og.rev 5.4.2.0 (2011/12/01) 画面リソースで画面編集機能のON/OFFを設定できるようにする。
    210         * @og.rev 5.5.2.4 (2012/05/16) nullに対する冗長な比較
    211         * @og.rev 5.5.5.2 (2012/08/20) 画面リソースのoモード対応
    212         * @og.rev 5.5.6.2 (2012/09/24) makeTagのtarget対応
    213         * @og.rev 5.6.0.2 (2013/01/19) editモードのisEditコントロール対応
    214         * @og.rev 5.7.5.0 (2014/04/04) 編集リンク自体を出すかどうかどうか(初期値:true)
    215         * @og.rev 5.7.8.1 (2014/07/18) command="RESET" 時に、ダウンロードリンクを表示
    216         * @og.rev 5.7.8.1 (2014/07/18) addDownCmnd , addUpldCmndを追加
    217         * @og.rev 6.2.0.1 (2015/03/06) 画面IDのキーを"GAMENID" に統一します。
    218         * @og.rev 6.2.2.0 (2015/03/27) ファイルの拡張子を、".xls" から、システムリソースの TABLE_WRITER_EXCEL_TYPE に変更
    219         * @og.rev 6.3.1.0 (2015/06/28) 4:個人設定可のリソースの取得方法に修正(バグFix)。TABLE_WRITER_EXCEL_TYPE
    220         * @og.rev 6.3.4.0 (2015/08/01) 14_EDIT の指定で、フォルダではなく、index.jspまで指定します。
    221         * @og.rev 6.4.4.1 (2016/03/18) StringBuilderの代わりに、OgBuilderを使用する。
    222         * @og.rev 6.8.1.3 (2017/08/04) 日本語のeditNameが、ネイティブモードでHTTP400 エラーになる。･･･ 5.10.0.2 (2018/06/22)
    223         * @og.rev 6.8.1.4 (2017/08/25) filename に、拡張子はつけません。
    224         * @og.rev 5.9.32.1 (2018/05/11) makeTagに、URLチェック対応のための引数を追加
    225         *
    226         * @return      後続処理の指示
    227         */
    228        @Override
    229        public int doEndTag() {
    230                debugPrint();
    231
    232                if( isError      ) { return SKIP_PAGE ; }               // ページの残りの処理を行わない。
    233                if( typeDownload ) { return EVAL_PAGE ; }               // ページの残りを評価する。
    234
    235                boolean isDownload ;
    236                // 5.7.8.1 (2014/07/18) command="RESET" 時に、ダウンロードリンクを表示
    237                if(    "NEW".equals(   command ) || "RENEW".equals( command )
    238                        || "FIRST".equals( command ) || "LAST".equals(  command )
    239                        || "PREV".equals(  command ) || "NEXT".equals(  command )
    240                        || "VIEW".equals(  command ) || "RESET".equals( command ) ) {
    241                        isDownload = true;
    242                }
    243                else if( "COPY".equals( command ) || "INSERT".equals( command ) ) {
    244                        isDownload = false;
    245                }
    246                // 5.7.8.1 (2014/07/18) addDownCmnd , addUpldCmndを追加
    247                else if( addDownCmnd != null && addDownCmnd.equals( command ) ) {
    248                        isDownload = true;
    249                }
    250                else if( addUpldCmnd != null && addUpldCmnd.equals( command ) ) {
    251                        isDownload = false;
    252                }
    253                else {
    254                        return EVAL_PAGE ;
    255                }
    256
    257                byte bitMode ;
    258                // 6.4.1.1 (2016/01/16) PMD refactoring. Avoid if (x != y) ..; else ..;
    259                if( roles == null ) {
    260                        final GUIInfo guiInfo = (GUIInfo)getSessionAttribute( HybsSystem.GUIINFO_KEY );
    261                        bitMode = guiInfo.getBitMode();
    262                }
    263                else {
    264                        final RoleMode roleMode = RoleMode.newInstance( roles );
    265                        final RoleMode userRoleMode = getUser().getRoleMode();
    266                        bitMode = userRoleMode.getAccessBitMode( roleMode );
    267                }
    268
    269                if( filename == null ) {
    270                        // 6.2.2.0 (2015/03/27) ファイルの拡張子を、".xls" から、システムリソースの TABLE_WRITER_EXCEL_TYPE に変更
    271                        // 6.3.1.0 (2015/06/28) 4:個人設定可のリソースの取得方法に修正(バグFix)
    272                        // 6.8.1.4 (2017/08/25) filename に、拡張子はつけません。
    273                        filename = getGUIInfoAttri( "LABEL" );
    274                }
    275                final String guikey = getGUIInfoAttri( "KEY" ); // 4.3.0.1 (2008/08/11)
    276                if( isDownload ) {
    277                        if( RoleMode.isDownload( bitMode ) ) {
    278                                // 4.3.0.1 (2008/08/11) callBack パラメータの設定漏れ修正、引数から見直し
    279                                // <og:link href="{@SYS.JSP}/common/fileDownload.jsp" target="_blank" useGamenId="false"
    280                                //              keys="filename,h_clms" vals="{@GUI.LABEL}.xls,{@h_clms}" >
    281                                // 5.3.7.0 (2011/07/01) PL/SQLを利用した検索でファイルダウンロードが出来るように対応します。
    282                                // 6.2.0.1 (2015/03/06) 画面IDのキーを"GAMENID" に統一します。
    283                                final String href = downloadJsp + "?command=RENEW&GAMENID=" + guikey + "&filename=" + StringUtil.urlEncode( filename ) ;
    284
    285//                              jspPrint( makeTag( downloadImg,href,"Download File", target ) );                // 5.5.6.2 (2012/09/24)
    286                                jspPrint( makeTag( downloadImg,href,"Download File", target,true ) );   // 5.9.32.1 (2018/05/11) URLチェック対応
    287
    288                                // 5.1.6.0 (2010/05/01) 帳票画面定義機能対応
    289                                // 5.3.6.0 (2011/06/01) Edit機能見直し
    290                                final GUIInfo editGui = getUser().getGUIInfo( EDIT_GAMENID );
    291                                // 5.7.5.0 (2014/04/04) 編集リンク自体を出すかどうかどうか(初期値:true)
    292                                // 6.1.0.0 (2014/12/26) refactoring:Prefer StringBuffer over += for concatenating strings
    293                                if( editGui != null && useEditLink ) {
    294                                        final String editName = getRequestValue( "editName" );
    295
    296                                        final OgBuilder buf = new OgBuilder()
    297                                                .append( "javascript:ogOpen('" , sysJsp )                                               // 前後に分断されるので、注意
    298                                                .append( "/" , editGui.getAddress() )                                                   // 6.3.4.0 (2015/08/01)
    299                                                .append( "/index.jsp?command=NEW&GAMENID=" , guikey )                   // 6.2.0.1 (2015/03/06) 画面IDのキーを"GAMENID" に統一します。
    300                                                .appendIf( editName != null                                                                             // 5.5.2.4 (2012/05/16) nullに対する冗長な比較
    301                                                                , "&editName=" , StringUtil.urlEncode( editName ) )             // 6.8.1.3 (2017/08/04) 日本語のeditNameが、ネイティブモードでHTTP400 エラーになる。
    302                                                .appendIf( RoleMode.isEdit( bitMode ) && isEdit                                 // 5.6.0.2(2013/01/09)
    303                                                                , "&edit=true" )
    304                                                .append( "&fullEdit=" , String.valueOf( RoleMode.isFullEdit( bitMode ) ) )
    305                                                .append( "',null,null,'width=800px,height=350px,top=350,left=100,resizable=yes',false);" );
    306                                        // 6.8.1.3 (2017/08/04) a href ではなく、a onClick にする。
    307//                                      final String editLink = makeTag( editImg,buf.toString(),"Edit",null );
    308                                        final String editLink = makeTag( editImg,buf.toString(),"Edit",null,false );    // 5.9.32.1 (2018/05/11) URLチェック対応
    309                                        jspPrint( editLink.replace( "href","onClick" ) );                       // 6.8.1.3 (2017/08/04) makeTag を修正したくなかった。
    310
    311                                }
    312                        }
    313                }
    314                else {
    315                        if( RoleMode.isUpload( bitMode ) ) {
    316                                // 4.3.0.1 (2008/08/11) callBack パラメータの設定漏れ修正、引数から見直し
    317                                // <og:link href="{@SYS.JSP}/common/filePopup.jsp" keys="callBack" vals="{@GUI.KEY}/{@SESSION.JSPID}" >
    318
    319                                final String jspId  = (String)getSessionAttribute( "JSPID" );
    320                                // 5.3.7.0 (2011/07/01) Excel取込で画面IDとアドレスが異なる場合にエラーとなるバグを修正
    321                                String callBack = getGUIInfoAttri( "ADDRESS" ) + "/" + jspId + "?GAMENID=" + guikey;
    322                                callBack = StringUtil.urlEncode( callBack );
    323                                final String href = uploadJsp + "?callBack=" +  callBack;
    324
    325//                              jspPrint( makeTag( uploadImg,href,"Upload File",target ) );                     // 5.5.6.2 (2012/09/24)
    326                                jspPrint( makeTag( uploadImg,href,"Upload File",target,false ) );       // 5.9.32.1 (2018/05/11) URLチェック対応
    327                        }
    328                }
    329
    330                return EVAL_PAGE ;
    331        }
    332
    333        /**
    334         * タグリブオブジェクトをリリースします。
    335         * キャッシュされて再利用されるので、フィールドの初期設定を行います。
    336         *
    337         * @og.rev 5.7.4.1 (2014/03/15) エラーメッセージ変更
    338         * @og.rev 5.7.5.0 (2014/04/04) useEditLink 追加
    339         * @og.rev 5.7.8.1 (2014/07/18) addDownCmnd,addUpldCmnd 追加
    340         * @og.rev 5.9.32.1 (2018/05/08) URLチェック対応
    341         */
    342        @Override
    343        protected void release2() {
    344                super.release2();
    345                sysJsp                  = HybsSystem.sys( "JSP" );
    346                command                 = null;         // ダウンロード="NEW|RENEW|FIRST|LAST|PREV|NEXT|VIEW|RESET" 、アップロード="COPY|INSERT"
    347                downloadImg             = sysJsp + "/image/fileDownload.gif";   // ダウンロード時のアイコン
    348                downloadJsp             = sysJsp + "/common/fileDownload.jsp";  // ダウンロード時の呼び出しJSP
    349                uploadImg               = sysJsp + "/image/fileUpload.gif";             // アップロード時のアイコン
    350                uploadJsp               = sysJsp + "/common/filePopup.jsp";             // アップロード時の呼び出しJSP
    351                imgWidth                = "20px";                                               // アイコン幅サイズ(px)
    352                imgHeight               = "20px";                                               // アイコン高さサイズ(px)
    353                filename                = null;                                                 // ダウンロード時ファイル名("{@GUI.LABEL}") 6.8.1.4 (2017/08/25) 拡張子はつけません。
    354                roles                   = null;                                                 // アクセスロールズ
    355                target                  = null;                                                 // ダウンロードファイルを開くターゲット
    356                errorMsg                = "ERR0042";                                    // 出力対象データが見つかりませんでした。再度検索して下さい。 5.7.4.0 (2014/03/15)
    357                typeDownload    = false;                                                // Download 処理を行うかどうか(初期値:false)
    358                isError                 = false;
    359                editImg                 = sysJsp + "/image/edit.png";   // 編集時のアイコン
    360                isEdit                  = true;                                                 // 5.6.0.2 (2013/01/19)
    361                useEditLink             = true;                                                 // 5.7.5.0 (2014/04/04) 追加
    362                addDownCmnd             = null;                                                 // 5.7.8.1 (2014/07/18) ダウンロード時のコマンドを追加
    363                addUpldCmnd             = null;                                                 // 5.7.8.1 (2014/07/18) アップロード時のコマンドを追加
    364                useURLCheck             = HybsSystem.sysBool( "USE_FILEUD_URL_CHECK" );         // 5.9.32.1 (2018/05/11)
    365                urlCheckCrypt   = HybsSystem.sys( "URL_CHECK_CRYPT" );                          // 5.9.32.1 (2018/05/11)
    366        }
    367
    368        /**
    369         * リンクを作成します。
    370         *
    371         * @og.rev 4.3.0.1 (2008/08/11) callBack パラメータの設定漏れ修正、引数から見直し
    372         * @og.rev 5.5.6.2 (2012/09/24) tgt引数追加
    373         * @og.rev 6.4.2.0 (2016/01/29) alt属性にtitle属性を追記。
    374         * @og.rev 5.9.32.1 (2018/05/08) URLチェック対応
    375         *
    376         * @param       imgsrc  イメージソース
    377         * @param       href    リンクのURL
    378         * @param       alt             イメージの説明文書
    379         * @param       tgt             HTMLのtarget
    380         * @param       useChk  urlCheck対象 [true:useURLCheckの条件に応じて、ﾁｪｯｸ用URLを作成する。/false:常につけない]
    381         *
    382         * @return      リンク文字列
    383         * @og.rtnNotNull
    384         */
    385//      private String makeTag( final String imgsrc, final String href,  final String alt, final String tgt ) {                                                 // 5.5.6.2 (2012/09/24)
    386        private String makeTag( final String imgsrc, final String href,  final String alt, final String tgt, final boolean useChk ) {   // 5.9.32.1 (2018/05/08)
    387                // linkのBODY部にセットするイメージタグの作成
    388                // 6.1.1.0 (2015/01/17) Attributesの連結記述
    389                final String img = XHTMLTag.img(
    390                                new Attributes()
    391                                        .set( "width"   , imgWidth )
    392                                        .set( "height"  , imgHeight )
    393                                        .set( "src"             , imgsrc )
    394                                        .set( "alt"             , alt )
    395                                        .set( "title"   , alt )                                 // 6.4.2.0 (2016/01/29)
    396                        );
    397
    398                // 5.9.32.1 (2018/05/11) urlCheck
    399                final String tag = useURLCheck && useChk
    400                                                        ? XHTMLTag.addURLCheckKey( href, HybsSystem.URL_CHECK_KEY, getUser().getUserID(), System.currentTimeMillis() + URL_CHECK_TIME )
    401                                                        : href ;
    402
    403                // 6.1.1.0 (2015/01/17) Attributesの連結記述
    404                return XHTMLTag.link(
    405                                new Attributes()
    406//                                      .set( "href"    , href )
    407                                        .set( "href"    , tag )                                 // 5.9.32.1 (2018/05/11) urlCheck
    408                                        .set( "body"    , img )
    409                                        .set( "target"  , tgt )                                 // 5.5.6.2 (2012/09/24)
    410                        );
    411        }
    412
    413        /**
    414         * 【TAG】command を指定します。
    415         *
    416         * @og.tag
    417         * command を指定します。
    418         * ダウンロードは、"NEW|RENEW|FIRST|LAST|PREV|NEXT|VIEW|RESET" のみ有効です。
    419         * アップロードは、"COPY|INSERT" のみ有効です。
    420         * それ以外のコマンドでは、アイコンは表示されません。
    421         * 例えば、NEXT/PREV など。
    422         *
    423         * @param       cmd コマンド [NEW/RENEW/FIRST/LAST/PREV/NEXT/VIEW/RESET/COPY/INSERT]
    424         * @see         #setAddDownCmnd( String )
    425         * @see         #setAddUpldCmnd( String )
    426         * @see         #setCommand( String )
    427         */
    428        public void setCommand( final String cmd ) {
    429                command = nval( getRequestParameter( cmd ),command );
    430        }
    431
    432        /**
    433         * 【TAG】ダウンロード時のアイコンを指定します(初期値:"{&#064;SYS.JSP}/image/fileDownload.gif")。
    434         *
    435         * @og.tag
    436         * ダウンロード時に表示されるアイコンを指定します。
    437         * 初期値:"{&#064;SYS.JSP}/image/fileDownload.gif" です。
    438         *
    439         * @param       img ダウンロード時のアイコン
    440         */
    441        public void setDownloadImg( final String img ) {
    442                downloadImg = nval( getRequestParameter( img ),downloadImg );
    443        }
    444
    445        /**
    446         * 【TAG】ダウンロード時の呼び出しJSPを指定します(初期値:"{&#064;SYS.JSP}/common/fileDownload.jsp")。
    447         *
    448         * @og.tag
    449         * ダウンロード時に呼び出されるJSPファイル名を指定します。
    450         * 初期値:"{&#064;SYS.JSP}/common/fileDownload.jsp" です。
    451         *
    452         * @param       file ダウンロード時の呼び出しJSP
    453         */
    454        public void setDownloadJsp( final String file ) {
    455                downloadJsp = nval( getRequestParameter( file ),downloadJsp );
    456        }
    457
    458        /**
    459         * 【TAG】アップロード時のアイコンを指定します(初期値:"{&#064;SYS.JSP}/image/fileUpload.gif")。
    460         *
    461         * @og.tag
    462         * アップロード時に表示されるアイコンを指定します。
    463         * 初期値:"{&#064;SYS.JSP}/image/fileUpload.gif" です。
    464         *
    465         * @param       img アップロード時のアイコン
    466         */
    467        public void setUploadImg( final String img ) {
    468                uploadImg = nval( getRequestParameter( img ),uploadImg );
    469        }
    470
    471        /**
    472         * 【TAG】アップロード時の呼び出しJSPを指定します(初期値:"{&#064;SYS.JSP}/common/fileUpload.jsp")。
    473         *
    474         * @og.tag
    475         * アップロード時に呼び出されるJSPファイル名を指定します。
    476         * 初期値:"{&#064;SYS.JSP}/common/fileUpload.jsp" です。
    477         *
    478         * @param       file アップロード時の呼び出しJSP
    479         */
    480        public void setUploadJsp( final String file ) {
    481                uploadJsp = nval( getRequestParameter( file ),uploadJsp );
    482        }
    483
    484        /**
    485         * 【TAG】アイコン幅サイズ(px)を指定します(初期値:20px)。
    486         *
    487         * @og.tag
    488         * アップロード/ダウンロードのアイコンを表示する際の幅サイズ(px)を指定します。
    489         * ファイルサイズは、アップロード/ダウンロード共通です。
    490         * 初期値は、20px です。
    491         *
    492         * @param       width   アイコン幅サイズ(px)
    493         */
    494        public void setImgWidth( final String width ) {
    495                imgWidth = nval( getRequestParameter( width ),imgWidth );
    496        }
    497
    498        /**
    499         * 【TAG】アイコン高さサイズ(px)を指定します(初期値:20px)。
    500         *
    501         * @og.tag
    502         * アップロード/ダウンロードのアイコンを表示する際の高さサイズ(px)を指定します。
    503         * ファイルサイズは、アップロード/ダウンロード共通です。
    504         * 初期値は、20px です。
    505         *
    506         * @param       height  アイコン高さサイズ(px)
    507         */
    508        public void setImgHeight( final String height ) {
    509                imgHeight = nval( getRequestParameter( height ),imgHeight );
    510        }
    511
    512        /**
    513         * 【TAG】ダウンロード時ファイル名を指定します(初期値:"{&#064;GUI.LABEL}")。
    514         *
    515         * @og.tag
    516         * ダウンロード時のファイル名を指定します
    517         * 通常は、画面のラベル(言語対応)で、拡張子は付けません。ファイルの種類に応じて、拡張子を自動設定します。
    518         *
    519         * @og.rev 6.8.1.4 (2017/08/25) 拡張子はつけません。
    520         *
    521         * @param       file    ダウンロード時ファイル名 ("{&#064;GUI.LABEL}")
    522         */
    523        public void setFilename( final String file ) {
    524                filename = nval( getRequestParameter( file ),filename );
    525        }
    526
    527        /**
    528         * 【TAG】ロールズをセットします。
    529         *
    530         * @og.tag
    531         * ここで指定したロールを元に、ユーザー毎のアクセス許可がチェックされます。
    532         * アクセス許可されないと、表示されません。
    533         * このロールを指定しない場合は、画面のロールが使用されます。
    534         *
    535         * @param       rls パラメータ
    536         */
    537        public void setRoles( final String rls ) {
    538                roles = nval( getRequestParameter( rls ),roles );
    539        }
    540
    541        /**
    542         * 【TAG】ダウンロード文書を表示させるフレーム、またはウィンドウの名前を指定します。
    543         *
    544         * @og.tag フレーム名(ターゲット属性)を設定します。
    545         *
    546         * @param       name ダウンロード文書のフレーム名(ターゲット属性)
    547         */
    548        public void setTarget( final String name ) {
    549                target = nval( getRequestParameter( name ),target );
    550        }
    551
    552        /**
    553         * 【TAG】Download 処理を行うかどうか[true:実行する/false:リンク作成]を指定します(初期値:false)。
    554         *
    555         * @og.tag
    556         * Download 処理を行うには、指定の画面(呼び出し元)と、抜き出した時の
    557         * DBTableModel がマッチしているか判定します。
    558         * また、DBTableModel が存在しない、または、不備な場合(オーバーフロー)は、
    559         * 最終SQLを実行する必要があり、そもそも、抜出処理が出来ない状態では、
    560         * エラーを返す必要があります。
    561         * それら、一連のDownload 処理を行うかどうかを指定します。
    562         * true の場合、session の HybsSystem.DB_LAST_SQL_KEY に格納された
    563         * DBLastSql オブジェクトを取得し、scope が request または、overflow が
    564         * true の場合に、BODY部を実行します。(通常、queryタグを記述します。)
    565         * query の出力先は、scope を request にします。
    566         * それ以外は、tableId から取り出した DBTableModel を、scope = "request"
    567         * に(アドレスのみ)コピーします。
    568         * writeTable タグでは、scope="request" から、DBTableModel を取り出します。
    569         *
    570         * 初期値は、false(抜き出しでは無くリンク作成) です。
    571         *
    572         * @param       type    Download処理 [true:実行する/false:リンク作成]
    573         */
    574        public void setTypeDownload( final String type ) {
    575                typeDownload = nval( getRequestParameter( type ),typeDownload );
    576        }
    577
    578        /**
    579         * 【TAG】ダウンロード出来ない場合のエラーメッセージIDを指定します(初期値:ERR0042)。
    580         *
    581         * @og.tag
    582         * DBTableModel が、最後に作成された画面と、メモリ中の DBLastSql オブジェクトが
    583         * 管理している情報が異なる場合は、ダウンロード出来ません。
    584         * 同様に、DBLastSql オブジェクト 自身が作成されていない場合も出来ません。
    585         * そのようなケースに表示するエラーメッセージのメッセージIDを指定します。
    586         * 引数は、指定できません。
    587         * 初期値は、『ERR0042：出力対象データが見つかりませんでした。再度検索して下さい。』 です。
    588         *
    589         * @param       msg ダウンロード文書のフレーム名(ターゲット属性)
    590         */
    591        public void setErrorMsg( final String msg ) {
    592                errorMsg = nval( getRequestParameter( msg ),errorMsg );
    593        }
    594
    595        /**
    596         * 【TAG】編集アイコンを指定します(初期値:"{&#064;SYS.JSP}/image/edit.png")。
    597         *
    598         * @og.tag
    599         * 編集アイコンを指定します。
    600         * 初期値:"{&#064;SYS.JSP}/image/edit.png" です。
    601         *
    602         * @og.rev 5.1.6.0 (2010/05/01) 新規追加
    603         *
    604         * @param       img アップロード時のアイコン
    605         */
    606        public void setEditImg( final String img ) {
    607                editImg = nval( getRequestParameter( img ),editImg );
    608        }
    609
    610        /**
    611         * 【TAG】Edit画面でカラム編集タブを出すかどうか[true:出す/false:出さない]設定します(初期値:true:出す)。
    612         *
    613         * @og.tag
    614         * falseを指定するとカラム編集タブを出さない。
    615         *
    616         * @param       type    編集タブ出力 [true:出す/false:出さない]
    617         */
    618        public void setClmEdit( final String type ) {
    619                isEdit = nval( getRequestParameter( type ),isEdit );
    620        }
    621
    622        /**
    623         * 【TAG】Edit画面でカラム編集リンクを出力するかどうか[true:する/false:しない]設定します(初期値:true:する)。
    624         *
    625         * @og.tag
    626         * falseを指定するとカラム編集リンクを出さない。
    627         * 従来は、カラム編集画面の内、【表示項目設定】タブを表示しないだけでした。
    628         * この設定は、RWMODE を、 ##d , ##u , ##f の場合にも同様の設定が可能です。
    629         * カラム編集リンク自体を出さない機能は、現時点ではリソース設定できないため、
    630         * タグのパラメータとして指定できるようにします。
    631         * 基本的には、このパラメータはほとんど使われていないハズなので、
    632         * 機能を置き換えます。
    633         * 初期値は、カラム編集リンクを出力する(=true)です。
    634         *
    635         * @og.rev 5.7.5.0 (2014/04/04) 新規追加
    636         *
    637         * @param       flag    リンク出力 [true:する/false:しない]
    638         * @see         org.opengion.hayabusa.taglib.QueryButtonTag#setUseEditMenu(String)
    639         */
    640        public void setUseEditLink( final String flag ) {
    641                useEditLink = nval( getRequestParameter( flag ),useEditLink );
    642        }
    643
    644        /**
    645         * 【TAG】ダウンロード時のコマンドを追加指定できます(初期値:null)。
    646         *
    647         * @og.tag
    648         * ダウンロードリンクが表示される command は、
    649         * "NEW|RENEW|FIRST|LAST|PREV|NEXT|VIEW|RESET" のみです。
    650         * これ以外の command で、ダウンロードリンクを表示させたい場合は、
    651         * この、addDownCmnd に、記述します。
    652         * 初期値は、null(追加コマンドはない)です。
    653         *
    654         * @og.rev 5.7.8.1 (2014/07/18) 新規追加
    655         *
    656         * @param       cmd     追加するコマンド
    657         * @see         #setCommand( String )
    658         */
    659        public void setAddDownCmnd( final String cmd ) {
    660                addDownCmnd = nval( getRequestParameter( cmd ),addDownCmnd );
    661        }
    662
    663        /**
    664         * 【TAG】アップロード時のコマンドを追加指定できます(初期値:null)。
    665         *
    666         * @og.tag
    667         * アップロードリンクが表示される command は、"COPY|INSERT" のみです。
    668         * これ以外の command で、アップロードリンクを表示させたい場合は、
    669         * この、addUpldCmnd に、記述します。
    670         * 初期値は、null(追加コマンドはない)です。
    671         *
    672         * @og.rev 5.7.8.1 (2014/07/18) 新規追加
    673         *
    674         * @param       cmd     追加するコマンド
    675         * @see         #setCommand( String )
    676         */
    677        public void setAddUpldCmnd( final String cmd ) {
    678                addUpldCmnd = nval( getRequestParameter( cmd ),addUpldCmnd );
    679        }
    680
    681        /**
    682         * 【TAG】リンクアドレスにURLチェック用の確認キーを付加するかどうか[true/false]を指定します。
    683         *
    684         * @og.tag
    685         * この属性は、URLCheckFilter(org.opengion.hayabusa.filter.URLCheckFilter)と合わせて使用します。
    686         * trueが指定された場合、リンクURLのパラメーターに、URL確認用のパラメーターが出力されます。
    687         * このパラメーターを、URLCheckFilterが復号化し、正式なアクセスであるかどうかの判定を行います。
    688         *
    689         * この属性はjsp/fileDownloadに対してチェックをかける場合にtrueにする必要があります。
    690         * 通常はシステムリソースのFILEUD_URL_CHECKで設定します。
    691         *
    692         * 初期値は、 "false"(確認キーを出力しない) です。
    693         *
    694         * @og.rev 5.9.32.1 (2018/05/08) 追加
    695         *
    696         * @param       flag 暗号化するかかどうか [true:暗号化する/false:しない]
    697         * @see org.opengion.hayabusa.filter.URLCheckFilter
    698         */
    699        public void setUseURLCheck( final String flag ) {
    700                useURLCheck = nval( getRequestParameter( flag ),useURLCheck );
    701        }
    702
    703        /**
    704         * このオブジェクトの文字列表現を返します。
    705         * 基本的にデバッグ目的に使用します。
    706         *
    707         * @return このクラスの文字列表現
    708         * @og.rtnNotNull
    709         */
    710        @Override
    711        public String toString() {
    712                return ToString.title( this.getClass().getName() )
    713                                .println( "VERSION"             ,VERSION                )
    714                                .println( "command"             ,command                )
    715                                .println( "downloadImg" ,downloadImg    )
    716                                .println( "downloadJsp" ,downloadJsp    )
    717                                .println( "uploadImg"   ,uploadImg              )
    718                                .println( "uploadJsp"   ,uploadJsp              )
    719                                .println( "imgWidth"    ,imgWidth               )
    720                                .println( "imgHeight"   ,imgHeight              )
    721                                .println( "filename"    ,filename               )
    722                                .println( "roles"               ,roles                  )
    723                                .println( "target"              ,target                 )
    724                                .println( "Other..."    ,getAttributes().getAttribute() )
    725                                .fixForm().toString() ;
    726        }
    727}