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