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.DBColumn;
021import org.opengion.hayabusa.db.DBEventColumn;
022import org.opengion.hayabusa.db.DBLastSql;
023import org.opengion.hayabusa.db.DBTableModel;
024import org.opengion.hayabusa.resource.GUIInfo;
025import org.opengion.hayabusa.resource.LabelInterface;
026import org.opengion.hayabusa.resource.ResourceFactory;
027import org.opengion.hayabusa.resource.ResourceManager;
028import org.opengion.hayabusa.resource.UserInfo;
029
030import static org.opengion.fukurou.util.StringUtil.nval;
031import org.opengion.fukurou.system.DateSet;                                             // 6.4.2.0 (2016/01/29)
032import org.opengion.fukurou.system.BuildNumber;                                 // 6.4.2.0 (2016/01/29) hayabusa.common.BuildNumber → fukurou.system.BuildNumber に移動
033import org.opengion.fukurou.system.HybsConst ;                                  // 6.1.0.0 (2014/12/26)
034import org.opengion.fukurou.system.MsgUtil;                                             // 6.4.3.2 (2016/02/19)
035// import org.opengion.fukurou.system.OgRuntimeException;               // 6.9.2.1 (2018/03/12)
036import org.opengion.fukurou.util.Attributes;
037import org.opengion.fukurou.util.StringUtil;
038import org.opengion.fukurou.util.HybsDateUtil;
039import org.opengion.fukurou.util.ToString;                                              // 6.1.1.0 (2015/01/17)
040import org.opengion.fukurou.db.DBFunctionName;
041import org.opengion.fukurou.db.ApplicationInfo;
042import org.opengion.fukurou.db.Transaction;                                             // 6.3.6.1 (2015/08/28)
043import org.opengion.fukurou.db.TransactionReal;                                 // 6.3.6.1 (2015/08/28)
044
045import java.io.IOException;
046import java.io.ObjectInputStream;
047import java.net.InetAddress;
048import java.net.UnknownHostException;
049import java.util.Arrays;
050import java.util.Collections;
051import java.util.Enumeration;
052import java.util.HashMap;
053import java.util.Locale;
054import java.util.Map;
055import java.util.LinkedHashMap;                                                                 // 6.2.5.1 (2015/06/12)
056import java.util.Set;                                                                                   // 6.4.3.4 (2016/03/11)
057import java.util.Scanner;                                                                               // 5.1010.1 (2019/04/05)
058
059import javax.servlet.ServletContext;
060import javax.servlet.ServletRequest;
061import javax.servlet.http.Cookie;
062import javax.servlet.http.HttpServletRequest;
063import javax.servlet.http.HttpServletResponse;
064import javax.servlet.http.HttpSession;
065import javax.servlet.jsp.JspWriter;
066import javax.servlet.jsp.tagext.BodyContent;
067import javax.servlet.jsp.tagext.BodyTagSupport;
068import javax.servlet.jsp.tagext.TryCatchFinally;
069
070/**
071 * TagSupport から継承されたサブクラスです。
072 *
073 * 汎用属性 のsetterメソッドと、Attributes オブジェクトを持っています。
074 * それ以外に、{@XXXX} 変数の対応と、lang属性のメソッドも用意しています。
075 *
076 * language 属性は、個々のリソースのロケールを指定できます。通常は、
077 * ユーザー情報の lang 属性をデフォルトで使用し、セットされていない場合は、
078 * リクエスト情報のロケールから取得します。
079 *
080 * 以下に、このメソッド内で定義される属性を記述します。
081 *
082 *       language           【TAG】タグ内部で使用する言語コード[ja/en/zh/…]を指定します
083 *       lbl                【TAG】ラベルリソースのラベルIDを指定します
084 *       debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
085 *       caseKey            【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null)
086 *       caseVal            【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null)
087 *       caseNN             【TAG】指定の値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます(初期値:判定しない)
088 *       caseNull           【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます(初期値:判定しない)
089 *       caseIf             【TAG】指定の値が、true/TRUE文字列の場合は、このタグは使用されます(初期値:判定しない)
090 *       scope              【TAG】キャッシュする場合のスコープ(request,session)を指定します(初期値:session)
091 *
092 * 各属性は、{@XXXX} 変数が使用できます。
093 * これは、ServletRequest から、XXXX をキーに値を取り出し,この変数に
094 * 割り当てます。つまり、このXXXXをキーにリクエストすれば、
095 * この変数に値をセットすることができます。
096 *
097 * http://localhost/query.jsp?KEY1=VLA1&KEY2=VAL2
098 *
099 * のようなリクエストで、{@KEY1} とすれば、 VAL1 がセットされます。
100 *
101 * このタグは、ラベル部分と入力フィールド部分がテーブルタグの<td>
102 * により左右に分割されます。HTML 表示時は、前後に<tr>タグで囲って,
103 * 整形できます。
104 *
105 * @og.group 画面制御
106 *
107 * @version  4.0
108 * @author   Kazuhiko Hasegawa
109 * @since    JDK5.0,
110 */
111class CommonTagSupport extends BodyTagSupport implements TryCatchFinally {
112        /** このプログラムのVERSION文字列を設定します。   {@value} */
113        private static final String VERSION = "7.2.0.0 (2020/02/14)" ;
114        private static final long serialVersionUID = 720020200214L ;
115
116        /** システムの改行コードを設定します。*/
117        protected static final String CR                 = HybsConst.CR;                        // 6.1.0.0 (2014/12/26) refactoring
118        /** HTMLの改行コード(<br /> + CR)を設定します。*/
119        protected static final String BR                 = HybsConst.BR;                        // 6.1.0.0 (2014/12/26) refactoring
120        /** StringBilderなどの初期値を設定します。   {@value} */
121        protected static final int BUFFER_MIDDLE = HybsConst.BUFFER_MIDDLE;     // 6.1.0.0 (2014/12/26) refactoring
122
123        private transient Attributes            attri           = new Attributes();
124        private transient ResourceManager       resource        ;
125        private transient UserInfo                      userInfo        ;
126        private transient GUIInfo                       guiInfo         ;
127        private transient HttpSession           session         ;
128        private transient ServletRequest        request         ;
129        /** 6.4.3.1 (2016/02/12) 取得元の HashMap を ConcurrentHashMap に置き換え。  */
130        private transient Map<String,String[]>  requestCache;           // 3.5.6.2 (2004/07/05)
131        private transient LabelInterface        msglbl          ;                       // 4.0.0 (2005/01/31)
132
133        private String                          language        ;
134        private boolean                         debugFlag       ;                               // 3.5.5.3 (2004/04/09)
135        private boolean                         isReqNull       ;
136        private boolean                         quotCheck       ;                               // 4.0.0 (2005/08/31)
137        private String                          scope           = "session";    // "request","page","session","application"
138        // 3.1.7.0 (2003/05/02) value値の使用可否を指定する、useValue 属性を追加。
139        private Long                            startTransaction;                       // 3.6.0.8 (2004/11/19)
140        private int[]                           rowNo           ;                               // 4.0.0 (2005/01/31)
141        private boolean                         xssCheck        = HybsSystem.sysBool( "USE_XSS_CHECK" ); // 5.0.0.2 (2009/09/15)
142        private boolean                         useTrans        ;                               // 5.1.6.0 (2010/05/01)
143
144        private String                          caseKey         ;                               // 5.2.2.0 (2010/11/01) 新規追加
145        private String                          caseVal         ;                               // 5.2.2.0 (2010/11/01) 新規追加
146        private boolean                         caseNN          = true;                 // 5.6.7.0 (2013/07/27) 新規追加
147        private boolean                         caseNull        = true;                 // 5.6.8.0 (2013/09/06) 新規追加
148        private boolean                         caseIf          = true;                 // 6.2.6.0 (2015/06/19) 新規追加
149
150        private boolean                         isSanitized     ;                               // 5.7.4.2 (2014/03/20) 新規追加
151
152        /**
153         * Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
154         *
155         * @return      後続処理の指示(SKIP_BODY)
156         */
157        @Override
158        public int doStartTag() {
159                return SKIP_BODY ;                              // Body を評価しない
160        //      return( EVAL_BODY_INCLUDE );    // Body インクルード( extends TagSupport 時)
161        //      return EVAL_BODY_BUFFERED ;             // Body を評価する。( extends BodyTagSupport 時)
162        }
163
164        /**
165         * Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。
166         *
167         * @return      後続処理の指示(SKIP_BODY)
168         */
169        @Override
170        public int doAfterBody() {
171                return SKIP_BODY ;                              // Body を評価しない
172        //      return( EVAL_BODY_AGAIN );              // ボディーを再評価( extends TagSupport 時)
173        //      return EVAL_BODY_BUFFERED ;             // ボディーを再評価( extends BodyTagSupport 時)
174        }
175
176        /**
177         * Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
178         *
179         * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
180         *
181         * @return      後続処理の指示
182         */
183        @Override
184        public int doEndTag() {
185                debugPrint();           // 4.0.0 (2005/02/28)
186
187                return EVAL_PAGE ;              // ページの残りを評価する。( extends TagSupport 時)
188        //      return(SKIP_PAGE);              // ページの残りの処理を行わない。
189        }
190
191        /**
192         * タグの処理中(セッターメソッドを除く)の例外を全て受け取ります。
193         *
194         * タグの中のボディ部の評価中、または Tag.doStartTag(), Tag.doEndTag(),
195         * IterationTag.doAfterBody(), BodyTag.doInitBody() のいずれもの
196         * メソッドの中で、Throwableが投げられたときに呼び出されます。
197         *
198         * このメソッドはセッターメソッドの中でThrowableが起きた場合は呼び出されません。
199         *
200         * @og.rev 3.5.0.0 (2003/09/17) TryCatchFinally インターフェースを適用。
201         * @og.rev 6.8.5.0 (2018/01/09) タグリブで発生したエラーを、session に登録しておきます。
202         * @og.rev 6.9.2.1 (2018/03/12) タグリブで発生したエラーを、session に登録する処理を、一旦廃止
203         * @og.rev 7.0.6.4 (2019/11/29) HybsSystemException を throw するように変更します。
204         *
205         * @param       th      このタグを通過してきたThrowableな例外
206         */
207        @Override
208        public void doCatch( final Throwable th ) throws Throwable {
209//              // 6.8.5.0 (2018/01/09) ※ なぜか、うまく使えていません。
210//              final Throwable cause = (Throwable)getSessionAttribute( "CommonTagThrowable" );
211//
212//              if( cause != null ) {
213//                      th.addSuppressed( cause );
214//              }
215//
216//              setSessionAttribute( "CommonTagThrowable" , th );
217//
218
219//              throw th;
220
221                if( th instanceof HybsSystemException ) {
222                        throw th;
223                }
224                else {
225                        throw new HybsSystemException( th );                            // 7.0.6.4 (2019/11/29)
226                }
227        }
228
229        /**
230         * タグの処理毎の、doEndTag()の後で呼び出されます。
231         *
232         * Tag,IterationTag,BodyTagを実装した全てのクラスの doEndTag()の
233         * 後で呼び出されます。 このメソッドはタグのボディ部や Tag.doStartTag(),
234         * Tag.doEndTag(), IterationTag.doAfterBody() ,BodyTag.doInitBody()の
235         * すべてのメソッドで例外が発生した後でも呼び出されます。
236         *
237         * このメソッドはセッターメソッドの中でThrowableが起きた場合は呼び出されません。
238         *
239         * このメソッドからは例外を投げるべきではありません。
240         * このメソッドは呼び出し毎のデータの整合性をとることとリソース管理の
241         * 動作をさせることを意図しています。
242         *
243         * @og.rev 3.5.0.0 (2003/09/17) TryCatchFinally インターフェースを適用。
244         *
245         */
246        @Override
247        public void doFinally() {
248                release2();
249        }
250
251        /**
252         * タグリブオブジェクトをリリースします。
253         * キャッシュされて再利用されるので、フィールドの初期設定を行います。
254         *
255         * @og.rev 2.0.0.4 (2002/09/27) カスタムタグの release() メソッドを、追加
256         * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
257         * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。HybsRequestWrapper 廃止。直接 Mapでキャッシュする。
258         * @og.rev 3.1.3.0 (2003/04/10) エンコード情報の取得を廃止する。
259         * @og.rev 3.1.7.0 (2003/05/02) value値の使用可否を指定する、useValue 属性を追加。
260         * @og.rev 3.5.5.3 (2004/04/09) debugFlag を、String ではなく、boolean 型に変更
261         * @og.rev 3.6.0.8 (2004/11/19) startTransaction 属性を追加
262         * @og.rev 3.8.0.2 (2005/07/11) rightNow 属性を追加
263         * @og.rev 5.0.0.2 (2009/09/15) XSS対応
264         * @og.rev 5.1.6.0 (2010/05/01) DBLastSQL周りの実装見直し
265         * @og.rev 5.1.8.0 (2010/07/01) isNullSet 属性 廃止にともなう、useValue 属性廃止
266         * @og.rev 5.2.2.0 (2010/11/01) caseKey、caseVal 属性の追加
267         * @og.rev 5.3.2.0 (2011/02/01) paramNames 属性の追加
268         * @og.rev 5.6.7.0 (2013/07/27) caseNN 属性の追加
269         * @og.rev 5.6.8.0 (2013/09/06) caseNull 属性の追加
270         * @og.rev 5.7.4.1 (2014/03/14) rightNow 属性 廃止
271         * @og.rev 5.7.4.1 (2014/03/14) isSanitized 属性の追加
272         * @og.rev 6.2.6.0 (2015/06/19) caseIf 属性の追加
273         */
274        protected void release2() {
275                language        = null;
276                attri           = new Attributes();
277                resource        = null;
278                debugFlag       = false;                // 3.5.5.3 (2004/04/09)
279                userInfo        = null;
280                guiInfo         = null;
281                session         = null;
282                request         = null;
283                isReqNull       = false;
284                scope           = "session";    // "request","page","session","application"
285                requestCache = null;
286                startTransaction = null;        // 3.6.0.8 (2004/11/19)
287                rowNo           = null;                 // 4.0.0 (2005/01/31)
288                msglbl          = null;                 // 4.0.0 (2005/01/31)
289                quotCheck       = false;                // 4.0.0 (2005/08/31)
290                xssCheck        = HybsSystem.sysBool( "USE_XSS_CHECK" ); // 5.0.0.2 (2009/09/15)
291                useTrans        = false;                // 5.1.6.0 (2010/05/01)
292                caseKey         = null;                 // 5.2.2.0 (2010/11/01)
293                caseVal         = null;                 // 5.2.2.0 (2010/11/01)
294                caseNN          = true;                 // 5.6.7.0 (2013/07/27) 新規追加
295                caseNull        = true;                 // 5.6.8.0 (2013/09/06) 新規追加
296                caseIf          = true;                 // 6.2.6.0 (2015/06/19) 新規追加
297                isSanitized     = false;                // 5.7.4.2 (2014/03/20) 新規追加。一応入れておくが都度、初期化しています。
298        }
299
300        /**
301         * 【TAG】タグ内部で使用する言語コード[ja/en/zh/…]を指定します。
302         *
303         * @og.tag
304         * この言語コードに基づいて、表示のラベルをリソースから作成します。
305         *
306         * @param   lang 言語コード [ja/en/zh/…]
307         * @see         #getLanguage()
308         */
309        public void setLanguage( final String lang ) {
310                language = getRequestParameter( lang );
311        }
312
313        /**
314         * 言語コード[ja/en/zh/…]を取得します。
315         *
316         * 言語コードが、セットされている場合は,設定値を優先します。
317         * 設定されていない場合は、ログインユーザーの持つLANG属性を、それが null の場合は、
318         * 実行環境のリクエストの言語を返します。
319         *
320         * @og.rev 2.1.1.0 (2002/11/08) セッション情報から取得できない場合に、クライアントの
321         *                      リクエスト情報のロケールから取得する処理を追加
322         * @og.rev 2.2.0.0 (2002/12/17) セッション情報から取得するのではなく、ユーザー情報より
323         *                      取得するように変更。そこにない場合は、リクエスト情報の
324         *                      ロケールから取得する
325         *
326         * @og.rev 6.0.2.5 (2014/10/31) 初期エラー発生時は、ユーザーも取得できないので、null でも返す。
327         * @og.rev 6.4.3.2 (2016/02/19) なにも取得できない場合は、"ja" を返すように変更。
328         *
329         * @return   言語コード[ja/en/zh/…]
330         * @see         #setLanguage( String )
331         */
332        protected String getLanguage() {
333                // 6.0.2.5 (2014/10/31) 初期エラー発生時は、ユーザーも取得できないので、null でも返す。
334                try {
335                        if( language == null ) {
336                                language = getUser().getLang();
337                                if( language == null ) {
338                                        language = getRequest().getLocale().getLanguage();
339                                }
340                        }
341                }
342                catch( final RuntimeException ex ) {
343                        final String errMsg = "言語コードを取得できませんでした。"
344                                                + ex.getMessage() ;
345                        System.err.println( errMsg );
346                }
347
348                // 6.4.3.2 (2016/02/19) なにも取得できない場合は、"ja" を返すように変更。
349                return language == null ? "ja" : language ;
350        }
351
352        /**
353         * 【TAG】ラベルリソースのラベルIDを指定します。
354         *
355         * @og.tag
356         * ラベルを変更するときに、lbl属性を使います。
357         *
358         * ラベルID は、所定の language に基づく ResourceManager の
359         * getLabelData( id ) を呼び出し、その結果のLabelInterfaceを使用します。
360         * getMsglbl() で取り出せます。
361         * ラベルとメッセージは統一されました。
362         *
363         * @og.rev 4.0.0.0 (2005/01/31) label 変数は、生データを保管するように変更。
364         *
365         * @param   lbl ラベルID
366         * @see         #getMsglbl()
367         */
368        public void setLbl( final String lbl ) {
369                msglbl = (LabelInterface)getResource().getLabelData( getRequestParameter( lbl ) ) ;             // 4.0.0 (2005/01/31)
370        }
371
372        /**
373         * 【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)。
374         *
375         * @og.tag
376         * デバッグ情報を [true:出力する/false:しない]を指定します。
377         * 出力形式自体は、個々のタグによって異なります。
378         *
379         * @og.rev 3.5.5.3 (2004/04/09) debugFlag を、String ではなく、boolean 型に変更
380         *
381         * @param   flag  デバッグ出力 [true:する/それ以外:しない]
382         */
383        public void setDebug( final String flag ) {
384                debugFlag = nval( getRequestParameter( flag ),debugFlag );
385        }
386
387        /**
388         * 【TAG】キャッシュする場合のスコープ[request/page/session/application]を指定します(初期値:session)。
389         *
390         * @og.tag
391         * "request","page","session","application" が指定できます。
392         * JSPのスコープは、「変数の有効範囲」を表すもので、フレームワーク上では、
393         * 主にテーブルモデルを管理するスコープを指します。
394         *
395     * <table class="plain">
396     *   <caption>テーブルモデルを管理するスコープ変数の有効範囲</caption>
397     *   <tr><th>スコープ   </th><th>変数の有効範囲</th><th>説明</th></tr>
398     *   <tr><td>page           </td><td>JSPページ内</td>
399     *       <td>そのJSPページ内のみで有効です。フレームワーク的には、JSPページにまたがる処理が多いため、ほとんど使う機会はありません。</td></tr>
400     *   <tr><td>request        </td><td>HTTPリクエスト</td>
401     *       <td>リクエストの一連の処理期間中に有効な変数で、メモリに多くの情報を残したくない場合に利用します。検索系やポップアップのJSP画面等に利用します。</td></tr>
402     *   <tr><td>session        </td><td>HTTPセッション</td>
403     *       <td>初期設定されているスコープで、ログインユーザー単位にログアウトまで保持されます。
404     *           内部的には、同じキーワード(tableId)で管理しているため、検索都度、破棄されます。
405     *           (ガーベジコレクションにて破棄されるのを待ちます。)</td></tr>
406     *   <tr><td>application</td><td>Webアプリケーション</td>
407     *       <td>ユーザー間で共有する場合のスコープになります。JSP画面の開発では、まず使うことはありません。</td></tr>
408     * </table>
409     *
410         * @param  scp スコープ [request/page/session/application]
411         * @see         #getScope()
412         */
413        public void setScope( final String scp ) {
414                scope = nval( getRequestParameter( scp ),scope );
415        }
416
417        /**
418         * キャッシュする場合のスコープ[request/page/session/application]を返します。
419         *
420         * "request","page","session","application" があります。
421         *
422         * @og.rev 3.5.5.8 (2004/05/20) 新規追加
423         *
424         * @return   スコープ[request/page/session/application]
425         * @see         #setScope( String )
426         */
427        public String getScope() {
428                return scope ;
429        }
430
431        /**
432         * 【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null)。
433         *
434         * @og.tag
435         * caseKey.matches( caseVal ) の値が、true の場合は、このタグは使用されます。
436         * false の場合は、このタグは使用されません。
437         *
438         * caseKey , caseVal ともに null の場合は、true です。どちらかが、非null の場合は、
439         * もう片方も 非null で、かつ、caseKey.matches( caseVal ) が成立する必要があります。
440         * この属性は、caseKey , caseVal , caseNN , caseNull , caseIf とともに useTag() の判定で使用されます。
441         *
442         * @og.rev 5.2.2.0 (2010/11/01) 新規追加
443         * @og.rev 5.6.3.3 (2013/04/19) 条件変更のためのコメント修正
444         *
445         * @param       ckey 条件キー (何も指定されない場合は、使用すると判断)
446         * @see         #setCaseVal( String )
447         * @see         #useTag()
448         */
449        public void setCaseKey( final String ckey ) {
450                caseKey = nval( getRequestParameter( ckey ),caseKey );
451        }
452
453        /**
454         * 【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null)。
455         *
456         * @og.tag
457         * caseKey.matches( caseVal ) の値が、true の場合は、このタグは使用されます。
458         * false の場合は、このタグは使用されません。
459         *
460         * caseKey , caseVal ともに null の場合は、true です。どちらかが、非null の場合は、
461         * もう片方も 非null で、かつ、caseKey.matches( caseVal ) が成立する必要があります。
462         * この属性は、caseKey , caseVal , caseNN , caseNull , caseIf とともに useTag() の判定で使用されます。
463         *
464         * @og.rev 5.2.2.0 (2010/11/01) 新規追加
465         * @og.rev 5.6.3.3 (2013/04/19) 条件変更のためのコメント修正
466         *
467         * @param       cval 条件値 (何も指定されない場合は、使用すると判断)
468         * @see         #setCaseKey( String )
469         * @see         #useTag()
470         */
471        public void setCaseVal( final String cval ) {
472                caseVal = nval( getRequestParameter( cval ),caseVal );
473        }
474
475        /**
476         * 【TAG】このタグ自体を利用するかどうかの条件として、NotNullかどうか判定します(初期値:判定しない)。
477         *
478         * @og.tag
479         * この値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます。
480         * null/ゼロ文字列 の場合は、このタグは使用されません。
481         * 何も指定しない場合は、使用されます。
482         * caseNull と逆の動きをします。
483         * {&#064;XXXX} で、指定した場合は、値が設定されなければ、使用されません。
484         *
485         * この属性は、caseKey , caseVal , caseNN , caseNull , caseIf とともに useTag() の判定で使用されます。
486         *
487         * @og.rev 5.6.7.0 (2013/07/27) 新規追加
488         *
489         * @param       cnn NotNull判定値 (何も指定されない場合は、使用すると判断)
490         * @see         #setCaseVal( String )
491         * @see         #useTag()
492         */
493        public void setCaseNN( final String cnn ) {
494                final String tempNN = nval( getRequestParameter( cnn ),null );
495
496                caseNN = tempNN != null && !tempNN.isEmpty() ;
497        }
498
499        /**
500         * 【TAG】このタグ自体を利用するかどうかの条件として、Nullかどうか判定します(初期値:判定しない)。
501         *
502         * @og.tag
503         * この値が、null/ゼロ文字列 の場合は、このタグは使用されます。
504         * null/ゼロ文字列 でない場合は、このタグは使用されません。
505         * 何も指定しない場合は、使用されます。
506         * caseNN と逆の動きをします。
507         * {&#064;XXXX} で、指定した場合は、値が設定されていなければ、使用されます。
508         *
509         * この属性は、caseKey , caseVal , caseNN , caseNull , caseIf とともに useTag() の判定で使用されます。
510         *
511         * @og.rev 5.6.8.0 (2013/09/06) 新規追加
512         *
513         * @param       cnul Null判定値 (何も指定されない場合は、使用すると判断)
514         * @see         #setCaseVal( String )
515         * @see         #useTag()
516         */
517        public void setCaseNull( final String cnul ) {
518                final String tempNull = nval( getRequestParameter( cnul ),null );
519
520                caseNull = tempNull == null || tempNull.isEmpty() ;
521        }
522
523        /**
524         * 【TAG】このタグ自体を利用するかどうかの条件として、true/TRUEかどうか判定します(初期値:判定しない)。
525         *
526         * @og.tag
527         * この値が、true/TRUE文字列 の場合は、このタグは使用されます。
528         * それ以外の場合は、このタグは使用されません。
529         * {&#064;XXXX} を指定した場合、null/ゼロ文字列でも、使用しないと判定されますので、ご注意ください。
530         *
531         * 7.0.1.1 (2018/10/22)
532         *  引数の先頭に、'!' を記述した場合、false/FALSE 判定を行います。
533         *  パース後の値が、"true" か、"!false" の場合のみ、条件成立となります。
534         *
535         *  "!{&#064;XXXX}" 指定の場合、null/ゼロ文字列の場合は、"!" だけになり、使用されません
536         *  これは、caseIfの反転ではありません。
537         *
538         * この属性は、caseKey , caseVal , caseNN , caseNull , caseIf とともに useTag() の判定で使用されます。
539         *
540         * @og.rev 6.2.6.0 (2015/06/19) caseIf 属性の追加
541         * @og.rev 7.0.1.1 (2018/10/22) 属性に、'!' を使用できるようにします。
542         *
543         * @param       cif true/TRUE判定 (null/ゼロ文字列場合のは、使用しないと判定)
544         * @see         #setCaseVal( String )
545         * @see         #useTag()
546         */
547        public void setCaseIf( final String cif ) {
548                // ※ 引数がnullの場合は、false。  nvl( flag,caseIf ) ではないので注意
549//              caseIf = "true".equalsIgnoreCase( getRequestParameter( cif ) );
550                final String flag = getRequestParameter( cif );         // null,ゼロ文字列もありうる。
551                caseIf = "true".equalsIgnoreCase( flag ) || "!false".equalsIgnoreCase( flag );
552        }
553
554        /**
555         * このタグ自体を利用するかどうかの条件判定を行います。
556         *
557         * caseNN &amp;&amp; caseNull &amp;&amp; caseIf &amp;&amp;
558         *    ( (caseKey == null &amp;&amp; caseVal == null) ||
559         *              (caseKey != null &amp;&amp; caseVal != null &amp;&amp; caseKey.matches( caseVal )))
560         * の結果を返します。
561         *
562         * これは、タグ本体に、条件式を登録できる機能です。必要なタグには、tld ファイルで、
563         * caseKey 、caseVal 、caseNN 、caseNull属性が使用できるように、設定します。
564         * 各タグを、equals タグで括る方法では、ソースの見通しが悪くなるため、
565         * ある程度タグ自身に判定機能を設けることで対応できるようにしました。
566         * ただ、本来、JSP 側にロジックを持ち込むのはよくないので、利用に関しては、
567         * 慎重にお願いします。
568         *
569         * @og.rev 5.2.2.0 (2010/11/01) 新規追加
570         * @og.rev 5.6.3.3 (2013/04/19) 条件変更(caseKey と caseVal が 両方とも null の場合のみ true)
571         * @og.rev 5.6.7.0 (2013/07/27) caseNN 属性追加。先のcaseKey、caseVal 条件と、AND 結合になります。
572         * @og.rev 5.6.8.0 (2013/09/06) caseNull 属性追加。先の条件と、AND 結合になります。
573         * @og.rev 6.2.6.0 (2015/06/19) caseIf 属性の追加
574         *
575         * @return      このタグ自体を利用するかどうか(true:利用する/false:利用しない)
576         * @see         #setCaseVal( String )
577         * @see         #setCaseKey( String )
578         * @see         #setCaseNN( String )
579         * @see         #setCaseIf( String )
580         */
581        protected boolean useTag() {
582//              return caseNN && caseNull && caseIf &&
583//                                      ( (caseKey == null && caseVal == null) ||
584//                                        (caseKey != null && caseVal != null && caseKey.matches( caseVal ))) ;
585                return caseNN && caseNull && caseIf &&                                                          // 6.9.7.0 (2018/05/14) PMD Useless parentheses.
586                                        ( caseKey == null && caseVal == null ||
587                                          caseKey != null && caseVal != null && caseKey.matches( caseVal ) ) ;
588        }
589
590        /**
591         * (通常は使いません)タグで処理される処理がメインとなるトランザクション処理かどうかを指定します(初期値:false)。
592         *
593         * この値は、ファイルダウンロード処理に影響します。この値がtrueに指定された時にcommitされたDBTableModelが
594         * ファイルダウンロードの対象の表になります。
595         *
596         * このパラメーターは、通常、各タグにより実装され、ユーザーが指定する必要はありません。
597         * 但し、1つのJSP内でDBTableModelが複数生成される場合に、前に処理したDBTableModelについてファイルダウンロードをさせたい
598         * 場合は、後ろでDBTableModelを生成するタグで、明示的にこの値をfalseに指定することで、ファイルダウンロード処理の対象から
599         * 除外することができます。
600         *
601         * @og.rev 5.1.6.0 (2010/05/01) 新規作成
602         *
603         * @param  flag メイントランザクション処理かどうか [true:メイン/false:その他]
604         */
605        protected void useMainTrans( final boolean flag ) {
606                useTrans = flag;
607        }
608
609        /**
610         * メッセージラベル(msglbl)を取得します。
611         *
612         * メッセージラベルは、lbl属性で登録された値を、
613         * それぞれのリソースに応じて各言語に変換した結果を格納しています。
614         *
615         * @og.rev 4.0.0.0 (2005/01/31) msglbl は、LabelInterface オブジェクトを利用
616         *
617         * @return   メッセージラベル
618         * @see         #setLbl( String )
619         */
620        protected String getMsglbl() {
621                String rtn = null;
622
623                if( msglbl != null ) { rtn = msglbl.getLabel(); }
624
625                return rtn ;
626        }
627
628        /**
629         * メッセージラベル(msglbl)のチップス表記を取得します。
630         *
631         * メッセージラベルは、lbl属性で登録された値を、
632         * それぞれのリソースに応じて各言語に変換した結果を格納しています。
633         * 別途、title属性を指定している場合は、置き換えます。
634         *
635         * @og.rev 4.0.0.0 (2005/01/31) msglbl は、LabelInterface オブジェクトを利用
636         *
637         * @return   メッセージラベル
638         */
639        protected String getLongLabel() {
640                String rtn = null;
641
642                if( msglbl != null ) {
643                        rtn = msglbl.getLongLabel( get( "title" ) );
644                }
645
646                return rtn ;
647        }
648
649        /**
650         * メッセージラベル(LabelInterface)を取得します。
651         *
652         * メッセージラベルは、lbl属性で登録された値を、
653         * それぞれのリソースに応じて各言語に変換した結果を格納しています。
654         *
655         * @return   メッセージラベル
656         */
657        protected LabelInterface getLabelInterface() {
658                return msglbl ;
659        }
660
661        /**
662         * ResourceManager を取得します。
663         *
664         * ページスコープ にセットされた ResourceManager があれば、それを、
665         * なければ、language 属性よりデフォルト ResourceManager を構築します。
666         * LOCAL_RES_KEY で管理される ResourceManager は、LocalResourceTag で
667         * 登録されたリソースです。これは、ローカルリソース情報として、使用されます。
668         *
669         * @return      ResourceManagerオブジェクト
670         */
671        protected ResourceManager getResource() {
672                if( resource == null ) {
673                        resource = (ResourceManager)pageContext.getAttribute( HybsSystem.LOCAL_RES_KEY );
674                        if( resource == null ) {
675                                resource = ResourceFactory.newInstance( getLanguage() );
676                        }
677                }
678                return resource;
679        }
680
681        /**
682         * デバッグ情報を出力するかどうか[true:する/false:しない]を取得します。
683         *
684         * setDebug( String )で登録します。
685         * 初期値は、false です。
686         *
687         * @og.rev 3.5.5.3 (2004/04/09) getDebug() から、メソッド名変更
688         *
689         * @return      デバッグ出力 [true:する/false:しない]
690         */
691        protected boolean isDebug() {
692                return debugFlag ;
693        }
694
695        /**
696         * ラベル文字列を返します。
697         *
698         * これは、{&#064;LBL.XXXX %Y} 引数処理をおこなうための、サポートメソッドです。
699         * 引数は、"XXXX %Y" という状態で受け取ります。(LBL. ははずした形)
700         * ラベルには、通常のラベル(Label)以外に、Short,Tips,Description,RawShortLabel の情報を持っています。
701         * {&#064;LBL.XXXX %Y} の Y に、先のLabel,Short,Tips,Description,RawShortLabel,CodeData の頭文字('L','S','T','D','R','C')を
702         * 指定することで、それぞれの状態を取得することが可能になります。
703         * Y を指定しない場合({&#064;LBL.XXXX}) は、'L' が指定された場合と同じ効果があります。
704         * Y は、先頭文字1文字で判断していますので、{&#064;LBL.XXXX %Short}と記述できます。
705         * Y 引数には、&#064;で始まるリクエスト引数が指定できます。例えば、{&#064;LBL.XXXX &#064;ZZ}
706         * とすると、ZZ のリクエスト引数の値が Y に適用されます。
707         * ラベルキーそのものをパラメータ化することが出来ます。
708         * これは、{&#064;LBL.&#064;XXXX}という形式になります。引数は、先の説明と同じです。
709         * この場合は、XXXX をキーにリクエスト引数の値が、ラベルリソースのキーになります。
710         *
711         * @og.rev 4.0.0.0 (2007/10/17) メッセージリソース統合に伴い、{&#064;LBL.XXXX Y}⇒{&#064;LBL.XXXX %Y}
712         * @og.rev 5.4.0.1 (2011/11/01) ラベル形式('L','S','T','D') に、R(RawShortLabel) を追加
713         * @og.rev 5.5.7.2 (2012/10/09) ラベル形式('L','S','T','D','R') に、C(CodeData) を追加
714         *
715         * @param    lbl ラベルのキー
716         *
717         * @return   ラベル文字列
718         */
719        protected String getLabel( final String lbl ) {
720
721                String key = lbl ;
722                String val = null;
723
724                final int spc = lbl.indexOf( ' ' );             // " " があるかどうか
725                if( spc > 0 ) {
726                        key = lbl.substring( 0,spc );
727                        if( key.charAt(0) == '@' ) { key = getRequestValue( key.substring( 1 ) ); }
728
729                        // リクエスト引数が指定された場合
730                        char ch  = lbl.length() > spc+1 ? lbl.toUpperCase( Locale.JAPAN ).charAt( spc+1 ) : ' ';        // Label,Short,Tips,Description
731                        char ch2 = lbl.length() > spc+2 ? lbl.toUpperCase( Locale.JAPAN ).charAt( spc+2 ) : ' ';        // Label,Short,Tips,Description
732                        if( ch == '@' ) {
733                                final String tmp = getRequestValue( lbl.substring( spc+2 ) );
734                                if( tmp != null && tmp.length() > 0 ) {
735                                        ch  = tmp.toUpperCase( Locale.JAPAN ).charAt(0);
736                                        ch2 = tmp.length() > 1 ? tmp.toUpperCase( Locale.JAPAN ).charAt( 1 ) : ' ';
737                                }
738                        }
739                        // 4.0.0.0 (2007/10/19)
740                        if( ch == '%' ) {
741                                switch( ch2 ) {
742                                        case 'L': val = getResource().getLabel( key ); break;
743                                        case 'S': val = getResource().getLabelData( key ).getShortLabel(); break;
744                                        case 'T': val = getResource().getLabelData( key ).getLongLabel(); break;
745                                        case 'D': val = getResource().getLabelData( key ).getDescription(); break;
746                                        case 'R': val = getResource().getLabelData( key ).getRawShortLabel(); break;    // 5.4.0.1 (2011/11/01)
747                                        case 'C': val = getResource().getLabelData( key + "." + getRequestValue( key ) ).getShortLabel(); break;        // 5.5.7.2 (2012/10/09)
748                                        default : break;
749                                }
750                        }
751                        else if( ch != ' ' ) {
752                                String[] msgVals = StringUtil.csv2Array( lbl.substring( spc+1 ),' ' );
753                                for( int i=0; i<msgVals.length; i++ ) {
754                                        // リクエスト文字パラメータ時の処理。その他は、ラベル文字は処理不要。
755                                        if( StringUtil.startsChar( msgVals[i] , '@' ) ) {                                       // 6.4.1.1 (2016/01/16) 1文字 String.startsWith
756                                                msgVals[i] = getRequestValue( msgVals[i].substring( 1 ) );
757                                        }
758                                }
759                                val = getResource().getLabel( key,msgVals );
760                        }
761                }
762                else {
763                        if( key.charAt(0) == '@' ) { key = getRequestValue( key.substring( 1 ) ); }
764                }
765
766                if( val == null ) { val = getResource().getLabel( key ); }
767                return val;
768        }
769
770        /**
771         * DBColumn オブジェクトを返します。
772         *
773         * これは、キーを元に DBColumnオブジェクトをカラムリソースの
774         * 定義ファイルより取得して、リソースマネージャで管理します。
775         *
776         * @param       key     オブジェクトのキー
777         *
778         * @return      DBColumnオブジェクト
779         */
780        protected DBColumn getDBColumn( final String key ) {
781                return getResource().makeDBColumn( key ) ;
782        }
783
784        /**
785         * 内部の Attributes オブジェクトに、属性値をセットします。
786         *
787         * 同じキーの値が登録されていた場合は、置き換えられます。
788         *
789         * @param   key   キー
790         * @param   value 属性値
791         * @see         #add( String , String )
792         */
793        protected void set( final String key, final String value ) {
794                attri.set( key,value );
795        }
796
797        /**
798         * 内部の Attributes オブジェクトに、属性値を追加します。
799         *
800         * ここでは、すでに同じキーが登録されている場合は、その値に、
801         * 標準セパレータ(スペース)を追加して、文字列結合します。
802         * たとえば、class 属性などは、値をスペースで追加する事で、
803         * CSS で処理することができます。
804         *
805         * @og.rev 4.0.0.0 (2007/05/18) 新規追加
806         *
807         * @param   key   キー
808         * @param   value 属性値
809         * @see         #add( String , String , String )
810         * @see         #set( String , String )
811         */
812        protected void add( final String key, final String value ) {
813                attri.add( key,value );
814        }
815
816        /**
817         * 内部の Attributes オブジェクトに、属性値を追加します。
818         *
819         * ここでは、すでに同じキーが登録されている場合は、その値に、
820         * 引数のセパレータを追加して、文字列結合します。
821         *
822         * @og.rev 3.5.0.0 (2003/09/17) 新規追加
823         * @og.rev 3.5.5.9 (2004/06/07) セパレータ引数付きのメソッドに変更
824         *
825         * @param   key   キー
826         * @param   value 属性値
827         * @param   sepa  セパレータ
828         * @see         #add( String , String )
829         */
830        protected void add( final String key, final String value, final String sepa ) {
831                attri.add( key,value,sepa );
832        }
833
834        /**
835         * 内部の Attributes オブジェクトから、属性値を取得します。
836         *
837         * @param       key     キー
838         *
839         * @return      属性値
840         * @see         #set( String , String )
841         */
842        protected String get( final String key ) {
843                return attri.get( key );
844        }
845
846        /**
847         * 属性オブジェクトの取得。
848         *
849         * Attributes オブジェクトを取得します。
850         *
851         * @return      Attributesオブジェクト
852         */
853        protected Attributes getAttributes() {
854                return attri;
855        }
856
857        /**
858         * {&#064;XXXX} 形式の文字列から XXXX をキーとして ServletRequest から getParameter で値を取り出します。
859         *
860         * 他の文字列に混在した {&#064;XXXX} 文字を変換可能です。
861         * ただし、処理の簡素化のため、上記形式以外は変換いたしません。
862         * エラー例)× { &#064;XXXX }、{&#064; XXXX }、{&#064;XXXX&#064;yyyy}、{&#064;XXXX{&#064;yyyy}}
863         * また、"{&#064;" を通常の記述で使うことは無いと考え、エスケープも用意して
864         * いません。よって、"{&#064;" のパターンが見つかって,"}" で閉じられていない
865         * 場合は,エラーとして、HybsSystemException を throw します。
866         *
867         * @og.rev 3.8.0.4 (2005/08/08) {} の処理方法見直し。連続処理、単体処理を可能にします。
868         *
869         * @param   key リクエストのキー
870         *
871         * @return  リクエストの値
872         * @og.rtnNotNull
873         */
874        protected String getRequestParameter( final String key ) {
875                isReqNull = false;
876
877                if( key == null ) { isReqNull = true; return ""; }
878                int index = key.indexOf( "{@" );
879                if( index < 0 ) { return key; }
880
881                // 変数が "{@XXXX}" の場合を優先的に検索。
882                // これにより多くのパターンで、StringTokenizer による
883                // 文字列操作を行う必要がなくなります。
884                if( index == 0 &&
885                        key.indexOf( '}' ) == key.lastIndexOf( '}' ) &&                         // 6.4.2.1 (2016/02/05) PMD refactoring. Useless parentheses.
886                        key.charAt(key.length()-1) == '}' ) {
887                                return getRequestValue( key.substring( 2,key.length()-1 ) );
888                }
889
890                // 3.8.0.4 (2005/08/08) {} の処理方法見直し。連続処理、単体処理を可能にします。
891                final StringBuilder rtn = new StringBuilder( BUFFER_MIDDLE );
892                int start = 0;
893                while( index >= 0 ) {
894                        final int end = key.indexOf( '}',index );
895                        if( end < 0 ) {
896                                final String errMsg = "{@ と } との対応関係がずれています。" + CR
897                                                        + "key=[" + key + "] : index=" + index ;
898                                throw new HybsSystemException( errMsg );
899                        }
900
901                        // {@ より前方の文字列を追加
902                        if( index > 0 ) { rtn.append( key.substring( start,index ) ); }
903
904                        // {@XXXX} の XXXX部分を処理
905                        final String val = getRequestValue( key.substring( index+2,end ) );
906                        if( val != null ) { rtn.append( val ); }
907
908                        start = end+1 ;
909                        index = key.indexOf( "{@",start );
910                }
911                rtn.append( key.substring( start ) );
912
913                return rtn.toString();
914        }
915
916        /**
917         * {&#064;XXX.YYYY} 形式の文字列から値を取得します。
918         * 予約語のみ処理をし、それ以外は{&#064;xxx}のままとします。
919         *
920         * 他の文字列に混在した {&#064;XXXX} 文字を変換可能です。
921         * ただし、処理の簡素化のため、上記形式以外は変換いたしません。
922         * エラー例)× { &#064;XXXX }、{&#064; XXXX }、{&#064;XXXX&#064;yyyy}、{&#064;XXXX{&#064;yyyy}}
923         * また、"{&#064;" を通常の記述で使うことは無いと考え、エスケープも用意して
924         * いません。よって、"{&#064;" のパターンが見つかって,"}" で閉じられていない
925         * 場合は,エラーとして、HybsSystemException を throw します。
926         *
927         * @og.rev 5.5.4.0 (2012/07/02) 新規作成
928         *
929         * @param   key リクエストのキー
930         *
931         * @return  リクエストの値
932         * @og.rtnNotNull
933         */
934        protected String getReservedParameter( final String key ) {
935                isReqNull = false;
936
937                if( key == null ) { isReqNull = true; return ""; }
938                int index = key.indexOf( "{@" );
939                if( index < 0 ) { return key; }
940
941                // 変数が "{@XXXX}" の場合を優先的に検索。
942                // これにより多くのパターンで、StringTokenizer による
943                // 文字列操作を行う必要がなくなります。
944                if( index == 0 &&
945                        key.indexOf( '}' ) == key.lastIndexOf( '}' ) &&                                 // 6.4.2.1 (2016/02/05) PMD refactoring. Useless parentheses.
946                        key.charAt(key.length()-1) == '}' ) {                                                   // 6.4.2.1 (2016/02/05) PMD refactoring. Useless parentheses.
947                                return getReservedValue( key.substring( 2,key.length()-1 ) );
948                }
949
950                // 3.8.0.4 (2005/08/08) {} の処理方法見直し。連続処理、単体処理を可能にします。
951                final StringBuilder rtn = new StringBuilder( BUFFER_MIDDLE );
952                int start = 0;
953                while( index >= 0 ) {
954                        final int end = key.indexOf( '}',index );
955                        if( end < 0 ) {
956                                final String errMsg = "{@ と } との対応関係がずれています。" + CR
957                                                        + "key=[" + key + "] : index=" + index ;
958                                throw new HybsSystemException( errMsg );
959                        }
960
961                        // {@ より前方の文字列を追加
962                        if( index > 0 ) { rtn.append( key.substring( start,index ) ); }
963
964                        // {@XXXX} の XXXX部分を処理
965                        final String val = getReservedValue( key.substring( index+2,end ) );
966                        if( val != null ) { rtn.append( val ); }
967
968                        start = end+1 ;
969                        index = key.indexOf( "{@",start );
970                }
971                rtn.append( key.substring( start ) );
972
973                return rtn.toString();
974        }
975
976        /**
977         * {&#064;XXXX} 形式の文字列から XXXX をキーとして ServletRequest から getParameterValues で値を取り出します。
978         *
979         * これは、複数(配列)でリクエストを取り出すことが可能です。
980         * そのため、他の文字列に混在させて変換することができません。
981         * "{&#064;XXXX}" 形式 からのみの変換となります。
982         *
983         * @og.rev 3.6.0.0 (2004/09/22) キーがnull のときにnullではなく長さ0の配列を返します。
984         *
985         * @param   key リクエストのキー
986         *
987         * @return  リクエストの値
988         * @og.rtnNotNull
989         */
990        protected String[] getRequestParameterValues( final String key ) {
991                if( key == null ) { return new String[0]; }             // 3.6.0.0 (2004/09/22)
992                final int index = key.indexOf( "{@" );
993                if( index < 0 ) { return StringUtil.csv2Array( key ); }
994
995                if( index == 0 && key.charAt( key.length()-1 ) == '}' ) {
996                        return getRequestValues( key.substring( 2,key.length()-1 ) );
997                }
998
999                final String errMsg = "引数の形式が異なります。 [" + key + "]" ;
1000                throw new HybsSystemException( errMsg );
1001        }
1002
1003        /**
1004         * 引数 inStr が、引数 check のSetの中に存在すれば、 true を、存在しなければ、false を返します。
1005         *
1006         * check は、 String配列 を、inStr は、null でも構いません。
1007         * ※ 6.3.5.0 (2015/08/08) 大文字小文字の区別廃止。
1008         *
1009         * @og.rev 2.1.0.3 (2002/11/08) 文字列配列を引数に取るメソッドを追加
1010         * @og.rev 6.3.5.0 (2015/08/08) forループの変更と、大文字小文字の区別廃止
1011         * @og.rev 6.4.3.4 (2016/03/11) String配列 から、Setに置き換えます。
1012         *
1013         * @param    inStr      チェックする文字列
1014         * @param    chkSet     チェック用の文字列Set
1015         *
1016         * @return   存在する true /  存在しない false
1017         */
1018        protected boolean check( final String inStr, final Set<String> chkSet ) {
1019                return inStr != null && chkSet != null && chkSet.contains( inStr );
1020        }
1021
1022        /**
1023         * ユーザーオブジェクトが持っている内部情報を取得します。
1024         *
1025         * これは、UserInfo#getAttribute( String ) で取得される情報です。
1026         * ユーザーパラメータとは異なります。
1027         *
1028         * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 getUser() を使用するように変更
1029         *
1030         * @param    user ユーザー情報を取り出すキー
1031         *
1032         * @return   ユーザー情報文字列
1033         */
1034        protected String getUserInfo( final String user ) {
1035                if( user == null ) { return null; }
1036
1037                String key = user ;
1038                if( key.charAt(0) == '@' ) {
1039                        key = getRequestValue( key.substring( 1 ) );
1040                }
1041
1042                return getUser().getAttribute( key );
1043        }
1044
1045        /**
1046         * ユーザーオブジェクトが持っているEditの内部情報を取得します。
1047         *
1048         * これは、UserInfo#getSelectedEdit( String ) で取得される情報です。
1049         * ユーザーパラメータとは異なります。
1050         *
1051         * @og.rev 5.8.2.3 (2014/12/27) 新規作成
1052         *
1053         * @param    guikey 取り出す画面ID
1054         *
1055         * @return   ユーザー情報文字列
1056         */
1057        protected String getUserEditInfo( final String guikey ) {
1058                if( guikey == null ) { return null; }
1059
1060                String key = guikey ;
1061                if( key.charAt(0) == '@' ) {
1062                        key = getRequestValue( key.substring( 1 ) );
1063                }
1064
1065        // * @og.rev 6.4.5.0 (2016/04/08) UserInfo のEditConfig関連機能を、DBEditConfigManagerに移植します。
1066        //      final DBEditConfigManager dbConfMgr = getUser().getEditConfigManager();         // 6.4.5.0 (2016/04/08)
1067        //      return dbConfMgr.getSelectedEdit( key );
1068                return getUser().getSelectedEdit( key );
1069        }
1070
1071        /**
1072         * ユーザー情報を設定します。
1073         *
1074         * 初めての場合は、session 登録項目 の HybsSystem#USERINFO_KEY キー の値で
1075         * 取得します。
1076         * save属性は、GE20(ユーザー定数)に情報を保存するかどうかを指定します。
1077         *
1078         * @og.rev 2.1.1.4 (2002/11/25) ユーザー情報をセットするメソッドを追加
1079         * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 getUser() を使用するように変更
1080         * @og.rev 4.3.4.0 (2008/12/01) GE20(ユーザー定数)へ登録するかのフラグを追加
1081         *
1082         * @param    key ユーザー情報をセットするキー
1083         * @param    value ユーザー情報文字列
1084         * @param    save 情報保存 [true:保存/false:保存しない]
1085         */
1086        protected void setUserInfo( final String key,final String value, final boolean save ) {
1087                if( key != null ) {
1088                        getUser().setAttribute( key, value, save );
1089                }
1090        }
1091
1092        /**
1093         * ユーザー情報オブジェクトを取得します。
1094         *
1095         * 初めての場合は、session 登録項目 の HybsSystem#USERINFO_KEY キー の値で
1096         * 取得します。
1097         *
1098         * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 新規追加
1099         * @og.rev 3.6.0.0 (2004/09/17) private ⇒ protected 化します。
1100         *
1101         * @return   ユーザー情報オブジェクト
1102         * @og.rtnNotNull
1103         */
1104        protected UserInfo getUser() {
1105                if( userInfo == null ) {
1106                        userInfo = (UserInfo)getSessionAttribute( HybsSystem.USERINFO_KEY );
1107                }
1108                if( userInfo == null ) {
1109                        final String errMsg = "ユーザーオブジェクトが存在しません。";
1110                        throw new HybsSystemException( errMsg );
1111                }
1112                return userInfo ;
1113        }
1114
1115        /**
1116         * 画面情報(GUIInfo)を取得します。
1117         *
1118         * これは、session 登録項目 の HybsSystem#GUIMAP_KEY キー の値で
1119         * 登録された MAP を取り出し、そこから取得します。
1120         * 画面情報は、ログインユーザー毎に個別に持っています。
1121         *
1122         * @og.rev 4.0.0.0 (2005/01/31) GUIInfo が存在しない場合も処理を続けます。
1123         *
1124         * @param    gamenId 画面ID
1125         *
1126         * @return   画面情報(GUIInfo)
1127         */
1128        protected GUIInfo getGUIInfo( final String gamenId ) {
1129                return getUser().getGUIInfo( gamenId );
1130        }
1131
1132        /**
1133         * 画面情報(GUIInfo)の属性値を取得します。
1134         *
1135         * これは、{&#064;GUI.XXXX ID} 引数処理をおこなうための、サポートメソッドです。
1136         * 引数は、"XXXX ID" という状態で受け取ります。(GUI. ははずした形)
1137         * XXXXには、画面情報(GUIInfo)の属性キーを指定します。IDが指定されない場合は、
1138         * 実行中の自分自身の画面が指定されたことになります。
1139         * これは、session 登録項目 の HybsSystem#GUIINFO_KEY キー の値で取得します。
1140         * この値は,画面が呼び出される毎に毎回設定されており、リクエスト毎に
1141         * 所得し直す必要があります。
1142         *
1143         * ID に、画面IDを指定した場合は、&#064; 指定によるリクエスト引数の値を適用できます。
1144         * {&#064;GUI.&#064;XXXX ID} や、{&#064;GUI.XXXX &#064;ID} です。(同時指定も可能)
1145         *
1146         * @og.rev 3.6.0.6 (2004/10/22) GUIInfo が存在しない場合も処理を続けます。
1147         * @og.rev 4.0.0.0 (2004/11/30) 画面ID引数や、リクエスト引数の使用を可能にします。
1148         * @og.rev 5.9.32.2 (2018/05/18) エラー表示変更
1149         * @og.rev 5.10.12.3 (2019/06/21) エラー表示変更
1150         *
1151         * @param    attkey 画面情報を取り出すキー
1152         *
1153         * @return   画面情報文字列
1154         */
1155        protected String getGUIInfoAttri( final String attkey ) {
1156                if( attkey == null ) { return null; }
1157
1158                String  key = attkey ;
1159                final GUIInfo gui ;
1160
1161                final int spc = key.indexOf( ' ' );             // " " があるかどうか
1162                if( spc > 0 ) {
1163                        key = attkey.substring( 0,spc );
1164                        String id = attkey.substring( spc+1 );
1165                        if( StringUtil.startsChar( id , '@' ) ) {                                                       // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
1166                                id = getRequestValue( id.substring( 1 ) );
1167                        }
1168                        gui = getUser().getGUIInfo( id );
1169                }
1170                else {
1171                        if( guiInfo == null ) {
1172                                guiInfo = (GUIInfo)getSessionAttribute( HybsSystem.GUIINFO_KEY );
1173                        }
1174                        gui = guiInfo;
1175                }
1176//              if( gui == null ) { return "Not Found[" + attkey + "]"; }
1177//              if( gui == null ) { return "Not Found(" + attkey + ")"; }       // 5.9.32.2 (2018/05/18) []で囲むとテーブルモデルで予期せぬエラーになるため変更
1178                if( gui == null ) { return "NotFound_" + attkey ; }                     // 5.10.12.3 (2019/06/21) URLで確実に使える文字のみで構成しておく
1179                if( StringUtil.startsChar( key , '@' ) ) {                                      // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
1180                        key = getRequestValue( key.substring( 1 ) );
1181                }
1182
1183                return gui.getAttribute( key );
1184        }
1185
1186        /**
1187         * {&#064;NVL.XXX 値} で、XXXが NULLの場合、値を返します。
1188         *
1189         * ORACLE等の COALESCE ( expr_list ) 処理に近い結果を返します。
1190         * NVL ( expr1 , expr2 ) は、expr1 が NULL の場合、expr2 を返しますが、
1191         * COALESCE は、第一引数が NULLなら、次の引数、それも NULL なら、さらに次と
1192         * 引数リストを順次処理していきます。
1193         * それと同じく、XXX が NULL なら、その次・・と順次評価していき、NULL でない
1194         * 値が返ってきたところで、その値を返します。
1195         * これは、{&#064;NVL.XXX &#064;YYY ZZZ ・・・} 形式を処理します。
1196         * これは、パラメータ XXX が NULLの場合、次の値を使います。(&#064;YYY) 
1197         * &#064;YYY は、YYY パラメータの事で、これも NULL の場合は、ZZZ を使います。
1198         * 最後まで NULL の場合は、 ゼロ文字列が返されます。
1199         *
1200         * @og.rev 5.6.4.0 (2013/05/02) 新規追加
1201         * @og.rev 6.9.3.0 (2018/03/26) パラメータ処理で、ダブルクオート内は分解しない
1202         * @og.rev 6.9.3.1 (2018/04/02) パラメータ処理で、ダブルクオート内は分解しない・・の処理漏れ追加
1203         *
1204         * @param    attkey NVL情報を取り出すパラメータ
1205         *
1206         * @return   NULL以外の値が出てくるまで、順次評価した結果
1207         */
1208        protected String getNVLAttri( final String attkey ) {
1209                if( attkey == null ) { return null; }
1210
1211                final String[] keys = StringUtil.csv2Array( attkey,' ' );               // ダブルクオート内は分解しない。
1212//              final String[] keys = attkey.split( " " );                      // スペースで、パラメータを分解する。
1213                String val = getRequestValue( keys[0] );                        // 第一パラメータは、そのままのキーで検索
1214
1215                // val が null の間は、チェックする。
1216                if( val == null || val.isEmpty() ) {
1217                        for( int i=1; i<keys.length; i++ ) {
1218                                val = keys[i];
1219                                // 先頭が @ の場合は、リクエスト変数のキーとして、値を判定
1220                                if( StringUtil.startsChar( val , '@' ) ) {                                      // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
1221                                        if( val.indexOf( ' ' ) > 0 ) {                                                  // 6.9.3.1 (2018/04/02) 空白を含む場合は、ダブルクオート内の処理
1222                                                val = getReservedValue( val.substring( 1 ) );                   // 6.9.3.0 (2018/03/26) もう一度変数処理
1223                                        }
1224                                        else {
1225                                                val = getRequestValue( val.substring( 1 ) );                    // 6.9.3.1 (2018/04/02) 一旦元に戻す。
1226                                        }
1227//                                      val = getRequestValue( val.substring( 1 ) );
1228//                                      val = getReservedValue( val.substring( 1 ) );                   // 6.9.3.0 (2018/03/26) もう一度変数処理
1229                                }
1230                                if( val != null && val.length() > 0 ) { break; }
1231                        }
1232                }
1233
1234                if( val == null ) { val = ""; }         // NULL の場合は、 ゼロ文字列を返す。
1235
1236                return val;
1237        }
1238
1239        /**
1240         * {&#064;LAST.XXX} で、XXXが 最後に使われた値を返します。
1241         *
1242         * XXX は、command="NEW" でセットされたリクエスト値です。通常、{&#064;MEM.XXX} は
1243         * 画面単位に、既存のキャッシュから値を取り出しますが、{&#064;LAST.XXX} は、
1244         * 画面に関係なく、ユーザー単位に管理しています。
1245         * また、値は、データベース(GE20)に保管されますので、次回ログイン時にも有効です。
1246         * この処理が呼び出されたときに、リクエスト変数に、XXXX が存在した場合は、そちらを優先に
1247         * 使います。その場合は、command に関係なく、値を設定しておきます。
1248         *
1249         * command="NEW"の場合のリクエスト変数の値の設定は、RequestCacheTag で行います。
1250         * 
1251         * ※ データベースには、画面アクセス情報のセーブ時に行われます。
1252         * valueタグのsave属性の様に、リアルタイムではありませんので、Tomcatが
1253         * 異常終了した場合は、セーブされません。
1254         *
1255         * @og.rev 5.6.8.1 (2013/09/13) 新規追加
1256         *
1257         * @param    attkey 最後に使われた値をを取り出すパラメータ
1258         *
1259         * @return   XXXが 最後に使われた値
1260         * @see         org.opengion.hayabusa.taglib.RequestCacheTag#commandExec( String ,ServletRequest )
1261         * @see         org.opengion.hayabusa.resource.UserInfo#getLastRequestValue( String )
1262         */
1263        protected String getLASTAttri( final String attkey ) {
1264                if( attkey == null ) { return null; }
1265
1266                // 最新のリクエスト変数をチェック
1267                final String[] vals = getRequest().getParameterValues( attkey );
1268
1269                String val = null;
1270                if( vals == null ) {
1271                        val = getUser().getLastRequestValue( attkey );          // なければ、取得
1272                }
1273                else {
1274                        for( int i=0; i<vals.length; i++ ) {
1275                                val = vals[i];
1276                                if( ! "0".equals( val ) ) { break; }                    // チェックボックス対応
1277                        }
1278                        getUser().setLastRequestValue( attkey,val );            // あれば、最新の値をセット
1279                }
1280
1281                return val ;
1282        }
1283
1284        /**
1285         * {&#064;SUMR.XXX} で、XXXの 複数リクエスト時の値を合算します。
1286         *
1287         * 同一キーのリクエスト変数に、複数のパラメータが
1288         * 設定された場合、その値を合計します。
1289         * 数値変換できない場合は、カンマで連結します。
1290         * 通常は、edior="BITBOX" などで、数値の合計を求めるために使われます。
1291         *
1292         * @og.rev 6.2.2.4 (2015/04/24) SUM追加
1293         * @og.rev 6.2.3.0 (2015/05/01) CSV形式の作成を、String#join( CharSequence , CharSequence... )を使用。
1294         * @og.rev 7.2.0.0 (2020/02/14) SUMはValueTagとダブるため、SUMR とします。
1295         *
1296         * @param    attkey 最後に使われた値をを取り出すパラメータ
1297         *
1298         * @return   XXXの 複数リクエスト時の値を合算
1299         */
1300        protected String getSumRequestValue( final String attkey ) {
1301                if( attkey == null ) { return null; }
1302
1303                // 最新のリクエスト変数をチェック
1304                final String[] vals = getRequestValues( attkey );
1305
1306                String rtn = "";
1307                if( vals != null && vals.length > 0 ) {
1308                        try {
1309                                int sum = 0;
1310                                for( int i=0; i<vals.length; i++ ) {
1311                                        final String val = vals[i];
1312                                        if( val != null && !val.isEmpty() ) {
1313                                                sum += Integer.parseInt( val );
1314                                        }
1315                                }
1316                                rtn = String.valueOf( sum );                            // 最後までエラーがなかった場合。
1317                        }
1318                        catch( final NumberFormatException ex ) {
1319                                // 数値変換エラー時は、文字列連結します。
1320                                // 6.2.3.0 (2015/05/01) CSV形式の作成を、String#join( CharSequence , CharSequence... )を使用。
1321                                rtn = String.join( "," , vals ) ;
1322                        }
1323                }
1324
1325                return rtn ;
1326        }
1327
1328        /**
1329         * {&#064;REQ.XXX} で、XXXの リクエストオブジェクトのメソッドの値を取得します。
1330         *
1331         * HttpServletRequest のメソッドを実行します。
1332         * それ以外に、ROWCOUNT というキーワードで、選択された行数を返します。
1333         * 
1334         * 通常のリクエストの値以外にRestAPIで利用される場合のあるX-HTTP-Method-Overrideと、
1335         * POSTデータのBodyの値(JSONを変数名を指定せずに送信する場合がある)についても
1336         * 取得できるようにしておきます。
1337         *
1338         * <table class="plain">
1339         *   <caption>{&#064;REQ.XXX}の説明</caption>
1340         *   <tr><th>KEY</th><th>VALUE</th></tr>
1341         *   <tr><td>ROWCOUNT           </td><td style="white-space: normal">チェックされた件数</td></tr>
1342         *   <tr><td>RequestURL         </td><td style="white-space: normal">request.getRequestURL()</td></tr>
1343         *   <tr><td>AuthType           </td><td style="white-space: normal">request.getAuthType()</td></tr>
1344         *   <tr><td>ContextPath        </td><td style="white-space: normal">request.getContextPath()</td></tr>
1345         *   <tr><td>Method             </td><td style="white-space: normal">request.getMethod()</td></tr>
1346         *   <tr><td>PathInfo           </td><td style="white-space: normal">request.getPathInfo()</td></tr>
1347         *   <tr><td>PathTranslated     </td><td style="white-space: normal">request.getPathTranslated()</td></tr>
1348         *   <tr><td>QueryString        </td><td style="white-space: normal">request.getQueryString()</td></tr>
1349         *   <tr><td>RemoteUser         </td><td style="white-space: normal">request.getRemoteUser()</td></tr>
1350         *   <tr><td>RequestURI         </td><td style="white-space: normal">request.getRequestURI()</td></tr>
1351         *   <tr><td>ServletPath        </td><td style="white-space: normal">request.getServletPath()</td></tr>
1352         *   <tr><td>RemoteAddr         </td><td style="white-space: normal">request.getRemoteAddr()</td></tr>
1353         *   <tr><td>RemoteHost         </td><td style="white-space: normal">request.getRemoteHost()</td></tr>
1354         *   <tr><td>Scheme             </td><td style="white-space: normal">request.getScheme()</td></tr>
1355         *   <tr><td>ServerName         </td><td style="white-space: normal">request.getServerName()</td></tr>
1356         *   <tr><td>ServerPort         </td><td style="white-space: normal">request.getServerPort()</td></tr>
1357         *   <tr><td>MethodOverride     </td><td style="white-space: normal">X-HTTP-Method-Override</td></tr>
1358         *   <tr><td>PostData           </td><td style="white-space: normal">request.getInputStream()</td></tr>
1359         *   <tr><td>JSPID              </td><td style="white-space: normal">JSPファイル名</td></tr>
1360         * </table>
1361         *
1362         * @og.rev 6.4.7.0 (2016/06/03) REQ追加
1363         * @og.rev 5.10.10.0 (2019/03/29) MethodOverride追加
1364         * @og.rev 7.0.4.1 (2019/06/10) {&#064;REQ.JSPID}追加
1365         * @og.rev 5.10.10.1 (2019/04/05) BodyData追加
1366         *
1367         * @param    attkey 最後に使われた値を取り出すパラメータ
1368         *
1369         * @return   XXXに対応したリクエストメソッドの実行結果
1370         */
1371        protected String getRequestMethod( final String attkey ) {
1372                if( attkey == null ) { return null; }
1373
1374                final HttpServletRequest req = (HttpServletRequest)pageContext.getRequest();
1375
1376                String rtn = "";
1377
1378                if(      "ROWCOUNT"                     .equalsIgnoreCase( attkey ) ) {
1379                        final String[] vals = req.getParameterValues( HybsSystem.ROW_SEL_KEY );
1380                        rtn = vals == null ? "0" : String.valueOf( vals.length );
1381                }
1382                else if( "RequestURL"           .equalsIgnoreCase( attkey ) ) { rtn = req.getRequestURL().toString();                   }
1383                else if( "AuthType"                     .equalsIgnoreCase( attkey ) ) { rtn = req.getAuthType();                                                }
1384                else if( "ContextPath"          .equalsIgnoreCase( attkey ) ) { rtn = req.getContextPath();                                             }
1385                else if( "Method"                       .equalsIgnoreCase( attkey ) ) { rtn = req.getMethod();                                                  }
1386                else if( "PathInfo"                     .equalsIgnoreCase( attkey ) ) { rtn = req.getPathInfo();                                                }
1387                else if( "PathTranslated"       .equalsIgnoreCase( attkey ) ) { rtn = req.getPathTranslated();                                  }
1388                else if( "QueryString"          .equalsIgnoreCase( attkey ) ) { rtn = req.getQueryString();                                             }
1389                else if( "RemoteUser"           .equalsIgnoreCase( attkey ) ) { rtn = req.getRemoteUser();                                              }
1390                else if( "RequestURI"           .equalsIgnoreCase( attkey ) ) { rtn = req.getRequestURI();                                              }
1391                else if( "ServletPath"          .equalsIgnoreCase( attkey ) ) { rtn = req.getServletPath();                                             }
1392                else if( "RemoteAddr"           .equalsIgnoreCase( attkey ) ) { rtn = req.getRemoteAddr();                                              }
1393                else if( "RemoteHost"           .equalsIgnoreCase( attkey ) ) { rtn = req.getRemoteHost();                                              }
1394                else if( "Scheme"                       .equalsIgnoreCase( attkey ) ) { rtn = req.getScheme();                                                  }
1395                else if( "ServerName"           .equalsIgnoreCase( attkey ) ) { rtn = req.getServerName();                                              }
1396                else if( "ServerPort"           .equalsIgnoreCase( attkey ) ) { rtn = String.valueOf( req.getServerPort() );    }
1397                else if( "MethodOverride"       .equalsIgnoreCase( attkey ) ) { rtn = String.valueOf( req.getHeader("X-HTTP-Method-Override") ); }      //5.10.10.0 (2019/03/29)
1398                else if( "ContentType"          .equalsIgnoreCase( attkey ) ) { rtn = String.valueOf( req.getHeader("Content-Type") ); }                        //5.10.10.1 (2019/04/05)
1399                else if( "PostData"                     .equalsIgnoreCase( attkey ) ) {                                                                                                                                         //5.10.10.1 (2019/04/05)
1400                        try( final Scanner sc = new Scanner(req.getInputStream(), "UTF-8").useDelimiter("\\A"); ){
1401                                rtn = sc.hasNext() ? sc.next() : "";
1402                        }catch( final IOException ie ) {
1403                                System.out.println(ie);
1404                                rtn="";
1405                        }
1406                }
1407                // 7.0.4.1 (2019/06/10) {&#064;REQ.JSPID}追加
1408                else if( "JSPID"                        .equalsIgnoreCase( attkey ) ) {
1409                        rtn = req.getRequestURI();
1410                        final int ad = rtn.lastIndexOf( '/' );
1411                        if( ad >= 0 ) {
1412                                rtn = rtn.substring( ad+1 );
1413                        }
1414                }
1415
1416                if( rtn == null ) { rtn = ""; }
1417
1418                return rtn ;
1419        }
1420
1421        /**
1422         * 予約語に関する情報の文字列を取得します。
1423         *
1424         * @og.rev 5.5.4.0 (2012/07/02) 予約語部分のみ分離
1425         * @og.rev 5.6.4.0 (2013/05/02) NVL 追加
1426         * @og.rev 5.6.8.1 (2013/09/13) LAST 追加
1427         * @og.rev 5.8.2.3 (2014/12/27) USEREDIT追加
1428         * @og.rev 6.2.2.4 (2015/04/24) SUM追加
1429         * @og.rev 6.4.7.0 (2016/06/03) REQ追加
1430         * @og.rev 6.5.0.0 (2016/09/30)) VAL追加。value値とリクエスト変数では、リクエスト変数が上位なので、value値を取り出したい場合に使用します。
1431         * @og.rev 6.7.7.0 (2017/03/31) applicationスコープの文字列を取得します。
1432         * @og.rev 6.7.7.2 (2017/04/14) VAL に、&#064; 付きのパラメータを使えるようにします。
1433         * @og.rev 5.9.26.1 (2017/11/10) JSON追加。JSON化するのではなく、JSONタイプのエスケープ処理をする。
1434         * @og.rev 7.0.5.0 (2019/09/09) 追加 ENV.で環境変数の値を取得できるようにします。
1435         * @og.rev 7.2.0.0 (2020/02/14) SUMはValueTagとダブるため、SUMR とします。
1436         *
1437         * @param    key キー
1438         *
1439         * @return   リクエスト情報の文字列
1440         * @og.rtnNotNull
1441         */
1442        protected String getReservedValue( final String key ) {
1443                if( key == null ) { isReqNull = true; return ""; }              // 3.4.0.3 (2003/09/10)
1444
1445                String rtn ;
1446                final int adrs = key.indexOf( '.' );
1447                if( adrs > 0 ) {
1448                        final String subKey = key.substring( adrs+1 );
1449                        if( key.startsWith( "USER." ) ) {
1450                                rtn = getUserInfo( subKey );
1451                        }
1452                        else if( key.startsWith( "USEREDIT." ) ) {
1453                                rtn = getUserEditInfo( subKey );        // 5.8.2.3 (2014/12/27)
1454                        }
1455                        else if( key.startsWith( "GUI." ) ) {
1456                                rtn = getGUIInfoAttri( subKey );        // 4.0.0 (2005/01/31)
1457                        }
1458                        else if( key.startsWith( "SYS." ) ) {
1459                                rtn = sys( subKey );            // 3.5.6.6 (2004/08/23)
1460                        }
1461                        else if( key.startsWith( "SESSION." ) ) {               // 3.5.5.3 (2004/04/09)
1462                                rtn = String.valueOf( getSessionAttribute( subKey ) );
1463                        }
1464                        // 6.7.7.0 (2017/03/31) applicationスコープの文字列を取得します。
1465                        else if( key.startsWith( "APP." ) ) {           // 6.7.7.0 (2017/03/31)
1466                                rtn = String.valueOf( getContextAttribute( subKey ) );
1467                        }
1468                        // 3.4.0.3 (2003/09/10) MEM.XXXX で、REQUEST_CACHE の値を取得できるように修正。
1469                        else if( key.startsWith( "MEM." ) ) {
1470                                // 3.5.4.7 (2004/02/06) getRequestCacheData を使用するように修正
1471                                rtn = getRequestCacheData( subKey );
1472                        }
1473                        // 3.8.0.2 (2005/07/11) MSG.XXXX で、メッセージリソースの値を取得できるように追加。
1474                        // 3.8.0.2 (2005/07/11) LBL.XXXX で、ラベルリソースの値を取得できるように追加。
1475                        else if( key.startsWith( "LBL." ) ) {
1476                                rtn = getLabel( subKey );
1477                        }
1478                        // 3.8.0.2 (2005/07/11) DATE.XXXX で、日付関係の値を取得できるように追加。
1479                        else if( key.startsWith( "DATE." ) ) {
1480                                rtn = getDateFormat( subKey );
1481                        }
1482                        // 3.8.0.1 (2005/06/17) NVAR.XXXX で、getUnicodeEscape 変換() を行います。
1483                        // NVAR. を取り除いた XXXX で再度、リクエスト値を取得し、それを Escape変換します。
1484                        else if( key.startsWith( "NVAR." ) ) {
1485                                rtn = StringUtil.getUnicodeEscape( getRequestValue( subKey ) );
1486                        }
1487                        // 4.3.6.0 (2009/04/01) メールモジュール用の予約語
1488                        else if( key.startsWith( "MAIL." ) ) {
1489                                rtn = ( String )getSessionAttribute( key );
1490                        }
1491                        // 4.3.7.0 (2009/06/01) DB関数名の取得
1492                        else if( key.startsWith( "DBF." ) ) {
1493                                rtn = getDBFunctionName( subKey );
1494                        }
1495                        // 4.4.0.0 (2009/08/02) データロールに基づく条件式の取得
1496                        else if( key.startsWith( "SEC." ) ) {
1497                                rtn = getDataCondition( subKey );
1498                        }
1499                        // 5.3.9.0 (2011/09/01) URLエンコード変換
1500                        else if( key.startsWith( "URL." ) ) {
1501                                rtn = StringUtil.urlEncode( getRequestValue( subKey ) );
1502                        }
1503                        // 5.5.1.3 (2012/04/09) エスケープ変換
1504                        else if( key.startsWith( "ESC." ) ) {
1505                                rtn = StringUtil.htmlFilter( getRequestValue(subKey,false) );
1506                        }
1507                        // 5.6.4.0 (2013/05/02) NVL 追加
1508                        else if( key.startsWith( "NVL." ) ) {
1509                                rtn = getNVLAttri( subKey );
1510                        }
1511                        // 5.6.8.1 (2013/09/13) LAST 追加
1512                        else if( key.startsWith( "LAST." ) ) {
1513                                rtn = getLASTAttri( subKey );
1514                        }
1515                        // 6.2.2.4 (2015/04/24) SUM追加
1516                        // 7.2.0.0 (2020/02/14) SUMはValueTagとダブるため、SUMR とします。
1517                        // 他に、MIN,MAX,HMF,AVG も、ValueTagで使用中なので注意すること。
1518//                      else if( key.startsWith( "SUM." ) ) {
1519                        else if( key.startsWith( "SUMR." ) ) {
1520                                rtn = getSumRequestValue( subKey );
1521                        }
1522                        // 6.4.7.0 (2016/06/03) REQ追加
1523                        else if( key.startsWith( "REQ." ) ) {
1524                                rtn = getRequestMethod( subKey );
1525                        }
1526                        // 6.5.0.0 (2016/09/30)) VAL追加
1527                        else if( key.startsWith( "VAL." ) ) {
1528                                // 6.7.7.2 (2017/04/14) VAL に、&#064; 付きのパラメータを使えるようにします。
1529                                if( subKey != null && !subKey.isEmpty() && subKey.charAt(0) == '@' ) {
1530                                        final String tmpKey = getRequestValue( subKey.substring( 1 ) );
1531                                        rtn = (String)getRequestAttribute( tmpKey );
1532                                }
1533                                else {
1534                                        rtn = (String)getRequestAttribute( subKey );    // ※ 取り出しは、subKey で
1535                                }
1536                        }
1537                        // 5.9.26.1 (2017/11/10) 追加 JSONタイプのエスケープを行う(JSONにするわけではない)
1538                        else if( key.startsWith( "JSON." ) ) {
1539                                rtn = StringUtil.jsonFilter( getRequestValue(subKey) );
1540                        }
1541                        // 7.0.5.0 (2019/09/09) 追加 ENV.で環境変数の値を取得できるようにします。
1542                        else if( key.startsWith( "ENV." ) ) {
1543                                rtn = System.getenv( subKey );
1544                        }
1545                        // 4.0.0.0 (2007/06/12) DB.XXXX は、直接取り出すように変更します。
1546                        // 6.3.5.0 (2015/08/08) CHART.TAG は、直接取り出すように変更します。
1547                        else { // 4.0.0.0 (2007/11/16)
1548                                rtn = (String)getRequestAttribute( key );               // ※ 取り出しは、key で
1549                        }
1550                }
1551                else{
1552                        rtn = "{@" + key + "}"; // 予約語以外は括弧を付けて書き戻します。
1553                }
1554                return rtn;
1555        }
1556
1557        /**
1558         * リクエスト情報の文字列を取得します。
1559         *
1560         * @og.rev 5.0.0.2 (2009/09/15) XSS対策
1561         *
1562         * @param    key キー
1563         *
1564         * @return   リクエスト情報の文字列
1565         */
1566        protected String getRequestValue( final String key ) {
1567                return getRequestValue( key, xssCheck);
1568        }
1569
1570        /**
1571         * リクエスト情報の文字列を取得します。
1572         *
1573         * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 エンコードの取得方法変更
1574         * @og.rev 3.0.0.0 (2002/12/25) StringUtil#changeString 廃止
1575         * @og.rev 3.0.0.0 (2002/12/25) ValueTag追加の為、指定の scope の Attributeより取得
1576         * @og.rev 3.1.0.1 (2003/03/26) Valueタグの値と、request情報の値の所得優先順位を、request が優先されるように変更。
1577         * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。HybsRequestWrapper 廃止。直接 Mapでキャッシュする。
1578         * @og.rev 3.1.5.0 (2003/04/22) SYS.XXXX で、システムパラメータ の値を取得できるように修正。
1579         * @og.rev 3.1.7.0 (2003/05/02) リクエスト情報の取得順序を、Request、キャッシュ、Value の順に変更。
1580         * @og.rev 3.1.7.0 (2003/05/02) value値の使用可否を指定する、useValue 属性を追加。
1581         * @og.rev 3.4.0.3 (2003/09/10) MEM.XXXX で、REQUEST_CACHE の値を取得できるように修正。
1582         * @og.rev 3.5.4.7 (2004/02/06) getRequestCacheData を使用するように修正
1583         * @og.rev 3.5.5.3 (2004/04/09) {&#064;SESSION.XXXX} で、session.getAttribute( "XXXX" ) の値を取得するように修正
1584         * @og.rev 3.5.6.6 (2004/08/23) SYS.XXXX の処理を getSystemParameter( String key ) メソッドへ移動
1585         * @og.rev 3.8.0.1 (2005/06/17) NVAR.XXXX で、getUnicodeEscape 変換() を行います。
1586         * @og.rev 3.8.0.2 (2005/07/11) MSG.XXXX , LBL.XXXX の処理を追加
1587         * @og.rev 3.8.0.2 (2005/07/11) チェックボックス対応で、重複リクエストに対応させます。
1588         * @og.rev 3.8.8.8 (2007/05/11) 重複リクエスト処理の場所を移動。リクエストのみ対象とする。
1589         * @og.rev 4.0.0.0 (2005/08/31) quotCheck によるSQLインジェクション対策
1590         * @og.rev 4.0.0.0 (2005/08/31) getSystemParameter を sys に名称変更
1591         * @og.rev 4.0.0.0 (2007/04/02) Valueタグの値と、キャッシュでは、Valueタグの値を優先するように変更
1592         * @og.rev 4.0.0.0 (2007/11/16) "."付きのパラメータのエラー処理をなくし、getRequestAttributeで取得する。
1593         * @og.rev 4.3.0.0 (2008/07/04) DB.XXXX は、必ずStringオブジェクトとし、String.valueOf しない。
1594         * @og.rev 4.3.6.0 (2009/04/01) メールモジュール用の予約語MAIL.XXXXの取得対応
1595         * @og.rev 4.4.0.0 (2009/08/02) データロール対応(SEC.xxxの取得対応)
1596         * @og.rev 5.0.0.2 (2009/09/15) XSS対策用にメソッドにフラグを追加
1597         * @og.rev 5.1.8.0 (2010/07/01) isNullSet 属性 廃止にともなう、useValue 属性廃止
1598         * @og.rev 5.3.9.0 (2011/09/01) URL.XXXX処理を追加
1599         * @og.rev 5.5.1.3 (2012/04/09) ESC.XXXX処理を追加
1600         * @og.rev 5.5.4.0 (2012/07/01) 予約語の処理を分離
1601         * @og.rev 5.7.4.2 (2014/03/20) サニタイズ処理は、getSanitizedBodyString() ではなく、ここで行います。
1602         * @og.rev 5.9.25.2 (2017/10/27) xssCheck及びquotCheckのエラーメッセージをラベルリソース化
1603         *
1604         * @param       key     キー
1605         * @param       xssCheckFlg     XSS対策用[true:行う/false:行わない]
1606         *
1607         * @return   リクエスト情報の文字列
1608         * @og.rtnNotNull
1609         */
1610        protected String getRequestValue( final String key, final boolean xssCheckFlg ) {
1611                if( key == null ) { isReqNull = true; return ""; }              // 3.4.0.3 (2003/09/10)
1612
1613                String rtn ;
1614                final int adrs = key.indexOf( '.' );
1615
1616                if( adrs > 0 ) {
1617                        rtn = getReservedValue( key ); // 5.5.4.0 (2012/07/02)
1618                }
1619                else {
1620                        rtn = getRequest().getParameter( key );
1621
1622                        // 5.7.4.2 (2014/03/20) サニタイズ処理は、getSanitizedBodyString() ではなく、ここで行います。
1623                        // 6.0.0.1 (2014/04/25) These nested if statements could be combined
1624                        if( isSanitized && rtn != null && rtn.indexOf( '[' ) >= 0 ) {
1625                                rtn = rtn.replace( "[", "\\]\\" );
1626                        }
1627
1628                        // 5.0.0.2 (2009/09/15) tagCheck によるthan signチェック Parameterのみにかけるためこの位置
1629                        if( rtn != null && rtn.length() > 0 && xssCheckFlg && ( rtn.indexOf( '<' ) >= 0 || rtn.indexOf( '>' ) >= 0 ) ) {
1630
1631                                // 5.9.25.2 (2017/10/27)
1632                                getResource();
1633                                final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE )
1634                                        .append( resource.getLabel( "ERR0048.1" ) ).append( CR )
1635                                        .append( resource.getLabel( "ERR0048.2",new String[] { key,rtn,getTagName() } ) ).append( CR );
1636
1637                                throw new HybsSystemException( buf.toString() );
1638                        }
1639
1640                        // 3.8.8.8 (2007/05/11) 重複リクエスト処理の場所を移動。リクエストのみ対象とする。
1641                        // 3.8.0.2 (2005/07/11) チェックボックス対応で、重複リクエストに対応させます。
1642                        // {@XXXX} で、値が"0"の場合、複数リクエストを確認して、"1"が含まれていれば、"1"とします。
1643                        if( "0".equals(rtn) ) {
1644                                final boolean backFlag = isReqNull ;
1645                                final String[] vals = getRequestValues( key );
1646                                if( vals != null && vals.length > 1 ) {
1647                                        for( int i=0; i<vals.length; i++ ) {
1648                                                if( "1".equals( vals[i] ) ) { rtn = "1"; break; }
1649                                        }
1650                                }
1651                                isReqNull = backFlag;   // 3.8.8.8 (2007/05/11) getRequestValues での NULLセット解除
1652                        }
1653
1654                        // 3.1.0.1 (2003/03/26) Valueタグの値と、request情報の値の取得優先順位を、
1655                        // request が優先されるように変更。
1656                        if( ( rtn == null || rtn.isEmpty() ) && requestCache != null ) {
1657                                final String[] str = requestCache.get( key );
1658                                if( str != null && str.length > 0 ) {
1659                                        rtn = str[0];
1660                                }
1661                        }
1662                        // 5.1.8.0 (2010/07/01) isNullSet 属性 廃止にともなう、useValue 属性廃止
1663                        if( rtn == null || rtn.isEmpty() ) {
1664                                final Object obj = pageContext.findAttribute( key );
1665                                if( obj != null ) {
1666                                        rtn = obj.toString();
1667                                }
1668                        }
1669                }
1670                if( rtn == null || rtn.isEmpty() ) {
1671                        isReqNull = true;
1672                        rtn    = "";
1673                }
1674                // 4.0.0 (2005/08/31) quotCheck によるSQLインジェクション対策
1675                else if( quotCheck && rtn.indexOf( '\'' ) >= 0 && !key.startsWith( "SEC." ) ) {         // 6.0.2.5 (2014/10/31) refactoring
1676
1677                        // 5.9.25.2 (2017/10/27)
1678                        getResource();
1679                        final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE )
1680                                .append( resource.getLabel( "ERR0049.1" ) ).append( CR )
1681                                .append( resource.getLabel( "ERR0049.2",new String[] { key,rtn,getTagName() } ) ).append( CR );
1682
1683                        throw new HybsSystemException( buf.toString() );
1684                }
1685
1686                return rtn ;
1687        }
1688
1689        /**
1690         * リクエスト情報の文字列を取得します。
1691         *
1692         * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 エンコードの取得方法変更
1693         * @og.rev 3.0.0.0 (2002/12/25) StringUtil#changeString 廃止
1694         * @og.rev 3.1.8.0 (2003/05/16) RequestCache データをリクエスト配列情報にも適用する。
1695         * @og.rev 5.3.8.0 (2011/08/01) Attribute等からも値が取得できるようにする。
1696         *
1697         * @param    key キー
1698         *
1699         * @return   リクエスト情報の文字列
1700         */
1701        protected String[] getRequestValues( final String key ) {
1702                String[] rtn = getRequest().getParameterValues( key );
1703
1704                // 3.1.8.0 (2003/05/16) RequestCache データをリクエスト配列情報にも適用する。
1705                if( ( rtn == null || rtn.length == 0 ) && requestCache != null ) {
1706                        rtn =requestCache.get( key );
1707                }
1708
1709                // 5.3.8.0 (2011/08/01) Attribute等からも値が取得できるようにする。
1710                if( rtn == null || rtn.length == 0 ) {
1711                        final String tmp = getRequestValue( key );
1712                        if( tmp != null && tmp.length() > 0 ) {
1713                                rtn = new String[]{ tmp };
1714                        }
1715                }
1716
1717                if( rtn == null || rtn.length == 0 ) { isReqNull = true; }
1718                return rtn ;
1719        }
1720
1721        /**
1722         * リクエスト情報の文字列のキー集合を取得します。
1723         *
1724         * @og.rev 5.3.2.0 (2011/02/01) パラメーターの外部指定対応
1725         *
1726         * @return   リクエスト情報の文字列のキー集合
1727         */
1728        protected Enumeration<?> getParameterNames() {          // 4.3.3.6 (2008/11/15) Generics警告対応
1729                final String[] names = (String[])getRequestAttribute( HybsSystem.PARAM_NAMES_KEY );
1730                return names == null ? getRequest().getParameterNames() : Collections.enumeration( Arrays.asList( names ) ) ;
1731        }
1732
1733        /**
1734         * リクエスト情報の文字列のキー集合をセットします。
1735         *
1736         * @og.rev 5.3.2.0 (2011/02/01) パラメーターの外部指定対応
1737         *
1738         * @param names リクエスト情報の文字列のキー配列(可変長引数)
1739         */
1740        protected void setParameterNames( final String... names ) {
1741                setRequestAttribute( HybsSystem.PARAM_NAMES_KEY, names );
1742        }
1743
1744        /**
1745         * リクエスト情報の文字列に NULL が存在していたかどうかを取得します。
1746         *
1747         * これは、getRequestParameter( String ) の呼出し毎に設定されます。
1748         * つまり、上記メソッドの実行直後の値を取り出す必要があります。
1749         * NULL が含まれていた(true)/含まれていなかった。(false)
1750         *
1751         * @return      NULLが含まれていた(true)/含まれていなかった。(false)
1752         */
1753        protected boolean isNull() {
1754                return isReqNull;
1755        }
1756
1757        /**
1758         * セッションに登録されているオブジェクトを取得します。
1759         *
1760         * @param   key キー
1761         *
1762         * @return   セッションに登録されているオブジェクト
1763         */
1764        protected Object getSessionAttribute( final String key ) {
1765                if( session == null ) { session = pageContext.getSession(); }
1766                return session.getAttribute( key );
1767        }
1768
1769        /**
1770         * セッションに 指定のキーでオブジェクトをセットします。
1771         *
1772         * @param   key キー
1773         * @param   object セッションに登録するオブジェクト
1774         */
1775        protected void setSessionAttribute( final String key ,final Object object ) {
1776                if( session == null ) { session = pageContext.getSession(); }
1777                session.setAttribute( key,object );
1778        }
1779
1780        /**
1781         * セッションに指定のキーで登録されているオブジェクトを 削除します。
1782         *
1783         * @param   key キー
1784         */
1785        protected void removeSessionAttribute( final String key ) {
1786                if( session == null ) { session = pageContext.getSession(); }
1787                session.removeAttribute( key );
1788        }
1789
1790        /**
1791         * リクエストに登録されているオブジェクトを取得します。
1792         *
1793         * @param   key キー
1794         *
1795         * @return   リクエストンに登録されているオブジェクト
1796         */
1797        protected Object getRequestAttribute( final String key ) {
1798                return getRequest().getAttribute( key );
1799        }
1800
1801        /**
1802         * リクエストに 指定のキーでオブジェクトをセットします。
1803         *
1804         * @param   key キー
1805         * @param   object リクエストに登録するオブジェクト
1806         */
1807        protected void setRequestAttribute( final String key ,final Object object ) {
1808                getRequest().setAttribute( key,object );
1809        }
1810
1811        /**
1812         * リクエストに指定のキーで登録されているオブジェクトを 削除します。
1813         *
1814         * @param   key キー
1815         */
1816        protected void removeRequestAttribute( final String key ) {
1817                getRequest().removeAttribute( key );
1818        }
1819
1820        /**
1821         * コンテキスト(application)に登録されているオブジェクトを取得します。
1822         *
1823         * scope属性に、"application" が指定された場合に、実行されます。
1824         *
1825         * @og.rev 3.0.0.0 (2002/12/25) scope="application" 指定の追加
1826         *
1827         * @param   key キー
1828         *
1829         * @return   コンテキスト(application)に登録されているオブジェクト
1830         */
1831        protected Object getContextAttribute( final String key ) {
1832                final ServletContext application = pageContext.getServletContext();
1833                return application.getAttribute( key );
1834        }
1835
1836        /**
1837         * コンテキスト(application)指定のキーでオブジェクトをセットします。
1838         *
1839         * scope属性に、"application" が指定された場合に、実行されます。
1840         *
1841         * @og.rev 3.0.0.0 (2002/12/25) scope="application" 指定の追加
1842         *
1843         * @param   key キー
1844         * @param   object コンテキスト(application)に登録するオブジェクト
1845         */
1846        protected void setContextAttribute( final String key ,final Object object ) {
1847                final ServletContext application = pageContext.getServletContext();
1848                application.setAttribute( key,object );
1849        }
1850
1851        /**
1852         * コンテキスト(application)指定のキーで登録されているオブジェクトを 削除します。
1853         *
1854         * scope属性に、"application" が指定された場合に、実行されます。
1855         *
1856         * @og.rev 3.0.0.0 (2002/12/25) scope="application" 指定の追加
1857         *
1858         * @param   key キー
1859         */
1860        protected void removeContextAttribute( final String key ) {
1861                final ServletContext application = pageContext.getServletContext();
1862                application.removeAttribute( key );
1863        }
1864
1865        /**
1866         * アプリケーションサーバーのコンテキストパスのURLを返します。
1867         *
1868         * @return   コンテキストパス
1869         */
1870        protected String getContextPath() {
1871                return ((HttpServletRequest)getRequest()).getContextPath();
1872        }
1873
1874        /**
1875         * スコープに応じて登録されているオブジェクトを取得します。
1876         *
1877         * @og.rev 3.0.0.0 (2002/12/25) scope="application" 指定の追加
1878         * @og.rev 6.7.7.0 (2017/03/31) scope="application" つづり間違い訂正
1879         *
1880         * @param   key キー
1881         *
1882         * @return   スコープに応じて登録されているオブジェクト
1883         */
1884        protected Object getObject( final String key ) {
1885                if(      "session".equals( scope )              ) { return getSessionAttribute( key ); }
1886                else if( "request".equals( scope )              ) { return getRequestAttribute( key ); }
1887                else if( "application".equals( scope )  ) { return getContextAttribute( key ); }                // 6.7.7.0 (2017/03/31)
1888                else {
1889                        final String errMsg = "このスコープはサポートされていません。[" + scope + "]";
1890                        throw new IllegalArgumentException( errMsg );
1891                }
1892        }
1893
1894        /**
1895         * スコープに応じて登録されているオブジェクトを指定のキーでセットします。
1896         *
1897         * @og.rev 3.0.0.0 (2002/12/25) scope="application" 指定の追加
1898         *
1899         * @param   key キー
1900         * @param   object リクエストに登録するオブジェクト
1901         * @see     #setObject( String ,Object ,String )
1902         */
1903        protected void setObject( final String key ,final Object object ) {
1904                setObject( key,object,scope );
1905        }
1906
1907        /**
1908         * スコープに応じて登録されているオブジェクトを指定のキーでセットします。
1909         *
1910         * 引数にスコープを指定します。スコープが null の場合は、オリジナルの
1911         * スコープを使用します。
1912         *
1913         * @og.rev 5.2.2.0 (2010/11/01) 新規追加
1914         * @og.rev 6.7.7.0 (2017/03/31) scope="application" つづり間違い訂正
1915         *
1916         * @param   key キー
1917         * @param   object リクエストに登録するオブジェクト
1918         * @param   scp スコープ
1919         * @see     #setObject( String ,Object )
1920         */
1921        protected void setObject( final String key ,final Object object ,final String scp ) {
1922                final String inScp = (scp == null) ? scope : scp ;
1923
1924                if(      "session".equals( inScp        ) ) { setSessionAttribute( key,object ); }
1925                else if( "request".equals( inScp        ) ) { setRequestAttribute( key,object ); }
1926                else if( "application".equals( inScp ) ) { setContextAttribute( key,object ); }         // 6.7.7.0 (2017/03/31)
1927                else {
1928                        final String errMsg = "このスコープはサポートされていません。[" + inScp + "]";
1929                        throw new IllegalArgumentException( errMsg );
1930                }
1931        }
1932
1933        /**
1934         * スコープに応じて登録されているオブジェクトを指定のキーで削除します。
1935         *
1936         * @og.rev 3.0.0.0 (2002/12/25) scope="application" 指定の追加
1937         * @og.rev 6.7.7.0 (2017/03/31) scope="application" つづり間違い訂正
1938         *
1939         * @param   key キー
1940         */
1941        protected void removeObject( final String key ) {
1942                if( "session".equals( scope ) ) { removeSessionAttribute( key ); }
1943                else if( "request".equals( scope ) ) { removeRequestAttribute( key ); }
1944                else if( "application".equals( scope ) ) { removeContextAttribute( key ); }             // 6.7.7.0 (2017/03/31)
1945                else {
1946                        final String errMsg = "このスコープはサポートされていません。[" + scope + "]";
1947                        throw new IllegalArgumentException( errMsg );
1948                }
1949        }
1950
1951        /**
1952         * リクエストオブジェクトを取得します。
1953         *
1954         * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 エンコードの取得方法変更
1955         * @og.rev 2.2.0.0 (2002/12/17) 文字化け対策 setCharacterEncoding が効いていないので削除
1956         * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。HybsRequestWrapper 廃止。直接 Mapでキャッシュする。
1957         * @og.rev 3.4.0.3 (2003/09/10) 冗長な個所や、無意味な個所を、等価な内容のロジックに置き換える。
1958         * @og.rev 3.5.5.0 (2004/03/12) command=RESET 時にも、キャッシュを取り出すように変更します。
1959         *
1960         * @return   リクエストオブジェクト
1961         */
1962        @SuppressWarnings(value={"unchecked"})
1963        protected ServletRequest getRequest() {
1964                if( request == null ) {
1965                        request = pageContext.getRequest();
1966                        // リクエストキャッシュ機能
1967                        final String cmd =request.getParameter( "command" );
1968                        if( "RENEW".equals( cmd ) || "RESET".equals( cmd ) ) {  // 3.5.5.0
1969                                requestCache = (Map<String,String[]>)getSessionAttribute( HybsSystem.REQ_CACHE_KEY );
1970                        }
1971                }
1972                return request;
1973        }
1974
1975        /**
1976         * BodyContent オブジェクトを取得して、ボディの内容を取得します。
1977         *
1978         * 処理としては、getRequestParameter() によるパラメータ処理も含みます。
1979         * このメソッドは、必ず doAfterBody() から呼び出してください。それ以外(例えば、
1980         * doEndTag()等)では、すでに Body情報が破棄/再利用されている可能性があり、
1981         * 正常に動作しなくなる可能性があります。
1982         *
1983         * @og.rev 3.1.1.0 (2003/03/28) BodyContent オブジェクトを取得して、ボディの内容を取得する処理を追加
1984         * @og.rev 6.3.1.1 (2015/07/10) BodyString,BodyRawStringは、CommonTagSupport で、trim() します。
1985         *
1986         * @return   ボディ文字列
1987         */
1988        protected String getBodyString() {
1989                final BodyContent body = getBodyContent();
1990                return getRequestParameter( body.getString().trim() );          // 6.3.1.1 (2015/07/10)
1991        }
1992
1993        /**
1994         * BodyContent オブジェクトを取得して、ボディの内容を取得します。
1995         *
1996         * {&#064;XXXX}を変換しない生のBODY文を返します
1997         *
1998         * @og.rev 4.3.6.0 (2009/04/01) 新規作成
1999         * @og.rev 6.3.1.1 (2015/07/10) BodyString,BodyRawStringは、CommonTagSupport で、trim() します。
2000         *
2001         * @return   ボディ文字列
2002         */
2003        protected String getBodyRawString() {
2004                final BodyContent body = getBodyContent();
2005                return body.getString().trim();         // 6.3.1.1 (2015/07/10)
2006        }
2007
2008        /**
2009         * BodyContent オブジェクトを取得して、ボディの内容を取得します。
2010         *
2011         * {&#064;XXXX}の変換を行いますが、その変換結果に、"["が含まれる場合は、
2012         * "\\]\\"に変換して、フォーマット処理されないようにサニタイズします。
2013         *
2014         * @og.rev 5.1.7.0 (2010/06/01) 新規作成
2015         * @og.rev 5.7.4.2 (2014/03/20) サニタイズ処理を、標準の処理で行う。
2016         *
2017         * @return   ボディ文字列
2018         */
2019        protected String getSanitizedBodyString() {
2020                isSanitized = true;
2021                final String rtn = getBodyString();
2022                isSanitized = false;                            // 一連の処理の中だけ、有効とします。
2023
2024                return rtn;
2025        }
2026
2027        /**
2028         * JspWriter を使用した画面出力です。
2029         *
2030         * @param msg 画面に出力する文字列
2031         */
2032        protected void jspPrint( final String msg ) {
2033                if( msg == null ) { return ; }
2034                try {
2035                        final JspWriter out = pageContext.getOut();
2036                        out.print( msg );
2037                } catch( final IOException ex ) {
2038                        final String errMsg = "画面出力時の PageContext の取得時にエラーが発生しました。"
2039                                                        + ex.getMessage();                              // 5.1.8.0 (2010/07/01) errMsg 修正
2040                        throw new HybsSystemException( errMsg,ex );             // 3.5.5.4 (2004/04/15) 引数の並び順変更
2041                }
2042        }
2043
2044        /**
2045         * デバッグ用の文字列を JspWriter を使用して画面に出力します。
2046         * このメソッドは、debugFlag=true の場合のみ動作します。
2047         *
2048         * 出力内容は,各オブジェクトの toString() 文字列です。
2049         *
2050         * @og.rev 4.0.0.0 (2005/02/28) debugFlag の条件式を追加。
2051         * @og.rev 4.0.0.0 (2005/02/28) 簡易リファレンスへのリンクを追加。
2052         */
2053        protected void debugPrint() {
2054                if( debugFlag ) {
2055                        try {
2056                                final JspWriter out = pageContext.getOut();
2057                                out.println( getDocumentLink() );               // 4.0.0 (2005/02/28)
2058                                out.println( "<pre>" );
2059                                out.println( toString() );
2060                                out.println( "</pre>" );
2061                        } catch( final IOException ex ) {
2062                                final String errMsg = "デバッグ画面出力時の PageContext の取得時にエラーが発生しました。"
2063                                                        + ex.getMessage();                      // 5.1.8.0 (2010/07/01) errMsg 修正
2064                                throw new HybsSystemException( errMsg,ex );             // 3.5.5.4 (2004/04/15) 引数の並び順変更
2065                        }
2066                }
2067        }
2068
2069        /**
2070         * GAMENID付のリクエストキャッシュ情報を取り出します。
2071         *
2072         * @og.rev 3.5.4.7 (2004/02/06) 新規作成
2073         *
2074         * @param key リクエストキャッシュのキー情報
2075         *
2076         * @return リクエスト情報(存在しない場合は、null)
2077         */
2078        protected String getRequestCacheData( final String key ) {
2079                String rtn = null;
2080
2081                final String memKey = HybsSystem.REQ_CACHE_KEY + getGUIInfoAttri( "KEY" );      // 4.0.0 (2005/01/31)
2082                final Map<?,?> mem = (Map<?,?>)getSessionAttribute( memKey );           // 4.3.3.6 (2008/11/15) Generics警告対応
2083
2084                if( mem != null ) {
2085                        final String[] vals = (String[])mem.get( key );
2086                        if( vals != null && vals.length > 0 ) {
2087                                rtn = vals[0];
2088                        }
2089                }
2090                return rtn ;
2091        }
2092
2093        /**
2094         * GAMENID付のリクエストキャッシュ情報を取り出します。
2095         *
2096         * @og.rev 3.5.4.7 (2004/02/06) 新規作成
2097         *
2098         * @param key  リクエストキャッシュのキー情報
2099         * @param value リクエストキャッシュに登録する値
2100         */
2101        @SuppressWarnings(value={"unchecked"})
2102        protected void setRequestCacheData( final String key,final String value ) {
2103                final String[] vals = new String[] { value } ;
2104
2105                final String memKey = HybsSystem.REQ_CACHE_KEY + getGUIInfoAttri( "KEY" );      // 4.0.0 (2005/01/31)
2106                final Map<String,String[]> mem = (Map<String,String[]>)getSessionAttribute( memKey );
2107                if( mem != null ) {
2108                        mem.put( key,vals );
2109                }
2110        }
2111
2112        /**
2113         * CSV形式引数(CSV引数)を配列に分解して返します。
2114         *
2115         * CSV形式引数(CSV引数)で複数指定されたリクエストパラメータを
2116         * 文字列配列に分解して、返します。
2117         * 引数は、{&#064;XXXX} 変数も使用できます。
2118         * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
2119         * こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。
2120         *
2121         * @og.rev 3.5.6.2 (2004/07/05) 新規作成
2122         *
2123         * @param       csvKey 引数(CSV形式)
2124         *
2125         * @return      配列に分解されたリクエストパラメータ値
2126         */
2127        protected String[] getCSVParameter( final String csvKey ) {
2128                final String[] keys = StringUtil.csv2Array( csvKey );           // ダブルクオート内は分解しない。
2129                String[] vals = new String[keys.length];
2130                for( int i=0; i<keys.length; i++ ) {
2131                        vals[i] = getRequestParameter( keys[i] ) ;
2132                }
2133                return vals ;
2134        }
2135
2136        /**
2137         * CSV形式のkeys,vals引数(CSV引数)を配列に分解して返します。
2138         *
2139         * CSV形式引数(CSV引数)で複数指定されたリクエストパラメータを
2140         * 文字列配列に分解して、返します。
2141         * 引数は、{&#064;XXXX} 変数も使用できます。
2142         * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
2143         * こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。
2144         *
2145         * ※ これは、keys,vals を同時に処理します。keys を分解後、カンマがあれば、
2146         *    vals も 再度、CSV分解します。
2147         *
2148         * @og.rev 6.2.5.1 (2015/06/12) CSV形式のkeys,vals引数(CSV引数)対応。新規作成。
2149         *
2150         * @param       csvKey 引数(CSV形式)
2151         * @param       csvVal 引数(CSV形式)
2152         *
2153         * @return      Mapにセットされたリクエストパラメータ値
2154         * @see         #getCSVParameter( String )
2155         */
2156        protected Map<String,String> getCSVParameter( final String csvKey , final String csvVal ) {
2157                final String[] keys = StringUtil.csv2Array( csvKey );           // ダブルクオート内は分解しない。
2158                final String[] vals = StringUtil.csv2Array( csvVal );           // ダブルクオート内は分解しない。
2159
2160                if( keys.length != vals.length ) {
2161                        final String errMsg = "キーとバリューの個数が異なります。" + CR
2162                                                + " keys.length=[" + keys.length + "]  vals.length=[" + vals.length + "]" + CR
2163                                                + " keys=" + csvKey  + CR
2164                                                + " vals=" + csvVal ;
2165                        throw new HybsSystemException( errMsg );
2166                }
2167
2168                final Map<String,String> kvMap = new LinkedHashMap<>();                 // keys,valsの登録順は残しておきます。
2169
2170                for( int i=0; i<keys.length; i++ ) {
2171                        final String key1 = getRequestParameter( keys[i] ) ;            // ※ rtnNotNull
2172                        String val1 = getRequestParameter( vals[i] ) ;
2173                        if( key1.isEmpty() ) { continue; }                                                      // キーに関しては、何か値が必要。
2174
2175                        if( key1.contains( "," ) ) {                                                            // キーにカンマが含まれるとき
2176                                final String[] keys2 = StringUtil.csv2Array( key1 );
2177                                final String[] vals2 = StringUtil.csv2Array( val1 );
2178
2179                                // keys 分解の個別の個数チェック
2180                                if( keys2.length != vals2.length ) {
2181                                        final String errMsg = "部分キーと部分バリューの個数が異なります。" + CR
2182                                                                + " keys2.length=[" + keys2.length + "]  vals2.length=[" + vals2.length + "]" + CR
2183                                                                + " orgKey=" + csvKey  + CR
2184                                                                + " orgVal=" + csvVal  + CR
2185                                                                + " keys2=" + key1 + CR
2186                                                                + " vals2=" + val1 ;
2187                                        throw new HybsSystemException( errMsg );
2188                                }
2189
2190                                for( int j=0; j<keys2.length; j++ ) {
2191                                        if( keys2[j] != null && !keys2[j].isEmpty() && vals2[j] != null ) {
2192                                                kvMap.put( keys2[j] , vals2[j] );
2193                                        }
2194                                }
2195                        }
2196                        else {
2197                                // val にカンマが含まれる場合は、前後に、ダブルクオートを追加する。
2198                                if( val1.contains( "," ) ) { val1 = '"' + val1 + '"' ; }
2199                                kvMap.put( key1 , val1 );
2200                        }
2201                }
2202
2203                return kvMap ;
2204        }
2205
2206        /**
2207         * システム変数 {&#064;SYS.XXXX} に対する値の取得を行います。
2208         *
2209         * 本来は、システムパラメータ の値を取得できますが、
2210         * システム的な共有値も取得できるように機能追加しています。
2211         * また、ユーザー個別にシステムパラメータを変更できます。この取得は、
2212         * システムパラメータとして取得します。(値はユーザー個別値を返します。)
2213         * ここで、引数に、&#064;変数が使用できます。具体的には、{&#064;SYS.&#064;XXXX}
2214         * で、&#064;XXXX をリクエスト変数から取得した値を利用します。
2215         * この中で、&#064;GUIID だけが、さらに特殊で、実行中の画面IDを割り当てます。
2216         * この &#064;GUIID は、ここまでの文字列を画面IDに置き換えるとともに、それ以降の
2217         * 文字列を、画面IDに連結させます。
2218         * {&#064;SYS.&#064;GUIID_XXXX} ⇒ 画面ID_XXXX 文字列で、システムパラメータ の値を取得します。
2219         *
2220         *      SERVER_NAME     このTomcatが実行しているサーバー名             localhost 等
2221         *      SERVER_URL      Portも含むURLアドレス                          http://localhost:8823/
2222         *      CONTEXT_URL     実行しているコンテキストのURLアドレス          http://localhost:8823/dbdef2/
2223         *      REAL_PATH       / ルートに対応する物理ディレクトリ             d:/webapps/dbdef2/ 等
2224         *      CONTEXT_NAME    コンテキスト名(webapps 直下の仮想フォルダ名)   dbdef 等
2225         *      COOKIE          クッキー取得
2226         *      DATE            YMDH とほぼ同じですが、'yyyy/MM/dd HH:mm:ss' の形式で取得できます。
2227         *      HOSTNAME IPドレス スペース区切りで指定したIPアドレスからホスト名を逆引きします(5.6.6.2 (2013/07/19))
2228         *      任意            ユーザーパラメータ(GE16) の値/システムパラメータ(GE12)の値を取得
2229         *        &#064;GUIID_XXXX  既存の画面IDに、_XXXX を追加した文字列
2230         *        &#064;XXXX        XXXX でリクエスト変数から取得した文字列
2231         *        XXXX              XXXX の文字列
2232         *      PRINTER         サーバーのプリンター一覧(6.2.6.0 (2015/06/19))
2233         *
2234         * @og.rev 3.5.6.6 (2004/08/23) 新規作成
2235         * @og.rev 3.7.0.3 (2005/03/01) クッキー取得機能を追加
2236         * @og.rev 4.0.0.0 (2005/11/30) ユーザーパラメータは、システムパラメータとして取得します。
2237         * @og.rev 5.1.6.0 (2010/05/01) システムパラメータに、&#064;GUIID という特殊パラメータが使用できるように対応します。
2238         * @og.rev 5.6.6.2 (2013/07/19) SYS.HOSTNAMEに対応します。
2239         * @og.rev 6.2.6.0 (2015/06/19) PRINTERに対応します。
2240         * @og.rev 6.4.2.0 (2016/01/29) DateSet.getDate( String ) を利用するように修正します。
2241         * @og.rev 6.9.5.0 (2018/04/23) うまく動いていないようなので、廃止
2242         *
2243         * @param       key     {&#064;SYS.XXXX}のXXXX部分の文字列(キー)
2244         *
2245         * @return   キーに対する値。なければ、null
2246         */
2247        protected String sys( final String key ) {
2248                final String rtn;
2249
2250                if( key.startsWith( "COOKIE." ) ) {             // 3.7.0.3 (2005/03/01)
2251                        rtn = getCookie( key.substring( "COOKIE.".length() ) );
2252                }
2253                else if( key.startsWith( "DATE" ) ) {
2254                        final int idx = key.indexOf( ' ' );
2255                        if( idx >= 0 ) {
2256                                rtn = DateSet.getDate( key.substring( idx+1 ) );                                // 6.4.2.0 (2016/01/29)
2257                        }
2258                        else {
2259                                rtn = HybsSystem.getDate();
2260                        }
2261                }
2262                else if( key.startsWith( "HOSTNAME" ) ) { // 5.6.6.2 (2013/07/19)
2263                        final int idx = key.indexOf( ' ' );
2264                        if( idx >= 0 ) {
2265                                final String key2 = key.substring( idx+1 ) ;
2266                                if( StringUtil.startsChar( key2 , '@' ) ) {                                     // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
2267                                        rtn = getHostName( getRequestValue( key2.substring( 1 ) ) );
2268                                }
2269                                else{
2270                                        rtn = getHostName( key2 );
2271                                }
2272                        }
2273                        else{
2274                                rtn = getUser().getParameter( key );
2275                        }
2276                }
2277//              // 6.9.5.0 (2018/04/23) うまく動いていないようなので、廃止
2278//              // 5.1.6.0 (2010/05/01) {@SYS.@GUIID_XXXX} パラメータ対応
2279//              else if( key.startsWith( "@GUIID" ) ) {
2280//                      final String key2 = getGUIInfoAttri( "ID" ) +  key.substring( "@GUIID".length() );
2281//                      rtn = getUser().getParameter( key2 );
2282//              }
2283                // 6.2.6.0 (2015/06/19) PRINTERに対応します。
2284                else if( key.startsWith( "PRINTER" ) ) {
2285                        rtn = HybsSystem.getPrinter();
2286                }
2287                // 5.1.6.0 (2010/05/01) {@SYS.@XXXX} パラメータ対応
2288                else if( StringUtil.startsChar( key , '@' ) ) {                                         // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
2289                        final String key2 = getRequestValue( key.substring( 1 ) );
2290                        rtn = getUser().getParameter( key2 );
2291                }
2292                else {
2293                        rtn = getUser().getParameter( key );
2294                }
2295
2296                return rtn ;
2297        }
2298
2299        /**
2300         * システムパラメータの値を、boolean 型に変換して返します。
2301         *
2302         * 本来は、システムパラメータ の値を取得できますが、
2303         * システム的な共有値も取得できるように機能追加しています。
2304         * また、ユーザー個別にシステムパラメータを変更できます。この取得は、
2305         * システムパラメータとして取得します。(値はユーザー個別値を返します。)
2306         *
2307         * @og.rev 4.0.0.0 (2005/11/30) 新規追加
2308         *
2309         * @param       key システム設定キー
2310         *
2311         * @return      システム設定値(boolean型)
2312         */
2313        protected boolean sysBool( final String key ) {
2314                return Boolean.parseBoolean( sys( key ) );              // 6.1.0.0 (2014/12/26) refactoring
2315        }
2316
2317        /**
2318         * システムパラメータの値を、int 型に変換して返します。
2319         *
2320         * 本来は、システムパラメータ の値を取得できますが、
2321         * システム的な共有値も取得できるように機能追加しています。
2322         * また、ユーザー個別にシステムパラメータを変更できます。この取得は、
2323         * システムパラメータとして取得します。(値はユーザー個別値を返します。)
2324         *
2325         * ※ システムパラメータの値が数字でない場合、HybsSystemException が throw されます。
2326         * ※ キーの値が nullの場合、HybsSystemException が throw されます。
2327         *
2328         * @og.rev 4.0.0.0 (2005/11/30) 新規追加
2329         *
2330         * @param       key システム設定キー
2331         *
2332         * @return      システム設定値(int型)
2333         */
2334        protected int sysInt( final String key ) {
2335                String tmp = null;
2336                int rtn ;
2337                try {
2338                        tmp = sys( key );
2339                        rtn = Integer.parseInt( tmp );
2340                }
2341                catch( final NumberFormatException ex ) {
2342                        final String errMsg = "システムパラメータの値が数字ではありません。" + CR
2343                                        + "  Resource key=[" + key + "] val=[" + tmp + "]"  ;
2344                        throw new HybsSystemException( errMsg,ex );             // 3.5.5.4 (2004/04/15) 引数の並び順変更
2345                }
2346                catch( final IllegalArgumentException ex ) {
2347                        final String errMsg = "キーの値が null です。key=[" + key + "] val=[" + tmp + "]";
2348                        throw new HybsSystemException( errMsg,ex );             // 3.5.5.4 (2004/04/15) 引数の並び順変更
2349                }
2350
2351                return rtn;
2352        }
2353
2354        /**
2355         * Transactionオブジェクトを取得します。
2356         * これは、自身のタグの親タグ(囲われているタグ)から、TransactionTag を
2357         * 見つけて、すでに、Transactionオブジェクトが作成済みなら、そのオブジェクトを
2358         * そうでないなら、新規に作成して返します。
2359         *
2360         * Transactionオブジェクトは、AutoCloseableインタフェースを実装しているため、
2361         * try-with-resources構築を使用することが可能です。
2362         *
2363         * @og.rev 6.3.6.1 (2015/08/28) Transactionオブジェクトの取得方法変更。
2364         *
2365         * @return   Transactionオブジェクト
2366         */
2367        protected Transaction getTransaction() {
2368                final TransactionTag tranTag = (TransactionTag)findAncestorWithClass( this,TransactionTag.class );
2369
2370                return tranTag == null  ? new TransactionReal( getApplicationInfo() )
2371                                                                : tranTag.getTranObj();
2372        }
2373
2374        /**
2375         * session に、処理開始時刻を設定します。
2376         * これは、DBTableModel を登録する場合に、一連の処理が連続であるかどうかを
2377         * 判断する時に使用します。
2378         * 処理が一連でない(start 時のタイムスタンプが書き換えられている)場合は、
2379         * DBTableModel の登録処理を行いません。
2380         * なお、判断処理を行うのは、scope が session の場合のみです。
2381         * 判定は、commitTableObject( String ,DBTableModel ) で行います。
2382         *
2383         * @og.rev 3.6.0.8 (2004/11/19) 新規追加
2384         * @og.rev 4.3.0.0 (2008/07/04) fileUD 対応。
2385         * @og.rev 5.1.6.0 (2010/05/01) DBLastSqlの処理は、DBTableModelが新規作成された処理でのみ行う。
2386         *
2387         * @param   tableId キー
2388         * @see     #commitTableObject( String ,DBTableModel )
2389         */
2390        protected void startQueryTransaction( final String tableId ) {
2391                if( "session".equals( scope ) ) {
2392                        startTransaction = Long.valueOf( System.currentTimeMillis() );
2393                        setSessionAttribute( tableId+"_TRANSACTION", startTransaction );
2394                }
2395
2396                // 5.1.6.0 (2010/05/01) DBLastSqlの処理の見直し
2397                if( useTrans ) {
2398                        // 4.3.0.0 (2008/07/04) fileUD 対応
2399                        removeSessionAttribute( HybsSystem.DB_LAST_SQL_KEY );   // 無条件削除
2400                }
2401        }
2402
2403        /**
2404         * スコープに応じて登録されている DBTableModel を指定のキーでセットします。
2405         * これは、startQueryTransaction( String ) でセッションに登録した処理開始時刻と、
2406         * このオブジェクト自身が持っている(セッションに登録した開始時刻そのもの)を
2407         * 比較し、異なる場合は、DBTableModel の登録を行いません。
2408         * これにより、検索処理の開始順にしか登録しないようなロジックを入れています。
2409         * 検索処理時間が掛かるSQLを実行した場合、先に検索した結果があとから登録される
2410         * ケースがあるためです。
2411         * また、判断処理を行うのは、scope が session の場合のみです。
2412         *
2413         * @og.rev 3.6.0.8 (2004/11/19) 新規追加
2414         * @og.rev 3.8.1.1 (2005/11/21) ExcelOut の整合性を取る為の仕掛け
2415         * @og.rev 4.3.0.0 (2008/07/04) fileUD 対応。
2416         * @og.rev 5.1.6.0 (2010/05/01) DBLastSqlの処理は、DBTableModelが新規作成された処理でのみ行う。
2417         *
2418         * @param   tableId キー
2419         * @param   table   登録するDBTableModelオブジェクト
2420         *
2421         * @return  正常に登録(true) / 一連でないため登録していない(false)
2422         * @see     #startQueryTransaction( String )
2423         */
2424        protected boolean commitTableObject( final String tableId ,final DBTableModel table ) {
2425                // 登録しないケースをピックアップします。
2426                if( "session".equals( scope ) ) {
2427                        final String key = tableId+"_TRANSACTION";
2428                        final Long endTime = (Long)getSessionAttribute( key );
2429                        removeSessionAttribute( key );
2430                        if( endTime == null ||
2431                                startTransaction == null ||
2432                                endTime.compareTo( startTransaction ) != 0 ) {
2433                                        final String msg = "CommonTagSupport Query処理が割り込まれました。DBTableModel は登録しません。"
2434                                                                + "[" + getUser().getUserID() + "],"
2435                                                                + "[" + getGUIInfoAttri( "KEY" ) + "]"  // 4.0.0 (2005/01/31)
2436                                                                + "[" + startTransaction + "]"                          // 4.0.0 (2005/01/31)
2437                                                                + "[" + endTime + "]";                                          // 4.0.0 (2005/01/31)
2438                                        System.out.println( msg );
2439                                        return false;
2440                        }
2441                        // 3.8.1.1 (2005/11/21) ExcelOut の整合性を取る為の仕掛け
2442                        if( table != null && HybsSystem.TBL_MDL_KEY.equals( tableId ) ) {
2443                                final String consisKey = table.getConsistencyKey();
2444                                setSessionAttribute( HybsSystem.TBL_MDL_CONKEY,consisKey );
2445                        }
2446                }
2447
2448                // 4.3.0.0 (2008/07/04) fileUD 対応
2449                // 5.1.6.0 (2010/05/01) DBLastSqlの処理の見直し
2450                if( useTrans && table != null ) {
2451                        final String guikey = getGUIInfoAttri( "KEY" );
2452                        final DBLastSql lastSql = new DBLastSql( scope,guikey,table.isOverflow(),tableId );
2453                        setSessionAttribute( HybsSystem.DB_LAST_SQL_KEY,lastSql );
2454                }
2455
2456                setObject( tableId,table );
2457                return true;
2458        }
2459
2460        /**
2461         * 表示データの HybsSystem.ROW_SEL_KEY を元に、選ばれた 行番号の
2462         * 配列を返します。
2463         * 配列情報は、行番号でソートされて返されます。
2464         * なにも選ばれていない場合は、サイズ0の配列を返します。
2465         *
2466         * @og.rev 4.0.0.0 (2005/01/31) 新規追加
2467         * @og.rev 6.3.9.1 (2015/11/27) 内部処理が、長さが0の配列を返すように変更されたので、その対応。
2468         *
2469         * @return      (選ばれていない場合は、サイズ0の配列を返す)
2470         * @og.rtnNotNull
2471         */
2472        protected int[] getParameterRows() {
2473                if( rowNo != null ) { return rowNo; }
2474
2475                // 6.3.9.1 (2015/11/27) org.opengion.hayabusa.servlet.MultipartRequest#getIntParameters(String) が、
2476                // 存在しない場合、長さが0の配列を返すことにしたので、同じロジックに変更しておきます。
2477                rowNo = (int[])getRequestAttribute( HybsSystem.ROW_SEL_KEY );
2478                if( rowNo != null && rowNo.length > 0 ) { return rowNo; }
2479
2480                final String[] selected = getRequestValues( HybsSystem.ROW_SEL_KEY ) ;
2481
2482                // 6.3.9.1 (2015/11/27) ラムダ式で書き直します。
2483                return selected == null || selected.length == 0
2484                                        ? new int[0]
2485                                        : Arrays.stream( selected )
2486                                                        .filter( str -> str != null && !str.isEmpty() )
2487                                                        .mapToInt( Integer::parseInt )
2488                                                        .sorted()
2489                                                        .toArray();
2490        }
2491
2492        /**
2493         * 表示データの HybsSystem.ROW_SEL_KEY に対して、選ばれた 行番号の
2494         * 配列を設定します。
2495         * ここで設定した選択配列は、getParameterRows() メソッドで取得する場合、優先されます。
2496         *
2497         * @og.rev 4.0.0.0 (2005/01/31) 新規追加
2498         *
2499         * @param       rowNo   行番号配列(可変長引数)
2500         */
2501        protected void setParameterRows( final int... rowNo ) {
2502                setRequestAttribute(  HybsSystem.ROW_SEL_KEY , rowNo );
2503        }
2504
2505        /**
2506         * 指定のクッキーをセットします。
2507         * これは、従来,各Taglibパッケージで使用していました、ErrorMessage オブジェクトを、
2508         * HTMLテーブル形式で表示する為に、DBUtilクラスや、ViewFormクラスなど、複数のクラスを
2509         * 複雑に組み合わせて使用していましたが、一つの static メソッドにまとめたものです。
2510         *
2511         * @og.rev 3.7.0.3 (2005/03/01) 新規登録
2512         *
2513         * @param   key         クッキーのキー
2514         * @param   value       クッキーの設定値
2515         * @param       maxage  最長存続期間を秒単位で設定 (負の値は Cookie を保存しない、 0 なら Cookie を削除する)
2516         */
2517        protected void setCookie( final String key,final String value,final int maxage ) {
2518                final HttpServletResponse res = (HttpServletResponse)pageContext.getResponse();
2519                final Cookie ck = new Cookie( key, value );
2520                ck.setMaxAge( maxage );         // 有効秒
2521                res.addCookie( ck );
2522        }
2523
2524        /**
2525         * 指定のクッキーを取得します。
2526         * 見つからない場合は、null を返します。
2527         *
2528         * @og.rev 3.7.0.3 (2005/03/01) 新規登録
2529         *
2530         * @param       key     クッキーのキー
2531         *
2532         * @return      クッキーの設定値
2533         */
2534        protected String getCookie( final String key ) {
2535                final HttpServletRequest req = (HttpServletRequest)pageContext.getRequest();
2536                final Cookie[] cks = req.getCookies();
2537
2538                String val = null;
2539                for( int i=0; i<cks.length; i++ ) {
2540                        final Cookie ck = cks[i];
2541                        if( ck.getName().equals( key ) ) {
2542                                val = ck.getValue();
2543                                break;
2544                        }
2545                }
2546                return val ;
2547        }
2548
2549        /**
2550         * リクエスト情報の シングルクォート(') 存在チェックを実施するかどうか[true/false]を設定します
2551         *              (初期値:USE_SQL_INJECTION_CHECK[={@og.value SystemData#USE_SQL_INJECTION_CHECK}])。
2552         *
2553         * SQLインジェクション対策の一つとして、暫定的ではありますが、SQLのパラメータに
2554         * 渡す文字列にシングルクォート(') を許さない設定にすれば、ある程度は防止できます。
2555         * 数字タイプの引数には、 or 5=5 などのシングルクォートを使用しないコードを埋めても、
2556         * 数字チェックで検出可能です。文字タイプの場合は、必ず (')をはずして、
2557         * ' or 'A' like 'A のような形式になる為、(')チェックだけでも有効です。
2558         * (') が含まれていたエラーにする(true)/かノーチェックか(false)を指定します。
2559         * (初期値:システム定数のUSE_SQL_INJECTION_CHECK[={@og.value SystemData#USE_SQL_INJECTION_CHECK}])。
2560         *
2561         * @og.rev 4.0.0.0 (2005/08/31) 新規追加
2562         *
2563         * @param       flag    シングルクォートチェック  [true:する/:falseしない]
2564         * @see         org.opengion.hayabusa.common.SystemData#USE_SQL_INJECTION_CHECK
2565         */
2566        protected void useQuotCheck( final boolean flag ) {
2567                quotCheck = flag;
2568        }
2569
2570        /**
2571         * リクエスト情報の HTMLTag開始/終了文字(&gt;&lt;) 存在チェックを実施するかどうか[true/false]を設定します
2572         *              (初期値:USE_XSS_CHECK[={@og.value SystemData#USE_XSS_CHECK}])。
2573         *
2574         * クロスサイトスクリプティング(XSS)対策の一環としてless/greater than signについてのチェックを行います。
2575         * (&gt;&lt;) が含まれていたエラーにする(true)/かノーチェックか(false)を指定します。
2576         * 現在の実装としてはリクエストパラメータのみチェックして、attributesに対しては行いません。
2577         * (初期値:システム定数のUSE_XSS_CHECK[={@og.value SystemData#USE_XSS_CHECK}])。
2578         *
2579         * @og.rev 5.0.0.2 (2009/09/15) 新規追加
2580         *
2581         * @param       flag    XSSチェック [true:する/false:しない]
2582         * @see         org.opengion.hayabusa.common.SystemData#USE_XSS_CHECK
2583         */
2584        protected void useXssCheck( final boolean flag ) {
2585                xssCheck = flag;
2586        }
2587
2588        /**
2589         * 日付関係の情報を簡易的に取り出す処理を行います。
2590         *
2591         * これは、{&#064;DATE.XXXX AA BB CC} 引数処理をおこなうための、サポートメソッドです。
2592         * XXXX は結果のフォーマット、AA が基準時刻で省略した場合は、現在時刻が利用されます。
2593         * BB 引数は、日付についての加減算処理を行うためのコマンドです。
2594         * CC 引数は、BB引数のコマンドに付属するパラメータです。加減算処理の数値を指定できます。
2595         * AA,BB,CC 引数については、先頭に、@ を付ける事で、リクエスト変数が使用できます。
2596         *
2597         * 引数は、"XXXX AA BB CC" という状態で受け取ります。(DATE. ははずした形)
2598         * 第一引数(key) "XXXX" は、日付処理を行うフォーマットの予約語になっています。
2599         * ・Y4   :4文字の年データ(yyyy)を扱います。
2600         * ・YMD  :8文字の4-2-2年月日データ(yyyyMMdd)を扱います。
2601         * ・Y2MD  :6文字の2-2-2年月日データ(yyMMdd)を扱います。
2602         * ・YM   :6文字の4-2年月データ(yyyyMM)を扱います。
2603         * ・HMS  :6文字の2-2-2時分秒データ(HHmmss)を扱います。
2604         * ・HM   :4文字の2-2時分データ(HHmm)を扱います。6.7.4.1 (2017/02/17)
2605         * ・YMDHMS :14文字の4-2-2-2-2-2年月日時分秒データ(yyyyMMddHHmmss)を扱います。
2606         * ・EEE  :曜日をデフォルトロケールで表示します。
2607         *
2608         * F付きは、フォーマットされた日付を返します。
2609         * ・YMDF  :10文字の日付表現(yyyy/MM/dd)を扱います。
2610         * ・Y2MDF :8文字の日付表現(yy/MM/dd)を扱います。
2611         * ・YMF  :7文字の日付表現(yyyy/MM)を扱います。
2612         * ・HMSF  :8文字の時刻表現(HH:mm:ss)を扱います。
2613         * ・HMF   :5文字の時刻表現(HH:mm)を扱います。6.7.4.1 (2017/02/17)
2614         * ・YMDHMSF:19文字の日付表現(yyyy/MM/dd HH:mm:ss)を扱います。
2615         * ・MDF  :5文字の月日表現(MM/dd)を扱います。
2616         * ・MDEF  :5文字+曜日の月日表現(MM/dd(EEE))を扱います。
2617         * ・MDHMF :11文字の月日時分表現(MM/dd HH:mm)を扱います。 (7.0.0.1 (2018/10/09) 追加)
2618         * ・MD2F  :漢字の月日表現(MM月dd日)を扱います。(5.5.5.2 追加)
2619         * ・HM2F  :漢字の時分表現(HH時mm分)を扱います。(7.0.0.1 (2018/10/09) 追加)
2620         * ・MDHM2F :漢字の月日時分表現(MM月dd日 HH時mm分)を扱います。(7.0.0.1 (2018/10/09) 追加)
2621         * ・GYMDF :和暦の年月日表現(GGGGyyyy年MM月dd日)を扱います。
2622         * ・G2YMDF :和暦の日付表現(Gyyyy/MM/dd)を扱います。
2623         * ・GYMF  :和暦の年月表現(GGGGyyyy年MM月)を扱います。
2624         * ・GYF  :和暦の年表現(GGGGyyyy)を扱います。
2625         *
2626         * ・DIFF  :日付の差分を求めます。(7.0.1.1 (2018/10/22) 追加)
2627         *               AA - BB を求め、CCの数値で単位を指定します。
2628         *
2629         * なお、上記以外のフォーマットを指定する場合は、XXXX部分に直接記述できます。(5.5.5.2 追加)
2630         * ただし、スペースで分解するため、フォーマットにスペースを含む場合は、ダブルコーテーション等で
2631         * くくる等の処理が必要です。基本的には、自由フォーマットは、エラーチェックがない為、使わないでください。
2632         *
2633         * 第二引数 AA は、基準となる日付を、yyyyMMdd形式で指定します。nullの場合は、現在日時を使用します。
2634         * 指定できる日付は、yyyyMMdd形式を推奨しますが、'/' , '-' , ' ' , ':' を削除して使います。
2635         * 6桁の場合は、yyyyMM + 01 とし、8ケタの場合は、yyyyMMdd とし、14ケタ以上の場合は、前半14文字を
2636         * yyyyMMddHHmmss として処理します。それ以外の桁数の場合は、エラーになります。
2637         * たとえば、"2012/09/05 16:52:36" のようなフォーマットデータの場合、'/' , '-' , ' ' , ':' を削除して
2638         * "20120905165236" に変換後、日付オブジェクトに変換されます。
2639         *
2640         * AA には、数字で始まる(20050701など)実日付と&#064;で始まるパラメータが使用できます。
2641         * &#064;AA と記述することで、{&#064;AA}で指定する場合と同様のリクエストパラメータが使用できます。
2642         * このパラメータの値の解析結果が、null の場合は、現在時刻が使用されます。
2643         * 数字以外の場合は、省略されたと判断して、コマンド(BB引数)として使用されます。
2644         *
2645         * BB 引数は、日付についての加減算処理を行います。
2646         * 省略すると、なにも加減算処理を行いません。
2647         * この引数もパラメータ(&#064;BB)指定で、リクエストパラメータが使用できます。
2648         * 加減算処理のパラメータが使用できるのは、"H" , "D" , "M" の1文字パラメータの場合のみです。
2649         * それ以外のコマンドで、加減算処理する場合は、独立した CC 引数 を使用してください。
2650         * ・SY :当年の最初の日付にセットします。(当年1月1日)。CC引数は、-N:N年前、0:当年(=SY)、N:N年後 6.9.2.1 (2018/03/12)
2651         * ・SD :当月の最初の日付にセットします。(当月1日)。CC引数は、-N:N月前、0:当月(=SD)、N:N月後、-1:BSD と同じ、1:ASD と同じ
2652         * ・SW :日付処理の週初め(月曜日)にセットします。日付は当日より前に移動します。CC引数は、-N:N週前、0:今週(=SW)、N:N週後
2653         * ・SH :指定の最初の時にセットします。(分秒を0000にする)。CC引数は、時の倍数(4と指定すれば、4時間単位に前に戻る) 6.7.4.1 (2017/02/17)
2654         * ・SM :指定の最初の分にセットします。(秒を00にする)。CC引数は、分の倍数(15と指定すれば、15分単位に前に戻る) 6.7.4.1 (2017/02/17)
2655         * ・SS :指定の最初の秒にセットします。CC引数は、秒の倍数(15と指定すれば、15秒単位に前に戻る) 6.7.4.1 (2017/02/17)
2656         * ・EY :当年の最後の日付にセットします。(当年年末)。CC引数は、-N:N年前、0:当年(=EY)、N:N年後 6.9.2.1 (2018/03/12)
2657         * ・ED :当月の最後の日付にセットします。(当月月末)。CC引数は、-N:N月前、0:当月(=ED)、N:N月後、-1:BED と同じ、1:AED と同じ
2658         * ・EW :日付処理の週末(日曜日)にセットします。日付は当日より後ろに移動します。CC引数は、-N:N週前、0:今週(=EW)、N:N週後
2659         * ・EH :指定の次の時にセットします。(分秒を0000にした次の時)。CC引数は、時の倍数(4と指定すれば、4時間単位に前に進む) 6.7.4.1 (2017/02/17)
2660         * ・EM :指定の次の分にセットします。(秒を00にした次の分)。CC引数は、分の倍数(15と指定すれば、15分単位に前に進む) 6.7.4.1 (2017/02/17)
2661         * ・ES :指定の次の秒にセットします。CC引数は、秒の倍数(15と指定すれば、15秒単位に前に進む) 6.7.4.1 (2017/02/17)
2662         * ・M1 ~ MXXX :月を指定の分だけ進めます。M1なら翌月、M6 なら半年後
2663         * ・D1 ~ DXXX :日を指定の分だけ進めます。D1なら翌日、D200 なら200日後
2664         * ・H1 ~ HXXX :時を指定の分だけ進めます。H1なら1時間後、H24 なら24時間後(5.5.5.6 (2012/08/31) 追加)
2665         * ・MI  :分を指定の分だけ進めます。第四引数(intC) で、時間を指定します。(6.8.4.1 (2017/12/18) 追加)
2666         * ・YMD :CC 引数のYMD表記の日付を加減算します。6.8.4.1 (2017/12/18) 追加
2667         * ・HM  :CC 引数のHM表記の時刻を加減算します。6.8.4.1 (2017/12/18) 追加
2668         * ・NO  :AA 引数がnullの場合、現在時刻ではなく空文字列にします。  7.0.1.3 (2018/11/12) 追加
2669         * ・(有閑)BSD :先月の最初の日付にセットします。(先月1日)(5.5.5.2 追加)。SD -1 と同等
2670         * ・(有閑)BED :先月の最後の日付にセットします。(先月月末)(5.5.5.2 追加)。ED -1 と同等
2671         * ・(有閑)ASD :翌月の最初の日付にセットします。(翌月1日)(5.5.5.2 追加)。SD 1  と同等
2672         * ・(有閑)AED :翌月の最後の日付にセットします。(翌月月末)(5.5.5.2 追加)。ED 1  と同等
2673         *
2674         * 7.0.1.1 (2018/10/22)
2675         *   DATE.DIFF の場合、BB 引数は、日付データになります。AA-BB の関係です。
2676         *
2677         * CC 引数は、特別な処理で、BB 引数に対して、加算、減算のための数字を指定できます。(5.7.4.1 (2014/03/14) 追加)
2678         * 従来は、BB 引数が、"H" , "D" , "M" の 1文字パラメータの場合のみ利用可能でした。
2679         * これは、"H15" と指定するのと、"H" "15" と指定するのと同じ意味になります。
2680         * 異なるのは、CC 引数も、(&#064;CC)指定で、リクエストパラメータが使用できます。
2681         * 従来は、文字列として結合された状態でしか、BB 引数を渡せませんでしたが、この、CC 引数の
2682         * 追加で、日付の加減算を、パラメータ指定できるようになります。
2683         * 数字以外の文字が指定されたり、パラメータの解析結果が NULL の場合には、BB引数自体も無視されます。
2684         * 注意点は、各 BB 引数に応じて、数字の意味が異なるという事です。
2685         *
2686         * HXXX,DXXX,MXXX 形式に、CC 引数を付けた場合は、XXX にさらに加算されます。
2687         * prmB に、数字を使用した場合、(コマンドでない場合)にも、CC 引数は、加算されます。
2688         *
2689         * 7.0.1.1 (2018/10/22)
2690         *   DATE.DIFF の場合、CC 引数は、差分の単位を指定するキーワードになります。AA-BB の結果を、
2691         *   1:年 2:月 3:日 4:時 5:分 6:秒 に換算 して返します。端数は切り捨てで整数で返します。
2692         *
2693         * @og.rev 3.8.0.2 (2005/07/11) 新規追加
2694         * @og.rev 5.4.0.1 (2011/11/01) 日付処理の機能追加(BB 引数に、リクエストパラメータ対応)
2695         * @og.rev 5.5.0.2 (2012/03/09) 和暦対応
2696         * @og.rev 5.5.5.2 (2012/08/18) XXXXフォーマット追加、自由フォーマット対応、BB引数追加、/,-削除機能追加、SM,EM廃止
2697         * @og.rev 5.5.5.6 (2012/08/31) H1 ~ HXXX 追加。時間の加算を指定できる。
2698         * @og.rev 5.5.7.2 (2012/10/09) HybsDateUtil を利用するように修正します。
2699         * @og.rev 5.5.8.2 (2012/11/09) prmA の判定に、null と ゼロ文字列を判定する。
2700         * @og.rev 5.6.0.1 (2013/01/11) 5.5.7.2でyyyyMMddしか取っていないため、HHmmssを追加します
2701         * @og.rev 5.7.4.1 (2014/03/14) AA 引数の@解析後のコマンド判定方法を、8ケタ以下から先頭が数字以外に変更します。
2702         * @og.rev 5.7.4.1 (2014/03/14) CC 引数を、"H" , "D" , "M" 以外でも使用できるように拡張します。
2703         *
2704         * @param   value       パラメータ
2705         *
2706         * @return   メッセージ情報
2707         * @see         org.opengion.fukurou.util.HybsDateUtil#getDateFormat( String,String,String,int )
2708         */
2709        protected String getDateFormat( final String value ) {
2710                // {@DATE.XXXX AA BB CC} を分割
2711                final String[] vals = StringUtil.csv2Array( value,' ' );                // ダブルクオート内は保持される。
2712
2713                final String key = vals[0] ;
2714
2715                // 5.7.4.1 (2014/03/14) 初期化時に、vals を設定しておきます。
2716                String prmA = vals.length >= 2 ? vals[1] : null ;
2717                String prmB = vals.length >= 3 ? vals[2] : null ;
2718                String prmC = vals.length >= 4 ? vals[vals.length-1] : null ;           // 互換性。最後の値が、CC引数
2719
2720                if( StringUtil.startsChar( prmA , '@' ) ) {                                                     // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
2721                        prmA = getRequestValue( prmA.substring(1) );
2722                }
2723
2724                if( StringUtil.startsChar( prmB , '@' ) ) {                                                     // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
2725                        prmB = getRequestValue( prmB.substring(1) );
2726                }
2727
2728                if( StringUtil.startsChar( prmC , '@' ) ) {                                                     // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
2729                        prmC = getRequestValue( prmC.substring(1) );
2730                }
2731
2732                // 5.7.4.1 (2014/03/14) AA 引数の@解析後のコマンド判定方法を、8ケタ以下から先頭が数字以外に変更します。
2733                if( prmA != null && prmA.length() > 0 ) {
2734                        final char chA = prmA.charAt(0);
2735                        if( chA < '0' || chA > '9' ) {          // 先頭が、数字以外の場合は、コマンドなので、一つずつずらす。
2736                                prmC = prmB;
2737                                prmB = prmA;
2738                                prmA = null;
2739                        }
2740                }
2741
2742                // 5.7.4.1 (2014/03/14) CC 引数を、"H" , "D" , "M" 以外でも使用できるように拡張します。
2743                int intC = 0;
2744                if( prmC != null && prmC.length() > 0 ) {
2745                        try { 
2746                                intC = Integer.parseInt( prmC );
2747                        }
2748                        catch( final NumberFormatException ex ) {
2749                                final String errMsg = "CC引数が数字ではありません。value=[" + value + "]" 
2750                                                                + ex.getMessage() ;
2751                                System.err.println( errMsg );
2752                        }
2753                }
2754
2755                // prmA が null か、isEmpty() の場合は、現在時刻が使用される。
2756                return HybsDateUtil.getDateFormat( key,prmA,prmB,intC );        // 5.7.4.1 (2014/03/14) CC 引数を拡張します。
2757        }
2758
2759        /**
2760         * debug や エラー時に参考にする、簡易リファレンスへのリンクを作成します。
2761         * リンクを行うタグの名称は、getTagName() メソッドより取得します。
2762         *
2763         * @og.rev 4.0.0.0 (2005/01/31) 新規追加
2764         * @og.rev 4.2.1.0 (2008/04/11) URLを相対パスに変更
2765         * @og.rev 6.2.1.0 (2015/03/13) 簡易リファレンスへのリンクが相対パスでは、common/gamen 以下から使えない。
2766         * @og.rev 6.3.1.1 (2015/07/10) 簡易リファレンスは、documents.html ではなく、quickReference.html です。
2767         * @og.rev 7.0.1.0 (2018/10/15) XHTML → HTML5 対応(空要素の、"/>" 止めを、">" に変更します)。
2768         *
2769         * @return  簡易リファレンスへのリンク
2770         * @og.rtnNotNull
2771         * @see  #getTagName()
2772         */
2773        protected String getDocumentLink() {
2774                final String name = getTagName();
2775
2776        //      try {
2777        //              Field fld = getClass().getDeclaredField( "VERSION" ) ;
2778        //              version = (String)fld.get( null );
2779        //      }
2780        //      catch( final Exception ex ) {
2781        //              version = ex.toString();
2782        //      }
2783
2784                // org.opengion.hayabusa.taglib.AbcdTag というクラス名より、abcd を取り出す。
2785                final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE )
2786//                      .append( "<br /><a href=\"" )
2787                        .append( "<br><a href=\"" )                                                                     // 7.0.1.0 (2018/10/15)
2788                        .append( HybsSystem.sys( "JSP" ) )                                                      // 6.2.1.0 (2015/03/13) 追加
2789                        .append( "/common/quickReference.html#VAL_" )                           // 6.3.1.1 (2015/07/10) リンク先間違い
2790                        .append( name )
2791                        .append( "\" target=\"_brank\" >簡易リファレンス[" )
2792                        .append( name )
2793                        .append( "] " )
2794                        .append( BuildNumber.ENGINE_INFO )                                                      // 6.3.1.1 (2015/07/10) ENGINE_INFO の追加
2795                //      .append( version )
2796                        .append( "</a>" ).append( BR );
2797
2798                return buf.toString();
2799        }
2800
2801        /**
2802         * タグの名称を、返します。
2803         * これは、debug や エラー時に参考にする、簡易リファレンスへのリンクを作成する場合に
2804         * 使用します。
2805         * 通常は、org.opengion.hayabusa.taglib.AbcdTag という自分自身のクラス名より、
2806         * abcd の部分を取り出し、返します。
2807         * クラス名とタグ名が、上記変換ルールと異なる場合は、このメソッドを
2808         * 使用して、直接 abcd の部分に相当する文字列を返すようにしてください。
2809         *
2810         * @og.rev 4.0.0.0 (2005/01/31) 新規追加
2811         *
2812         * @return  タグの名称
2813         * @og.rtnNotNull
2814         * @see  #getDocumentLink()
2815         */
2816        protected String getTagName() {
2817                final String name = getClass().getName();
2818                final int adrs = name.lastIndexOf('.');
2819
2820                // org.opengion.hayabusa.taglib.AbcdTag というクラス名より、abcd を取り出す。
2821                return name.substring( adrs+1,adrs+2 ).toLowerCase(Locale.JAPAN)
2822                                + name.substring( adrs+2,name.length()-3 ) ;
2823        }
2824
2825        /**
2826         * リクエストに対して、画面遷移なしモードを有効にします[true/false]。
2827         * この情報は画面IDをキーにセッションに保存されるため、
2828         * 各タグで共有することができます。
2829         *
2830         * @og.rev 4.3.3.0 (2008/10/01) 新規作成
2831         * @og.rev 4.3.8.0 (2009/08/01) リクエストからセッションに変更(名称も変更)
2832         * @og.rev 5.1.3.0 (2010/02/01) noTransition、ajaxSubmitのコントロールは、requestで行う。
2833         *
2834         * @param       flag    画面遷移なしモード [true:有効/false:無効]
2835         */
2836        protected void setNoTransitionRequest( final boolean flag ) {
2837                setRequestAttribute( HybsSystem.NO_TRANSITION_MODE_KEY, String.valueOf( flag ));
2838        }
2839
2840        /**
2841         * リクエストで画面遷移なしモードが有効になっているかを返します。
2842         * この情報はセッションから画面IDをキーに取得します。
2843         * セッションに情報が設定されていない(#setNoTransition()が呼ばれていない)場合は、
2844         * falseを返します。
2845         *
2846         * @og.rev 4.3.3.0 (2008/10/01) 新規作成
2847         * @og.rev 4.3.8.0 (2009/08/01) リクエストからセッションに変更
2848         * @og.rev 5.1.3.0 (2010/02/01) noTransition、ajaxSubmitのコントロールは、requestで行う。
2849         *
2850         * @return 画面遷移なしモードが有効
2851         */
2852        protected boolean isNoTransitionRequest() {
2853                return nval( (String)getRequestAttribute( HybsSystem.NO_TRANSITION_MODE_KEY ), false );
2854        }
2855
2856        /**
2857         * リクエストに対して、AjaxSubmitモードを使用するかどうか指定します[true/false]。
2858         * この情報は画面IDをキーにセッションに保存されるため、
2859         * 各タグで共有することができます。
2860         *
2861         * @og.rev 4.3.8.0 (2009/08/01) 新規作成
2862         * @og.rev 5.1.3.0 (2010/02/01) noTransition、ajaxSubmitのコントロールは、requestで行う。
2863         *
2864         * @param       flag    AjaxSubmitモード [true:使用する/false:使用しない]
2865         */
2866        protected void setAjaxSubmitRequest( final boolean flag ) {
2867                setRequestAttribute( HybsSystem.USE_AJAX_SUBMIT_KEY, String.valueOf( flag ));
2868        }
2869
2870        /**
2871         * リクエストでAjaxSubmitモードが有効になっているかを返します。
2872         * この情報はセッションから画面IDをキーに取得します。
2873         * セッションに情報が設定されていない(#setNoTransition()が呼ばれていない)場合は、
2874         * falseを返します。
2875         *
2876         * @og.rev 4.3.8.0 (2009/08/01) 新規作成
2877         * @og.rev 5.1.3.0 (2010/02/01) noTransition、ajaxSubmitのコントロールは、requestで行う。
2878         *
2879         * @return AjaxSubmitモードが有効
2880         */
2881        protected boolean isAjaxSubmitRequest() {
2882                return nval( (String)getRequestAttribute( HybsSystem.USE_AJAX_SUBMIT_KEY ), false );
2883        }
2884
2885        /**
2886         * シリアライズ用のカスタムシリアライズ読み込みメソッド
2887         *
2888         * ここでは、transient 宣言された内部変数の内、初期化が必要なフィールドのみ設定します。
2889         *
2890         * @og.rev 4.0.0.0 (2006/09/31) 新規追加
2891         * @serialData 一部のオブジェクトは、シリアライズされません。
2892         *
2893         * @param       strm    ObjectInputStreamオブジェクト
2894         * @see #release2()
2895         */
2896        private void readObject( final ObjectInputStream strm ) throws IOException , ClassNotFoundException {
2897                strm.defaultReadObject();
2898                attri = new Attributes();
2899        }
2900
2901        /**
2902         * アクセスログ取得の為,ApplicationInfoオブジェクトを返します。
2903         * 見つからない場合は、null が返ります。(暫定対応)
2904         *
2905         * @og.rev 3.8.7.0 (2006/12/15) 新規追加
2906         *
2907         * @return      アクセスログ取得の為の管理オブジェクト
2908         */
2909        protected ApplicationInfo getApplicationInfo() {
2910                final String gamenId = getGUIInfoAttri( "KEY" );
2911                final String jspId   = (String)getSessionAttribute( "JSPID" );
2912
2913                return getUser().getApplicationInfo( gamenId,jspId );
2914        }
2915
2916        /**
2917         * イベントカラムの実行に必要なカラム情報をマップに登録します。
2918         *
2919         * @og.rev 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
2920         * @og.rev 6.3.3.0 (2015/07/25) eventValue 追加
2921         *
2922         * @param col DBカラム
2923         */
2924        protected void addEventColumn( final DBColumn col ) {
2925                addEventColumn( col.getName(), col.getEventColumn(), col.getEventValue(), col.getEventURL()
2926                                                , col.getRenderer(), col.getEditor(), col.getRawRendParam(), col.getRawEditParam() );
2927        }
2928
2929        /**
2930         * イベントカラムの実行に必要なカラム情報をマップに登録します。
2931         *
2932         * @og.rev 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
2933         * @og.rev 6.3.3.0 (2015/07/25) eventValue 追加
2934         *
2935         * @param name カラム名
2936         * @param evCol イベントカラム名
2937         * @param evVal 子カラムの値SQL
2938         * @param url イベントURL
2939         * @param renderer カラムのレンデラー
2940         * @param editor カラムのエディター
2941         * @param rendParam カラムの表示パラメーター
2942         * @param editParam カラムの編集パラメーター
2943         */
2944        @SuppressWarnings(value={"unchecked"})
2945        protected void addEventColumn( final String name, final String evCol , final String evVal, final String url, 
2946                                                final String renderer, final String editor, final String rendParam, final String editParam ) {
2947                if( evCol == null || evCol.isEmpty() ){ return; }
2948
2949                String key = (String)getRequestAttribute( HybsSystem.USE_EVENT_COLUMN_KEY );
2950                if( key == null || key.isEmpty() ) {
2951                        key = HybsSystem.USE_EVENT_COLUMN_KEY + System.currentTimeMillis();
2952                        setRequestAttribute( HybsSystem.USE_EVENT_COLUMN_KEY, key );
2953                }
2954
2955                Map<String, DBEventColumn> evColMap = (Map<String, DBEventColumn>)( getSessionAttribute( key ) );
2956                if( evColMap == null ){
2957                        evColMap = new HashMap<>();
2958                }
2959                if( evColMap.get( name ) == null ) {
2960                        evColMap.put( name, new DBEventColumn( name, evCol, evVal, url, renderer, editor, rendParam, editParam ) );     // 6.3.3.0 (2015/07/25)
2961                }
2962                setSessionAttribute( key, evColMap );
2963        }
2964
2965        /**
2966         * 各データベースに対応するファンクション名を返します。
2967         *
2968         * @og.rev 4.3.7.0 (2009/06/01) 新規作成
2969         * @og.rev 5.1.4.0 (2010/03/01) データベース名 でなく、DBID 名で検索するようにします。
2970         *
2971         * @param   key ファンクション名(定義文字)
2972         *
2973         * @return  実ファンクション名
2974         */
2975        protected String getDBFunctionName( final String key ) {
2976                final int idx = key.indexOf( ' ' );
2977                String func = null;
2978                String dbid = null;
2979                if( idx >= 0 ) {
2980                        func = key.substring( 0, idx );
2981                        dbid = key.substring( idx+1, key.length() );
2982                        if( StringUtil.startsChar( dbid , '@' ) ) { dbid = getRequestValue( dbid.substring( 1 ) ); }    // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
2983                }
2984                else {
2985                        func = key;
2986                }
2987                // 5.1.4.0 (2010/03/01) データベース名 でなく、DBID 名で検索する。
2988                return DBFunctionName.getFunctionName( func, dbid );
2989        }
2990
2991        /**
2992         * データロールの設定に基づき、キー(カラム名)に対応する条件式を返します。
2993         *
2994         * @og.rev 4.4.0.0 (2009/08/02) 新規作成
2995         *
2996         * @param   key カラム名
2997         *
2998         * @return  条件式
2999         */
3000        protected String getDataCondition( final String key ) {
3001                return getUser().getDataCondition( key );
3002        }
3003
3004        /**
3005         * 与えたIPアドレスからホスト名を取得して返します。
3006         * 取得できなかった場合は空文字を返します。
3007         * IPアドレスが解決できない場合や、セキュリティマネージャーで
3008         * 許可されていない場合はエラーを返します。
3009         *
3010         * @og.rev 5.6.6.2 (2013/07/19) 新規作成
3011         *
3012         * @param   ip IPアドレス
3013         *
3014         * @return  ホスト名(取得できない場合は空文字)
3015         */
3016        protected String getHostName( final String ip ) {
3017                String hostname = "";
3018                try{
3019                        hostname =  InetAddress.getByName(ip).getHostName();
3020                }
3021                catch( final UnknownHostException ex ){
3022                        final String errMsg = "IPアドレスが解決できません。"
3023                                + ex.getMessage();                      
3024                        throw new HybsSystemException( errMsg,ex );             
3025                }
3026                catch( final SecurityException ex ){
3027                        final String errMsg = "この操作はセキュリティ上許可されていません。"
3028                                + ex.getMessage();                      
3029                        throw new HybsSystemException( errMsg,ex );
3030                }
3031                return hostname;
3032        }
3033
3034        /**
3035         * 指定のURLの文字列から、最適なURLを作成します。
3036         * 
3037         * 引数の url が、'/' で始まる場合は、コンテキスト以下の相対パスと判断します。
3038         * つまり、"/gf" + url で表されることになります。
3039         * ただし、経過処置として、先頭が、コンテキストを含む文字列の場合は、そのまま返します。
3040         * 
3041         * それ以外は、そのまま返します。
3042         * ただし、引数が、null やゼロ文字列の時は、ゼロ文字列を返します。
3043         *
3044         * @og.rev 6.3.2.0 (2015/07/10) 指定のURLの文字列から、最適なURLを作成します。
3045         *
3046         * @param       url 指定のURLの文字列から、最適なURLを作成します。
3047         *
3048         * @return      コンテキストに応じた URL を返します。
3049         * @og.rtnNotNull
3050         */
3051        protected static String makeUrl( final String url ) {
3052                if( url == null || url.isEmpty() ) { return ""; }
3053
3054                if( url.charAt(0) == '/' ) {
3055                        final String CPATH = '/' + HybsSystem.sys( "CONTEXT_NAME" );            // CPATH = "/gf"
3056                        if( !url.startsWith( CPATH ) ) {
3057                                return CPATH + url ;
3058                        }
3059                }
3060
3061                return url ;
3062        }
3063
3064        /**
3065         * "org.opengion.hayabusa.message" の、Locale.JAPANESE リソースから取得するメッセージを文字列で返します。
3066         *
3067         * id と引数を受け取り、ResourceBundle と、MessageFormat.format で加工した
3068         * 文字列を返します。
3069         * baseName は、F_BS_NM で、Locale に、Locale.JAPANESE を指定したメッセージを作成します。
3070         * hayabusaパッケージと、pluginパッケージで主に使われる、メッセージの取得方法です。
3071         *
3072         * @og.rev 6.4.3.2 (2016/02/19) 新規追加
3073         *
3074         * @param id    リソースのキーとなるID。
3075         * @param args  リソースを、MessageFormat.format で加工する場合の引数。
3076         *
3077         * @return MessageFormat.formatで加工された文字列
3078         * @see         MsgUtil#H_BS_NM
3079         */
3080        protected String getMsg( final String id , final Object... args ) {
3081                return MsgUtil.getMsg( MsgUtil.H_BS_NM , new Locale( getLanguage() ) , id , args );
3082        }
3083
3084//      /**
3085//       * タグリブで発生したThrowableを session から取り出します。
3086//       *
3087//       * とりだした Throwable は、remove しています。
3088//       *
3089//       * @og.rev 6.8.5.0 (2018/01/09) タグリブで発生したエラーを、session に登録しておきます。
3090//       * @og.rev 6.9.2.1 (2018/03/12) タグリブで発生したエラーを、session に登録する処理を、一旦廃止
3091//       *
3092//       * @return      元のThrowableオブジェクト
3093//       */
3094//      protected Throwable getCommonTagThrowable() {
3095//              final Throwable th  = (Throwable)getSessionAttribute( "CommonTagThrowable" );
3096//
3097//              removeSessionAttribute( "CommonTagThrowable" );
3098//
3099//              return th;
3100//      }
3101
3102        /**
3103         * このオブジェクトの文字列表現を返します。
3104         * 基本的にデバッグ目的に使用します。
3105         *
3106         * @return このクラスの文字列表現
3107         * @og.rtnNotNull
3108         */
3109        @Override
3110        public String toString() {
3111                return ToString.title( this.getClass().getName() )
3112                                .println( "Other..."    ,getAttributes().getAttribute() )
3113                                .fixForm().toString() ;
3114        }
3115}