    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.common.HybsSystemException;
    020import org.opengion.hayabusa.db.DBTableModel;
    021import org.opengion.hayabusa.db.DBTableModelSorter;
    022import org.opengion.hayabusa.db.DBColumn;
    023import org.opengion.hayabusa.db.DBTableModelUtil;
    024import org.opengion.fukurou.system.DateSet;                                             // 6.4.2.0 (2016/01/29)
    025import org.opengion.fukurou.util.StringUtil;
    026import org.opengion.fukurou.util.ToString;                                              // 6.1.1.0 (2015/01/17)
    027import org.opengion.fukurou.security.HybsCryptography ;                 // 5.7.4.3 (2014/03/28)
    028import org.opengion.fukurou.model.POIUtil;                                              // 6.2.2.0 (2015/03/27)
    029import org.opengion.fukurou.util.FileInfo;                                              // 6.2.2.0 (2015/03/27)
    030import org.opengion.fukurou.util.FileUtil;                                              // 6.7.4.1 (2017/02/17)
    031import org.opengion.fukurou.util.ArraySet;                                              // 6.4.3.4 (2016/03/11)
    032import org.opengion.hayabusa.io.HybsFileOperationFactory;               // 8.0.0.1 (2021/10/08)
    033
    034import static org.opengion.fukurou.util.StringUtil.nval ;
    035
    036import java.util.Arrays;
    037import java.io.File;
    038import java.io.FileFilter;
    039import java.io.IOException;
    040
    041/**
    042 * ﾌｧｲﾙを検索し､DBTableModel にｾｯﾄするﾀｸﾞです｡
    043 *
    044 * ﾌｧｲﾙの検索結果は､[WRITABLE],LEVEL,FILE_TYPE,PARENT,NAME,LASTMODIFIED,FILE_LENGTH,RWH,[MD5],[TO_PARENT,TO_NAME],[････]
    045 * のｶﾗﾑを持つ DBTableModel にｾｯﾄ されます｡このｶﾗﾑは､固定です｡
    046 * 並び替えについては､このﾀｸﾞで指定しますが､ﾌｧｲﾙの選別(where 条件)は､
    047 * BODY 部に記述する fileWhere ﾀｸﾞで指定します｡(複数指定可能))
    048 *
    049 * [ｶﾗﾑ名]      検索するﾌｧｲﾙの属性は､以下のｶﾗﾑ名で作成されます｡
    050 *     [WRITABLE]       useWritable=trueで､先頭ｶﾗﾑに､WRITABLE ｶﾗﾑが挿入されます｡
    051 *      LEVEL           ﾃﾞｨﾚｸﾄﾘを展開する場合のﾚﾍﾞﾙ｡
    052 *      FILE_TYPE       ﾌｧｲﾙ(F)かﾃﾞｨﾚｸﾄﾘ(D)であるか判定｡
    053 *      PARENT          この抽象ﾊﾟｽ名の親のﾊﾟｽ名文字列を返します｡
    054 *      NAME            この抽象ﾊﾟｽ名が示すﾌｧｲﾙまたはﾃﾞｨﾚｸﾄﾘの名前を返します｡
    055 *      LASTMODIFIED    最後に変更された時刻を返します｡
    056 *      FILE_LENGTH     ﾌｧｲﾙの長さを返します｡
    057 *      RWH             読み込み､書き込み､隠し属性をそれぞれ､ｒ,w,h で表します｡
    058 *     [MD5]            useMD5=trueで､MD5 というｶﾗﾑを追加したうえで､ﾌｧｲﾙのMD5計算を行います｡
    059 *     [TEXT]           useText=trueで､ﾌｧｲﾙの内容を文字列にして､TEXTというｶﾗﾑに設定します｡
    060 *     [TO_PARENT]      useUpdateClms=trueで､fileUpdateﾀｸﾞでCOPYやMOVEを行う時に使用する必須となるｶﾗﾑ(TO_PARENT,TO_NAME)を追加します｡
    061 *     [TO_NAME]        同上
    062 *     [････]           addClms属性で指定されたｶﾗﾑを追加します｡
    063 *
    064 * @og.formSample
    065 * ●形式：&lt;og:fileQuery from="…" multi="true/false" &gt;
    066 *             &lt;og:fileWhere … /&gt;
    067 *              …
    068 *         &lt;/og:fileQuery&gt;
    069 * ●body：あり(EVAL_BODY_BUFFERED:BODYを評価し､{&#064;XXXX} を解析します)
    070 *
    071 * ●Tag定義：
    072 *   &lt;og:fileQuery
    073 *       from             ○【TAG】検索を開始するﾌｧｲﾙまたはﾃﾞｨﾚｸﾄﾘを指定します(必須)｡
    074 *       multi              【TAG】多段階展開するか､１ﾚﾍﾞﾙ展開するかどうか[true:多段階/false:１ﾚﾍﾞﾙ]を指定します(初期値:false:１ﾚﾍﾞﾙ)｡
    075 *       level              【TAG】多段階展開するﾚﾍﾞﾙを指定します(初期値:100)｡
    076 *       orderBy            【TAG】ｿｰﾄするｶﾗﾑ名を指定します(一つのみ)｡
    077 *       desc               【TAG】表示順を逆転するかどうか[true/false]を指定します(初期値:false)｡
    078 *       useWritable        【TAG】先頭ｶﾗﾑに､WRITABLE ｶﾗﾑを追加するかどうか[true/false]を指定します(初期値:false)｡
    079 *       useMD5             【TAG】MD5ｶﾗﾑを追加したうえで､MD5計算を行うかどうか[true/false]を指定します(初期値:false)｡
    080 *       useText            【TAG】TEXTｶﾗﾑを追加したうえで､ﾌｧｲﾙの内容を読み込むかどうか[true/false]を指定します(初期値:false)｡
    081 *       useUpdateClms      【TAG】TO_PARENT､TO_NAMEｶﾗﾑを追加するかどうか[true/false]を指定します(初期値:false)｡
    082 *       addClms            【TAG】検索結果のｶﾗﾑ列に追加するｶﾗﾑ名を､CSV形式で指定します｡
    083 *       nameOnly           【TAG】ﾌｧｲﾙの拡張子を除いた名前部分のみの値で行います｡7.2.6.0 (2020/06/30)
    084 *       fileType           【TAG】選択対象[FILE/DIR]を指定します｡下位展開は考慮(multi 属性準拠)されます｡
    085 *       addFrom            【TAG】from属性で指定された基準ﾌｧｲﾙ/ﾌｫﾙﾀﾞ自体をﾘｽﾄに追加するかどうか[true/false]を指定します(初期値:true)｡
    086 *       fromBase           【TAG】検索結果のPARENT列から､fromBase指定のﾊﾟｽを削除した相対ﾊﾟｽを作成します｡  (7.0.2.1 (2019/03/04))
    087 *       command            【TAG】ｺﾏﾝﾄﾞ (NEW,RENEW)をｾｯﾄします("NEW" と "RENEW" 時のみ実行する(初期値:NEW))｡
    088 *       maxRowCount        【TAG】(通常は使いません)ﾃﾞｰﾀの最大読み込み件数を指定します (初期値:DB_MAX_ROW_COUNT[=1000])(0:[無制限])｡
    089 *       displayMsg         【TAG】検索結果を画面上に表示するﾒｯｾｰｼﾞﾘｿｰｽIDを指定します (初期値:VIEW_DISPLAY_MSG[=])
    090 *       overflowMsg        【TAG】検索ﾃﾞｰﾀが最大検索数をｵｰﾊﾞｰした場合に表示するﾒｯｾｰｼﾞﾘｿｰｽIDを指定します
    091 *                                    (初期値:MSG0007[検索結果が､制限行数を超えましたので､残りはｶｯﾄされました])｡
    092 *       notfoundMsg        【TAG】検索結果がｾﾞﾛ件の場合に表示するﾒｯｾｰｼﾞﾘｿｰｽIDを指定します(初期値:MSG0077[対象ﾃﾞｰﾀはありませんでした])｡
    093 *       stopZero           【TAG】検索結果が０件のとき処理を続行するかどうか[true/false]を指定します(初期値:false[続行する])
    094 *       tableId            【TAG】(通常は使いません)結果のDBTableModelを､sessionに登録するときのｷｰを指定します
    095 *       scope              【TAG】ｷｬｯｼｭする場合のｽｺｰﾌﾟ[request/page/session/application]を指定します(初期値:session)｡
    096 *       useSLabel          【TAG】7.0.7.0 (2019/12/13) ｴﾗｰﾒｯｾｰｼﾞにSLABELを利用するかどうか[true/false]を指定します(初期値:false)
    097 *       useLocal           【TAG】ｼｽﾃﾑ定数でｸﾗｳﾄﾞ設定されていても､ｸﾗｳﾄﾞ環境を使用しない場合､trueを指定します(初期値:false) 8.0.1.0 (2021/10/29)
    098 *       caseKey            【TAG】このﾀｸﾞ自体を利用するかどうかの条件ｷｰを指定します(初期値:null) 6.8.0.0 (2017/06/02)
    099 *       caseVal            【TAG】このﾀｸﾞ自体を利用するかどうかの条件値を指定します(初期値:null) 6.8.0.0 (2017/06/02)
    100 *       caseNN             【TAG】指定の値が､null/ｾﾞﾛ文字列 でない場合(Not Null=NN)は､このﾀｸﾞは使用されます(初期値:判定しない) 6.8.0.0 (2017/06/02)
    101 *       caseNull           【TAG】指定の値が､null/ｾﾞﾛ文字列 の場合は､このﾀｸﾞは使用されます(初期値:判定しない) 6.8.0.0 (2017/06/02)
    102 *       caseIf             【TAG】指定の値が､true/TRUE文字列の場合は､このﾀｸﾞは使用されます(初期値:判定しない) 6.8.0.0 (2017/06/02)
    103 *       debug              【TAG】ﾃﾞﾊﾞｯｸﾞ情報を出力するかどうか[true/false]を指定します(初期値:false)｡
    104 *   &gt;   ... Body ...
    105 *   &lt;/og:fileQuery&gt;
    106 *
    107 * ●使用例
    108 *    ･一般的な属性でﾌｧｲﾙの検索を行います｡
    109 *         &lt;og:fileQuery
    110 *                from    = "d:/webapps/dbdef/jsp/"
    111 *                multi   = "true"
    112 *                command = "{&#064;command}"  &gt;
    113 *            &lt;og:fileWhere endWith=".jsp" /&gt;
    114 *      &lt;/og:fileQuery&gt;
    115 *
    116 *    ･最終変更日で逆順ｿｰﾄする｡対象は､2002/10/01 以降に変更されたﾌｧｲﾙ｡
    117 *        &lt;og:fileQuery
    118 *                from    = "d:/webapps/dbdef/jsp/"
    119 *                multi   = "true"
    120 *                orderBy = "LASTMODIFIED"
    121 *                desc    = "true"
    122 *                command = "{&#064;command}"  &gt;
    123 *            &lt;og:fileWhere lastModified="20021001000000" /&gt;
    124 *        &lt;/og:fileQuery&gt;
    125 *
    126 * @og.rev 4.0.0.0 (2005/01/31) 内部ﾛｼﾞｯｸ改定
    127 * @og.group その他入力
    128 *
    129 * @version  4.0
    130 * @author       Kazuhiko Hasegawa
    131 * @since    JDK5.0,
    132 */
    133public class FileQueryTag extends QueryTag {
    134        /** このﾌﾟﾛｸﾞﾗﾑのVERSION文字列を設定します｡ {@value} */
    135        private static final String VERSION = "8.0.1.0 (2021/10/29)" ;
    136        private static final long serialVersionUID = 801020211029L ;
    137
    138        // 6.4.3.4 (2016/03/11) String配列 から､Setに置き換えます｡
    139        private static final ArraySet<String> SELECT_SET = new ArraySet<>( "LEVEL","FILE_TYPE","PARENT","NAME","LASTMODIFIED","FILE_LENGTH","RWH" );
    140
    141        private static final String[] USE_UPDATE_CLM = { "TO_PARENT","TO_NAME" };       // 5.3.4.0 (2011/04/01)
    142
    143        private transient FileFilter filter     ;               // FileWhere で指定したﾌｨﾙﾀｰ
    144
    145        private boolean multi                   ;                       // 下位層展開ﾌﾗｸﾞ
    146        private int             level                   = 100;          // 展開ﾚﾍﾞﾙ
    147        private String  from                    = HybsSystem.sys( "FILE_URL" ); // 検索起点ﾌｧｲﾙ
    148        private String  orderBy                 ;                       // 5.3.4.0 (2011/04/01) ｿｰﾄｶﾗﾑ
    149        private boolean desc                    ;                       // 5.3.4.0 (2011/04/01) ｿｰﾄの方向(true:逆順)
    150        private String[]        addClms         = new String[0];                                // 5.3.4.0 (2011/04/01) 追加ｶﾗﾑ配列
    151        private String[]        defClms         ;                       // 5.7.4.3 (2014/03/28) 初期値のｶﾗﾑ配列
    152        private String  fileType                ;                       // 5.3.4.0 (2011/04/01) 選択対象を指定(FILE,DIR)
    153        private boolean useWritable             ;                       // 5.7.4.3 (2014/03/28) 先頭ｶﾗﾑに､WRITABLE ｶﾗﾑを追加するかどうか[true/false](初期値:false)
    154        private boolean useMD5                  ;                       // 5.7.4.3 (2014/03/28) MD5ｶﾗﾑを追加したうえで､MD5計算を行うかどうか[true/false](初期値:false)
    155        private boolean useText                 ;                       // 6.2.2.0 (2015/03/27) TEXTｶﾗﾑを追加したうえで､ﾌｧｲﾙの内容を読み込むかどうか[true/false]を指定します(初期値:false)｡
    156        private boolean useUpdateClms   ;                       // 5.3.4.0 (2011/04/01) TO_PARENT､TO_NAMEｶﾗﾑを追加(true:追加)
    157        private boolean addFrom                 = true;         // 5.3.9.0 (2011/09/01) from属性で指定された基準ﾌｧｲﾙ/ﾌｫﾙﾀﾞ自体をﾘｽﾄに追加するかどうか
    158        private int             fromLen                 = -1;           // 7.0.2.1 (2019/03/04) fromBase の文字数をPARENTから削除するための数
    159        private boolean nameOnly                ;                       // 7.2.6.0 (2020/06/30) ﾌｧｲﾙの拡張子を除いた名前部分のみの値で行います｡
    160        private boolean useLocal                ;                       // 8.0.1.0 (2021/10/29) ｸﾗｳﾄﾞ設定を使用しない場合は､true
    161
    162        /**
    163         * ﾃﾞﾌｫﾙﾄｺﾝｽﾄﾗｸﾀｰ
    164         *
    165         * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
    166         */
    167        public FileQueryTag() { super(); }              // これも､自動的に呼ばれるが､空のﾒｿｯﾄﾞを作成すると警告されるので､明示的にしておきます｡
    168
    169        /**
    170         * Taglibのﾀｸﾞ本体を処理する doAfterBody() を ｵｰﾊﾞｰﾗｲﾄﾞします｡
    171         *
    172         * ﾀｸﾞ本体が空の場合は､呼ばれないので､従来の doAfterBody() 処理を､
    173         * doEndTag() に持っていきます｡
    174         * よって､親ｸﾗｽの doAfterBody() を実行させないため､このﾒｿｯﾄﾞを用意しています｡
    175         *
    176         * @og.rev 6.7.4.1 (2017/02/17) 親ｸﾗｽの処理を､実行させない｡
    177         *
    178         * @return      後続処理の指示(SKIP_BODY)
    179         */
    180        @Override
    181        public int doAfterBody() {
    182                return SKIP_BODY ;
    183        }
    184
    185        /**
    186         * Taglibの終了ﾀｸﾞが見つかったときに処理する doEndTag() を ｵｰﾊﾞｰﾗｲﾄﾞします｡
    187         *
    188         * ﾀｸﾞ本体が空の場合は､呼ばれないので､従来の doAfterBody() 処理を､
    189         * doEndTag() に持っていきます｡
    190         *
    191         * @og.rev 6.7.4.1 (2017/02/17) 従来の doAfterBody() 処理を､doEndTag() に持ってくる｡
    192         * @og.rev 6.8.0.0 (2017/06/02) caseKey,caseVal,caseNN,caseNull 属性を追加
    193         * @og.rev 8.0.0.1 (2021/10/08) cloud対応
    194         *
    195         * @return      後続処理の指示
    196         */
    197        @Override
    198        public int doEndTag() {
    199                if( !useTag() ) { return SKIP_BODY ; }  // 6.8.0.0 (2017/06/02)
    200
    201                executeCount = 0;
    202
    203                table = initDBTable();
    204                if( maxRowCount < 0 ) {
    205                        maxRowCount     = sysInt( "DB_MAX_ROW_COUNT" ) ;
    206                }
    207
    208                // 5.3.5.0 (2011/05/01) 最初のﾌｧｲﾙが存在する場合のみ､実行する｡
    209//              final File fin = new File( from );
    210                final File fin = HybsFileOperationFactory.create( useLocal,from );              // 8.0.0.1 (2021/10/08)
    211                if( fin.exists() ) {
    212                        // 7.0.2.1 (2019/03/04) 検索結果のPARENT列から､from指定のﾊﾟｽを削除した相対ﾊﾟｽを作成
    213
    214                        execute( fin,0 ) ;
    215
    216                        // 5.3.4.0 (2011/04/01) 指定ｶﾗﾑのｿｰﾄ処理
    217                        if( orderBy != null ) {
    218                                final int clmNo = table.getColumnNo( orderBy );
    219                                final DBTableModelSorter temp = new DBTableModelSorter();
    220                                temp.setModel( table );
    221                                temp.sortByColumn( clmNo,!desc );       // 注意 desc の値と ｿｰﾄ正逆は､反対です｡
    222                                table = temp;
    223                        }
    224                }
    225                return super.doEndTag();
    226        }
    227
    228        /**
    229         * ﾀｸﾞﾘﾌﾞｵﾌﾞｼﾞｪｸﾄをﾘﾘｰｽします｡
    230         * ｷｬｯｼｭされて再利用されるので､ﾌｨｰﾙﾄﾞの初期設定を行います｡
    231         *
    232         * @og.rev 5.3.4.0 (2011/04/01) 指定ｶﾗﾑのｿｰﾄ処理機能､ｶﾗﾑ追加機能､fileType追加
    233         * @og.rev 5.3.9.0 (2011/09/01) addFrom属性追加
    234         * @og.rev 5.7.4.3 (2014/03/28) useWritable,useMD5属性追加｡valClms を defClms に置き換え｡
    235         * @og.rev 6.2.2.0 (2015/03/27) useText属性追加｡
    236         * @og.rev 7.0.2.1 (2019/03/04) fromBase属性追加に伴い､fromLen変数を用意｡
    237         * @og.rev 7.2.6.0 (2020/06/30) nameOnly 属性 を追加します｡
    238         * @og.rev 8.0.1.0 (2021/10/29) useLocal 属性を追加｡
    239         */
    240        @Override
    241        protected void release2() {
    242                super.release2();
    243                filter                  = null;
    244                multi                   = false;
    245                level                   = 100;
    246                from                    = HybsSystem.sys( "FILE_URL" );
    247                orderBy                 = null;                         // 5.3.4.0 (2011/04/01) ｿｰﾄｶﾗﾑ
    248                desc                    = false;                        // 5.3.4.0 (2011/04/01) 降順ﾌﾗｸﾞ
    249                addClms                 = new String[0];        // 5.3.4.0 (2011/04/01) 追加ｶﾗﾑ配列
    250                defClms                 = null;                         // 5.7.4.3 (2014/03/28) 初期値のｶﾗﾑ配列
    251                fileType                = null;                         // 5.3.4.0 (2011/04/01) 選択対象を指定(FILE,DIR,ALL)
    252                useWritable             = false;                        // 5.7.4.3 (2014/03/28) 先頭ｶﾗﾑに､WRITABLE ｶﾗﾑを追加するかどうか[true/false](初期値:false)
    253                useMD5                  = false;                        // 5.7.4.3 (2014/03/28) MD5ｶﾗﾑを追加したうえで､MD5計算を行うかどうか[true/false](初期値:false)
    254                useText                 = false;                        // 6.2.2.0 (2015/03/27) TEXTｶﾗﾑを追加したうえで､ﾌｧｲﾙの内容を読み込むかどうか[true/false]を指定します(初期値:false)｡
    255                useUpdateClms   = false;                        // 5.3.4.0 (2011/04/01) TO_PARENT､TO_NAMEｶﾗﾑを追加(true:追加)
    256                addFrom                 = true;                         // 5.3.9.0 (2011/09/01) addFrom属性追加
    257                fromLen                 = -1;                           // 7.0.2.1 (2019/03/04) fromBase の文字数をPARENTから削除するための数
    258                nameOnly                = false;                        // 7.2.6.0 (2020/06/30) ﾌｧｲﾙの拡張子を除いた名前部分のみの値で行います｡
    259                useLocal                = false;                        // 8.0.1.0 (2021/10/29) ｸﾗｳﾄﾞ設定を使用しない場合は､true
    260        }
    261
    262        /**
    263         * FileQuery を実行します｡
    264         *
    265         * @og.rev 5.3.4.0 (2011/04/01) fileType の条件に合致する場合だけ､ﾃﾞｰﾀを作成する｡
    266         * @og.rev 5.3.7.0 (2011/07/01) ﾌｫﾙﾀﾞにｱｸｾｽできない場合は､null となるのでその対応
    267         * @og.rev 7.0.2.1 (2019/03/04) fromBase属性追加に伴い､fromLen変数を用意｡
    268         *
    269         * @param       fin     検索を開始するﾌｧｲﾙ/ﾃﾞｨﾚｸﾄﾘ
    270         * @param       lvl     階層展開ﾚﾍﾞﾙ
    271         */
    272        protected void execute( final File fin,final int lvl ) {
    273                if( !multi && lvl > 1 || lvl > level ) { return; }                      // 階層展開する､しない   // 6.9.7.0 (2018/05/14) PMD Useless parentheses.
    274                if( executeCount > maxRowCount ) { table.setOverflow( true ); return; }
    275
    276                final boolean isDIR = fin.isDirectory();
    277
    278                if(             fileType == null
    279                        ||  isDIR &&  "DIR".equalsIgnoreCase( fileType )
    280                        || !isDIR && "FILE".equalsIgnoreCase( fileType ) ) {
    281                                // 6.0.2.4 (2014/10/17) RpC:条件ﾃｽﾄを繰り返しています｡
    282                                if( addFrom || lvl > 0 ) {
    283                                        addFileData( executeCount++,lvl,fin );
    284                                }
    285                }
    286                if( isDIR ) {
    287                        final File[] list = fin.listFiles( filter );
    288                        // 5.3.7.0 (2011/07/01) ﾌｫﾙﾀﾞにｱｸｾｽできない場合は､null となる｡
    289                        if( list != null ) {
    290                                for( int i=0; i<list.length; i++ ) {
    291                                        execute( list[i],lvl+1 );
    292                                }
    293                        }
    294                }
    295        }
    296
    297        /**
    298         * 初期化された DBTableModel を返します｡
    299         *
    300         * ここでは､useWritable､useMD5､useUpdateClms､addClms を加味した
    301         * DBTableModel と初期値ﾃﾞｰﾀ(defClms)を作成します｡
    302         * 以前は､TO_PARENT､TO_NAMEと､addClms 分のみ初期値を持っていましたが､
    303         * 5.7.4.3 (2014/03/28)で､先頭ｶﾗﾑのWRITABLEの初期値を､DBColumn の初期値ではなく
    304         * 手動設定する必要がある為､すべてのｶﾗﾑ列の初期値を持っておきます｡
    305         *
    306         * @og.rev 5.3.4.0 (2011/04/01) 指定ｶﾗﾑ追加機能追加
    307         * @og.rev 5.7.4.3 (2014/03/28) useWritable,useMD5属性追加
    308         * @og.rev 6.2.2.0 (2015/03/27) TEXTｶﾗﾑを追加したうえで､ﾌｧｲﾙの内容を読み込むかどうか[true/false]を指定します(初期値:false)｡
    309         * @og.rev 6.4.3.4 (2016/03/11) String配列 から､Setに置き換えます｡
    310         * @og.rev 7.0.2.1 (2019/03/04) 追加ｶﾗﾑの位置のｱﾄﾞﾚｽ指定が間違っていた｡
    311         *
    312         * @return       ﾃｰﾌﾞﾙﾓﾃﾞﾙ
    313         */
    314        private DBTableModel initDBTable() {
    315                final DBTableModel tbl = DBTableModelUtil.newDBTable();
    316
    317                // 5.7.4.3 (2014/03/28) 以下の処理は､ほぼ全面見直し
    318                int size = SELECT_SET.size() ;                                                  // 6.4.3.4 (2016/03/11) 基本ｶﾗﾑの数
    319
    320                if( useWritable   ) { size++ ; }                                                // WRITABLE ｶﾗﾑを追加
    321                if( useMD5        ) { size++ ; }                                                // MD5 ｶﾗﾑを追加
    322                if( useText       ) { size++ ; }                                                // 6.2.2.0 (2015/03/27) TEXT ｶﾗﾑを追加
    323                if( useUpdateClms ) { size += USE_UPDATE_CLM.length; }  // TO_PARENT､TO_NAMEｶﾗﾑを追加
    324                size += addClms.length ;                                                                // addClms(追加ｶﾗﾑ)数を追加
    325
    326                // DBTableModel の初期化と､初期値配列の確保
    327                tbl.init( size );
    328                defClms = new String[size];
    329
    330                int ad=0;
    331                // 先頭は､WRITABLE
    332                if( useWritable ) {
    333                        final DBColumn dbColumn = getDBColumn( "WRITABLE" );
    334                        defClms[ad] = "1";                                                                      // WRITABLE を設定するときは､とりあえず 書き込み許可
    335                        tbl.setDBColumn( ad++,dbColumn );
    336                }
    337
    338                // SELECT の 基本ｶﾗﾑの設定｡(初期値は不要)
    339                // 6.4.3.4 (2016/03/11) String配列 から､Setに置き換えます｡
    340                // ｵﾘｼﾞﾅﾙの forEach｡ｶｳﾝﾀ初期値とﾗﾑﾀﾞ式を与えると､ﾗﾑﾀﾞ式の引数に､ｶｳﾝﾀと値が設定される｡
    341                SELECT_SET.forEach( ad , (i,v) -> {
    342                        final DBColumn dbColumn = getDBColumn( v );
    343                        tbl.setDBColumn( i,dbColumn );
    344                } );
    345
    346                ad += SELECT_SET.size();                                                                // 7.0.2.1 (2019/03/04)
    347
    348                // MD5 ｶﾗﾑを追加｡
    349                if( useMD5 ) {
    350                        final DBColumn dbColumn = getDBColumn( "MD5" );
    351                        defClms[ad] = "";                                                                       // ﾃﾞｨﾚｸﾄﾘの場合は､MD5計算しません｡
    352                        tbl.setDBColumn( ad++,dbColumn );
    353                }
    354
    355                // 6.2.2.0 (2015/03/27) TEXT ｶﾗﾑを追加
    356                if( useText ) {
    357                        final DBColumn dbColumn = getDBColumn( "TEXT" );
    358                        defClms[ad] = "";                                                                       // ﾃﾞｨﾚｸﾄﾘの場合は､TEXT計算しません｡
    359                        tbl.setDBColumn( ad++,dbColumn );
    360                }
    361
    362                // TO_PARENT､TO_NAMEｶﾗﾑを追加
    363                if( useUpdateClms ) {
    364                        for( int i=0; i<USE_UPDATE_CLM.length; i++ ) {
    365                                final DBColumn dbColumn = getDBColumn( USE_UPDATE_CLM[i] );
    366                                defClms[ad] = dbColumn.getDefault();                    // 初期値を指定しておく
    367                                tbl.setDBColumn( ad++,dbColumn );
    368                        }
    369                }
    370
    371                // 追加ｶﾗﾑのaddClmsｶﾗﾑを追加
    372                for( int i=0; i<addClms.length; i++ ) {
    373                        final DBColumn dbColumn = getDBColumn( addClms[i] );
    374                        defClms[ad] = dbColumn.getDefault();                                    // 初期値を指定しておく
    375                        tbl.setDBColumn( ad++,dbColumn );
    376                }
    377
    378                return tbl ;
    379        }
    380
    381        /**
    382         * DBTableModel に､ﾌｧｲﾙ情報をｾｯﾄします｡
    383         * ﾌｧｲﾙ情報は､[WRITABLE],LEVEL,FILE_TYPE,PARENT,NAME,LASTMODIFIED,FILE_LENGTH,RWH,[MD5],[TO_PARENT,TO_NAME],[････] です｡
    384         *
    385         * useWritable=true の場合､先頭ｶﾗﾑに､WRITABLE ｶﾗﾑを追加します｡
    386         * useMD5=true の場合､MD5ｶﾗﾑを追加したうえで､MD5計算を行います(ﾌｧｲﾙのみ計算します)｡
    387         * useUpdateClms=true の場合TO_PARENT､TO_NAMEｶﾗﾑを追加します｡
    388         * addClms で指定されたｶﾗﾑをその後ろに追加します｡
    389         *
    390         * @og.rev 5.3.4.0 (2011/04/01) 指定ｶﾗﾑ追加機能追加
    391         * @og.rev 5.7.4.3 (2014/03/28) useWritable,useMD5属性追加
    392         * @og.rev 6.2.2.0 (2015/03/27) TEXTｶﾗﾑを追加したうえで､ﾌｧｲﾙの内容を読み込むかどうか[true/false]を指定します(初期値:false)｡
    393         * @og.rev 6.2.3.0 (2015/05/01) POIUtil のﾒｿｯﾄﾞ名変更に伴う対応
    394         * @og.rev 6.2.4.2 (2015/05/29) POIUtil#extractor の判定方法変更
    395         * @og.rev 6.4.2.0 (2016/01/29) DateSet.getDate( String ) を利用するように修正します｡
    396         * @og.rev 7.0.2.1 (2019/03/04) fromLen属性追加｡
    397         * @og.rev 7.1.0.0 (2020/01/20) fromLen属性で､CanonicalFileで区切り文字'￥'が消えるため､そのため､PARENTに'￥'が残る現象の対応｡
    398         * @og.rev 7.2.6.0 (2020/06/30) nameOnly 属性 を追加します｡
    399         *
    400         * @param       rowNo   ｾｯﾄする行番号
    401         * @param       lvl     ｾｯﾄするﾚﾍﾞﾙ
    402         * @param       fin             ﾌｧｲﾙ情報の元となるﾌｧｲﾙｵﾌﾞｼﾞｪｸﾄ
    403         */
    404        private void addFileData( final int rowNo,final int lvl,final File fin ) {
    405                try {
    406                        final File file = fin.getCanonicalFile();
    407
    408                        final String rwh = (    file.canRead()  ? "r" : "-" )
    409                                                +       ( file.canWrite() ? "w" : "-" )
    410                                                +       ( file.isHidden() ? "h" : "-" );
    411
    412                        final String lastModified = DateSet.getDate( file.lastModified(),"yyyyMMddHHmmss" );                            // 6.4.2.0 (2016/01/29)
    413
    414                        final boolean isF = file.isFile();                                                      // File=true,それ以外=false
    415
    416                        final int size = table.getColumnCount() ;
    417                        String[] data = Arrays.copyOf( defClms,size );                          // JDK1.6
    418
    419                        int ad=0;
    420                        if( useWritable ) { ad++ ; }            // 単にひとつ進める｡初期値はｾｯﾄ済み｡
    421
    422                        // SELECT の 基本ｶﾗﾑの設定
    423                        data[ad++] = String.valueOf( lvl ) ;                                            // LEVEL
    424                        data[ad++] = isF ? "F" : "D" ;                                                          // FILE_TYPE
    425                        // 7.0.2.1 (2019/03/04) 検索結果のPARENT列から､from指定のﾊﾟｽを削除した相対ﾊﾟｽを作成
    426                        final String parent = file.getParent() ;                                                        // PARENTの元(正規ﾊﾟｽ)
    427//                      data[ad++] = fromLen > 0 ? parent.substring( fromLen ) : parent ;       // PARENT
    428                        data[ad++] = fromLen > 0 ? ( parent.length() < fromLen ? "" : parent.substring( fromLen ) ) : parent ;  // PARENT 7.1.0.0 (2020/01/20)
    429
    430                        // 7.2.6.0 (2020/06/30) nameOnly 属性 を追加します｡
    431                        String fname = file.getName() ;                                                         // NAME
    432                        if( nameOnly ) {
    433                                final int idx = fname.lastIndexOf( '.' );
    434                                if( idx >= 0 ) { fname = fname.substring( 0,idx ); }
    435                        }
    436//                      data[ad++] = file.getName() ;                                                           // NAME
    437                        data[ad++] = fname ;                                                                            // NAME
    438                        data[ad++] = lastModified ;                                                                     // LASTMODIFIED
    439                        data[ad++] = String.valueOf( FileUtil.length( file ) );         // FILE_LENGTH 6.7.4.1 (2017/02/17) DIRの容量も計算する
    440                        data[ad++] = rwh ;                                                                                      // RWH
    441
    442                        // MD5 ｶﾗﾑを追加(ﾌｧｲﾙの場合のみ計算します)
    443                        if( useMD5 && isF ) {
    444                                data[ad++] = HybsCryptography.getMD5( file );
    445                        }
    446
    447                        // 6.2.2.0 (2015/03/27) TEXT ｶﾗﾑを追加(ﾌｧｲﾙの場合のみ取り込みます)
    448                        if( useText && isF ) {
    449                                final String sufix = FileInfo.getSUFIX( file ) ;
    450                                String val = "";
    451                                try {
    452                                        if( POIUtil.isPOI( file ) ) {                                           // 6.2.4.2 (2015/05/29)
    453                                                val = POIUtil.extractor( file );
    454                                        }
    455                                        else if( "txt,jsp,java,xml,css,js".contains( sufix ) ) {
    456                                                val = POIUtil.extractor( file , "UTF-8");                               // 6.2.3.0 (2015/05/01)
    457                                        }
    458                                        else {
    459                                                val = POIUtil.extractor( file , "Windows-31J");                 // 6.2.3.0 (2015/05/01)
    460                                        }
    461                                }
    462                                catch( final RuntimeException ex ) {
    463                                        // 変換に失敗しても､処理は継続する｡
    464                                        final String errMsg = "ﾌｧｲﾙのﾃｷｽﾄ変換に失敗しました｡[" + fin + "]"
    465                                                                + " ROW=[" + rowNo + "]"
    466                                                                + CR + ex.getMessage();
    467                                        System.err.println( errMsg );
    468                                }
    469                                data[ad++] = val;
    470                        }
    471
    472                        // useUpdateClms=true 時の TO_PARENT､TO_NAMEｶﾗﾑや､addClmsの追加ｶﾗﾑは､初期値のみｾｯﾄ
    473                        // 初期値ｾｯﾄは､Arrays.copyOf で､defClms のｺﾋﾟｰで完了｡
    474
    475                        table.addColumnValues( data );
    476                }
    477                catch( final IOException ex ) {
    478                        final String errMsg = "正式なﾌｧｲﾙ名の取得に失敗しました｡[" + fin + "]"
    479                                                + " ROW=[" + rowNo + "]"
    480                                                + CR + ex.getMessage();
    481                        throw new HybsSystemException( errMsg,ex );
    482                }
    483        }
    484
    485        /**
    486         * 【TAG】ﾌｧｲﾙの検索元となるﾃﾞｨﾚｸﾄﾘを指定します
    487         *              (初期値:FILE_URL[={@og.value SystemData#FILE_URL}])｡
    488         *
    489         * @og.tag ﾌｧｲﾙの検索元となるﾃﾞｨﾚｸﾄﾘを指定します｡
    490         *
    491         * @og.rev 4.0.0.0 (2007/11/20) 指定されたﾃﾞｨﾚｸﾄﾘ名の最後が"\"or"/"で終わっていない場合に､"/"を付加する｡
    492         * @og.rev 6.4.2.1 (2016/02/05) URLの最後に､"/" を追加する処理を廃止｡
    493         * @og.rev 6.4.2.1 (2016/02/05) HybsSystem.url2dir に引数追加｡
    494         *
    495         * @param       url ﾌｧｲﾙの検索元となるﾃﾞｨﾚｸﾄﾘ
    496         */
    497        public void setFrom( final String url ) {
    498                final String furl = nval( getRequestParameter( url ),null );
    499                from = HybsSystem.url2dir( from,furl,"." );                     // 6.4.2.1 (2016/02/05)
    500        }
    501
    502        /**
    503         * 【TAG】多段階展開するか､１ﾚﾍﾞﾙ展開するかどうか[true/false]を指定します(初期値:false)｡
    504         *
    505         * @og.tag
    506         * 初期値は､false (１ﾚﾍﾞﾙ) です｡
    507         *
    508         * @param       mlti 多段階展開するか [true:する/false:１ﾚﾍﾞﾙ]
    509         */
    510        public void setMulti( final String mlti ) {
    511                multi = nval( getRequestParameter( mlti ),multi );
    512        }
    513
    514        /**
    515         * 【TAG】多段階展開するﾚﾍﾞﾙを指定します(初期値:100)｡
    516         *
    517         * @og.tag
    518         *
    519         * @param       lvl 多段階展開するﾚﾍﾞﾙ
    520         */
    521        public void setLevel( final String lvl ) {
    522                level = nval( getRequestParameter( lvl ),level );
    523        }
    524
    525        /**
    526         * 【TAG】ｿｰﾄするｶﾗﾑ名を指定します(一つのみ)｡
    527         *
    528         * @og.tag
    529         * ｿｰﾄするｶﾗﾑ名を､"LEVEL","FILE_TYPE","PARENT","NAME","LASTMODIFIED","FILE_LENGTH","RWH"
    530         * から一つ選びます｡
    531         * これは､複数ｶﾗﾑでのｿｰﾄはできません｡
    532         * 逆順にｿｰﾄする場合は､desc属性を true にｾｯﾄください｡
    533         * + をつけても､無効(ｶﾗﾑ名がないということ)でｴﾗｰになります｡
    534         *
    535         * @og.rev 5.3.4.0 (2011/04/01) 新規追加
    536         * @og.rev 6.3.4.0 (2015/08/01) Arrays.toString から String.join に置き換え｡
    537         * @og.rev 6.4.3.4 (2016/03/11) String配列 から､Setに置き換えます｡
    538         *
    539         * @param       clm ｿｰﾄするｶﾗﾑ名 (一つのみ､逆順はﾏｲﾅｽを付ける)
    540         * @see         #setDesc( String )
    541         */
    542        public void setOrderBy( final String clm ) {
    543                orderBy = nval( getRequestParameter( clm ),orderBy );
    544
    545                if( orderBy != null && ! check( orderBy, SELECT_SET ) ) {
    546                        final String errMsg = "指定の orderBy は､指定できません｡" + CR
    547                                                        + "orderBy=[" + orderBy + "] "                          + CR
    548                                                        + "orderByList=" + String.join( ", " , SELECT_SET ) ;
    549                        throw new HybsSystemException( errMsg );
    550                }
    551        }
    552
    553        /**
    554         * 【TAG】表示順を逆転するかどうか[true/false]を指定します(初期値:false)｡
    555         *
    556         * @og.tag
    557         * orderBy 属性で指定した表示順を､逆順にするかどうかを指定できます｡
    558         * 初期値は､false (昇順) です｡
    559         *
    560         * @og.rev 5.3.4.0 (2011/04/01) 新規追加
    561         *
    562         * @param       flag 表示順逆順 [逆順:true/正順:false]
    563         * @see         #setOrderBy( String )
    564         */
    565        public void setDesc( final String flag ) {
    566                desc = nval( getRequestParameter( flag ),desc );
    567        }
    568
    569        /**
    570         * 【TAG】先頭ｶﾗﾑに､WRITABLE ｶﾗﾑを追加するかどうか[true/false]を指定します(初期値:false)｡
    571         *
    572         * @og.tag
    573         * ﾌｧｲﾙ検索結果の１ﾚｺｰﾄﾞ単位に､書き込み許可/禁止属性を付けるには､
    574         * ｶﾗﾑ列の先頭に､WRITABLE ｶﾗﾑを追加する必要があります｡
    575         * 初期値は､false (追加しない) です｡
    576         *
    577         * @og.rev 5.7.4.3 (2014/03/28) 新規追加
    578         *
    579         * @param       flag WRITABLEｶﾗﾑ追加 [true:する/false:しない]
    580         */
    581        public void setUseWritable( final String flag ) {
    582                useWritable = nval( getRequestParameter( flag ),useWritable );
    583        }
    584
    585        /**
    586         * 【TAG】MD5ｶﾗﾑを追加したうえで､MD5計算を行うかどうか[true/false]を指定します(初期値:false)｡
    587         *
    588         * @og.tag
    589         * ﾌｧｲﾙの改変等をﾁｪｯｸするには､ﾌｧｲﾙのﾊｯｼｭ値を拾う必要があります｡
    590         * ﾀｲﾑｽﾀﾝﾌﾟとｻｲｽﾞ（LASTMODIFIED,FILE_LENGTH）でも､類似の処理は可能ですが､
    591         * より､厳密な一致をみるなら､MD5でﾊｯｼｭした結果を突き合わせるのがﾍﾞｽﾄです｡
    592         * useMD5=true に設定すると､MD5 というｶﾗﾑを追加したうえで､MD5計算結果をｾｯﾄします｡
    593         * 初期値は､false (追加しない) です｡
    594         *
    595         * @og.rev 5.7.4.3 (2014/03/28) 新規追加
    596         *
    597         * @param       flag MD5ｶﾗﾑ追加 [true:する/false:しない]
    598         */
    599        public void setUseMD5( final String flag ) {
    600                useMD5 = nval( getRequestParameter( flag ),useMD5 );
    601        }
    602
    603        /**
    604         * 【TAG】TEXTｶﾗﾑを追加したうえで､ﾌｧｲﾙの内容を読み込むかどうか[true/false]を指定します(初期値:false)｡
    605         *
    606         * @og.tag
    607         * ﾌｧｲﾙの内容を取得する場合に､true に設定します｡
    608         * 初期値は､false (追加しない) です｡
    609         *
    610         * @og.rev 6.2.2.0 (2015/03/27) TEXTｶﾗﾑを追加したうえで､ﾌｧｲﾙの内容を読み込むかどうか[true/false]を指定します(初期値:false)｡
    611         *
    612         * @param       flag TEXTｶﾗﾑ追加 [true:する/false:しない]
    613         */
    614        public void setUseText( final String flag ) {
    615                useText = nval( getRequestParameter( flag ),useText );
    616        }
    617
    618        /**
    619         * 【TAG】TO_PARENT､TO_NAMEｶﾗﾑを追加するかどうか[true/false]を指定します(初期値:false)｡
    620         *
    621         * @og.tag
    622         * fileUpdateﾀｸﾞでは､ﾌｧｲﾙのCOPYやMOVEが出来ますが､そのｺﾋﾟｰ先､移動先の
    623         * ﾌｧｲﾙを行ごとに指定する場合､TO_PARENT､TO_NAMEｶﾗﾑという固定名のｶﾗﾑが
    624         * 必要です｡
    625         * これを､addClms 属性で指定する代わりに､この属性で､true をｾｯﾄすることで､
    626         * 自動的に追加されます｡
    627         * 初期値は､false (追加しない) です｡
    628         *
    629         * @og.rev 5.3.4.0 (2011/04/01) 新規追加
    630         *
    631         * @param       flag TO_PARENT､TO_NAMEｶﾗﾑ追加 [true:追加する/false:追加しない]
    632         * @see         #setAddClms( String )
    633         * @see         org.opengion.hayabusa.taglib.FileUpdateTag
    634         */
    635        public void setUseUpdateClms( final String flag ) {
    636                useUpdateClms = nval( getRequestParameter( flag ),useUpdateClms );
    637        }
    638
    639        /**
    640         * 【TAG】検索結果のｶﾗﾑ列に追加するｶﾗﾑ名を､CSV形式で指定します｡
    641         *
    642         * @og.tag
    643         * ﾃﾞﾌｫﾙﾄのｶﾗﾑ名､[WRITABLE],LEVEL,FILE_TYPE,PARENT,NAME,LASTMODIFIED,FILE_LENGTH,RWH,[MD5],[TO_PARENT,TO_NAME]
    644         * 以外に､指定のｶﾗﾑ名を追加することが可能です｡
    645         * これは､ﾌｧｲﾙ検索結果以外の項目を追加して､ﾃﾞｰﾀﾍﾞｰｽに書き込む場合に､利用できます｡
    646         * 並び順は､ﾃﾞﾌｫﾙﾄｶﾗﾑの後ろに､指定のｶﾗﾑの順番で付きます｡
    647         * ここで追加したｶﾗﾑには､ｶﾗﾑﾘｿｰｽの初期値がｾｯﾄされます｡
    648         *
    649         * @og.rev 5.3.4.0 (2011/04/01) 新規追加
    650         *
    651         * @param       clms 追加するｶﾗﾑ名(CSV形式)
    652         * @see         #setUseUpdateClms( String )
    653         */
    654        public void setAddClms( final String clms ) {
    655                final String tmpClms = nval( getRequestParameter( clms ),null );
    656                if( tmpClms != null && tmpClms.length() > 0 ) {
    657                        addClms = StringUtil.csv2Array( tmpClms );
    658                }
    659        }
    660
    661        /**
    662         * 【TAG】ﾌｧｲﾙ名が､指定されたﾌｧｲﾙﾀｲﾌﾟ[DIR/FILE]と一致した場合､ｽﾙｰ(選択)されます(初期値:null)｡
    663         * @og.tag
    664         * 大文字小文字は区別しません｡
    665         * ﾌｧｲﾙﾀｲﾌﾟ は､DIR,FILE が指定できます｡
    666         * DIR は､ﾃﾞｨﾚｸﾄﾘのみ検索します｡(階層下がりも行います)
    667         * FILEは､ﾌｧｲﾙのみ検索します｡(階層下がりも行います)
    668         * 引数が null の場合は､追加しません｡(つまり､すべてｽﾙｰされます｡)
    669         *
    670         * @og.rev 5.3.4.0 (2011/04/01) fileType ﾒｿｯﾄﾞで選択対象指定の追加
    671         *
    672         * @param    str ﾌｧｲﾙﾀｲﾌﾟ [null:ｽﾙｰ/DIR:ﾃﾞｨﾚｸﾄﾘのみ検索/FILE:ﾌｧｲﾙのみ検索]
    673         */
    674        public void setFileType( final String str ) {
    675                final String tmp = nval( getRequestParameter( str ),fileType );
    676                if( tmp == null                                         ||
    677                        "DIR".equalsIgnoreCase( tmp )   ||
    678                        "FILE".equalsIgnoreCase( tmp ) ) {
    679                                fileType = tmp;
    680                }
    681                else {
    682                        // ﾌｧｲﾙﾀｲﾌﾟに不正な値が設定された場合は､ｴﾗｰになる｡
    683                        final String errMsg = "この､fileType 属性には､DIR,FILE 以外は指定できません｡["
    684                                                + tmp + "]";
    685                        throw new HybsSystemException( errMsg );
    686                }
    687        }
    688
    689        /**
    690         * 【TAG】from属性で指定された基準ﾌｧｲﾙ/ﾌｫﾙﾀﾞ自体をﾘｽﾄに追加するかどうか[true/false]を指定します(初期値:true)｡
    691         * @og.tag
    692         * 初期値はtrue(追加する)です｡
    693         *
    694         * @og.rev 5.3.9.0 (2011/09/01) 新規作成
    695         *
    696         * @param    flag 基準をﾘｽﾄに追加するかどうか [true:追加する/false:追加しない]
    697         */
    698        public void setAddFrom( final String flag ) {
    699                addFrom = nval( getRequestParameter( flag ),addFrom );
    700        }
    701
    702        /**
    703         * 【TAG】検索結果のPARENT列から､fromBase指定のﾊﾟｽを削除した相対ﾊﾟｽを作成します｡
    704         * @og.tag
    705         * 実ﾌｧｲﾙをURL化する場合に､階層をｽｷｬﾝしたPARENTから､fromBase分の文字列を削除します｡
    706         * PARENTに相対ﾊﾟｽを指定することが可能になります｡
    707         * 元となるﾌｧｲﾙﾊﾟｽは､getCanonicalFile() で作成した正規ﾊﾟｽ名になるため､
    708         * fromBase のﾊﾟｽの文字数も､同様に正規ﾊﾟｽ名から作成します｡
    709         *
    710         * @og.rev 7.0.2.1 (2019/03/04) fromBase属性追加に伴い､fromLen変数を用意｡
    711         * @og.rev 7.0.5.0 (2019/09/16) fromBase のﾊﾟｽの文字数も､正規ﾊﾟｽ名から作成｡
    712         * @og.rev 7.1.0.0 (2020/01/20) fromLen属性で､CanonicalFileで区切り文字'￥'が消えるため､そのため､PARENTに'￥'が残る現象の対応｡
    713         *
    714         * @param    base PARENT列から､fromBase指定のﾊﾟｽを削除した相対ﾊﾟｽを作成
    715         */
    716        public void setFromBase( final String base ) {
    717                final String fromBase = nval( getRequestParameter( base ),null );
    718                if( fromBase != null ) {
    719                        // 7.0.5.0 (2019/09/16) fromBase のﾊﾟｽの文字数も､正規ﾊﾟｽ名から作成｡
    720//                      fromLen = fromBase.length();
    721                        try {
    722                                fromLen = new File(fromBase).getCanonicalPath().length();               // 7.0.5.0 (2019/09/16)
    723                                // 7.1.0.0 (2020/01/20)
    724                                final char ch = fromBase.charAt( fromBase.length()-1 );
    725                                if( ch == '\\' || ch == '/' ) { fromLen++; }                                    // getCanonicalPathでは､最後の区切り記号が消える
    726                        }
    727                        catch( final IOException ex ) {
    728                                final String errMsg = "fromBaseの正式なﾌｧｲﾙ名の取得に失敗しました｡[" + base + "]"
    729                                                        + CR + ex.getMessage();
    730                                throw new HybsSystemException( errMsg,ex );
    731                        }
    732                }
    733        }
    734
    735        /**
    736         * 【TAG】ﾌｧｲﾙの拡張子を除いた名前部分のみの値で行います(初期値:false)｡
    737         *
    738         * @og.tag
    739         * ﾌｧｲﾙ検索の値を､ﾌｧｲﾙの拡張子を取り除いた値のみで､作成します｡
    740         * 初期値は､false (拡張子付きﾌｧｲﾙ名でﾘｽﾄ) です｡
    741         *
    742         * @og.rev 7.2.6.0 (2020/06/30) nameOnly 属性 を追加します｡
    743         *
    744         * @param       flag ﾌｧｲﾙの拡張子を除いた名前部分のみで作成するかどうか [true:名前部分のみ/false:ﾌｧｲﾙ名]
    745         */
    746        public void setNameOnly( final String flag ) {
    747                nameOnly = nval( getRequestParameter( flag ),nameOnly );
    748        }
    749
    750        /**
    751         * 【TAG】ｼｽﾃﾑ定数でｸﾗｳﾄﾞ設定されていても､ｸﾗｳﾄﾞ環境を使用しない場合､trueを指定します(初期値:false)｡
    752         *
    753         * @og.tag
    754         * ｸﾗｳﾄﾞ設定は､ｼｽﾃﾑ定数の『CLOUD_TARGET』と『CLOUD_BUCKET』の設定で自動的に使用しますが､
    755         * どうしてもﾛｰｶﾙでのみ使いたい場合は､この属性を true に設定します｡
    756         * 標準はfalse:設定どおりとなります｡
    757         *
    758         * true/false以外を指定した場合はfalse扱いとします｡
    759         *
    760         * @og.rev 8.0.1.0 (2021/10/29) useLocal 属性を追加｡
    761         *
    762         * @param flag ﾛｰｶﾙ環境のみ [true:ﾛｰｶﾙのみ/false:設定どおり]
    763         */
    764        public void setUseLocal( final String flag ) {
    765                useLocal = nval( getRequestParameter( flag ),useLocal );
    766        }
    767
    768        /**
    769         * FileFilterｵﾌﾞｼﾞｪｸﾄをｾｯﾄします｡
    770         * これは､BODY 部に登録した､FileWhereﾀｸﾞによって設定された
    771         * ﾌｧｲﾙﾌｨﾙﾀｰです｡
    772         *
    773         * @param       filter  ｵﾌﾞｼﾞｪｸﾄ
    774         */
    775        protected void setFileFilter( final FileFilter filter ) {
    776                this.filter = filter;
    777        }
    778
    779        /**
    780         * このｵﾌﾞｼﾞｪｸﾄの文字列表現を返します｡
    781         * 基本的にﾃﾞﾊﾞｯｸﾞ目的に使用します｡
    782         *
    783         * @return このｸﾗｽの文字列表現
    784         * @og.rtnNotNull
    785         */
    786        @Override
    787        public String toString() {
    788                return ToString.title( this.getClass().getName() )
    789                                .println( "VERSION"                     ,VERSION                )
    790                                .println( "multi"                       ,multi                  )
    791                                .println( "level"                       ,level                  )
    792                                .println( "from"                        ,from                   )
    793                                .println( "orderBy"                     ,orderBy                )
    794                                .println( "desc"                        ,desc                   )
    795                                .println( "addClms"                     ,Arrays.toString( addClms )     )
    796                                .println( "defClms"                     ,Arrays.toString( defClms )     )
    797                                .println( "fileType"            ,fileType               )
    798                                .println( "useWritable"         ,useWritable    )
    799                                .println( "useMD5"              ,useMD5                 )
    800                                .println( "useText"                     ,useText                )
    801                                .println( "useUpdateClms"       ,useUpdateClms  )
    802                                .println( "addFrom"                     ,addFrom                )
    803                                .println( "filter"                      ,filter                 )                               // 6.8.0.0 (2017/06/02)
    804                                .fixForm().toString()
    805                        + CR
    806                        + super.toString() ;
    807        }
    808}