    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.resource.GUIInfo;
    021import org.opengion.fukurou.db.Transaction;
    022import org.opengion.fukurou.util.StringUtil;
    023import org.opengion.fukurou.util.ToString;                                      // 6.1.1.0 (2015/01/17)
    024import org.opengion.fukurou.xml.XMLFileLoader;                          // 6.0.0.0 (2014/04/11) XMLFileLoader を使う様に変更
    025
    026import static org.opengion.fukurou.util.StringUtil.nval ;
    027
    028import java.sql.Connection;
    029
    030import java.io.File;
    031import java.io.StringWriter;                                                            // 6.0.0.0 (2014/04/11) XMLFileLoader に渡す Log
    032import java.util.Map;
    033import java.util.HashMap;
    034import java.util.Arrays;                                                                        // 6.0.0.0 (2014/04/11) keys,vals のｴﾗｰﾒｯｾｰｼﾞ作成用
    035
    036/**
    037 * 指定の拡張XDK形式ﾌｧｲﾙを直接ﾃﾞｰﾀﾍﾞｰｽに登録するﾃﾞｰﾀ入力ﾀｸﾞです。
    038 *
    039 * このｸﾗｽは、ｵﾗｸﾙ XDKの oracle.xml.sql.dml.OracleXMLSave ｸﾗｽと
    040 * ほぼ同様の目的で使用できる org.opengion.fukurou.xml.XMLFileLoader のﾗｯﾊﾟｰｸﾗｽです。
    041 *
    042 * 拡張XDK形式のXMLﾌｧｲﾙを読み込み、ﾃﾞｰﾀﾍﾞｰｽに INSERT します。
    043 * 拡張XDK形式の元となる ｵﾗｸﾙ XDK(Oracle XML Developer's Kit)については、以下の
    044 * ﾘﾝｸを参照願います。
    045 * <a href="https://docs.oracle.com/cd/F19136_01/adxdk/introduction-to-XDK.html" target="_blank" >
    046 * XDK(Oracle XML Developer's Kit)</a>
    047 *
    048 * このﾀｸﾞでは、keys,vals を登録することにより、<del>XMLﾌｧｲﾙに存在しないｶﾗﾑを
    049 * 追加したり</del>、XMLﾌｧｲﾙの情報を書き換えることが可能になります。
    050 * 例えば、登録日や、登録者、または、ﾃﾝﾌﾟﾚｰﾄより各ｼｽﾃﾑID毎に
    051 * 登録するなどです。
    052 *
    053 * 拡張XDK形式とは、ROW 以外に、SQL処理用ﾀｸﾞ(EXEC_SQL)を持つ XML ﾌｧｲﾙです。
    054 * また、登録するﾃｰﾌﾞﾙ(table)を ROWSETﾀｸﾞの属性情報として付与することができます。
    055 * (大文字小文字に注意)
    056 * これは、ｵﾗｸﾙXDKで処理する場合、無視されますので、同様に扱うことが出来ます。
    057 * この、EXEC_SQL は、それそれの XMLﾃﾞｰﾀをﾃﾞｰﾀﾍﾞｰｽに登録する際に、
    058 * SQL処理を自動的に流す為の、SQL文を記載します。
    059 * この処理は、ｲﾍﾞﾝﾄ毎に実行される為、その配置順は重要です。
    060 * このﾀｸﾞは、複数記述することも出来ますが、BODY部には、1つのSQL文のみ記述します。
    061 *
    062 * 6.0.0.0 (2014/04/11)
    063 *   指定のﾌｧｲﾙがﾌｫﾙﾀﾞの場合は、以下のﾌｧｲﾙすべて(拡張子はxml)を対象に読込-登録します。
    064 *   また、拡張子が、zip の場合は、zip内部の xml ﾌｧｲﾙを読込-登録します。
    065 *
    066 * ※ このﾀｸﾞは、Transaction ﾀｸﾞの対象です。
    067 *
    068 *   &lt;ROWSET tableName="XX" &gt;
    069 *       &lt;EXEC_SQL&gt;                    最初に記載して、初期処理(ﾃﾞｰﾀｸﾘｱ等)を実行させる。
    070 *           delete from GEXX where YYYYY
    071 *       &lt;/EXEC_SQL&gt;
    072 *       &lt;MERGE_SQL&gt;                   このSQL文で UPDATEして、結果が0件ならINSERTを行います。
    073 *           update GEXX set AA=[AA] , BB=[BB] where CC=[CC]
    074 *       &lt;/MERGE_SQL&gt;
    075 *       &lt;ROW num="1"&gt;
    076 *           &lt;ｶﾗﾑ1&gt;値1&lt;/ｶﾗﾑ1&gt;
    077 *             ･･･
    078 *           &lt;ｶﾗﾑn&gt;値n&lt;/ｶﾗﾑn&gt;
    079 *       &lt;/ROW&gt;
    080 *        ･･･
    081 *       &lt;ROW num="n"&gt;
    082 *          ･･･
    083 *       &lt;/ROW&gt;
    084 *       &lt;EXEC_SQL&gt;                    最後に記載して、項目の設定(整合性登録)を行う。
    085 *           update GEXX set AA='XX' , BB='XX' where YYYYY
    086 *       &lt;/EXEC_SQL&gt;
    087 *   &lt;ROWSET&gt;
    088 *
    089 * @og.formSample
    090 * ●形式:&lt;og:directXMLSave fileURL="[･･･]" ･･･ /&gt;
    091 * ●body:なし
    092 *
    093 * ●Tag定義:
    094 *   &lt;og:directXMLSave
    095 *       dbid               【TAG】(通常は使いません)検索時のDB接続IDを指定します(初期値:DEFAULT)
    096 *       fileURL            【TAG】読み取り元ﾃﾞｨﾚｸﾄﾘ名を指定します (初期値:FILE_URL[=filetemp/])
    097 *       filename           【TAG】ﾌｧｲﾙを作成するときのﾌｧｲﾙ名をｾｯﾄします (初期値:null)
    098 *       displayMsg         【TAG】query の結果を画面上に表示するﾒｯｾｰｼﾞIDを指定します(初期値:MSG0003[ﾌｧｲﾙの登録が完了しました。])
    099 *       keys               【TAG】XMLﾌｧｲﾙを読み取った後で指定するｷｰをCSV形式で複数指定します
    100 *       vals               【TAG】XMLﾌｧｲﾙを読み取った後で指定する値をCSV形式で複数指定します
    101 *       useTimeStamp       【TAG】XMLﾌｧｲﾙの読み取りで、ﾀｲﾑｽﾀﾝﾌﾟ管理を行うかどうか[true:行う/false:行わない]指定します(初期値:false)
    102 *       useTimeView        【TAG】処理時間を表示する TimeView を表示するかどうかを指定します
    103 *                                                                              (初期値:VIEW_USE_TIMEBAR[={@og.value SystemData#VIEW_USE_TIMEBAR}])。
    104 *       caseKey            【TAG】このﾀｸﾞ自体を利用するかどうかの条件ｷｰを指定します(初期値:null)
    105 *       caseVal            【TAG】このﾀｸﾞ自体を利用するかどうかの条件値を指定します(初期値:null)
    106 *       caseNN             【TAG】指定の値が、null/ｾﾞﾛ文字列 でない場合(Not Null=NN)は、このﾀｸﾞは使用されます(初期値:判定しない)
    107 *       caseNull           【TAG】指定の値が、null/ｾﾞﾛ文字列 の場合は、このﾀｸﾞは使用されます(初期値:判定しない)
    108 *       caseIf             【TAG】指定の値が、true/TRUE文字列の場合は、このﾀｸﾞは使用されます(初期値:判定しない)
    109 *       debug              【TAG】ﾃﾞﾊﾞｯｸﾞ情報を出力するかどうか[true/false]を指定します(初期値:false)
    110 *   /&gt;
    111 *
    112 * ●使用例
    113 *     &lt;og:directXMLSave
    114 *         dbid         = "ORCL"                接続ﾃﾞｰﾀﾍﾞｰｽID(初期値:DEFAULT)
    115 *         fileURL      = "{&#064;USER.ID}"     読み取り元ﾃﾞｨﾚｸﾄﾘ名
    116 *         filename     = "{&#064;filename}"    読み取り元ﾌｧｲﾙ名
    117 *         displayMsg   = "MSG0003"             登録完了後のﾒｯｾｰｼﾞ
    118 *     /&gt;
    119 *
    120 * @og.group ﾌｧｲﾙ入力
    121 * @og.rev 4.0.0.0 (2007/03/08) 新規追加
    122 * @og.rev 6.0.0.0 (2014/04/11) 単体ﾌｧｲﾙ以外(ﾌｫﾙﾀﾞ、ZIPﾌｧｲﾙ)への対応
    123 *
    124 * @version     4.0
    125 * @author      Kazuhiko Hasegawa
    126 * @since       JDK5.0,
    127 */
    128public class DirectXMLSaveTag extends CommonTagSupport {
    129        /** このプログラムのVERSION文字列を設定します。   {@value} */
    130        private static final String VERSION = "6.4.2.1 (2016/02/05)" ;
    131        private static final long serialVersionUID = 642120160205L ;
    132
    133        private String  dbid            ;
    134        private String  fileURL         = HybsSystem.sys( "FILE_URL" );                                 // 4.0.0 (2005/01/31)
    135        private String  filename        ;                                                                                               // 6.0.0.0 (2014/04/11) 初期値:null
    136        private String  displayMsg      = "MSG0003";                                                                    // ﾌｧｲﾙの登録が完了しました。
    137        private String[]        keys    ;
    138        private String[]        vals    ;
    139        private boolean useTimeStamp;                                                                                           // 6.0.2.0 (2014/09/19) ﾀｲﾑｽﾀﾝﾌﾟ管理を行うかどうか(true:行う/false:行わない)
    140        private boolean useTimeView     = HybsSystem.sysBool( "VIEW_USE_TIMEBAR" );             // 6.3.6.0 (2015/08/16)
    141
    142        /**
    143         * ﾃﾞﾌｫﾙﾄｺﾝｽﾄﾗｸﾀｰ
    144         *
    145         * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
    146         */
    147        public DirectXMLSaveTag() { super(); }          // これも、自動的に呼ばれるが、空のﾒｿｯﾄﾞを作成すると警告されるので、明示的にしておきます。
    148
    149        /**
    150         * Taglibの終了ﾀｸﾞが見つかったときに処理する doEndTag() を ｵｰﾊﾞｰﾗｲﾄﾞします。
    151         *
    152         * @og.rev 4.0.0.0 (2007/10/18) ﾒｯｾｰｼﾞﾘｿｰｽ統合( getResource().getMessage ⇒ getResource().getLabel )
    153         * @og.rev 4.0.0.1 (2007/12/03) try ～ catch ～ finally をきちんと行う。
    154         * @og.rev 5.1.9.0 (2010/08/01) Transaction 対応
    155         * @og.rev 5.3.7.0 (2011/07/01) TransactionReal の引数変更
    156         * @og.rev 5.5.2.6 (2012/05/25) findbugs対応。例外経路で null 値を利用することが保証されています。
    157         * @og.rev 5.6.6.1 (2013/07/12) caseKey 、caseVal 属性対応
    158         * @og.rev 5.6.7.0 (2013/07/27) DDL（ﾃﾞｰﾀ定義言語：Data Definition Language）の処理件数追加
    159         * @og.rev 6.0.2.0 (2014/09/19) useTimeStamp 属性追加。ﾀｲﾑｽﾀﾝﾌﾟ管理を行うかどうか
    160         * @og.rev 6.3.5.1 (2015/08/16) doStartTag() 削除に伴う、dyStart の移動。
    161         * @og.rev 6.3.6.1 (2015/08/28) Transaction でAutoCloseableを使用したtry-with-resources構築に対応。
    162         *
    163         * @return      後続処理の指示
    164         */
    165        @Override
    166        public int doEndTag() {
    167                debugPrint();           // 4.0.0 (2005/02/28)
    168                // 5.6.6.1 (2013/07/12) caseKey 、caseVal 属性対応
    169                if( !useTag() ) { return EVAL_PAGE ; }
    170                final long dyStart = System.currentTimeMillis();                                                // 6.3.5.1 (2015/08/16) 時間測定用
    171
    172                final StringWriter logW = new StringWriter();                                                   // 6.0.0.0 (2014/04/11) XMLFileLoader で Logをｾｯﾄ
    173
    174                // 6.0.0.0 (2014/04/11) XMLFileLoader に渡す 読み取り開始ﾌｧｲﾙｵﾌﾞｼﾞｪｸﾄ。
    175                final String directory = HybsSystem.url2dir( fileURL );
    176                // 6.4.1.1 (2016/01/16) PMD refactoring. Avoid if (x != y) ..; else ..;
    177                final File loadFile = ( filename == null ) ? new File( directory ) : new File( directory,filename );
    178
    179                final int insCnt ;                                                                                                              // 追加数だけ記録する。
    180
    181                // 6.3.6.1 (2015/08/28) Transaction でAutoCloseableを使用したtry-with-resources構築に対応。
    182                try( Transaction tran = getTransaction() ) {
    183                        final Connection conn = tran.getConnection( dbid );                                     // 5.1.9.0 (2010/08/01) Transaction 対応
    184
    185                        // 6.0.0.0 (2014/04/11) ﾌｫﾙﾀﾞ一括登録ができるようにします。
    186                        // 6.0.2.0 (2014/09/19) useTimeStamp 属性追加。ﾀｲﾑｽﾀﾝﾌﾟ管理を行うかどうか
    187                        final XMLFileLoader loader = new XMLFileLoader( conn,useTimeStamp );    // ｺﾈｸｼｮﾝとuseTimeStamp 指定
    188                        if( keys != null ) { loader.setAfterMap( getAfterMap() ); }
    189                        loader.setLogWriter( logW );
    190
    191                        loader.loadXMLFiles( loadFile );
    192
    193                        final int[] crudCnt = loader.getCRUDCount();                                            // 実行結果のｶｳﾝﾄ数
    194                        insCnt = crudCnt[XMLFileLoader.INS];
    195
    196                        tran.commit();                                                                                                          // 5.1.9.0 (2010/08/01) Transaction 対応
    197                }
    198                catch( final Throwable ex ) {                                                                                   // catch は、close() されてから呼ばれます。
    199                        // 6.2.3.0 (2015/05/01) ｴﾗｰﾒｯｾｰｼﾞの追加
    200                        final String errMsg = "XMLファイルのLoadに失敗しました。" + CR
    201                                                                + ex.getMessage() + CR
    202                                                                + " file=" + loadFile;
    203                        throw new HybsSystemException( errMsg,ex );
    204                }
    205
    206                // 実行件数の表示
    207                // 4.0.0 (2005/11/30) 出力順の変更。一番最初に出力します。
    208                if( displayMsg != null && displayMsg.length() > 0 ) {
    209                        final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE )
    210                                .append( "<pre>" )
    211                                .append( logW.toString() )                                                      // 6.0.0.0 (2014/04/11) XMLFileLoader で Logをｾｯﾄ
    212                                .append( CR )
    213                                .append( HybsSystem.getDate() ).append( "  " )
    214                                .append( getResource().getLabel( displayMsg ) )
    215                                .append( CR )
    216                                .append( "</pre>" );
    217
    218                        jspPrint( buf.toString() );
    219                }
    220
    221                // 4.0.0 (2005/01/31) ｾｷｭﾘﾃｨﾁｪｯｸ(ﾃﾞｰﾀｱｸｾｽ件数登録)
    222                final long dyTime = System.currentTimeMillis()-dyStart;
    223                final GUIInfo guiInfo = (GUIInfo)getSessionAttribute( HybsSystem.GUIINFO_KEY );
    224                if( guiInfo != null ) { guiInfo.addWriteCount( insCnt,dyTime,loadFile.getPath() ); }
    225
    226                if( useTimeView ) {             // 6.3.6.0 (2015/08/16)
    227                        // 時間測定用の DIV 要素を出力
    228                        jspPrint( "<div id=\"queryTime\" value=\"" + (dyTime) + "\"></div>" );  // 3.5.6.3 (2004/07/12)
    229                }
    230                return EVAL_PAGE ;
    231        }
    232
    233        /**
    234         * ﾀｸﾞﾘﾌﾞｵﾌﾞｼﾞｪｸﾄをﾘﾘｰｽします。
    235         * ｷｬｯｼｭされて再利用されるので、ﾌｨｰﾙﾄﾞの初期設定を行います。
    236         *
    237         * @og.rev 4.0.0.0 (2007/10/10) dbid の初期値を、"DEFAULT" から null に変更
    238         * @og.rev 6.0.0.0 (2014/04/11) filename の初期値を、ｼｽﾃﾑﾌﾟﾛﾊﾟﾃｨｰのFILE_FILENAME から null に変更
    239         * @og.rev 6.0.0.0 (2014/04/11) displayMsg の初期値を、MSG0040 から MSG0003 に変更
    240         * @og.rev 6.0.2.0 (2014/09/19) useTimeStamp 属性追加。ﾀｲﾑｽﾀﾝﾌﾟ管理を行うかどうか
    241         */
    242        @Override
    243        protected void release2() {
    244                super.release2();
    245                dbid                    = null;
    246                fileURL                 = HybsSystem.sys( "FILE_URL" );                                                 // 4.0.0 (2005/01/31)
    247                filename                = null;                                                                                                 // 6.0.0.0 (2014/04/11) 初期値:null
    248                displayMsg              = "MSG0003";                                                                                    // ﾌｧｲﾙの登録が完了しました。
    249                keys                    = null;
    250                vals                    = null;
    251                useTimeStamp    = false;                                                                                                // 6.0.2.0 (2014/09/19) ﾀｲﾑｽﾀﾝﾌﾟ管理を行うかどうか
    252                useTimeView             = HybsSystem.sysBool( "VIEW_USE_TIMEBAR" );                             // 6.3.6.0 (2015/08/16)
    253        }
    254
    255        /**
    256         * XMLﾌｧｲﾙを読み取った後で指定するｶﾗﾑと値のﾍﾟｱ(ﾏｯﾌﾟ)情報を作成します。
    257         *
    258         * このｶﾗﾑと値のﾍﾟｱのﾏｯﾌﾟは、ｵﾌﾞｼﾞｪｸﾄ構築後に設定される為、
    259         * XMLﾌｧｲﾙのｷｰの存在に関係なく、Mapのｷｰと値が使用されます。(Map優先)
    260         * key が null や ｾﾞﾛ文字列の場合は、Map に追加しません。
    261         *
    262         * @og.rev 5.6.6.1 (2013/07/12) key が null や ｾﾞﾛ文字列の場合は、Map に追加しません。
    263         * @og.rev 6.0.0.0 (2014/04/11) keys と vals の個数ﾁｪｯｸを追加
    264         *
    265         * @return      ｶﾗﾑと値のﾍﾟｱ(ﾏｯﾌﾟ)情報
    266         */
    267        private Map<String,String> getAfterMap() {
    268                // 6.0.2.4 (2014/10/17) NP:null 値を利用している可能性があります。
    269                if( keys == null || vals == null ) { return null; }             // 追加しないｹｰｽ
    270
    271                // 6.0.0.0 (2014/04/11) keys と vals の個数ﾁｪｯｸを追加
    272                if( keys.length != vals.length ) {
    273                        final String errMsg = "keys と vals の個数が異なります。"
    274                                                                + " keys=" + Arrays.toString( keys )
    275                                                                + " vals=" + Arrays.toString( vals ) ;
    276                        throw new HybsSystemException( errMsg );
    277                }
    278
    279                final Map<String,String> map = new HashMap<>();
    280                for( int i=0; i<keys.length; i++ ) {
    281                        if( keys[i] != null && keys[i].length() > 0 ) {         // 5.6.6.1 (2013/07/12)
    282                                map.put( keys[i],vals[i] );
    283                        }
    284                }
    285                return map ;
    286        }
    287
    288        /**
    289         * 【TAG】(通常は使いません)検索時のDB接続IDを指定します(初期値:DEFAULT)。
    290         *
    291         * @og.tag
    292         *   検索時のDB接続IDを指定します。初期値は、DEFAULT です。
    293         *
    294         * @param       id      ﾃﾞｰﾀﾍﾞｰｽ接続ID
    295         */
    296        public void setDbid( final String id ) {
    297                dbid = nval( getRequestParameter( id ),dbid );
    298        }
    299
    300        /**
    301         * 【TAG】読み取り元ﾃﾞｨﾚｸﾄﾘ名を指定します
    302         *              (初期値:FILE_URL[={@og.value SystemData#FILE_URL}])。
    303         *
    304         * @og.tag
    305         * この属性で指定されるﾃﾞｨﾚｸﾄﾘより、ﾌｧｲﾙを読み取ります。
    306         * 指定方法は、通常の fileURL 属性と同様に、先頭が、'/' (UNIX) または、２文字目が、
    307         * ":" (Windows)の場合は、指定のURLそのままのﾃﾞｨﾚｸﾄﾘに、そうでない場合は、
    308         * fileURL = "{&#064;USER.ID}" と指定すると、FILE_URL 属性で指定のﾌｫﾙﾀﾞの下に、
    309         * さらに、各個人ID別のﾌｫﾙﾀﾞの下より、読み取ります。
    310         * (初期値:ｼｽﾃﾑ定数のFILE_URL[={@og.value SystemData#FILE_URL}])。
    311         *
    312         * @og.rev 4.0.0.0 (2007/11/20) 指定されたﾃﾞｨﾚｸﾄﾘ名の最後が"\"or"/"で終わっていない場合に、"/"を付加する。
    313         * @og.rev 6.4.2.1 (2016/02/05) URLの最後に、"/" を追加する処理を廃止。
    314         *
    315         * @param       url     ﾌｧｲﾙURL
    316         * @see         org.opengion.hayabusa.common.SystemData#FILE_URL
    317         */
    318        public void setFileURL( final String url ) {
    319                final String furl = nval( getRequestParameter( url ),null );
    320                if( furl != null ) {
    321                        fileURL = StringUtil.urlAppend( fileURL,furl );
    322                }
    323        }
    324
    325        /**
    326         * 【TAG】ﾌｧｲﾙを作成するときのﾌｧｲﾙ名をｾｯﾄします(初期値:null)。
    327         *
    328         * @og.tag
    329         * ﾌｧｲﾙを作成するときのﾌｧｲﾙ名をｾｯﾄします。
    330         * (初期値:null)。
    331         *
    332         * @og.rev 6.0.0.0 (2014/04/11) filename の初期値を、ｼｽﾃﾑﾌﾟﾛﾊﾟﾃｨｰのFILE_FILENAME から null に変更
    333         *
    334         * @param       fname   ﾌｧｲﾙ名
    335         */
    336        public void setFilename( final String fname ) {
    337                filename = nval( getRequestParameter( fname ),filename );
    338        }
    339
    340        /**
    341         * 【TAG】query の結果を画面上に表示するﾒｯｾｰｼﾞIDを指定します(初期値:MSG0003[ﾌｧｲﾙの登録が完了しました])。
    342         *
    343         * @og.tag
    344         * ここでは、検索結果の件数や登録された件数をまず出力し、
    345         * その次に、ここで指定したﾒｯｾｰｼﾞをﾘｿｰｽから取得して
    346         * 表示します。
    347         * 表示させたくない場合は, displayMsg = "" をｾｯﾄしてください。
    348         * 初期値は、検索件数を表示します。
    349         * ※ この属性には、ﾘｸｴｽﾄ変数({&#064;XXXX})は使用できません。
    350         *
    351         * @param       id      処理結果表示ﾒｯｾｰｼﾞID
    352         */
    353        public void setDisplayMsg( final String id ) {
    354                if( id != null ) { displayMsg = id; }
    355        }
    356
    357        /**
    358         * 【TAG】XMLﾌｧｲﾙを読み取った後で指定するｷｰをCSV形式で複数指定します。
    359         *
    360         * @og.tag
    361         * XMLﾌｧｲﾙを読み取った後で、ﾃﾞｰﾀを変更できます。
    362         * 変更するｶﾗﾑ名(ｷｰ)をCSV形式で指定します。
    363         * XMLﾌｧｲﾙにｷｰが存在していた場合は、vals で指定の値に書き換えます。
    364         * <del>ｷｰが存在していない場合は、ここで指定するｷｰと値が、ﾃﾞｰﾀとして
    365         * 追加されます。</del>
    366         * 例えば、登録日や、登録者、または、ﾃﾝﾌﾟﾚｰﾄより各ｼｽﾃﾑID毎に
    367         * 登録するなどの使い方を想定しています。
    368         * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
    369         * こうしないとﾃﾞｰﾀ自身にｶﾝﾏを持っている場合に分解をﾐｽる為です。
    370         *
    371         * @param       key     ﾘﾝｸ先に渡すｷｰ
    372         * @see         #setVals( String )
    373         */
    374        public void setKeys( final String key ) {
    375                keys = getCSVParameter( key );
    376        }
    377
    378        /**
    379         * 【TAG】XMLﾌｧｲﾙを読み取った後で指定する値をCSV形式で複数指定します。
    380         *
    381         * @og.tag
    382         * XMLﾌｧｲﾙを読み取った後で、ﾃﾞｰﾀを変更できます。
    383         * 変更する値をCSV形式で指定します。
    384         * XMLﾌｧｲﾙにｷｰが存在していた場合は、vals で指定の値に書き換えます。
    385         * <del>ｷｰが存在していない場合は、ここで指定するｷｰと値が、ﾃﾞｰﾀとして
    386         * 追加されます。</del>
    387         * 例えば、登録日や、登録者、または、ﾃﾝﾌﾟﾚｰﾄより各ｼｽﾃﾑID毎に
    388         * 登録するなどの使い方を想定しています。
    389         * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
    390         * こうしないとﾃﾞｰﾀ自身にｶﾝﾏを持っている場合に分解をﾐｽる為です。
    391         *
    392         * @param       val     keys属性に対応する値
    393         * @see         #setKeys( String )
    394         */
    395        public void setVals( final String val ) {
    396                vals = getCSVParameter( val );
    397        }
    398
    399        /**
    400         * 【TAG】ﾀｲﾑｽﾀﾝﾌﾟ管理を行うかどうか[true:行う/false:行わない]を指定します(初期値:false)。
    401         *
    402         * @og.tag
    403         * useTimeStamp=true の場合、登録の実行有無の判断は、ﾌｧｲﾙの更新時刻より判断します。
    404         * これは、読み取りﾌｧｲﾙの更新時刻が、０でない場合、読み取りを行います。
    405         * 読み取りが完了した場合は、更新時刻を ０ に設定します。
    406         * つまり、一度しか読み込まないように制御できます。
    407         * useTimeStamp=false の場合は、無条件に読み込みます。
    408         *
    409         * @og.rev 6.0.2.0 (2014/09/19) 新規追加
    410         *
    411         * @param       flag    ﾀｲﾑｽﾀﾝﾌﾟ管理 [true:行う/false:行わない]
    412         */
    413        public void setUseTimeStamp( final String flag ) {
    414                useTimeStamp = nval( getRequestParameter( flag ),useTimeStamp );
    415        }
    416
    417        /**
    418         * 【TAG】処理時間を表示する TimeView を表示するかどうか[true:する/false:しない]を指定します
    419         *              (初期値:VIEW_USE_TIMEBAR[={@og.value SystemData#VIEW_USE_TIMEBAR}])。
    420         *
    421         * @og.tag
    422         * true に設定すると、処理時間を表示するﾊﾞｰｲﾒｰｼﾞが表示されます。
    423         * これは、DB検索、APｻｰﾊﾞｰ処理、画面表示の各処理時間をﾊﾞｰｲﾒｰｼﾞで
    424         * 表示させる機能です。処理時間の目安になります。
    425         * (初期値:VIEW_USE_TIMEBAR[={@og.value SystemData#VIEW_USE_TIMEBAR}])。
    426         *
    427         * @og.rev 6.3.6.0 (2015/08/16) useTimeView の初期値を、VIEW_USE_TIMEBAR にする。
    428         *
    429         * @param       flag    処理時間を表示 [true:する/false:しない]
    430         */
    431        public void setUseTimeView( final String flag ) {
    432                useTimeView = nval( getRequestParameter( flag ),useTimeView );
    433        }
    434
    435        /**
    436         * このｵﾌﾞｼﾞｪｸﾄの文字列表現を返します。
    437         * 基本的にﾃﾞﾊﾞｯｸﾞ目的に使用します。
    438         *
    439         * @return このｸﾗｽの文字列表現
    440         * @og.rtnNotNull
    441         */
    442        @Override
    443        public String toString() {
    444                return ToString.title( this.getClass().getName() )
    445                                .println( "VERSION"                     ,VERSION                )
    446                                .println( "dbid"                        ,dbid                   )
    447                                .println( "fileURL"                     ,fileURL                )
    448                                .println( "filename"            ,filename               )
    449                                .println( "keys"                        ,String.join( ", " , keys ) )           // 7.2.9.5 (2020/11/28)
    450                                .println( "vals"                        ,String.join( ", " , vals ) )           // 7.2.9.5 (2020/11/28)
    451                                .println( "displayMsg"          ,displayMsg             )
    452                                .println( "Other..."            ,getAttributes().getAttribute() )
    453                                .fixForm().toString() ;
    454        }
    455}