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 jakarta.servlet.ServletContext;
060import jakarta.servlet.ServletRequest;
061import jakarta.servlet.http.Cookie;
062import jakarta.servlet.http.HttpServletRequest;
063import jakarta.servlet.http.HttpServletResponse;
064import jakarta.servlet.http.HttpSession;
065import jakarta.servlet.jsp.JspWriter;
066import jakarta.servlet.jsp.tagext.BodyContent;
067import jakarta.servlet.jsp.tagext.BodyTagSupport;
068import jakarta.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 = "8.0.0.0 (2021/09/30)" ;
114        private static final long serialVersionUID = 800020210930L ;
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         * @og.rev 7.2.9.0 (2020/10/12) ラベル形式('L','S','T','D','R','C') 処理を、メソッドに変更(null時はキーを返す)
715         * @og.rev 7.2.9.0 (2020/10/12) getRawShortLabelで、null時は key を返します。
716         *
717         * @param    lbl ラベルのキー
718         *
719         * @return   ラベル文字列
720         */
721        protected String getLabel( final String lbl ) {
722
723                String key = lbl ;
724                String val = null;
725
726                final int spc = lbl.indexOf( ' ' );             // " " があるかどうか
727                if( spc > 0 ) {
728                        key = lbl.substring( 0,spc );
729                        if( key.charAt(0) == '@' ) { key = getRequestValue( key.substring( 1 ) ); }
730
731                        // リクエスト引数が指定された場合
732                        char ch  = lbl.length() > spc+1 ? lbl.toUpperCase( Locale.JAPAN ).charAt( spc+1 ) : ' ';        // Label,Short,Tips,Description
733                        char ch2 = lbl.length() > spc+2 ? lbl.toUpperCase( Locale.JAPAN ).charAt( spc+2 ) : ' ';        // Label,Short,Tips,Description
734                        if( ch == '@' ) {
735                                final String tmp = getRequestValue( lbl.substring( spc+2 ) );
736                                if( tmp != null && tmp.length() > 0 ) {
737                                        ch  = tmp.toUpperCase( Locale.JAPAN ).charAt(0);
738                                        ch2 = tmp.length() > 1 ? tmp.toUpperCase( Locale.JAPAN ).charAt( 1 ) : ' ';
739                                }
740                        }
741                        // 4.0.0.0 (2007/10/19)
742                        if( ch == '%' ) {
743                                switch( ch2 ) {
744                                        case 'L': val = getResource().getLabel( key ); break;
745//                                      case 'S': val = getResource().getLabelData( key ).getShortLabel(); break;
746//                                      case 'T': val = getResource().getLabelData( key ).getLongLabel(); break;
747//                                      case 'D': val = getResource().getLabelData( key ).getDescription(); break;
748//                                      case 'R': val = getResource().getLabelData( key ).getRawShortLabel(); break;    // 5.4.0.1 (2011/11/01)
749//                                      case 'C': val = getResource().getLabelData( key + "." + getRequestValue( key ) ).getShortLabel(); break;        // 5.5.7.2 (2012/10/09)
750                                        // 7.2.9.0 (2020/10/12) ラベル形式('L','S','T','D','R','C') 処理を、メソッドに変更(null時はキーを返す)
751                                        case 'S': val = getResource().getShortLabel(    key ); break;
752                                        case 'T': val = getResource().getLongLabel(     key ); break;
753                                        case 'D': val = getResource().getDescription(   key ); break;
754//                                      case 'R': val = getResource().getRawShortLabel( key ); break;           // 5.4.0.1 (2011/11/01)
755                                        case 'R': val = getResource().getRawShortLabel( key,true ); break;      // 7.2.9.0 (2020/10/12)
756                                        case 'C': val = getResource().getShortLabel( key + "." + getRequestValue( key ) ); break;       // 5.5.7.2 (2012/10/09)
757                                        default : break;
758                                }
759                        }
760                        else if( ch != ' ' ) {
761                                String[] msgVals = StringUtil.csv2Array( lbl.substring( spc+1 ),' ' );
762                                for( int i=0; i<msgVals.length; i++ ) {
763                                        // リクエスト文字パラメータ時の処理。その他は、ラベル文字は処理不要。
764                                        if( StringUtil.startsChar( msgVals[i] , '@' ) ) {                                       // 6.4.1.1 (2016/01/16) 1文字 String.startsWith
765                                                msgVals[i] = getRequestValue( msgVals[i].substring( 1 ) );
766                                        }
767                                }
768                                val = getResource().getLabel( key,msgVals );
769                        }
770                }
771                else {
772                        if( key.charAt(0) == '@' ) { key = getRequestValue( key.substring( 1 ) ); }
773                }
774
775                if( val == null ) { val = getResource().getLabel( key ); }
776                return val;
777        }
778
779        /**
780         * DBColumn オブジェクトを返します。
781         *
782         * これは、キーを元に DBColumnオブジェクトをカラムリソースの
783         * 定義ファイルより取得して、リソースマネージャで管理します。
784         *
785         * @param       key     オブジェクトのキー
786         *
787         * @return      DBColumnオブジェクト
788         */
789        protected DBColumn getDBColumn( final String key ) {
790                return getResource().makeDBColumn( key ) ;
791        }
792
793        /**
794         * 内部の Attributes オブジェクトに、属性値をセットします。
795         *
796         * 同じキーの値が登録されていた場合は、置き換えられます。
797         *
798         * @param   key   キー
799         * @param   value 属性値
800         * @see         #add( String , String )
801         */
802        protected void set( final String key, final String value ) {
803                attri.set( key,value );
804        }
805
806        /**
807         * 内部の Attributes オブジェクトに、属性値を追加します。
808         *
809         * ここでは、すでに同じキーが登録されている場合は、その値に、
810         * 標準セパレータ(スペース)を追加して、文字列結合します。
811         * たとえば、class 属性などは、値をスペースで追加する事で、
812         * CSS で処理することができます。
813         *
814         * @og.rev 4.0.0.0 (2007/05/18) 新規追加
815         *
816         * @param   key   キー
817         * @param   value 属性値
818         * @see         #add( String , String , String )
819         * @see         #set( String , String )
820         */
821        protected void add( final String key, final String value ) {
822                attri.add( key,value );
823        }
824
825        /**
826         * 内部の Attributes オブジェクトに、属性値を追加します。
827         *
828         * ここでは、すでに同じキーが登録されている場合は、その値に、
829         * 引数のセパレータを追加して、文字列結合します。
830         *
831         * @og.rev 3.5.0.0 (2003/09/17) 新規追加
832         * @og.rev 3.5.5.9 (2004/06/07) セパレータ引数付きのメソッドに変更
833         *
834         * @param   key   キー
835         * @param   value 属性値
836         * @param   sepa  セパレータ
837         * @see         #add( String , String )
838         */
839        protected void add( final String key, final String value, final String sepa ) {
840                attri.add( key,value,sepa );
841        }
842
843        /**
844         * 内部の Attributes オブジェクトから、属性値を取得します。
845         *
846         * @param       key     キー
847         *
848         * @return      属性値
849         * @see         #set( String , String )
850         */
851        protected String get( final String key ) {
852                return attri.get( key );
853        }
854
855        /**
856         * 属性オブジェクトの取得。
857         *
858         * Attributes オブジェクトを取得します。
859         *
860         * @return      Attributesオブジェクト
861         */
862        protected Attributes getAttributes() {
863                return attri;
864        }
865
866        /**
867         * {&#064;XXXX} 形式の文字列から XXXX をキーとして ServletRequest から getParameter で値を取り出します。
868         *
869         * 他の文字列に混在した {&#064;XXXX} 文字を変換可能です。
870         * ただし、処理の簡素化のため、上記形式以外は変換いたしません。
871         * エラー例)× { &#064;XXXX }、{&#064; XXXX }、{&#064;XXXX&#064;yyyy}、{&#064;XXXX{&#064;yyyy}}
872         * また、"{&#064;" を通常の記述で使うことは無いと考え、エスケープも用意して
873         * いません。よって、"{&#064;" のパターンが見つかって,"}" で閉じられていない
874         * 場合は,エラーとして、HybsSystemException を throw します。
875         *
876         * @og.rev 3.8.0.4 (2005/08/08) {} の処理方法見直し。連続処理、単体処理を可能にします。
877         *
878         * @param   key リクエストのキー
879         *
880         * @return  リクエストの値
881         * @og.rtnNotNull
882         */
883        protected String getRequestParameter( final String key ) {
884                isReqNull = false;
885
886                if( key == null ) { isReqNull = true; return ""; }
887                int index = key.indexOf( "{@" );
888                if( index < 0 ) { return key; }
889
890                // 変数が "{@XXXX}" の場合を優先的に検索。
891                // これにより多くのパターンで、StringTokenizer による
892                // 文字列操作を行う必要がなくなります。
893                if( index == 0 &&
894                        key.indexOf( '}' ) == key.lastIndexOf( '}' ) &&                         // 6.4.2.1 (2016/02/05) PMD refactoring. Useless parentheses.
895                        key.charAt(key.length()-1) == '}' ) {
896                                return getRequestValue( key.substring( 2,key.length()-1 ) );
897                }
898
899                // 3.8.0.4 (2005/08/08) {} の処理方法見直し。連続処理、単体処理を可能にします。
900                final StringBuilder rtn = new StringBuilder( BUFFER_MIDDLE );
901                int start = 0;
902                while( index >= 0 ) {
903                        final int end = key.indexOf( '}',index );
904                        if( end < 0 ) {
905                                final String errMsg = "{@ と } との対応関係がずれています。" + CR
906                                                        + "key=[" + key + "] : index=" + index ;
907                                throw new HybsSystemException( errMsg );
908                        }
909
910                        // {@ より前方の文字列を追加
911                        if( index > 0 ) { rtn.append( key.substring( start,index ) ); }
912
913                        // {@XXXX} の XXXX部分を処理
914                        final String val = getRequestValue( key.substring( index+2,end ) );
915                        if( val != null ) { rtn.append( val ); }
916
917                        start = end+1 ;
918                        index = key.indexOf( "{@",start );
919                }
920                rtn.append( key.substring( start ) );
921
922                return rtn.toString();
923        }
924
925        /**
926         * {&#064;XXX.YYYY} 形式の文字列から値を取得します。
927         * 予約語のみ処理をし、それ以外は{&#064;xxx}のままとします。
928         *
929         * 他の文字列に混在した {&#064;XXXX} 文字を変換可能です。
930         * ただし、処理の簡素化のため、上記形式以外は変換いたしません。
931         * エラー例)× { &#064;XXXX }、{&#064; XXXX }、{&#064;XXXX&#064;yyyy}、{&#064;XXXX{&#064;yyyy}}
932         * また、"{&#064;" を通常の記述で使うことは無いと考え、エスケープも用意して
933         * いません。よって、"{&#064;" のパターンが見つかって,"}" で閉じられていない
934         * 場合は,エラーとして、HybsSystemException を throw します。
935         *
936         * @og.rev 5.5.4.0 (2012/07/02) 新規作成
937         *
938         * @param   key リクエストのキー
939         *
940         * @return  リクエストの値
941         * @og.rtnNotNull
942         */
943        protected String getReservedParameter( final String key ) {
944                isReqNull = false;
945
946                if( key == null ) { isReqNull = true; return ""; }
947                int index = key.indexOf( "{@" );
948                if( index < 0 ) { return key; }
949
950                // 変数が "{@XXXX}" の場合を優先的に検索。
951                // これにより多くのパターンで、StringTokenizer による
952                // 文字列操作を行う必要がなくなります。
953                if( index == 0 &&
954                        key.indexOf( '}' ) == key.lastIndexOf( '}' ) &&                                 // 6.4.2.1 (2016/02/05) PMD refactoring. Useless parentheses.
955                        key.charAt(key.length()-1) == '}' ) {                                                   // 6.4.2.1 (2016/02/05) PMD refactoring. Useless parentheses.
956                                return getReservedValue( key.substring( 2,key.length()-1 ) );
957                }
958
959                // 3.8.0.4 (2005/08/08) {} の処理方法見直し。連続処理、単体処理を可能にします。
960                final StringBuilder rtn = new StringBuilder( BUFFER_MIDDLE );
961                int start = 0;
962                while( index >= 0 ) {
963                        final int end = key.indexOf( '}',index );
964                        if( end < 0 ) {
965                                final String errMsg = "{@ と } との対応関係がずれています。" + CR
966                                                        + "key=[" + key + "] : index=" + index ;
967                                throw new HybsSystemException( errMsg );
968                        }
969
970                        // {@ より前方の文字列を追加
971                        if( index > 0 ) { rtn.append( key.substring( start,index ) ); }
972
973                        // {@XXXX} の XXXX部分を処理
974                        final String val = getReservedValue( key.substring( index+2,end ) );
975                        if( val != null ) { rtn.append( val ); }
976
977                        start = end+1 ;
978                        index = key.indexOf( "{@",start );
979                }
980                rtn.append( key.substring( start ) );
981
982                return rtn.toString();
983        }
984
985        /**
986         * {&#064;XXXX} 形式の文字列から XXXX をキーとして ServletRequest から getParameterValues で値を取り出します。
987         *
988         * これは、複数(配列)でリクエストを取り出すことが可能です。
989         * そのため、他の文字列に混在させて変換することができません。
990         * "{&#064;XXXX}" 形式 からのみの変換となります。
991         *
992         * @og.rev 3.6.0.0 (2004/09/22) キーがnull のときにnullではなく長さ0の配列を返します。
993         *
994         * @param   key リクエストのキー
995         *
996         * @return  リクエストの値
997         * @og.rtnNotNull
998         */
999        protected String[] getRequestParameterValues( final String key ) {
1000                if( key == null ) { return new String[0]; }             // 3.6.0.0 (2004/09/22)
1001                final int index = key.indexOf( "{@" );
1002                if( index < 0 ) { return StringUtil.csv2Array( key ); }
1003
1004                if( index == 0 && key.charAt( key.length()-1 ) == '}' ) {
1005                        return getRequestValues( key.substring( 2,key.length()-1 ) );
1006                }
1007
1008                final String errMsg = "引数の形式が異なります。 [" + key + "]" ;
1009                throw new HybsSystemException( errMsg );
1010        }
1011
1012        /**
1013         * 引数 inStr が、引数 check のSetの中に存在すれば、 true を、存在しなければ、false を返します。
1014         *
1015         * check は、 String配列 を、inStr は、null でも構いません。
1016         * ※ 6.3.5.0 (2015/08/08) 大文字小文字の区別廃止。
1017         *
1018         * @og.rev 2.1.0.3 (2002/11/08) 文字列配列を引数に取るメソッドを追加
1019         * @og.rev 6.3.5.0 (2015/08/08) forループの変更と、大文字小文字の区別廃止
1020         * @og.rev 6.4.3.4 (2016/03/11) String配列 から、Setに置き換えます。
1021         *
1022         * @param    inStr      チェックする文字列
1023         * @param    chkSet     チェック用の文字列Set
1024         *
1025         * @return   存在する true /  存在しない false
1026         */
1027        protected boolean check( final String inStr, final Set<String> chkSet ) {
1028                return inStr != null && chkSet != null && chkSet.contains( inStr );
1029        }
1030
1031        /**
1032         * ユーザーオブジェクトが持っている内部情報を取得します。
1033         *
1034         * これは、UserInfo#getAttribute( String ) で取得される情報です。
1035         * ユーザーパラメータとは異なります。
1036         *
1037         * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 getUser() を使用するように変更
1038         *
1039         * @param    user ユーザー情報を取り出すキー
1040         *
1041         * @return   ユーザー情報文字列
1042         */
1043        protected String getUserInfo( final String user ) {
1044                if( user == null ) { return null; }
1045
1046                String key = user ;
1047                if( key.charAt(0) == '@' ) {
1048                        key = getRequestValue( key.substring( 1 ) );
1049                }
1050
1051                return getUser().getAttribute( key );
1052        }
1053
1054        /**
1055         * ユーザーオブジェクトが持っているEditの内部情報を取得します。
1056         *
1057         * これは、UserInfo#getSelectedEdit( String ) で取得される情報です。
1058         * ユーザーパラメータとは異なります。
1059         *
1060         * @og.rev 5.8.2.3 (2014/12/27) 新規作成
1061         *
1062         * @param    guikey 取り出す画面ID
1063         *
1064         * @return   ユーザー情報文字列
1065         */
1066        protected String getUserEditInfo( final String guikey ) {
1067                if( guikey == null ) { return null; }
1068
1069                String key = guikey ;
1070                if( key.charAt(0) == '@' ) {
1071                        key = getRequestValue( key.substring( 1 ) );
1072                }
1073
1074        // * @og.rev 6.4.5.0 (2016/04/08) UserInfo のEditConfig関連機能を、DBEditConfigManagerに移植します。
1075        //      final DBEditConfigManager dbConfMgr = getUser().getEditConfigManager();         // 6.4.5.0 (2016/04/08)
1076        //      return dbConfMgr.getSelectedEdit( key );
1077                return getUser().getSelectedEdit( key );
1078        }
1079
1080        /**
1081         * ユーザー情報を設定します。
1082         *
1083         * 初めての場合は、session 登録項目 の HybsSystem#USERINFO_KEY キー の値で
1084         * 取得します。
1085         * save属性は、GE20(ユーザー定数)に情報を保存するかどうかを指定します。
1086         *
1087         * @og.rev 2.1.1.4 (2002/11/25) ユーザー情報をセットするメソッドを追加
1088         * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 getUser() を使用するように変更
1089         * @og.rev 4.3.4.0 (2008/12/01) GE20(ユーザー定数)へ登録するかのフラグを追加
1090         *
1091         * @param    key ユーザー情報をセットするキー
1092         * @param    value ユーザー情報文字列
1093         * @param    save 情報保存 [true:保存/false:保存しない]
1094         */
1095        protected void setUserInfo( final String key,final String value, final boolean save ) {
1096                if( key != null ) {
1097                        getUser().setAttribute( key, value, save );
1098                }
1099        }
1100
1101        /**
1102         * ユーザー情報オブジェクトを取得します。
1103         *
1104         * 初めての場合は、session 登録項目 の HybsSystem#USERINFO_KEY キー の値で
1105         * 取得します。
1106         *
1107         * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 新規追加
1108         * @og.rev 3.6.0.0 (2004/09/17) private ⇒ protected 化します。
1109         *
1110         * @return   ユーザー情報オブジェクト
1111         * @og.rtnNotNull
1112         */
1113        protected UserInfo getUser() {
1114                if( userInfo == null ) {
1115                        userInfo = (UserInfo)getSessionAttribute( HybsSystem.USERINFO_KEY );
1116                }
1117                if( userInfo == null ) {
1118                        final String errMsg = "ユーザーオブジェクトが存在しません。";
1119                        throw new HybsSystemException( errMsg );
1120                }
1121                return userInfo ;
1122        }
1123
1124        /**
1125         * 画面情報(GUIInfo)を取得します。
1126         *
1127         * これは、session 登録項目 の HybsSystem#GUIMAP_KEY キー の値で
1128         * 登録された MAP を取り出し、そこから取得します。
1129         * 画面情報は、ログインユーザー毎に個別に持っています。
1130         *
1131         * @og.rev 4.0.0.0 (2005/01/31) GUIInfo が存在しない場合も処理を続けます。
1132         *
1133         * @param    gamenId 画面ID
1134         *
1135         * @return   画面情報(GUIInfo)
1136         */
1137        protected GUIInfo getGUIInfo( final String gamenId ) {
1138                return getUser().getGUIInfo( gamenId );
1139        }
1140
1141        /**
1142         * 画面情報(GUIInfo)の属性値を取得します。
1143         *
1144         * これは、{&#064;GUI.XXXX ID} 引数処理をおこなうための、サポートメソッドです。
1145         * 引数は、"XXXX ID" という状態で受け取ります。(GUI. ははずした形)
1146         * XXXXには、画面情報(GUIInfo)の属性キーを指定します。IDが指定されない場合は、
1147         * 実行中の自分自身の画面が指定されたことになります。
1148         * これは、session 登録項目 の HybsSystem#GUIINFO_KEY キー の値で取得します。
1149         * この値は,画面が呼び出される毎に毎回設定されており、リクエスト毎に
1150         * 所得し直す必要があります。
1151         *
1152         * ID に、画面IDを指定した場合は、&#064; 指定によるリクエスト引数の値を適用できます。
1153         * {&#064;GUI.&#064;XXXX ID} や、{&#064;GUI.XXXX &#064;ID} です。(同時指定も可能)
1154         *
1155         * @og.rev 3.6.0.6 (2004/10/22) GUIInfo が存在しない場合も処理を続けます。
1156         * @og.rev 4.0.0.0 (2004/11/30) 画面ID引数や、リクエスト引数の使用を可能にします。
1157         * @og.rev 5.9.32.2 (2018/05/18) エラー表示変更
1158         * @og.rev 5.10.12.3 (2019/06/21) エラー表示変更
1159         *
1160         * @param    attkey 画面情報を取り出すキー
1161         *
1162         * @return   画面情報文字列
1163         */
1164        protected String getGUIInfoAttri( final String attkey ) {
1165                if( attkey == null ) { return null; }
1166
1167                String  key = attkey ;
1168                final GUIInfo gui ;
1169
1170                final int spc = key.indexOf( ' ' );             // " " があるかどうか
1171                if( spc > 0 ) {
1172                        key = attkey.substring( 0,spc );
1173                        String id = attkey.substring( spc+1 );
1174                        if( StringUtil.startsChar( id , '@' ) ) {                                                       // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
1175                                id = getRequestValue( id.substring( 1 ) );
1176                        }
1177                        gui = getUser().getGUIInfo( id );
1178                }
1179                else {
1180                        if( guiInfo == null ) {
1181                                guiInfo = (GUIInfo)getSessionAttribute( HybsSystem.GUIINFO_KEY );
1182                        }
1183                        gui = guiInfo;
1184                }
1185//              if( gui == null ) { return "Not Found[" + attkey + "]"; }
1186//              if( gui == null ) { return "Not Found(" + attkey + ")"; }       // 5.9.32.2 (2018/05/18) []で囲むとテーブルモデルで予期せぬエラーになるため変更
1187                if( gui == null ) { return "NotFound_" + attkey ; }                     // 5.10.12.3 (2019/06/21) URLで確実に使える文字のみで構成しておく
1188                if( StringUtil.startsChar( key , '@' ) ) {                                      // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
1189                        key = getRequestValue( key.substring( 1 ) );
1190                }
1191
1192                return gui.getAttribute( key );
1193        }
1194
1195        /**
1196         * {&#064;NVL.XXX 値} で、XXXが NULLの場合、値を返します。
1197         *
1198         * ORACLE等の COALESCE ( expr_list ) 処理に近い結果を返します。
1199         * NVL ( expr1 , expr2 ) は、expr1 が NULL の場合、expr2 を返しますが、
1200         * COALESCE は、第一引数が NULLなら、次の引数、それも NULL なら、さらに次と
1201         * 引数リストを順次処理していきます。
1202         * それと同じく、XXX が NULL なら、その次・・と順次評価していき、NULL でない
1203         * 値が返ってきたところで、その値を返します。
1204         * これは、{&#064;NVL.XXX &#064;YYY ZZZ ・・・} 形式を処理します。
1205         * これは、パラメータ XXX が NULLの場合、次の値を使います。(&#064;YYY)
1206         * &#064;YYY は、YYY パラメータの事で、これも NULL の場合は、ZZZ を使います。
1207         * 最後まで NULL の場合は、 ゼロ文字列が返されます。
1208         *
1209         * @og.rev 5.6.4.0 (2013/05/02) 新規追加
1210         * @og.rev 6.9.3.0 (2018/03/26) パラメータ処理で、ダブルクオート内は分解しない
1211         * @og.rev 6.9.3.1 (2018/04/02) パラメータ処理で、ダブルクオート内は分解しない・・の処理漏れ追加
1212         * @og.rev 7.2.9.1 (2020/10/23) protected → private に変更
1213         *
1214         * @param    attkey NVL情報を取り出すパラメータ
1215         *
1216         * @return   NULL以外の値が出てくるまで、順次評価した結果
1217         */
1218//      protected String getNVLAttri( final String attkey ) {
1219        private String getNVLAttri( final String attkey ) {
1220                if( attkey == null ) { return null; }
1221
1222                final String[] keys = StringUtil.csv2Array( attkey,' ' );               // ダブルクオート内は分解しない。
1223//              final String[] keys = attkey.split( " " );                      // スペースで、パラメータを分解する。
1224                String val = getRequestValue( keys[0] );                        // 第一パラメータは、そのままのキーで検索
1225
1226                // val が null の間は、チェックする。
1227                if( val == null || val.isEmpty() ) {
1228                        for( int i=1; i<keys.length; i++ ) {
1229                                val = keys[i];
1230                                // 先頭が @ の場合は、リクエスト変数のキーとして、値を判定
1231                                if( StringUtil.startsChar( val , '@' ) ) {                                      // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
1232                                        if( val.indexOf( ' ' ) > 0 ) {                                                  // 6.9.3.1 (2018/04/02) 空白を含む場合は、ダブルクオート内の処理
1233                                                val = getReservedValue( val.substring( 1 ) );                   // 6.9.3.0 (2018/03/26) もう一度変数処理
1234                                        }
1235                                        else {
1236                                                val = getRequestValue( val.substring( 1 ) );                    // 6.9.3.1 (2018/04/02) 一旦元に戻す。
1237                                        }
1238//                                      val = getRequestValue( val.substring( 1 ) );
1239//                                      val = getReservedValue( val.substring( 1 ) );                   // 6.9.3.0 (2018/03/26) もう一度変数処理
1240                                }
1241                                if( val != null && val.length() > 0 ) { break; }
1242                        }
1243                }
1244
1245                if( val == null ) { val = ""; }         // NULL の場合は、 ゼロ文字列を返す。
1246
1247                return val;
1248        }
1249
1250
1251        /**
1252         * {&#064;REP.XXX 置換元 置換先} で、XXX の文字列変換した値を返します。
1253         *
1254         * XXX に対して、置換元文字列を置換先文字列で置換します。
1255         * これは、{&#064;REP.XXX &#064;YYY ZZZ} 形式を処理します。
1256         * これは、パラメータ XXX が NULLの場合、NULLを返します。
1257         * &#064;YYY は、YYY パラメータの事で、これが NULL の場合は、XXX を返します。
1258         *
1259         * ※ クォーティション(')を含む処理と、元々が IN 引数に、'AA,BB,CC' などの文字列処理を
1260         *    行う( 'AA,'BB,'CC' ) のが目的だったので、引数なしの場合は、上記変換を行う。
1261         *
1262         * @og.rev 8.0.0.0 (2021/09/30) REP.XXXX を追加します。
1263         *
1264         * @param    attkey 文字列置換パラメータ
1265         *
1266         * @return   XXX 値の第一引数と第二引数を置換した値
1267         */
1268        private String getREPAttri( final String attkey ) {
1269                if( attkey == null ) { return null; }
1270
1271                final String[] keys = StringUtil.csv2Array( attkey,' ' );               // ダブルクオート内は分解しない。
1272                String val = getRequestValue( keys[0] );                        // 第一パラメータは、そのままのキーで検索
1273
1274                if( val == null ) { val = ""; }                 // NULL の場合は、 ゼロ文字列を返す。
1275                if( keys.length < 3 ) {                                 // 引数が少ない場合は、"," を"','" に変換する。
1276                        return val.replace( ",","','" );
1277                }
1278
1279                // 置換元 文字列の取得
1280                String key1 = keys[1];
1281                // 先頭が @ の場合は、リクエスト変数のキーとして、値を判定
1282                if( StringUtil.startsChar( key1 , '@' ) ) {
1283                        key1 = getRequestValue( key1.substring( 1 ) );          // @ を削除して、値の取得
1284                }
1285                if( key1 == null || key1.isEmpty() ) {
1286                        return val;                                                     // 置換元が null か空文字列の場合は、置換しない
1287                }
1288
1289                // 置換先 文字列の取得
1290                String key2 = keys[2];
1291                // 先頭が @ の場合は、リクエスト変数のキーとして、値を判定
1292                if( StringUtil.startsChar( key2 , '@' ) ) {
1293                        key2 = getRequestValue( key2.substring( 1 ) );          // @ を削除して、値の取得
1294                }
1295                if( key2 == null )  {
1296                        key2 = "";                                                      // 置換先が null か空文字列の場合は、削除になる。
1297                }
1298
1299                return val.replace( key1,key2 );
1300        }
1301
1302        /**
1303         * {&#064;NN.XXX 値} で、XXXが NOT_NULLの場合、値を返します。
1304         *
1305         * 値が存在した場合に、別の値に変更する動作になります。
1306         * 引数が、NULLの場合は、NULLなので、例えばある値が設定されれば、
1307         * "true" を返すとか、"checked" を返すなどの処理が考えられます。
1308         * 値をセットしなかった場合は、処理を行いません。
1309         *
1310         * @og.rev 7.2.9.1 (2020/10/23) 新規追加
1311         *
1312         * @param    attkey NOT_NULL情報を取り出すパラメータ
1313         *
1314         * @return   NOT_NULLの場合、値を返します。
1315         */
1316        private String getNNAttri( final String attkey ) {
1317                if( attkey == null ) { return null; }           // 継続処理をさせるため、nullを返しておきます。
1318
1319                String val = "" ;                                                       // 不正なパラメータやキーが NULLの場合の初期値
1320
1321                final int spc = attkey.indexOf( ' ' );          // " " があるかどうか
1322                if( spc > 0 ) {                                                         // 値パラメータが存在するときのみ処理を行う。
1323                        String key = attkey.substring( 0,spc );
1324                        if( StringUtil.startsChar( key , '@' ) ) {
1325                                key = getRequestValue( key.substring( 1 ) );
1326                        }
1327                        key = getRequestValue( key );
1328
1329                        if( key != null && !key.isEmpty() ) {   // key が NOT NULL の場合のみ、処理を行う。
1330                                // 値を求める。
1331                                val = attkey.substring( spc+1 );
1332                                if( StringUtil.startsChar( id , '@' ) ) {                       // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
1333                                        val = getRequestValue( id.substring( 1 ) );
1334                                }
1335                        }
1336                }
1337
1338                return val;
1339        }
1340
1341        /**
1342         * {&#064;VALS.XXX アドレス セパレータ} で、XXXをセパレータで分解して、アドレスの値を返します。
1343         *
1344         * セパレータ の初期値は、,(カンマ)です。
1345         * XXX は、変数のキーワードになります。
1346         *
1347         * @og.rev 7.2.3.1 (2020/04/17) 新規追加
1348         * @og.rev 7.2.9.1 (2020/10/23) protected → private に変更
1349         *
1350         * @param    attkey VALS情報を取り出すパラメータ
1351         *
1352         * @return   指定の変数をセパレータで分割してアドレス番目の文字列を取り出す。
1353         */
1354//      protected String getValsAttri( final String attkey ) {
1355        private String getValsAttri( final String attkey ) {
1356                if( attkey == null ) { return null; }
1357
1358                final String[] keys = StringUtil.csv2Array( attkey,' ' );       // ダブルクオート内は分解しない。
1359                String val = getRequestValue( keys[0] );                                        // 第一パラメータは、そのままのキーで検索
1360
1361                if( val == null || val.isEmpty() ) {
1362                        val = "";                                                               // NULL の場合は、 ゼロ文字列を返す。
1363                }
1364                else {
1365                        final int      adrs = keys.length > 1 ? Integer.parseInt( keys[1] ) : 0 ;       // アドレスを取り出す
1366                        final String   sep  = keys.length > 2 ? keys[2] : "," ; // 区切り文字列
1367                        final String[] vals = val.split( sep );
1368
1369                        val = vals[adrs];
1370                }
1371
1372                return val;
1373        }
1374
1375        /**
1376         * {&#064;SUBSTR.XXX 開始インデックス 終了インデックス} で、XXXの部分文字列を取り出します。
1377         *
1378         * 終了インデックスを指定しない場合は、最後までです。
1379         * 開始インデックス(この値を含む)から、終了インデックス(この値を含まない)を切り出します。
1380         * インデックスは、文字数です。
1381         *
1382         * @og.rev 7.2.3.1 (2020/04/17) 新規追加
1383         * @og.rev 7.2.9.1 (2020/10/23) protected → private に変更
1384         *
1385         * @param    attkey SUBSTR情報を取り出すパラメータ
1386         *
1387         * @return   XXXの部分文字列
1388         */
1389//      protected String getSubstrAttri( final String attkey ) {
1390        private String getSubstrAttri( final String attkey ) {
1391                if( attkey == null ) { return null; }
1392
1393                final String[] keys = StringUtil.csv2Array( attkey,' ' );       // ダブルクオート内は分解しない。
1394
1395                final String val = getAtmarkVas( keys[0],true );                                                        // キーワードをリクエストから処理する
1396                final String ad1 = keys.length > 1 ? getAtmarkVas( keys[1],false ) : "" ;       // キーワードは、@が無ければそのままの値
1397                final String ad2 = keys.length > 2 ? getAtmarkVas( keys[2],false ) : "" ;       // キーワードは、@が無ければそのままの値
1398
1399                final int id1 = ad1.isEmpty() ? 0                               : Integer.parseInt( ad1 );
1400                final int id2 = ad2.isEmpty() ? val.length()    : Integer.parseInt( ad2 );
1401
1402                if( id1 < id2 && val.length() > id1 && val.length() >= id2 ) {
1403                        return val.substring( id1,id2 );
1404                }
1405
1406                return val;
1407        }
1408
1409        /**
1410         * {&#064;LAST.XXX} で、XXXが 最後に使われた値を返します。
1411         *
1412         * XXX は、command="NEW" でセットされたリクエスト値です。通常、{&#064;MEM.XXX} は
1413         * 画面単位に、既存のキャッシュから値を取り出しますが、{&#064;LAST.XXX} は、
1414         * 画面に関係なく、ユーザー単位に管理しています。
1415         * また、値は、データベース(GE20)に保管されますので、次回ログイン時にも有効です。
1416         * この処理が呼び出されたときに、リクエスト変数に、XXXX が存在した場合は、そちらを優先に
1417         * 使います。その場合は、command に関係なく、値を設定しておきます。
1418         *
1419         * command="NEW"の場合のリクエスト変数の値の設定は、RequestCacheTag で行います。
1420         *
1421         * ※ データベースには、画面アクセス情報のセーブ時に行われます。
1422         * valueタグのsave属性の様に、リアルタイムではありませんので、Tomcatが
1423         * 異常終了した場合は、セーブされません。
1424         *
1425         * @og.rev 5.6.8.1 (2013/09/13) 新規追加
1426         * @og.rev 7.2.9.1 (2020/10/23) protected → private に変更
1427         *
1428         * @param    attkey 最後に使われた値をを取り出すパラメータ
1429         *
1430         * @return   XXXが 最後に使われた値
1431         * @see         org.opengion.hayabusa.taglib.RequestCacheTag#commandExec( String ,ServletRequest )
1432         * @see         org.opengion.hayabusa.resource.UserInfo#getLastRequestValue( String )
1433         */
1434//      protected String getLASTAttri( final String attkey ) {
1435        private String getLASTAttri( final String attkey ) {
1436                if( attkey == null ) { return null; }
1437
1438                // 最新のリクエスト変数をチェック
1439                final String[] vals = getRequest().getParameterValues( attkey );
1440
1441                String val = null;
1442                if( vals == null ) {
1443                        val = getUser().getLastRequestValue( attkey );          // なければ、取得
1444                }
1445                else {
1446                        for( int i=0; i<vals.length; i++ ) {
1447                                val = vals[i];
1448                                if( ! "0".equals( val ) ) { break; }                    // チェックボックス対応
1449                        }
1450                        getUser().setLastRequestValue( attkey,val );            // あれば、最新の値をセット
1451                }
1452
1453                return val ;
1454        }
1455
1456        /**
1457         * {&#064;SUMR.XXX} で、XXXの 複数リクエスト時の値を合算します。
1458         *
1459         * 同一キーのリクエスト変数に、複数のパラメータが
1460         * 設定された場合、その値を合計します。
1461         * 数値変換できない場合は、カンマで連結します。
1462         * 通常は、edior="BITBOX" などで、数値の合計を求めるために使われます。
1463         *
1464         * @og.rev 6.2.2.4 (2015/04/24) SUM追加
1465         * @og.rev 6.2.3.0 (2015/05/01) CSV形式の作成を、String#join( CharSequence , CharSequence... )を使用。
1466         * @og.rev 7.2.0.0 (2020/02/14) SUMはValueTagとダブるため、SUMR とします。
1467         * @og.rev 7.2.9.1 (2020/10/23) protected → private に変更
1468         *
1469         * @param    attkey 最後に使われた値をを取り出すパラメータ
1470         *
1471         * @return   XXXの 複数リクエスト時の値を合算
1472         */
1473//      protected String getSumRequestValue( final String attkey ) {
1474        private String getSumRequestValue( final String attkey ) {
1475                if( attkey == null ) { return null; }
1476
1477                // 最新のリクエスト変数をチェック
1478                final String[] vals = getRequestValues( attkey );
1479
1480                String rtn = "";
1481                if( vals != null && vals.length > 0 ) {
1482                        try {
1483                                int sum = 0;
1484                                for( int i=0; i<vals.length; i++ ) {
1485                                        final String val = vals[i];
1486                                        if( val != null && !val.isEmpty() ) {
1487                                                sum += Integer.parseInt( val );
1488                                        }
1489                                }
1490                                rtn = String.valueOf( sum );                            // 最後までエラーがなかった場合。
1491                        }
1492                        catch( final NumberFormatException ex ) {
1493                                // 数値変換エラー時は、文字列連結します。
1494                                // 6.2.3.0 (2015/05/01) CSV形式の作成を、String#join( CharSequence , CharSequence... )を使用。
1495                                rtn = String.join( "," , vals ) ;
1496                        }
1497                }
1498
1499                return rtn ;
1500        }
1501
1502        /**
1503         * {&#064;REQ.XXX} で、XXXの リクエストオブジェクトのメソッドの値を取得します。
1504         *
1505         * HttpServletRequest のメソッドを実行します。
1506         * それ以外に、ROWCOUNT というキーワードで、選択された行数を返します。
1507         *
1508         * 通常のリクエストの値以外にRestAPIで利用される場合のあるX-HTTP-Method-Overrideと、
1509         * POSTデータのBodyの値(JSONを変数名を指定せずに送信する場合がある)についても
1510         * 取得できるようにしておきます。
1511         *
1512         * <table class="plain">
1513         *   <caption>{&#064;REQ.XXX}の説明</caption>
1514         *   <tr><th>KEY</th><th>VALUE</th></tr>
1515         *   <tr><td>ROWCOUNT           </td><td style="white-space: normal">チェックされた件数</td></tr>
1516         *   <tr><td>RequestURL         </td><td style="white-space: normal">request.getRequestURL()</td></tr>
1517         *   <tr><td>AuthType           </td><td style="white-space: normal">request.getAuthType()</td></tr>
1518         *   <tr><td>ContextPath        </td><td style="white-space: normal">request.getContextPath()</td></tr>
1519         *   <tr><td>Method             </td><td style="white-space: normal">request.getMethod()</td></tr>
1520         *   <tr><td>PathInfo           </td><td style="white-space: normal">request.getPathInfo()</td></tr>
1521         *   <tr><td>PathTranslated     </td><td style="white-space: normal">request.getPathTranslated()</td></tr>
1522         *   <tr><td>QueryString        </td><td style="white-space: normal">request.getQueryString()</td></tr>
1523         *   <tr><td>RemoteUser         </td><td style="white-space: normal">request.getRemoteUser()</td></tr>
1524         *   <tr><td>RequestURI         </td><td style="white-space: normal">request.getRequestURI()</td></tr>
1525         *   <tr><td>ServletPath        </td><td style="white-space: normal">request.getServletPath()</td></tr>
1526         *   <tr><td>RemoteAddr         </td><td style="white-space: normal">request.getRemoteAddr()</td></tr>
1527         *   <tr><td>RemoteHost         </td><td style="white-space: normal">request.getRemoteHost()</td></tr>
1528         *   <tr><td>Scheme             </td><td style="white-space: normal">request.getScheme()</td></tr>
1529         *   <tr><td>ServerName         </td><td style="white-space: normal">request.getServerName()</td></tr>
1530         *   <tr><td>ServerPort         </td><td style="white-space: normal">request.getServerPort()</td></tr>
1531         *   <tr><td>MethodOverride     </td><td style="white-space: normal">X-HTTP-Method-Override</td></tr>
1532         *   <tr><td>PostData           </td><td style="white-space: normal">request.getInputStream()</td></tr>
1533         *   <tr><td>JSPID              </td><td style="white-space: normal">JSPファイル名</td></tr>
1534         * </table>
1535         *
1536         * @og.rev 6.4.7.0 (2016/06/03) REQ追加
1537         * @og.rev 5.10.10.0 (2019/03/29) MethodOverride追加
1538         * @og.rev 7.0.4.1 (2019/06/10) {&#064;REQ.JSPID}追加
1539         * @og.rev 5.10.10.1 (2019/04/05) BodyData追加
1540         *
1541         * @param    attkey 最後に使われた値を取り出すパラメータ
1542         *
1543         * @return   XXXに対応したリクエストメソッドの実行結果
1544         */
1545        protected String getRequestMethod( final String attkey ) {
1546                if( attkey == null ) { return null; }
1547
1548                final HttpServletRequest req = (HttpServletRequest)pageContext.getRequest();
1549
1550                String rtn = "";
1551
1552                if(      "ROWCOUNT"                     .equalsIgnoreCase( attkey ) ) {
1553                        final String[] vals = req.getParameterValues( HybsSystem.ROW_SEL_KEY );
1554                        rtn = vals == null ? "0" : String.valueOf( vals.length );
1555                }
1556                else if( "RequestURL"           .equalsIgnoreCase( attkey ) ) { rtn = req.getRequestURL().toString();                   }
1557                else if( "AuthType"                     .equalsIgnoreCase( attkey ) ) { rtn = req.getAuthType();                                                }
1558                else if( "ContextPath"          .equalsIgnoreCase( attkey ) ) { rtn = req.getContextPath();                                             }
1559                else if( "Method"                       .equalsIgnoreCase( attkey ) ) { rtn = req.getMethod();                                                  }
1560                else if( "PathInfo"                     .equalsIgnoreCase( attkey ) ) { rtn = req.getPathInfo();                                                }
1561                else if( "PathTranslated"       .equalsIgnoreCase( attkey ) ) { rtn = req.getPathTranslated();                                  }
1562                else if( "QueryString"          .equalsIgnoreCase( attkey ) ) { rtn = req.getQueryString();                                             }
1563                else if( "RemoteUser"           .equalsIgnoreCase( attkey ) ) { rtn = req.getRemoteUser();                                              }
1564                else if( "RequestURI"           .equalsIgnoreCase( attkey ) ) { rtn = req.getRequestURI();                                              }
1565                else if( "ServletPath"          .equalsIgnoreCase( attkey ) ) { rtn = req.getServletPath();                                             }
1566                else if( "RemoteAddr"           .equalsIgnoreCase( attkey ) ) { rtn = req.getRemoteAddr();                                              }
1567                else if( "RemoteHost"           .equalsIgnoreCase( attkey ) ) { rtn = req.getRemoteHost();                                              }
1568                else if( "Scheme"                       .equalsIgnoreCase( attkey ) ) { rtn = req.getScheme();                                                  }
1569                else if( "ServerName"           .equalsIgnoreCase( attkey ) ) { rtn = req.getServerName();                                              }
1570                else if( "ServerPort"           .equalsIgnoreCase( attkey ) ) { rtn = String.valueOf( req.getServerPort() );    }
1571                else if( "MethodOverride"       .equalsIgnoreCase( attkey ) ) { rtn = String.valueOf( req.getHeader("X-HTTP-Method-Override") ); }      //5.10.10.0 (2019/03/29)
1572                else if( "ContentType"          .equalsIgnoreCase( attkey ) ) { rtn = String.valueOf( req.getHeader("Content-Type") ); }                        //5.10.10.1 (2019/04/05)
1573                else if( "PostData"                     .equalsIgnoreCase( attkey ) ) {                                                                                                                                         //5.10.10.1 (2019/04/05)
1574                        try( Scanner sc = new Scanner(req.getInputStream(), "UTF-8").useDelimiter("\\A"); ){
1575                                rtn = sc.hasNext() ? sc.next() : "";
1576                        }catch( final IOException ie ) {
1577                                System.out.println(ie);
1578                                rtn="";
1579                        }
1580                }
1581                // 7.0.4.1 (2019/06/10) {&#064;REQ.JSPID}追加
1582                else if( "JSPID"                        .equalsIgnoreCase( attkey ) ) {
1583                        rtn = req.getRequestURI();
1584                        final int ad = rtn.lastIndexOf( '/' );
1585                        if( ad >= 0 ) {
1586                                rtn = rtn.substring( ad+1 );
1587                        }
1588                }
1589
1590                if( rtn == null ) { rtn = ""; }
1591
1592                return rtn ;
1593        }
1594
1595        /**
1596         * 予約語に関する情報の文字列を取得します。
1597         *
1598         * @og.rev 5.5.4.0 (2012/07/02) 予約語部分のみ分離
1599         * @og.rev 5.6.4.0 (2013/05/02) NVL 追加
1600         * @og.rev 5.6.8.1 (2013/09/13) LAST 追加
1601         * @og.rev 5.8.2.3 (2014/12/27) USEREDIT追加
1602         * @og.rev 6.2.2.4 (2015/04/24) SUM追加
1603         * @og.rev 6.4.7.0 (2016/06/03) REQ追加
1604         * @og.rev 6.5.0.0 (2016/09/30)) VAL追加。value値とリクエスト変数では、リクエスト変数が上位なので、value値を取り出したい場合に使用します。
1605         * @og.rev 6.7.7.0 (2017/03/31) applicationスコープの文字列を取得します。
1606         * @og.rev 6.7.7.2 (2017/04/14) VAL に、&#064; 付きのパラメータを使えるようにします。
1607         * @og.rev 5.9.26.1 (2017/11/10) JSON追加。JSON化するのではなく、JSONタイプのエスケープ処理をする。
1608         * @og.rev 7.0.5.0 (2019/09/09) 追加 ENV.で環境変数の値を取得できるようにします。
1609         * @og.rev 7.2.0.0 (2020/02/14) SUMはValueTagとダブるため、SUMR とします。
1610         * @og.rev 7.2.3.1 (2020/04/17) System.getenv → HybsConst.getenv 変更(サービス化対応) , VALS 追加 , SUBSTR 追加
1611         * @og.rev 7.2.9.1 (2020/10/23) NN 追加、if処理を少しだけ分割します。
1612         * @og.rev 7.4.4.0 (2021/06/30) openGionV8事前準備(DataRole.java廃止)
1613         * @og.rev 8.0.0.0 (2021/09/30) TBL.XXXX を設定します。(TBL.CLMS,TBL.LBLS,TBL.SLBLS,TBL.COLS,TBL.ROWS)
1614         * @og.rev 8.0.0.0 (2021/09/30) REP.XXXX を追加します。
1615         *
1616         * @param    key キー
1617         *
1618         * @return   リクエスト情報の文字列
1619         * @og.rtnNotNull
1620         */
1621        protected String getReservedValue( final String key ) {
1622                if( key == null ) { isReqNull = true; return ""; }              // 3.4.0.3 (2003/09/10)
1623
1624                String rtn = null;
1625                final int adrs = key.indexOf( '.' );
1626
1627                if( adrs > 0 ) {
1628                        final String subKey = key.substring( adrs+1 );
1629                        if( adrs == 2 ) {
1630                                // 4.0.0.0 (2007/06/12) DB.XXXX は、直接取り出すように変更します。
1631                                if( key.startsWith( "DB." ) ) {
1632                                        rtn = (String)getRequestAttribute( key );               // ※ 取り出しは、key で
1633                                }
1634                                // 7.2.9.1 (2020/10/23)  NN 追加
1635                                else if( key.startsWith( "NN." ) ) {
1636                                        rtn = getNNAttri( subKey );
1637                                }
1638                        }
1639                        else if( adrs == 3 ) {
1640                                // 3.8.0.2 (2005/07/11) MSG.XXXX で、メッセージリソースの値を取得できるように追加。
1641                                // 3.8.0.2 (2005/07/11) LBL.XXXX で、ラベルリソースの値を取得できるように追加。
1642                                if( key.startsWith( "LBL." ) ) {
1643                                        rtn = getLabel( subKey );
1644                                }
1645                                else if( key.startsWith( "SYS." ) ) {
1646                                        rtn = sys( subKey );            // 3.5.6.6 (2004/08/23)
1647                                }
1648                                // 3.4.0.3 (2003/09/10) MEM.XXXX で、REQUEST_CACHE の値を取得できるように修正。
1649                                else if( key.startsWith( "MEM." ) ) {
1650                                        // 3.5.4.7 (2004/02/06) getRequestCacheData を使用するように修正
1651                                        rtn = getRequestCacheData( subKey );
1652                                }
1653                                // 5.6.4.0 (2013/05/02) NVL 追加
1654                                else if( key.startsWith( "NVL." ) ) {
1655                                        rtn = getNVLAttri( subKey );
1656                                }
1657                                // 8.0.0.0 (2021/09/30) REP.XXXX を追加します。
1658                                else if( key.startsWith( "REP." ) ) {
1659                                        rtn = getREPAttri( subKey );
1660                                }
1661                                // 6.5.0.0 (2016/09/30)) VAL追加
1662                                else if( key.startsWith( "VAL." ) ) {
1663                                        // 6.7.7.2 (2017/04/14) VAL に、&#064; 付きのパラメータを使えるようにします。
1664                                        if( subKey != null && !subKey.isEmpty() && subKey.charAt(0) == '@' ) {
1665                                                final String tmpKey = getRequestValue( subKey.substring( 1 ) );
1666                                                rtn = (String)getRequestAttribute( tmpKey );
1667                                        }
1668                                        else {
1669                                                rtn = (String)getRequestAttribute( subKey );    // ※ 取り出しは、subKey で
1670                                        }
1671                                }
1672                                // 6.4.7.0 (2016/06/03) REQ追加
1673                                else if( key.startsWith( "REQ." ) ) {
1674                                        rtn = getRequestMethod( subKey );
1675                                }
1676                                else if( key.startsWith( "GUI." ) ) {
1677                                        rtn = getGUIInfoAttri( subKey );        // 4.0.0 (2005/01/31)
1678                                }
1679                                // 6.7.7.0 (2017/03/31) applicationスコープの文字列を取得します。
1680                                else if( key.startsWith( "APP." ) ) {
1681                                        rtn = String.valueOf( getContextAttribute( subKey ) );
1682                                }
1683                                // 4.3.7.0 (2009/06/01) DB関数名の取得
1684                                else if( key.startsWith( "DBF." ) ) {
1685                                        rtn = getDBFunctionName( subKey );
1686                                }
1687                                // 5.5.1.3 (2012/04/09) エスケープ変換
1688                                else if( key.startsWith( "ESC." ) ) {
1689                                        rtn = StringUtil.htmlFilter( getRequestValue(subKey,false) );
1690                                }
1691                                // 4.4.0.0 (2009/08/02) データロールに基づく条件式の取得 7.4.4.0 (2021/06/30) Delete
1692        //                      else if( key.startsWith( "SEC." ) ) {
1693        //                              rtn = getDataCondition( subKey );
1694        //                      }
1695                                // 5.3.9.0 (2011/09/01) URLエンコード変換
1696                                else if( key.startsWith( "URL." ) ) {
1697                                        rtn = StringUtil.urlEncode( getRequestValue( subKey ) );
1698                                }
1699                                // 7.0.5.0 (2019/09/09) 追加 ENV.で環境変数の値を取得できるようにします。
1700                                else if( key.startsWith( "ENV." ) ) {
1701        //                              rtn = System.getenv( subKey );
1702                                        rtn = HybsConst.getenv( subKey );       // 7.2.3.1 (2020/04/17)
1703                                }
1704                                // 8.0.0.0 (2021/09/30) TBL.XXXX は、直接取り出すように変更します。(TBL.CLMS,TBL.LBLS,TBL.SLBLS,TBL.COLS,TBL.ROWS)
1705                                else if( key.startsWith( "TBL." ) ) {
1706                                        rtn = (String)getRequestAttribute( key );               // ※ 取り出しは、key で
1707                                }
1708                        }
1709                        else if( adrs == 4 ) {
1710                                // 3.8.0.2 (2005/07/11) DATE.XXXX で、日付関係の値を取得できるように追加。
1711                                if( key.startsWith( "DATE." ) ) {
1712                                        rtn = getDateFormat( subKey );
1713                                }
1714                                else if( key.startsWith( "USER." ) ) {
1715                                        rtn = getUserInfo( subKey );
1716                                }
1717                                // 5.6.8.1 (2013/09/13) LAST 追加
1718                                else if( key.startsWith( "LAST." ) ) {
1719                                        rtn = getLASTAttri( subKey );
1720                                }
1721                                // 4.3.6.0 (2009/04/01) メールモジュール用の予約語
1722                                else if( key.startsWith( "MAIL." ) ) {
1723                                        rtn = ( String )getSessionAttribute( key );
1724                                }
1725                                // 6.2.2.4 (2015/04/24) SUM追加
1726                                // 7.2.0.0 (2020/02/14) SUMはValueTagとダブるため、SUMR とします。
1727                                // 他に、MIN,MAX,HMF,AVG も、ValueTagで使用中なので注意すること。
1728        //                      else if( key.startsWith( "SUM." ) ) {
1729                                else if( key.startsWith( "SUMR." ) ) {
1730                                        rtn = getSumRequestValue( subKey );
1731                                }
1732                                // 5.9.26.1 (2017/11/10) 追加 JSONタイプのエスケープを行う(JSONにするわけではない)
1733                                else if( key.startsWith( "JSON." ) ) {
1734                                        rtn = StringUtil.jsonFilter( getRequestValue(subKey) );
1735                                }
1736                                // 7.2.3.1 (2020/04/17) VALS 追加
1737                                else if( key.startsWith( "VALS." ) ) {
1738                                        rtn = getValsAttri( subKey );
1739                                }
1740                                // 3.8.0.1 (2005/06/17) NVAR.XXXX で、getUnicodeEscape 変換() を行います。
1741                                // NVAR. を取り除いた XXXX で再度、リクエスト値を取得し、それを Escape変換します。
1742                                else if( key.startsWith( "NVAR." ) ) {
1743                                        rtn = StringUtil.getUnicodeEscape( getRequestValue( subKey ) );
1744                                }
1745                        }
1746                        else if( adrs > 5 ) {
1747                                // 7.2.3.1 (2020/04/17) SUBSTR 追加
1748                                if( key.startsWith( "SUBSTR." ) ) {
1749                                        rtn = getSubstrAttri( subKey );
1750                                }
1751                                else if( key.startsWith( "USEREDIT." ) ) {
1752                                        rtn = getUserEditInfo( subKey );        // 5.8.2.3 (2014/12/27)
1753                                }
1754                                else if( key.startsWith( "SESSION." ) ) {               // 3.5.5.3 (2004/04/09)
1755                                        rtn = String.valueOf( getSessionAttribute( subKey ) );
1756                                }
1757                        }
1758                        // 7.2.9.1 (2020/10/23) 処理されなかった場合は、そのままキーとして使用する。
1759                        if( rtn == null ) {
1760                                rtn = (String)getRequestAttribute( key );               // ※ 取り出しは、key で
1761                        }
1762//                      // 6.3.5.0 (2015/08/08) CHART.TAG は、直接取り出すように変更します。
1763//                      else { // 4.0.0.0 (2007/11/16)
1764//                              rtn = (String)getRequestAttribute( key );               // ※ 取り出しは、key で
1765//                      }
1766                }
1767                else{
1768                        rtn = "{@" + key + "}"; // 予約語以外は括弧を付けて書き戻します。
1769                }
1770                return rtn;
1771        }
1772
1773        /**
1774         * リクエスト情報の文字列を取得します。
1775         *
1776         * @og.rev 5.0.0.2 (2009/09/15) XSS対策
1777         *
1778         * @param    key キー
1779         *
1780         * @return   リクエスト情報の文字列
1781         */
1782        protected String getRequestValue( final String key ) {
1783                return getRequestValue( key, xssCheck);
1784        }
1785
1786        /**
1787         * リクエスト情報の文字列を取得します。
1788         *
1789         * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 エンコードの取得方法変更
1790         * @og.rev 3.0.0.0 (2002/12/25) StringUtil#changeString 廃止
1791         * @og.rev 3.0.0.0 (2002/12/25) ValueTag追加の為、指定の scope の Attributeより取得
1792         * @og.rev 3.1.0.1 (2003/03/26) Valueタグの値と、request情報の値の所得優先順位を、request が優先されるように変更。
1793         * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。HybsRequestWrapper 廃止。直接 Mapでキャッシュする。
1794         * @og.rev 3.1.5.0 (2003/04/22) SYS.XXXX で、システムパラメータ の値を取得できるように修正。
1795         * @og.rev 3.1.7.0 (2003/05/02) リクエスト情報の取得順序を、Request、キャッシュ、Value の順に変更。
1796         * @og.rev 3.1.7.0 (2003/05/02) value値の使用可否を指定する、useValue 属性を追加。
1797         * @og.rev 3.4.0.3 (2003/09/10) MEM.XXXX で、REQUEST_CACHE の値を取得できるように修正。
1798         * @og.rev 3.5.4.7 (2004/02/06) getRequestCacheData を使用するように修正
1799         * @og.rev 3.5.5.3 (2004/04/09) {&#064;SESSION.XXXX} で、session.getAttribute( "XXXX" ) の値を取得するように修正
1800         * @og.rev 3.5.6.6 (2004/08/23) SYS.XXXX の処理を getSystemParameter( String key ) メソッドへ移動
1801         * @og.rev 3.8.0.1 (2005/06/17) NVAR.XXXX で、getUnicodeEscape 変換() を行います。
1802         * @og.rev 3.8.0.2 (2005/07/11) MSG.XXXX , LBL.XXXX の処理を追加
1803         * @og.rev 3.8.0.2 (2005/07/11) チェックボックス対応で、重複リクエストに対応させます。
1804         * @og.rev 3.8.8.8 (2007/05/11) 重複リクエスト処理の場所を移動。リクエストのみ対象とする。
1805         * @og.rev 4.0.0.0 (2005/08/31) quotCheck によるSQLインジェクション対策
1806         * @og.rev 4.0.0.0 (2005/08/31) getSystemParameter を sys に名称変更
1807         * @og.rev 4.0.0.0 (2007/04/02) Valueタグの値と、キャッシュでは、Valueタグの値を優先するように変更
1808         * @og.rev 4.0.0.0 (2007/11/16) "."付きのパラメータのエラー処理をなくし、getRequestAttributeで取得する。
1809         * @og.rev 4.3.0.0 (2008/07/04) DB.XXXX は、必ずStringオブジェクトとし、String.valueOf しない。
1810         * @og.rev 4.3.6.0 (2009/04/01) メールモジュール用の予約語MAIL.XXXXの取得対応
1811         * @og.rev 4.4.0.0 (2009/08/02) データロール対応(SEC.xxxの取得対応)
1812         * @og.rev 5.0.0.2 (2009/09/15) XSS対策用にメソッドにフラグを追加
1813         * @og.rev 5.1.8.0 (2010/07/01) isNullSet 属性 廃止にともなう、useValue 属性廃止
1814         * @og.rev 5.3.9.0 (2011/09/01) URL.XXXX処理を追加
1815         * @og.rev 5.5.1.3 (2012/04/09) ESC.XXXX処理を追加
1816         * @og.rev 5.5.4.0 (2012/07/01) 予約語の処理を分離
1817         * @og.rev 5.7.4.2 (2014/03/20) サニタイズ処理は、getSanitizedBodyString() ではなく、ここで行います。
1818         * @og.rev 5.9.25.2 (2017/10/27) xssCheck及びquotCheckのエラーメッセージをラベルリソース化
1819         *
1820         * @param       key     キー
1821         * @param       xssCheckFlg     XSS対策用[true:行う/false:行わない]
1822         *
1823         * @return   リクエスト情報の文字列
1824         * @og.rtnNotNull
1825         */
1826        protected String getRequestValue( final String key, final boolean xssCheckFlg ) {
1827                if( key == null ) { isReqNull = true; return ""; }              // 3.4.0.3 (2003/09/10)
1828
1829                String rtn ;
1830                final int adrs = key.indexOf( '.' );
1831
1832                if( adrs > 0 ) {
1833                        rtn = getReservedValue( key ); // 5.5.4.0 (2012/07/02)
1834                }
1835                else {
1836                        rtn = getRequest().getParameter( key );
1837
1838                        // 5.7.4.2 (2014/03/20) サニタイズ処理は、getSanitizedBodyString() ではなく、ここで行います。
1839                        // 6.0.0.1 (2014/04/25) These nested if statements could be combined
1840                        if( isSanitized && rtn != null && rtn.indexOf( '[' ) >= 0 ) {
1841                                rtn = rtn.replace( "[", "\\]\\" );
1842                        }
1843
1844                        // 5.0.0.2 (2009/09/15) tagCheck によるthan signチェック Parameterのみにかけるためこの位置
1845                        if( rtn != null && rtn.length() > 0 && xssCheckFlg && ( rtn.indexOf( '<' ) >= 0 || rtn.indexOf( '>' ) >= 0 ) ) {
1846
1847                                // 5.9.25.2 (2017/10/27)
1848                                getResource();
1849                                final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE )
1850                                        .append( resource.getLabel( "ERR0048.1" ) ).append( CR )
1851                                        .append( resource.getLabel( "ERR0048.2",new String[] { key,rtn,getTagName() } ) ).append( CR );
1852
1853                                throw new HybsSystemException( buf.toString() );
1854                        }
1855
1856                        // 3.8.8.8 (2007/05/11) 重複リクエスト処理の場所を移動。リクエストのみ対象とする。
1857                        // 3.8.0.2 (2005/07/11) チェックボックス対応で、重複リクエストに対応させます。
1858                        // {@XXXX} で、値が"0"の場合、複数リクエストを確認して、"1"が含まれていれば、"1"とします。
1859                        if( "0".equals(rtn) ) {
1860                                final boolean backFlag = isReqNull ;
1861                                final String[] vals = getRequestValues( key );
1862                                if( vals != null && vals.length > 1 ) {
1863                                        for( int i=0; i<vals.length; i++ ) {
1864                                                if( "1".equals( vals[i] ) ) { rtn = "1"; break; }
1865                                        }
1866                                }
1867                                isReqNull = backFlag;   // 3.8.8.8 (2007/05/11) getRequestValues での NULLセット解除
1868                        }
1869
1870                        // 3.1.0.1 (2003/03/26) Valueタグの値と、request情報の値の取得優先順位を、
1871                        // request が優先されるように変更。
1872                        if( ( rtn == null || rtn.isEmpty() ) && requestCache != null ) {
1873                                final String[] str = requestCache.get( key );
1874                                if( str != null && str.length > 0 ) {
1875                                        rtn = str[0];
1876                                }
1877                        }
1878                        // 5.1.8.0 (2010/07/01) isNullSet 属性 廃止にともなう、useValue 属性廃止
1879                        if( rtn == null || rtn.isEmpty() ) {
1880                                final Object obj = pageContext.findAttribute( key );
1881                                if( obj != null ) {
1882                                        rtn = obj.toString();
1883                                }
1884                        }
1885                }
1886                if( rtn == null || rtn.isEmpty() ) {
1887                        isReqNull = true;
1888                        rtn    = "";
1889                }
1890                // 4.0.0 (2005/08/31) quotCheck によるSQLインジェクション対策
1891//              else if( quotCheck && rtn.indexOf( '\'' ) >= 0 && !key.startsWith( "SEC." ) ) {         // 6.0.2.5 (2014/10/31) refactoring
1892                else if( quotCheck && rtn.indexOf( '\'' ) >= 0 && !key.startsWith( "REP." ) ) {         // 7.4.4.0 (2021/06/30) Delete SEC." 廃止
1893
1894                        // 5.9.25.2 (2017/10/27)
1895                        getResource();
1896                        final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE )
1897                                .append( resource.getLabel( "ERR0049.1" ) ).append( CR )
1898                                .append( resource.getLabel( "ERR0049.2",new String[] { key,rtn,getTagName() } ) ).append( CR );
1899
1900                        throw new HybsSystemException( buf.toString() );
1901                }
1902
1903                return rtn ;
1904        }
1905
1906        /**
1907         * リクエスト情報の文字列を取得します。
1908         *
1909         * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 エンコードの取得方法変更
1910         * @og.rev 3.0.0.0 (2002/12/25) StringUtil#changeString 廃止
1911         * @og.rev 3.1.8.0 (2003/05/16) RequestCache データをリクエスト配列情報にも適用する。
1912         * @og.rev 5.3.8.0 (2011/08/01) Attribute等からも値が取得できるようにする。
1913         *
1914         * @param    key キー
1915         *
1916         * @return   リクエスト情報の文字列
1917         */
1918        protected String[] getRequestValues( final String key ) {
1919                String[] rtn = getRequest().getParameterValues( key );
1920
1921                // 3.1.8.0 (2003/05/16) RequestCache データをリクエスト配列情報にも適用する。
1922                if( ( rtn == null || rtn.length == 0 ) && requestCache != null ) {
1923                        rtn =requestCache.get( key );
1924                }
1925
1926                // 5.3.8.0 (2011/08/01) Attribute等からも値が取得できるようにする。
1927                if( rtn == null || rtn.length == 0 ) {
1928                        final String tmp = getRequestValue( key );
1929                        if( tmp != null && tmp.length() > 0 ) {
1930                                rtn = new String[]{ tmp };
1931                        }
1932                }
1933
1934                if( rtn == null || rtn.length == 0 ) { isReqNull = true; }
1935                return rtn ;
1936        }
1937
1938        /**
1939         * リクエスト情報の文字列のキー集合を取得します。
1940         *
1941         * @og.rev 5.3.2.0 (2011/02/01) パラメーターの外部指定対応
1942         *
1943         * @return   リクエスト情報の文字列のキー集合
1944         */
1945        protected Enumeration<?> getParameterNames() {          // 4.3.3.6 (2008/11/15) Generics警告対応
1946                final String[] names = (String[])getRequestAttribute( HybsSystem.PARAM_NAMES_KEY );
1947                return names == null ? getRequest().getParameterNames() : Collections.enumeration( Arrays.asList( names ) ) ;
1948        }
1949
1950        /**
1951         * リクエスト情報の文字列のキー集合をセットします。
1952         *
1953         * @og.rev 5.3.2.0 (2011/02/01) パラメーターの外部指定対応
1954         *
1955         * @param names リクエスト情報の文字列のキー配列(可変長引数)
1956         */
1957        protected void setParameterNames( final String... names ) {
1958                setRequestAttribute( HybsSystem.PARAM_NAMES_KEY, names );
1959        }
1960
1961        /**
1962         * リクエスト情報の文字列に NULL が存在していたかどうかを取得します。
1963         *
1964         * これは、getRequestParameter( String ) の呼出し毎に設定されます。
1965         * つまり、上記メソッドの実行直後の値を取り出す必要があります。
1966         * NULL が含まれていた(true)/含まれていなかった。(false)
1967         *
1968         * @return      NULLが含まれていた(true)/含まれていなかった。(false)
1969         */
1970        protected boolean isNull() {
1971                return isReqNull;
1972        }
1973
1974        /**
1975         * セッションに登録されているオブジェクトを取得します。
1976         *
1977         * @param   key キー
1978         *
1979         * @return   セッションに登録されているオブジェクト
1980         */
1981        protected Object getSessionAttribute( final String key ) {
1982                if( session == null ) { session = pageContext.getSession(); }
1983                return session.getAttribute( key );
1984        }
1985
1986        /**
1987         * セッションに 指定のキーでオブジェクトをセットします。
1988         *
1989         * @param   key キー
1990         * @param   object セッションに登録するオブジェクト
1991         */
1992        protected void setSessionAttribute( final String key ,final Object object ) {
1993                if( session == null ) { session = pageContext.getSession(); }
1994                session.setAttribute( key,object );
1995        }
1996
1997        /**
1998         * セッションに指定のキーで登録されているオブジェクトを 削除します。
1999         *
2000         * @param   key キー
2001         */
2002        protected void removeSessionAttribute( final String key ) {
2003                if( session == null ) { session = pageContext.getSession(); }
2004                session.removeAttribute( key );
2005        }
2006
2007        /**
2008         * リクエストに登録されているオブジェクトを取得します。
2009         *
2010         * @param   key キー
2011         *
2012         * @return   リクエストンに登録されているオブジェクト
2013         */
2014        protected Object getRequestAttribute( final String key ) {
2015                return getRequest().getAttribute( key );
2016        }
2017
2018        /**
2019         * リクエストに 指定のキーでオブジェクトをセットします。
2020         *
2021         * @param   key キー
2022         * @param   object リクエストに登録するオブジェクト
2023         */
2024        protected void setRequestAttribute( final String key ,final Object object ) {
2025                getRequest().setAttribute( key,object );
2026        }
2027
2028        /**
2029         * リクエストに指定のキーで登録されているオブジェクトを 削除します。
2030         *
2031         * @param   key キー
2032         */
2033        protected void removeRequestAttribute( final String key ) {
2034                getRequest().removeAttribute( key );
2035        }
2036
2037        /**
2038         * コンテキスト(application)に登録されているオブジェクトを取得します。
2039         *
2040         * scope属性に、"application" が指定された場合に、実行されます。
2041         *
2042         * @og.rev 3.0.0.0 (2002/12/25) scope="application" 指定の追加
2043         *
2044         * @param   key キー
2045         *
2046         * @return   コンテキスト(application)に登録されているオブジェクト
2047         */
2048        protected Object getContextAttribute( final String key ) {
2049                final ServletContext application = pageContext.getServletContext();
2050                return application.getAttribute( key );
2051        }
2052
2053        /**
2054         * コンテキスト(application)指定のキーでオブジェクトをセットします。
2055         *
2056         * scope属性に、"application" が指定された場合に、実行されます。
2057         *
2058         * @og.rev 3.0.0.0 (2002/12/25) scope="application" 指定の追加
2059         *
2060         * @param   key キー
2061         * @param   object コンテキスト(application)に登録するオブジェクト
2062         */
2063        protected void setContextAttribute( final String key ,final Object object ) {
2064                final ServletContext application = pageContext.getServletContext();
2065                application.setAttribute( key,object );
2066        }
2067
2068        /**
2069         * コンテキスト(application)指定のキーで登録されているオブジェクトを 削除します。
2070         *
2071         * scope属性に、"application" が指定された場合に、実行されます。
2072         *
2073         * @og.rev 3.0.0.0 (2002/12/25) scope="application" 指定の追加
2074         *
2075         * @param   key キー
2076         */
2077        protected void removeContextAttribute( final String key ) {
2078                final ServletContext application = pageContext.getServletContext();
2079                application.removeAttribute( key );
2080        }
2081
2082        /**
2083         * アプリケーションサーバーのコンテキストパスのURLを返します。
2084         *
2085         * @return   コンテキストパス
2086         */
2087        protected String getContextPath() {
2088                return ((HttpServletRequest)getRequest()).getContextPath();
2089        }
2090
2091        /**
2092         * スコープに応じて登録されているオブジェクトを取得します。
2093         *
2094         * @og.rev 3.0.0.0 (2002/12/25) scope="application" 指定の追加
2095         * @og.rev 6.7.7.0 (2017/03/31) scope="application" つづり間違い訂正
2096         *
2097         * @param   key キー
2098         *
2099         * @return   スコープに応じて登録されているオブジェクト
2100         */
2101        protected Object getObject( final String key ) {
2102                if(      "session".equals( scope )              ) { return getSessionAttribute( key ); }
2103                else if( "request".equals( scope )              ) { return getRequestAttribute( key ); }
2104                else if( "application".equals( scope )  ) { return getContextAttribute( key ); }                // 6.7.7.0 (2017/03/31)
2105                else {
2106                        final String errMsg = "このスコープはサポートされていません。[" + scope + "]";
2107                        throw new IllegalArgumentException( errMsg );
2108                }
2109        }
2110
2111        /**
2112         * スコープに応じて登録されているオブジェクトを指定のキーでセットします。
2113         *
2114         * @og.rev 3.0.0.0 (2002/12/25) scope="application" 指定の追加
2115         *
2116         * @param   key キー
2117         * @param   object リクエストに登録するオブジェクト
2118         * @see     #setObject( String ,Object ,String )
2119         */
2120        protected void setObject( final String key ,final Object object ) {
2121                setObject( key,object,scope );
2122        }
2123
2124        /**
2125         * スコープに応じて登録されているオブジェクトを指定のキーでセットします。
2126         *
2127         * 引数にスコープを指定します。スコープが null の場合は、オリジナルの
2128         * スコープを使用します。
2129         *
2130         * @og.rev 5.2.2.0 (2010/11/01) 新規追加
2131         * @og.rev 6.7.7.0 (2017/03/31) scope="application" つづり間違い訂正
2132         *
2133         * @param   key キー
2134         * @param   object リクエストに登録するオブジェクト
2135         * @param   scp スコープ
2136         * @see     #setObject( String ,Object )
2137         */
2138        protected void setObject( final String key ,final Object object ,final String scp ) {
2139                final String inScp = (scp == null) ? scope : scp ;
2140
2141                if(      "session".equals( inScp        ) ) { setSessionAttribute( key,object ); }
2142                else if( "request".equals( inScp        ) ) { setRequestAttribute( key,object ); }
2143                else if( "application".equals( inScp ) ) { setContextAttribute( key,object ); }         // 6.7.7.0 (2017/03/31)
2144                else {
2145                        final String errMsg = "このスコープはサポートされていません。[" + inScp + "]";
2146                        throw new IllegalArgumentException( errMsg );
2147                }
2148        }
2149
2150        /**
2151         * スコープに応じて登録されているオブジェクトを指定のキーで削除します。
2152         *
2153         * @og.rev 3.0.0.0 (2002/12/25) scope="application" 指定の追加
2154         * @og.rev 6.7.7.0 (2017/03/31) scope="application" つづり間違い訂正
2155         *
2156         * @param   key キー
2157         */
2158        protected void removeObject( final String key ) {
2159                if( "session".equals( scope ) ) { removeSessionAttribute( key ); }
2160                else if( "request".equals( scope ) ) { removeRequestAttribute( key ); }
2161                else if( "application".equals( scope ) ) { removeContextAttribute( key ); }             // 6.7.7.0 (2017/03/31)
2162                else {
2163                        final String errMsg = "このスコープはサポートされていません。[" + scope + "]";
2164                        throw new IllegalArgumentException( errMsg );
2165                }
2166        }
2167
2168        /**
2169         * リクエストオブジェクトを取得します。
2170         *
2171         * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 エンコードの取得方法変更
2172         * @og.rev 2.2.0.0 (2002/12/17) 文字化け対策 setCharacterEncoding が効いていないので削除
2173         * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。HybsRequestWrapper 廃止。直接 Mapでキャッシュする。
2174         * @og.rev 3.4.0.3 (2003/09/10) 冗長な個所や、無意味な個所を、等価な内容のロジックに置き換える。
2175         * @og.rev 3.5.5.0 (2004/03/12) command=RESET 時にも、キャッシュを取り出すように変更します。
2176         *
2177         * @return   リクエストオブジェクト
2178         */
2179        @SuppressWarnings(value={"unchecked"})
2180        protected ServletRequest getRequest() {
2181                if( request == null ) {
2182                        request = pageContext.getRequest();
2183                        // リクエストキャッシュ機能
2184                        final String cmd =request.getParameter( "command" );
2185                        if( "RENEW".equals( cmd ) || "RESET".equals( cmd ) ) {  // 3.5.5.0
2186                                requestCache = (Map<String,String[]>)getSessionAttribute( HybsSystem.REQ_CACHE_KEY );
2187                        }
2188                }
2189                return request;
2190        }
2191
2192        /**
2193         * BodyContent オブジェクトを取得して、ボディの内容を取得します。
2194         *
2195         * 処理としては、getRequestParameter() によるパラメータ処理も含みます。
2196         * このメソッドは、必ず doAfterBody() から呼び出してください。それ以外(例えば、
2197         * doEndTag()等)では、すでに Body情報が破棄/再利用されている可能性があり、
2198         * 正常に動作しなくなる可能性があります。
2199         *
2200         * @og.rev 3.1.1.0 (2003/03/28) BodyContent オブジェクトを取得して、ボディの内容を取得する処理を追加
2201         * @og.rev 6.3.1.1 (2015/07/10) BodyString,BodyRawStringは、CommonTagSupport で、trim() します。
2202         *
2203         * @return   ボディ文字列
2204         */
2205        protected String getBodyString() {
2206                final BodyContent body = getBodyContent();
2207                return getRequestParameter( body.getString().trim() );          // 6.3.1.1 (2015/07/10)
2208        }
2209
2210        /**
2211         * BodyContent オブジェクトを取得して、ボディの内容を取得します。
2212         *
2213         * {&#064;XXXX}を変換しない生のBODY文を返します
2214         *
2215         * @og.rev 4.3.6.0 (2009/04/01) 新規作成
2216         * @og.rev 6.3.1.1 (2015/07/10) BodyString,BodyRawStringは、CommonTagSupport で、trim() します。
2217         *
2218         * @return   ボディ文字列
2219         */
2220        protected String getBodyRawString() {
2221                final BodyContent body = getBodyContent();
2222                return body.getString().trim();         // 6.3.1.1 (2015/07/10)
2223        }
2224
2225        /**
2226         * BodyContent オブジェクトを取得して、ボディの内容を取得します。
2227         *
2228         * {&#064;XXXX}の変換を行いますが、その変換結果に、"["が含まれる場合は、
2229         * "\\]\\"に変換して、フォーマット処理されないようにサニタイズします。
2230         *
2231         * @og.rev 5.1.7.0 (2010/06/01) 新規作成
2232         * @og.rev 5.7.4.2 (2014/03/20) サニタイズ処理を、標準の処理で行う。
2233         *
2234         * @return   ボディ文字列
2235         */
2236        protected String getSanitizedBodyString() {
2237                isSanitized = true;
2238                final String rtn = getBodyString();
2239                isSanitized = false;                            // 一連の処理の中だけ、有効とします。
2240
2241                return rtn;
2242        }
2243
2244        /**
2245         * JspWriter を使用した画面出力です。
2246         *
2247         * @param msg 画面に出力する文字列
2248         */
2249        protected void jspPrint( final String msg ) {
2250                if( msg == null ) { return ; }
2251                try {
2252                        final JspWriter out = pageContext.getOut();
2253                        out.print( msg );
2254                } catch( final IOException ex ) {
2255                        final String errMsg = "画面出力時の PageContext の取得時にエラーが発生しました。"
2256                                                        + ex.getMessage();                              // 5.1.8.0 (2010/07/01) errMsg 修正
2257                        throw new HybsSystemException( errMsg,ex );             // 3.5.5.4 (2004/04/15) 引数の並び順変更
2258                }
2259        }
2260
2261        /**
2262         * デバッグ用の文字列を JspWriter を使用して画面に出力します。
2263         * このメソッドは、debugFlag=true の場合のみ動作します。
2264         *
2265         * 出力内容は,各オブジェクトの toString() 文字列です。
2266         *
2267         * @og.rev 4.0.0.0 (2005/02/28) debugFlag の条件式を追加。
2268         * @og.rev 4.0.0.0 (2005/02/28) 簡易リファレンスへのリンクを追加。
2269         */
2270        protected void debugPrint() {
2271                if( debugFlag ) {
2272                        try {
2273                                final JspWriter out = pageContext.getOut();
2274                                out.println( getDocumentLink() );               // 4.0.0 (2005/02/28)
2275                                out.println( "<pre>" );
2276                                out.println( toString() );
2277                                out.println( "</pre>" );
2278                        } catch( final IOException ex ) {
2279                                final String errMsg = "デバッグ画面出力時の PageContext の取得時にエラーが発生しました。"
2280                                                        + ex.getMessage();                      // 5.1.8.0 (2010/07/01) errMsg 修正
2281                                throw new HybsSystemException( errMsg,ex );             // 3.5.5.4 (2004/04/15) 引数の並び順変更
2282                        }
2283                }
2284        }
2285
2286        /**
2287         * GAMENID付のリクエストキャッシュ情報を取り出します。
2288         *
2289         * @og.rev 3.5.4.7 (2004/02/06) 新規作成
2290         *
2291         * @param key リクエストキャッシュのキー情報
2292         *
2293         * @return リクエスト情報(存在しない場合は、null)
2294         */
2295        protected String getRequestCacheData( final String key ) {
2296                String rtn = null;
2297
2298                final String memKey = HybsSystem.REQ_CACHE_KEY + getGUIInfoAttri( "KEY" );      // 4.0.0 (2005/01/31)
2299                final Map<?,?> mem = (Map<?,?>)getSessionAttribute( memKey );           // 4.3.3.6 (2008/11/15) Generics警告対応
2300
2301                if( mem != null ) {
2302                        final String[] vals = (String[])mem.get( key );
2303                        if( vals != null && vals.length > 0 ) {
2304                                rtn = vals[0];
2305                        }
2306                }
2307                return rtn ;
2308        }
2309
2310        /**
2311         * GAMENID付のリクエストキャッシュ情報を取り出します。
2312         *
2313         * @og.rev 3.5.4.7 (2004/02/06) 新規作成
2314         *
2315         * @param key  リクエストキャッシュのキー情報
2316         * @param value リクエストキャッシュに登録する値
2317         */
2318        @SuppressWarnings(value={"unchecked"})
2319        protected void setRequestCacheData( final String key,final String value ) {
2320                final String[] vals = new String[] { value } ;
2321
2322                final String memKey = HybsSystem.REQ_CACHE_KEY + getGUIInfoAttri( "KEY" );      // 4.0.0 (2005/01/31)
2323                final Map<String,String[]> mem = (Map<String,String[]>)getSessionAttribute( memKey );
2324                if( mem != null ) {
2325                        mem.put( key,vals );
2326                }
2327        }
2328
2329        /**
2330         * CSV形式引数(CSV引数)を配列に分解して返します。
2331         *
2332         * CSV形式引数(CSV引数)で複数指定されたリクエストパラメータを
2333         * 文字列配列に分解して、返します。
2334         * 引数は、{&#064;XXXX} 変数も使用できます。
2335         * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
2336         * こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。
2337         *
2338         * @og.rev 3.5.6.2 (2004/07/05) 新規作成
2339         *
2340         * @param       csvKey 引数(CSV形式)
2341         *
2342         * @return      配列に分解されたリクエストパラメータ値
2343         */
2344        protected String[] getCSVParameter( final String csvKey ) {
2345                final String[] keys = StringUtil.csv2Array( csvKey );           // ダブルクオート内は分解しない。
2346                String[] vals = new String[keys.length];
2347                for( int i=0; i<keys.length; i++ ) {
2348                        vals[i] = getRequestParameter( keys[i] ) ;
2349                }
2350                return vals ;
2351        }
2352
2353        /**
2354         * CSV形式のkeys,vals引数(CSV引数)を配列に分解して返します。
2355         *
2356         * CSV形式引数(CSV引数)で複数指定されたリクエストパラメータを
2357         * 文字列配列に分解して、返します。
2358         * 引数は、{&#064;XXXX} 変数も使用できます。
2359         * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
2360         * こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。
2361         *
2362         * ※ これは、keys,vals を同時に処理します。keys を分解後、カンマがあれば、
2363         *    vals も 再度、CSV分解します。
2364         *
2365         * @og.rev 6.2.5.1 (2015/06/12) CSV形式のkeys,vals引数(CSV引数)対応。新規作成。
2366         *
2367         * @param       csvKey 引数(CSV形式)
2368         * @param       csvVal 引数(CSV形式)
2369         *
2370         * @return      Mapにセットされたリクエストパラメータ値
2371         * @see         #getCSVParameter( String )
2372         */
2373        protected Map<String,String> getCSVParameter( final String csvKey , final String csvVal ) {
2374                final String[] keys = StringUtil.csv2Array( csvKey );           // ダブルクオート内は分解しない。
2375                final String[] vals = StringUtil.csv2Array( csvVal );           // ダブルクオート内は分解しない。
2376
2377                if( keys.length != vals.length ) {
2378                        final String errMsg = "キーとバリューの個数が異なります。" + CR
2379                                                + " keys.length=[" + keys.length + "]  vals.length=[" + vals.length + "]" + CR
2380                                                + " keys=" + csvKey  + CR
2381                                                + " vals=" + csvVal ;
2382                        throw new HybsSystemException( errMsg );
2383                }
2384
2385                final Map<String,String> kvMap = new LinkedHashMap<>();                 // keys,valsの登録順は残しておきます。
2386
2387                for( int i=0; i<keys.length; i++ ) {
2388                        final String key1 = getRequestParameter( keys[i] ) ;            // ※ rtnNotNull
2389                        String val1 = getRequestParameter( vals[i] ) ;
2390                        if( key1.isEmpty() ) { continue; }                                                      // キーに関しては、何か値が必要。
2391
2392                        if( key1.contains( "," ) ) {                                                            // キーにカンマが含まれるとき
2393                                final String[] keys2 = StringUtil.csv2Array( key1 );
2394                                final String[] vals2 = StringUtil.csv2Array( val1 );
2395
2396                                // keys 分解の個別の個数チェック
2397                                if( keys2.length != vals2.length ) {
2398                                        final String errMsg = "部分キーと部分バリューの個数が異なります。" + CR
2399                                                                + " keys2.length=[" + keys2.length + "]  vals2.length=[" + vals2.length + "]" + CR
2400                                                                + " orgKey=" + csvKey  + CR
2401                                                                + " orgVal=" + csvVal  + CR
2402                                                                + " keys2=" + key1 + CR
2403                                                                + " vals2=" + val1 ;
2404                                        throw new HybsSystemException( errMsg );
2405                                }
2406
2407                                for( int j=0; j<keys2.length; j++ ) {
2408                                        if( keys2[j] != null && !keys2[j].isEmpty() && vals2[j] != null ) {
2409                                                kvMap.put( keys2[j] , vals2[j] );
2410                                        }
2411                                }
2412                        }
2413                        else {
2414                                // val にカンマが含まれる場合は、前後に、ダブルクオートを追加する。
2415                                if( val1.contains( "," ) ) { val1 = '"' + val1 + '"' ; }
2416                                kvMap.put( key1 , val1 );
2417                        }
2418                }
2419
2420                return kvMap ;
2421        }
2422
2423        /**
2424         * システム変数 {&#064;SYS.XXXX} に対する値の取得を行います。
2425         *
2426         * 本来は、システムパラメータ の値を取得できますが、
2427         * システム的な共有値も取得できるように機能追加しています。
2428         * また、ユーザー個別にシステムパラメータを変更できます。この取得は、
2429         * システムパラメータとして取得します。(値はユーザー個別値を返します。)
2430         * ここで、引数に、&#064;変数が使用できます。具体的には、{&#064;SYS.&#064;XXXX}
2431         * で、&#064;XXXX をリクエスト変数から取得した値を利用します。
2432         * この中で、&#064;GUIID だけが、さらに特殊で、実行中の画面IDを割り当てます。
2433         * この &#064;GUIID は、ここまでの文字列を画面IDに置き換えるとともに、それ以降の
2434         * 文字列を、画面IDに連結させます。
2435         * {&#064;SYS.&#064;GUIID_XXXX} ⇒ 画面ID_XXXX 文字列で、システムパラメータ の値を取得します。
2436         *
2437         *      SERVER_NAME     このTomcatが実行しているサーバー名             localhost 等
2438         *      SERVER_URL      Portも含むURLアドレス                          http://localhost:8823/
2439         *      CONTEXT_URL     実行しているコンテキストのURLアドレス          http://localhost:8823/dbdef2/
2440         *      REAL_PATH       / ルートに対応する物理ディレクトリ             d:/webapps/dbdef2/ 等
2441         *      CONTEXT_NAME    コンテキスト名(webapps 直下の仮想フォルダ名)   dbdef 等
2442         *      COOKIE          クッキー取得
2443         *      DATE            YMDH とほぼ同じですが、'yyyy/MM/dd HH:mm:ss' の形式で取得できます。
2444         *      HOSTNAME        IPドレス スペース区切りで指定したIPアドレスからホスト名を逆引きします(5.6.6.2 (2013/07/19))
2445         *      任意            システムパラメータ(GE12)の値を取得
2446         *        &#064;GUIID_XXXX  既存の画面IDに、_XXXX を追加した文字列
2447         *        &#064;XXXX        XXXX でリクエスト変数から取得した文字列
2448         *        XXXX              XXXX の文字列
2449         *      PRINTER         サーバーのプリンター一覧(6.2.6.0 (2015/06/19))
2450         *
2451         * @og.rev 3.5.6.6 (2004/08/23) 新規作成
2452         * @og.rev 3.7.0.3 (2005/03/01) クッキー取得機能を追加
2453         * @og.rev 4.0.0.0 (2005/11/30) ユーザーパラメータは、システムパラメータとして取得します。
2454         * @og.rev 5.1.6.0 (2010/05/01) システムパラメータに、&#064;GUIID という特殊パラメータが使用できるように対応します。
2455         * @og.rev 5.6.6.2 (2013/07/19) SYS.HOSTNAMEに対応します。
2456         * @og.rev 6.2.6.0 (2015/06/19) PRINTERに対応します。
2457         * @og.rev 6.4.2.0 (2016/01/29) DateSet.getDate( String ) を利用するように修正します。
2458         * @og.rev 6.9.5.0 (2018/04/23) うまく動いていないようなので、廃止
2459         *
2460         * @param       key     {&#064;SYS.XXXX}のXXXX部分の文字列(キー)
2461         *
2462         * @return   キーに対する値。なければ、null
2463         */
2464        protected String sys( final String key ) {
2465                final String rtn;
2466
2467                if( key.startsWith( "COOKIE." ) ) {             // 3.7.0.3 (2005/03/01)
2468                        rtn = getCookie( key.substring( "COOKIE.".length() ) );
2469                }
2470                else if( key.startsWith( "DATE" ) ) {
2471                        final int idx = key.indexOf( ' ' );
2472                        if( idx >= 0 ) {
2473                                rtn = DateSet.getDate( key.substring( idx+1 ) );                                // 6.4.2.0 (2016/01/29)
2474                        }
2475                        else {
2476                                rtn = HybsSystem.getDate();
2477                        }
2478                }
2479                else if( key.startsWith( "HOSTNAME" ) ) { // 5.6.6.2 (2013/07/19)
2480                        final int idx = key.indexOf( ' ' );
2481                        if( idx >= 0 ) {
2482                                final String key2 = key.substring( idx+1 ) ;
2483                                if( StringUtil.startsChar( key2 , '@' ) ) {                                     // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
2484                                        rtn = getHostName( getRequestValue( key2.substring( 1 ) ) );
2485                                }
2486                                else{
2487                                        rtn = getHostName( key2 );
2488                                }
2489                        }
2490                        else{
2491                                rtn = getUser().getParameter( key );
2492                        }
2493                }
2494//              // 6.9.5.0 (2018/04/23) うまく動いていないようなので、廃止
2495//              // 5.1.6.0 (2010/05/01) {@SYS.@GUIID_XXXX} パラメータ対応
2496//              else if( key.startsWith( "@GUIID" ) ) {
2497//                      final String key2 = getGUIInfoAttri( "ID" ) +  key.substring( "@GUIID".length() );
2498//                      rtn = getUser().getParameter( key2 );
2499//              }
2500                // 6.2.6.0 (2015/06/19) PRINTERに対応します。
2501                else if( key.startsWith( "PRINTER" ) ) {
2502                        rtn = HybsSystem.getPrinter();
2503                }
2504                // 5.1.6.0 (2010/05/01) {@SYS.@XXXX} パラメータ対応
2505                else if( StringUtil.startsChar( key , '@' ) ) {                                         // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
2506                        final String key2 = getRequestValue( key.substring( 1 ) );
2507                        rtn = getUser().getParameter( key2 );
2508                }
2509                else {
2510                        rtn = getUser().getParameter( key );
2511                }
2512
2513                return rtn ;
2514        }
2515
2516        /**
2517         * システムパラメータの値を、boolean 型に変換して返します。
2518         *
2519         * 本来は、システムパラメータ の値を取得できますが、
2520         * システム的な共有値も取得できるように機能追加しています。
2521         * また、ユーザー個別にシステムパラメータを変更できます。この取得は、
2522         * システムパラメータとして取得します。(値はユーザー個別値を返します。)
2523         *
2524         * @og.rev 4.0.0.0 (2005/11/30) 新規追加
2525         *
2526         * @param       key システム設定キー
2527         *
2528         * @return      システム設定値(boolean型)
2529         */
2530        protected boolean sysBool( final String key ) {
2531                return Boolean.parseBoolean( sys( key ) );              // 6.1.0.0 (2014/12/26) refactoring
2532        }
2533
2534        /**
2535         * システムパラメータの値を、int 型に変換して返します。
2536         *
2537         * 本来は、システムパラメータ の値を取得できますが、
2538         * システム的な共有値も取得できるように機能追加しています。
2539         * また、ユーザー個別にシステムパラメータを変更できます。この取得は、
2540         * システムパラメータとして取得します。(値はユーザー個別値を返します。)
2541         *
2542         * ※ システムパラメータの値が数字でない場合、HybsSystemException が throw されます。
2543         * ※ キーの値が nullの場合、HybsSystemException が throw されます。
2544         *
2545         * @og.rev 4.0.0.0 (2005/11/30) 新規追加
2546         *
2547         * @param       key システム設定キー
2548         *
2549         * @return      システム設定値(int型)
2550         */
2551        protected int sysInt( final String key ) {
2552                String tmp = null;
2553                int rtn ;
2554                try {
2555                        tmp = sys( key );
2556                        rtn = Integer.parseInt( tmp );
2557                }
2558                catch( final NumberFormatException ex ) {
2559                        final String errMsg = "システムパラメータの値が数字ではありません。" + CR
2560                                        + "  Resource key=[" + key + "] val=[" + tmp + "]"  ;
2561                        throw new HybsSystemException( errMsg,ex );             // 3.5.5.4 (2004/04/15) 引数の並び順変更
2562                }
2563                catch( final IllegalArgumentException ex ) {
2564                        final String errMsg = "キーの値が null です。key=[" + key + "] val=[" + tmp + "]";
2565                        throw new HybsSystemException( errMsg,ex );             // 3.5.5.4 (2004/04/15) 引数の並び順変更
2566                }
2567
2568                return rtn;
2569        }
2570
2571        /**
2572         * Transactionオブジェクトを取得します。
2573         * これは、自身のタグの親タグ(囲われているタグ)から、TransactionTag を
2574         * 見つけて、すでに、Transactionオブジェクトが作成済みなら、そのオブジェクトを
2575         * そうでないなら、新規に作成して返します。
2576         *
2577         * Transactionオブジェクトは、AutoCloseableインタフェースを実装しているため、
2578         * try-with-resources構築を使用することが可能です。
2579         *
2580         * @og.rev 6.3.6.1 (2015/08/28) Transactionオブジェクトの取得方法変更。
2581         *
2582         * @return   Transactionオブジェクト
2583         */
2584        protected Transaction getTransaction() {
2585                final TransactionTag tranTag = (TransactionTag)findAncestorWithClass( this,TransactionTag.class );
2586
2587                return tranTag == null  ? new TransactionReal( getApplicationInfo() )
2588                                                                : tranTag.getTranObj();
2589        }
2590
2591        /**
2592         * session に、処理開始時刻を設定します。
2593         * これは、DBTableModel を登録する場合に、一連の処理が連続であるかどうかを
2594         * 判断する時に使用します。
2595         * 処理が一連でない(start 時のタイムスタンプが書き換えられている)場合は、
2596         * DBTableModel の登録処理を行いません。
2597         * なお、判断処理を行うのは、scope が session の場合のみです。
2598         * 判定は、commitTableObject( String ,DBTableModel ) で行います。
2599         *
2600         * @og.rev 3.6.0.8 (2004/11/19) 新規追加
2601         * @og.rev 4.3.0.0 (2008/07/04) fileUD 対応。
2602         * @og.rev 5.1.6.0 (2010/05/01) DBLastSqlの処理は、DBTableModelが新規作成された処理でのみ行う。
2603         *
2604         * @param   tableId キー
2605         * @see     #commitTableObject( String ,DBTableModel )
2606         */
2607        protected void startQueryTransaction( final String tableId ) {
2608                if( "session".equals( scope ) ) {
2609                        startTransaction = Long.valueOf( System.currentTimeMillis() );
2610                        setSessionAttribute( tableId+"_TRANSACTION", startTransaction );
2611                }
2612
2613                // 5.1.6.0 (2010/05/01) DBLastSqlの処理の見直し
2614                if( useTrans ) {
2615                        // 4.3.0.0 (2008/07/04) fileUD 対応
2616                        removeSessionAttribute( HybsSystem.DB_LAST_SQL_KEY );   // 無条件削除
2617                }
2618        }
2619
2620        /**
2621         * スコープに応じて登録されている DBTableModel を指定のキーでセットします。
2622         * これは、startQueryTransaction( String ) でセッションに登録した処理開始時刻と、
2623         * このオブジェクト自身が持っている(セッションに登録した開始時刻そのもの)を
2624         * 比較し、異なる場合は、DBTableModel の登録を行いません。
2625         * これにより、検索処理の開始順にしか登録しないようなロジックを入れています。
2626         * 検索処理時間が掛かるSQLを実行した場合、先に検索した結果があとから登録される
2627         * ケースがあるためです。
2628         * また、判断処理を行うのは、scope が session の場合のみです。
2629         *
2630         * @og.rev 3.6.0.8 (2004/11/19) 新規追加
2631         * @og.rev 3.8.1.1 (2005/11/21) ExcelOut の整合性を取る為の仕掛け
2632         * @og.rev 4.3.0.0 (2008/07/04) fileUD 対応。
2633         * @og.rev 5.1.6.0 (2010/05/01) DBLastSqlの処理は、DBTableModelが新規作成された処理でのみ行う。
2634         * @og.rev 8.0.0.0 (2021/09/30) TBL.XXXX を設定します。(TBL.CLMS,TBL.LBLS,TBL.SLBLS,TBL.COLS,TBL.ROWS)
2635         *
2636         * @param   tableId キー
2637         * @param   table   登録するDBTableModelオブジェクト
2638         *
2639         * @return  正常に登録(true) / 一連でないため登録していない(false)
2640         * @see     #startQueryTransaction( String )
2641         */
2642        protected boolean commitTableObject( final String tableId ,final DBTableModel table ) {
2643                // 登録しないケースをピックアップします。
2644                if( "session".equals( scope ) ) {
2645                        final String key = tableId+"_TRANSACTION";
2646                        final Long endTime = (Long)getSessionAttribute( key );
2647                        removeSessionAttribute( key );
2648                        if( endTime == null ||
2649                                startTransaction == null ||
2650                                endTime.compareTo( startTransaction ) != 0 ) {
2651                                        final String msg = "CommonTagSupport Query処理が割り込まれました。DBTableModel は登録しません。"
2652                                                                + "[" + getUser().getUserID() + "],"
2653                                                                + "[" + getGUIInfoAttri( "KEY" ) + "]"  // 4.0.0 (2005/01/31)
2654                                                                + "[" + startTransaction + "]"                          // 4.0.0 (2005/01/31)
2655                                                                + "[" + endTime + "]";                                          // 4.0.0 (2005/01/31)
2656                                        System.out.println( msg );
2657                                        return false;
2658                        }
2659                        // 3.8.1.1 (2005/11/21) ExcelOut の整合性を取る為の仕掛け
2660                        if( table != null && HybsSystem.TBL_MDL_KEY.equals( tableId ) ) {
2661                                final String consisKey = table.getConsistencyKey();
2662                                setSessionAttribute( HybsSystem.TBL_MDL_CONKEY,consisKey );
2663                        }
2664                }
2665
2666                // 4.3.0.0 (2008/07/04) fileUD 対応
2667                // 5.1.6.0 (2010/05/01) DBLastSqlの処理の見直し
2668                if( useTrans && table != null ) {
2669                        final String guikey = getGUIInfoAttri( "KEY" );
2670                        final DBLastSql lastSql = new DBLastSql( scope,guikey,table.isOverflow(),tableId );
2671                        setSessionAttribute( HybsSystem.DB_LAST_SQL_KEY,lastSql );
2672                }
2673
2674                setObject( tableId,table );
2675
2676                // 8.0.0.0 (2021/09/30) TBL.XXXX を設定します。(TBL.CLMS,TBL.LBLS,TBL.SLBLS,TBL.COLS,TBL.ROWS)
2677                if( table != null ) {
2678                        final StringBuilder clms = new StringBuilder( BUFFER_MIDDLE );
2679                        final StringBuilder lbls = new StringBuilder( BUFFER_MIDDLE );
2680                        final StringBuilder slbls = new StringBuilder( BUFFER_MIDDLE );
2681                        for( final DBColumn clm : table.getDBColumns() ) {
2682                                clms.append( clm.getName() ).append( ',' );                                                                     // カラム名
2683                                lbls.append( StringUtil.tagCut( clm.getLabel() ) ).append( ',' );                       // ラベル名
2684                                slbls.append( StringUtil.tagCut( clm.getShortLabel() ) ).append( ',' );         // ラベル名(名前(短))
2685                        }
2686
2687                        // 最後のカンマを除外します。
2688                        clms.setLength( clms.length()-1 );
2689                        lbls.setLength( lbls.length()-1 );
2690                        slbls.setLength( slbls.length()-1 );
2691
2692                        setRequestAttribute( "TBL.CLMS" , clms.toString() );
2693                        setRequestAttribute( "TBL.LBLS" , lbls.toString() );
2694                        setRequestAttribute( "TBL.SLBLS", slbls.toString() );
2695                        setRequestAttribute( "TBL.COLS" , String.valueOf( table.getColumnCount() ) );   // カラムの数
2696                        setRequestAttribute( "TBL.ROWS" , String.valueOf( table.getRowCount() ) );              // 行数(={@DB.COUNT})
2697                }
2698
2699                return true;
2700        }
2701
2702        /**
2703         * 表示データの HybsSystem.ROW_SEL_KEY を元に、選ばれた 行番号の
2704         * 配列を返します。
2705         * 配列情報は、行番号でソートされて返されます。
2706         * なにも選ばれていない場合は、サイズ0の配列を返します。
2707         *
2708         * @og.rev 4.0.0.0 (2005/01/31) 新規追加
2709         * @og.rev 6.3.9.1 (2015/11/27) 内部処理が、長さが0の配列を返すように変更されたので、その対応。
2710         *
2711         * @return      (選ばれていない場合は、サイズ0の配列を返す)
2712         * @og.rtnNotNull
2713         */
2714        protected int[] getParameterRows() {
2715                if( rowNo != null ) { return rowNo; }
2716
2717                // 6.3.9.1 (2015/11/27) org.opengion.hayabusa.servlet.MultipartRequest#getIntParameters(String) が、
2718                // 存在しない場合、長さが0の配列を返すことにしたので、同じロジックに変更しておきます。
2719                rowNo = (int[])getRequestAttribute( HybsSystem.ROW_SEL_KEY );
2720                if( rowNo != null && rowNo.length > 0 ) { return rowNo; }
2721
2722                final String[] selected = getRequestValues( HybsSystem.ROW_SEL_KEY ) ;
2723
2724                // 6.3.9.1 (2015/11/27) ラムダ式で書き直します。
2725                return selected == null || selected.length == 0
2726                                        ? new int[0]
2727                                        : Arrays.stream( selected )
2728                                                        .filter( str -> str != null && !str.isEmpty() )
2729                                                        .mapToInt( Integer::parseInt )
2730                                                        .sorted()
2731                                                        .toArray();
2732        }
2733
2734        /**
2735         * 表示データの HybsSystem.ROW_SEL_KEY に対して、選ばれた 行番号の
2736         * 配列を設定します。
2737         * ここで設定した選択配列は、getParameterRows() メソッドで取得する場合、優先されます。
2738         *
2739         * @og.rev 4.0.0.0 (2005/01/31) 新規追加
2740         *
2741         * @param       rowNo   行番号配列(可変長引数)
2742         */
2743        protected void setParameterRows( final int... rowNo ) {
2744                setRequestAttribute(  HybsSystem.ROW_SEL_KEY , rowNo );
2745        }
2746
2747        /**
2748         * 指定のクッキーをセットします。
2749         * これは、従来,各Taglibパッケージで使用していました、ErrorMessage オブジェクトを、
2750         * HTMLテーブル形式で表示する為に、DBUtilクラスや、ViewFormクラスなど、複数のクラスを
2751         * 複雑に組み合わせて使用していましたが、一つの static メソッドにまとめたものです。
2752         *
2753         * @og.rev 3.7.0.3 (2005/03/01) 新規登録
2754         *
2755         * @param   key         クッキーのキー
2756         * @param   value       クッキーの設定値
2757         * @param       maxage  最長存続期間を秒単位で設定 (負の値は Cookie を保存しない、 0 なら Cookie を削除する)
2758         */
2759        protected void setCookie( final String key,final String value,final int maxage ) {
2760                final HttpServletResponse res = (HttpServletResponse)pageContext.getResponse();
2761                final Cookie ck = new Cookie( key, value );
2762                ck.setMaxAge( maxage );         // 有効秒
2763                res.addCookie( ck );
2764        }
2765
2766        /**
2767         * 指定のクッキーを取得します。
2768         * 見つからない場合は、null を返します。
2769         *
2770         * @og.rev 3.7.0.3 (2005/03/01) 新規登録
2771         *
2772         * @param       key     クッキーのキー
2773         *
2774         * @return      クッキーの設定値
2775         */
2776        protected String getCookie( final String key ) {
2777                final HttpServletRequest req = (HttpServletRequest)pageContext.getRequest();
2778                final Cookie[] cks = req.getCookies();
2779
2780                String val = null;
2781                for( int i=0; i<cks.length; i++ ) {
2782                        final Cookie ck = cks[i];
2783                        if( ck.getName().equals( key ) ) {
2784                                val = ck.getValue();
2785                                break;
2786                        }
2787                }
2788                return val ;
2789        }
2790
2791        /**
2792         * リクエスト情報の シングルクォート(') 存在チェックを実施するかどうか[true/false]を設定します
2793         *              (初期値:USE_SQL_INJECTION_CHECK[={@og.value SystemData#USE_SQL_INJECTION_CHECK}])。
2794         *
2795         * SQLインジェクション対策の一つとして、暫定的ではありますが、SQLのパラメータに
2796         * 渡す文字列にシングルクォート(') を許さない設定にすれば、ある程度は防止できます。
2797         * 数字タイプの引数には、 or 5=5 などのシングルクォートを使用しないコードを埋めても、
2798         * 数字チェックで検出可能です。文字タイプの場合は、必ず (')をはずして、
2799         * ' or 'A' like 'A のような形式になる為、(')チェックだけでも有効です。
2800         * (') が含まれていたエラーにする(true)/かノーチェックか(false)を指定します。
2801         * (初期値:システム定数のUSE_SQL_INJECTION_CHECK[={@og.value SystemData#USE_SQL_INJECTION_CHECK}])。
2802         *
2803         * @og.rev 4.0.0.0 (2005/08/31) 新規追加
2804         *
2805         * @param       flag    シングルクォートチェック  [true:する/:falseしない]
2806         * @see         org.opengion.hayabusa.common.SystemData#USE_SQL_INJECTION_CHECK
2807         */
2808        protected void useQuotCheck( final boolean flag ) {
2809                quotCheck = flag;
2810        }
2811
2812        /**
2813         * リクエスト情報の HTMLTag開始/終了文字(&gt;&lt;) 存在チェックを実施するかどうか[true/false]を設定します
2814         *              (初期値:USE_XSS_CHECK[={@og.value SystemData#USE_XSS_CHECK}])。
2815         *
2816         * クロスサイトスクリプティング(XSS)対策の一環としてless/greater than signについてのチェックを行います。
2817         * (&gt;&lt;) が含まれていたエラーにする(true)/かノーチェックか(false)を指定します。
2818         * 現在の実装としてはリクエストパラメータのみチェックして、attributesに対しては行いません。
2819         * (初期値:システム定数のUSE_XSS_CHECK[={@og.value SystemData#USE_XSS_CHECK}])。
2820         *
2821         * @og.rev 5.0.0.2 (2009/09/15) 新規追加
2822         *
2823         * @param       flag    XSSチェック [true:する/false:しない]
2824         * @see         org.opengion.hayabusa.common.SystemData#USE_XSS_CHECK
2825         */
2826        protected void useXssCheck( final boolean flag ) {
2827                xssCheck = flag;
2828        }
2829
2830        /**
2831         * 日付関係の情報を簡易的に取り出す処理を行います。
2832         *
2833         * これは、{&#064;DATE.XXXX AA BB CC} 引数処理をおこなうための、サポートメソッドです。
2834         * XXXX は結果のフォーマット、AA が基準時刻で省略した場合は、現在時刻が利用されます。
2835         * BB 引数は、日付についての加減算処理を行うためのコマンドです。
2836         * CC 引数は、BB引数のコマンドに付属するパラメータです。加減算処理の数値を指定できます。
2837         * AA,BB,CC 引数については、先頭に、@ を付ける事で、リクエスト変数が使用できます。
2838         *
2839         * 引数は、"XXXX AA BB CC" という状態で受け取ります。(DATE. ははずした形)
2840         * 第一引数(key) "XXXX" は、日付処理を行うフォーマットの予約語になっています。
2841         * ・Y4   :4文字の年データ(yyyy)を扱います。
2842         * ・YMD  :8文字の4-2-2年月日データ(yyyyMMdd)を扱います。
2843         * ・Y2MD  :6文字の2-2-2年月日データ(yyMMdd)を扱います。
2844         * ・YM   :6文字の4-2年月データ(yyyyMM)を扱います。
2845         * ・HMS  :6文字の2-2-2時分秒データ(HHmmss)を扱います。
2846         * ・HM   :4文字の2-2時分データ(HHmm)を扱います。6.7.4.1 (2017/02/17)
2847         * ・YMDHMS :14文字の4-2-2-2-2-2年月日時分秒データ(yyyyMMddHHmmss)を扱います。
2848         * ・EEE  :曜日をデフォルトロケールで表示します。
2849         *
2850         * F付きは、フォーマットされた日付を返します。
2851         * ・YMDF  :10文字の日付表現(yyyy/MM/dd)を扱います。
2852         * ・Y2MDF :8文字の日付表現(yy/MM/dd)を扱います。
2853         * ・YMF  :7文字の日付表現(yyyy/MM)を扱います。
2854         * ・HMSF  :8文字の時刻表現(HH:mm:ss)を扱います。
2855         * ・HMF   :5文字の時刻表現(HH:mm)を扱います。6.7.4.1 (2017/02/17)
2856         * ・YMDHMSF:19文字の日付表現(yyyy/MM/dd HH:mm:ss)を扱います。
2857         * ・MDF  :5文字の月日表現(MM/dd)を扱います。
2858         * ・MDEF  :5文字+曜日の月日表現(MM/dd(EEE))を扱います。
2859         * ・MDHMF :11文字の月日時分表現(MM/dd HH:mm)を扱います。 (7.0.0.1 (2018/10/09) 追加)
2860         * ・MD2F  :漢字の月日表現(MM月dd日)を扱います。(5.5.5.2 追加)
2861         * ・HM2F  :漢字の時分表現(HH時mm分)を扱います。(7.0.0.1 (2018/10/09) 追加)
2862         * ・MDHM2F :漢字の月日時分表現(MM月dd日 HH時mm分)を扱います。(7.0.0.1 (2018/10/09) 追加)
2863         * ・GYMDF :和暦の年月日表現(GGGGyyyy年MM月dd日)を扱います。
2864         * ・G2YMDF :和暦の日付表現(Gyyyy/MM/dd)を扱います。
2865         * ・GYMF  :和暦の年月表現(GGGGyyyy年MM月)を扱います。
2866         * ・GYF  :和暦の年表現(GGGGyyyy)を扱います。
2867         *
2868         * ・DIFF  :日付の差分を求めます。(7.0.1.1 (2018/10/22) 追加)
2869         *               AA - BB を求め、CCの数値で単位を指定します。
2870         *
2871         * なお、上記以外のフォーマットを指定する場合は、XXXX部分に直接記述できます。(5.5.5.2 追加)
2872         * ただし、スペースで分解するため、フォーマットにスペースを含む場合は、ダブルコーテーション等で
2873         * くくる等の処理が必要です。基本的には、自由フォーマットは、エラーチェックがない為、使わないでください。
2874         *
2875         * 第二引数 AA は、基準となる日付を、yyyyMMdd形式で指定します。nullの場合は、現在日時を使用します。
2876         * 指定できる日付は、yyyyMMdd形式を推奨しますが、'/' , '-' , ' ' , ':' を削除して使います。
2877         * 6桁の場合は、yyyyMM + 01 とし、8ケタの場合は、yyyyMMdd とし、14ケタ以上の場合は、前半14文字を
2878         * yyyyMMddHHmmss として処理します。それ以外の桁数の場合は、エラーになります。
2879         * たとえば、"2012/09/05 16:52:36" のようなフォーマットデータの場合、'/' , '-' , ' ' , ':' を削除して
2880         * "20120905165236" に変換後、日付オブジェクトに変換されます。
2881         *
2882         * AA には、数字で始まる(20050701など)実日付と&#064;で始まるパラメータが使用できます。
2883         * &#064;AA と記述することで、{&#064;AA}で指定する場合と同様のリクエストパラメータが使用できます。
2884         * このパラメータの値の解析結果が、null の場合は、現在時刻が使用されます。
2885         * 数字以外の場合は、省略されたと判断して、コマンド(BB引数)として使用されます。
2886         *
2887         * BB 引数は、日付についての加減算処理を行います。
2888         * 省略すると、なにも加減算処理を行いません。
2889         * この引数もパラメータ(&#064;BB)指定で、リクエストパラメータが使用できます。
2890         * 加減算処理のパラメータが使用できるのは、"H" , "D" , "M" の1文字パラメータの場合のみです。
2891         * それ以外のコマンドで、加減算処理する場合は、独立した CC 引数 を使用してください。
2892         * ・SY :当年の最初の日付にセットします。(当年1月1日)。CC引数は、-N:N年前、0:当年(=SY)、N:N年後 6.9.2.1 (2018/03/12)
2893         * ・SD :当月の最初の日付にセットします。(当月1日)。CC引数は、-N:N月前、0:当月(=SD)、N:N月後、-1:BSD と同じ、1:ASD と同じ
2894         * ・SW :日付処理の週初め(月曜日)にセットします。日付は当日より前に移動します。CC引数は、-N:N週前、0:今週(=SW)、N:N週後
2895         * ・SH :指定の最初の時にセットします。(分秒を0000にする)。CC引数は、時の倍数(4と指定すれば、4時間単位に前に戻る) 6.7.4.1 (2017/02/17)
2896         * ・SM :指定の最初の分にセットします。(秒を00にする)。CC引数は、分の倍数(15と指定すれば、15分単位に前に戻る) 6.7.4.1 (2017/02/17)
2897         * ・SS :指定の最初の秒にセットします。CC引数は、秒の倍数(15と指定すれば、15秒単位に前に戻る) 6.7.4.1 (2017/02/17)
2898         * ・EY :当年の最後の日付にセットします。(当年年末)。CC引数は、-N:N年前、0:当年(=EY)、N:N年後 6.9.2.1 (2018/03/12)
2899         * ・ED :当月の最後の日付にセットします。(当月月末)。CC引数は、-N:N月前、0:当月(=ED)、N:N月後、-1:BED と同じ、1:AED と同じ
2900         * ・EW :日付処理の週末(日曜日)にセットします。日付は当日より後ろに移動します。CC引数は、-N:N週前、0:今週(=EW)、N:N週後
2901         * ・EH :指定の次の時にセットします。(分秒を0000にした次の時)。CC引数は、時の倍数(4と指定すれば、4時間単位に前に進む) 6.7.4.1 (2017/02/17)
2902         * ・EM :指定の次の分にセットします。(秒を00にした次の分)。CC引数は、分の倍数(15と指定すれば、15分単位に前に進む) 6.7.4.1 (2017/02/17)
2903         * ・ES :指定の次の秒にセットします。CC引数は、秒の倍数(15と指定すれば、15秒単位に前に進む) 6.7.4.1 (2017/02/17)
2904         * ・M1 ~ MXXX :月を指定の分だけ進めます。M1なら翌月、M6 なら半年後
2905         * ・D1 ~ DXXX :日を指定の分だけ進めます。D1なら翌日、D200 なら200日後
2906         * ・H1 ~ HXXX :時を指定の分だけ進めます。H1なら1時間後、H24 なら24時間後(5.5.5.6 (2012/08/31) 追加)
2907         * ・MI  :分を指定の分だけ進めます。第四引数(intC) で、時間を指定します。(6.8.4.1 (2017/12/18) 追加)
2908         * ・YMD :CC 引数のYMD表記の日付を加減算します。6.8.4.1 (2017/12/18) 追加
2909         * ・HM  :CC 引数のHM表記の時刻を加減算します。6.8.4.1 (2017/12/18) 追加
2910         * ・NO  :AA 引数がnullの場合、現在時刻ではなく空文字列にします。  7.0.1.3 (2018/11/12) 追加
2911         * ・(有閑)BSD :先月の最初の日付にセットします。(先月1日)(5.5.5.2 追加)。SD -1 と同等
2912         * ・(有閑)BED :先月の最後の日付にセットします。(先月月末)(5.5.5.2 追加)。ED -1 と同等
2913         * ・(有閑)ASD :翌月の最初の日付にセットします。(翌月1日)(5.5.5.2 追加)。SD 1  と同等
2914         * ・(有閑)AED :翌月の最後の日付にセットします。(翌月月末)(5.5.5.2 追加)。ED 1  と同等
2915         *
2916         * 7.0.1.1 (2018/10/22)
2917         *   DATE.DIFF の場合、BB 引数は、日付データになります。AA-BB の関係です。
2918         *
2919         * CC 引数は、特別な処理で、BB 引数に対して、加算、減算のための数字を指定できます。(5.7.4.1 (2014/03/14) 追加)
2920         * 従来は、BB 引数が、"H" , "D" , "M" の 1文字パラメータの場合のみ利用可能でした。
2921         * これは、"H15" と指定するのと、"H" "15" と指定するのと同じ意味になります。
2922         * 異なるのは、CC 引数も、(&#064;CC)指定で、リクエストパラメータが使用できます。
2923         * 従来は、文字列として結合された状態でしか、BB 引数を渡せませんでしたが、この、CC 引数の
2924         * 追加で、日付の加減算を、パラメータ指定できるようになります。
2925         * 数字以外の文字が指定されたり、パラメータの解析結果が NULL の場合には、BB引数自体も無視されます。
2926         * 注意点は、各 BB 引数に応じて、数字の意味が異なるという事です。
2927         *
2928         * HXXX,DXXX,MXXX 形式に、CC 引数を付けた場合は、XXX にさらに加算されます。
2929         * prmB に、数字を使用した場合、(コマンドでない場合)にも、CC 引数は、加算されます。
2930         *
2931         * 7.0.1.1 (2018/10/22)
2932         *   DATE.DIFF の場合、CC 引数は、差分の単位を指定するキーワードになります。AA-BB の結果を、
2933         *   1:年 2:月 3:日 4:時 5:分 6:秒 に換算 して返します。端数は切り捨てで整数で返します。
2934         *
2935         * @og.rev 3.8.0.2 (2005/07/11) 新規追加
2936         * @og.rev 5.4.0.1 (2011/11/01) 日付処理の機能追加(BB 引数に、リクエストパラメータ対応)
2937         * @og.rev 5.5.0.2 (2012/03/09) 和暦対応
2938         * @og.rev 5.5.5.2 (2012/08/18) XXXXフォーマット追加、自由フォーマット対応、BB引数追加、/,-削除機能追加、SM,EM廃止
2939         * @og.rev 5.5.5.6 (2012/08/31) H1 ~ HXXX 追加。時間の加算を指定できる。
2940         * @og.rev 5.5.7.2 (2012/10/09) HybsDateUtil を利用するように修正します。
2941         * @og.rev 5.5.8.2 (2012/11/09) prmA の判定に、null と ゼロ文字列を判定する。
2942         * @og.rev 5.6.0.1 (2013/01/11) 5.5.7.2でyyyyMMddしか取っていないため、HHmmssを追加します
2943         * @og.rev 5.7.4.1 (2014/03/14) AA 引数の@解析後のコマンド判定方法を、8ケタ以下から先頭が数字以外に変更します。
2944         * @og.rev 5.7.4.1 (2014/03/14) CC 引数を、"H" , "D" , "M" 以外でも使用できるように拡張します。
2945         *
2946         * @param   value       パラメータ
2947         *
2948         * @return   メッセージ情報
2949         * @see         org.opengion.fukurou.util.HybsDateUtil#getDateFormat( String,String,String,int )
2950         */
2951        protected String getDateFormat( final String value ) {
2952                // {@DATE.XXXX AA BB CC} を分割
2953                final String[] vals = StringUtil.csv2Array( value,' ' );                // ダブルクオート内は保持される。
2954
2955                final String key = vals[0] ;
2956
2957                // 5.7.4.1 (2014/03/14) 初期化時に、vals を設定しておきます。
2958                String prmA = vals.length >= 2 ? vals[1] : null ;
2959                String prmB = vals.length >= 3 ? vals[2] : null ;
2960                String prmC = vals.length >= 4 ? vals[vals.length-1] : null ;           // 互換性。最後の値が、CC引数
2961
2962                if( StringUtil.startsChar( prmA , '@' ) ) {                                                     // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
2963                        prmA = getRequestValue( prmA.substring(1) );
2964                }
2965
2966                if( StringUtil.startsChar( prmB , '@' ) ) {                                                     // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
2967                        prmB = getRequestValue( prmB.substring(1) );
2968                }
2969
2970                if( StringUtil.startsChar( prmC , '@' ) ) {                                                     // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
2971                        prmC = getRequestValue( prmC.substring(1) );
2972                }
2973
2974                // 5.7.4.1 (2014/03/14) AA 引数の@解析後のコマンド判定方法を、8ケタ以下から先頭が数字以外に変更します。
2975                if( prmA != null && prmA.length() > 0 ) {
2976                        final char chA = prmA.charAt(0);
2977                        if( chA < '0' || chA > '9' ) {          // 先頭が、数字以外の場合は、コマンドなので、一つずつずらす。
2978                                prmC = prmB;
2979                                prmB = prmA;
2980                                prmA = null;
2981                        }
2982                }
2983
2984                // 5.7.4.1 (2014/03/14) CC 引数を、"H" , "D" , "M" 以外でも使用できるように拡張します。
2985                int intC = 0;
2986                if( prmC != null && prmC.length() > 0 ) {
2987                        try {
2988                                intC = Integer.parseInt( prmC );
2989                        }
2990                        catch( final NumberFormatException ex ) {
2991                                final String errMsg = "CC引数が数字ではありません。value=[" + value + "]"
2992                                                                + ex.getMessage() ;
2993                                System.err.println( errMsg );
2994                        }
2995                }
2996
2997                // prmA が null か、isEmpty() の場合は、現在時刻が使用される。
2998                return HybsDateUtil.getDateFormat( key,prmA,prmB,intC );        // 5.7.4.1 (2014/03/14) CC 引数を拡張します。
2999        }
3000
3001        /**
3002         * debug や エラー時に参考にする、簡易リファレンスへのリンクを作成します。
3003         * リンクを行うタグの名称は、getTagName() メソッドより取得します。
3004         *
3005         * @og.rev 4.0.0.0 (2005/01/31) 新規追加
3006         * @og.rev 4.2.1.0 (2008/04/11) URLを相対パスに変更
3007         * @og.rev 6.2.1.0 (2015/03/13) 簡易リファレンスへのリンクが相対パスでは、common/gamen 以下から使えない。
3008         * @og.rev 6.3.1.1 (2015/07/10) 簡易リファレンスは、documents.html ではなく、quickReference.html です。
3009         * @og.rev 7.0.1.0 (2018/10/15) XHTML → HTML5 対応(空要素の、"/>" 止めを、">" に変更します)。
3010         *
3011         * @return  簡易リファレンスへのリンク
3012         * @og.rtnNotNull
3013         * @see  #getTagName()
3014         */
3015        protected String getDocumentLink() {
3016                final String name = getTagName();
3017
3018        //      try {
3019        //              Field fld = getClass().getDeclaredField( "VERSION" ) ;
3020        //              version = (String)fld.get( null );
3021        //      }
3022        //      catch( final Exception ex ) {
3023        //              version = ex.toString();
3024        //      }
3025
3026                // org.opengion.hayabusa.taglib.AbcdTag というクラス名より、abcd を取り出す。
3027                final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE )
3028//                      .append( "<br /><a href=\"" )
3029                        .append( "<br><a href=\"" )                                                                     // 7.0.1.0 (2018/10/15)
3030                        .append( HybsSystem.sys( "JSP" ) )                                                      // 6.2.1.0 (2015/03/13) 追加
3031                        .append( "/common/quickReference.html#VAL_" )                           // 6.3.1.1 (2015/07/10) リンク先間違い
3032                        .append( name )
3033                        .append( "\" target=\"_brank\" >簡易リファレンス[" )
3034                        .append( name )
3035                        .append( "] " )
3036                        .append( BuildNumber.ENGINE_INFO )                                                      // 6.3.1.1 (2015/07/10) ENGINE_INFO の追加
3037                //      .append( version )
3038                        .append( "</a>" ).append( BR );
3039
3040                return buf.toString();
3041        }
3042
3043        /**
3044         * タグの名称を、返します。
3045         * これは、debug や エラー時に参考にする、簡易リファレンスへのリンクを作成する場合に
3046         * 使用します。
3047         * 通常は、org.opengion.hayabusa.taglib.AbcdTag という自分自身のクラス名より、
3048         * abcd の部分を取り出し、返します。
3049         * クラス名とタグ名が、上記変換ルールと異なる場合は、このメソッドを
3050         * 使用して、直接 abcd の部分に相当する文字列を返すようにしてください。
3051         *
3052         * @og.rev 4.0.0.0 (2005/01/31) 新規追加
3053         *
3054         * @return  タグの名称
3055         * @og.rtnNotNull
3056         * @see  #getDocumentLink()
3057         */
3058        protected String getTagName() {
3059                final String name = getClass().getName();
3060                final int adrs = name.lastIndexOf('.');
3061
3062                // org.opengion.hayabusa.taglib.AbcdTag というクラス名より、abcd を取り出す。
3063                return name.substring( adrs+1,adrs+2 ).toLowerCase(Locale.JAPAN)
3064                                + name.substring( adrs+2,name.length()-3 ) ;
3065        }
3066
3067        /**
3068         * リクエストに対して、画面遷移なしモードを有効にします[true/false]。
3069         * この情報は画面IDをキーにセッションに保存されるため、
3070         * 各タグで共有することができます。
3071         *
3072         * @og.rev 4.3.3.0 (2008/10/01) 新規作成
3073         * @og.rev 4.3.8.0 (2009/08/01) リクエストからセッションに変更(名称も変更)
3074         * @og.rev 5.1.3.0 (2010/02/01) noTransition、ajaxSubmitのコントロールは、requestで行う。
3075         *
3076         * @param       flag    画面遷移なしモード [true:有効/false:無効]
3077         */
3078        protected void setNoTransitionRequest( final boolean flag ) {
3079                setRequestAttribute( HybsSystem.NO_TRANSITION_MODE_KEY, String.valueOf( flag ));
3080        }
3081
3082        /**
3083         * リクエストで画面遷移なしモードが有効になっているかを返します。
3084         * この情報はセッションから画面IDをキーに取得します。
3085         * セッションに情報が設定されていない(#setNoTransition()が呼ばれていない)場合は、
3086         * falseを返します。
3087         *
3088         * @og.rev 4.3.3.0 (2008/10/01) 新規作成
3089         * @og.rev 4.3.8.0 (2009/08/01) リクエストからセッションに変更
3090         * @og.rev 5.1.3.0 (2010/02/01) noTransition、ajaxSubmitのコントロールは、requestで行う。
3091         *
3092         * @return 画面遷移なしモードが有効
3093         */
3094        protected boolean isNoTransitionRequest() {
3095                return nval( (String)getRequestAttribute( HybsSystem.NO_TRANSITION_MODE_KEY ), false );
3096        }
3097
3098        /**
3099         * リクエストに対して、AjaxSubmitモードを使用するかどうか指定します[true/false]。
3100         * この情報は画面IDをキーにセッションに保存されるため、
3101         * 各タグで共有することができます。
3102         *
3103         * @og.rev 4.3.8.0 (2009/08/01) 新規作成
3104         * @og.rev 5.1.3.0 (2010/02/01) noTransition、ajaxSubmitのコントロールは、requestで行う。
3105         *
3106         * @param       flag    AjaxSubmitモード [true:使用する/false:使用しない]
3107         */
3108        protected void setAjaxSubmitRequest( final boolean flag ) {
3109                setRequestAttribute( HybsSystem.USE_AJAX_SUBMIT_KEY, String.valueOf( flag ));
3110        }
3111
3112        /**
3113         * リクエストでAjaxSubmitモードが有効になっているかを返します。
3114         * この情報はセッションから画面IDをキーに取得します。
3115         * セッションに情報が設定されていない(#setNoTransition()が呼ばれていない)場合は、
3116         * falseを返します。
3117         *
3118         * @og.rev 4.3.8.0 (2009/08/01) 新規作成
3119         * @og.rev 5.1.3.0 (2010/02/01) noTransition、ajaxSubmitのコントロールは、requestで行う。
3120         *
3121         * @return AjaxSubmitモードが有効
3122         */
3123        protected boolean isAjaxSubmitRequest() {
3124                return nval( (String)getRequestAttribute( HybsSystem.USE_AJAX_SUBMIT_KEY ), false );
3125        }
3126
3127        /**
3128         * シリアライズ用のカスタムシリアライズ読み込みメソッド
3129         *
3130         * ここでは、transient 宣言された内部変数の内、初期化が必要なフィールドのみ設定します。
3131         *
3132         * @og.rev 4.0.0.0 (2006/09/31) 新規追加
3133         * @serialData 一部のオブジェクトは、シリアライズされません。
3134         *
3135         * @param       strm    ObjectInputStreamオブジェクト
3136         * @see #release2()
3137         */
3138        private void readObject( final ObjectInputStream strm ) throws IOException , ClassNotFoundException {
3139                strm.defaultReadObject();
3140                attri = new Attributes();
3141        }
3142
3143        /**
3144         * アクセスログ取得の為,ApplicationInfoオブジェクトを返します。
3145         * 見つからない場合は、null が返ります。(暫定対応)
3146         *
3147         * @og.rev 3.8.7.0 (2006/12/15) 新規追加
3148         *
3149         * @return      アクセスログ取得の為の管理オブジェクト
3150         */
3151        protected ApplicationInfo getApplicationInfo() {
3152                final String gamenId = getGUIInfoAttri( "KEY" );
3153                final String jspId   = (String)getSessionAttribute( "JSPID" );
3154
3155                return getUser().getApplicationInfo( gamenId,jspId );
3156        }
3157
3158        /**
3159         * イベントカラムの実行に必要なカラム情報をマップに登録します。
3160         *
3161         * @og.rev 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
3162         * @og.rev 6.3.3.0 (2015/07/25) eventValue 追加
3163         *
3164         * @param col DBカラム
3165         */
3166        protected void addEventColumn( final DBColumn col ) {
3167                addEventColumn( col.getName(), col.getEventColumn(), col.getEventValue(), col.getEventURL()
3168                                                , col.getRenderer(), col.getEditor(), col.getRawRendParam(), col.getRawEditParam() );
3169        }
3170
3171        /**
3172         * イベントカラムの実行に必要なカラム情報をマップに登録します。
3173         *
3174         * @og.rev 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
3175         * @og.rev 6.3.3.0 (2015/07/25) eventValue 追加
3176         *
3177         * @param name カラム名
3178         * @param evCol イベントカラム名
3179         * @param evVal 子カラムの値SQL
3180         * @param url イベントURL
3181         * @param renderer カラムのレンデラー
3182         * @param editor カラムのエディター
3183         * @param rendParam カラムの表示パラメーター
3184         * @param editParam カラムの編集パラメーター
3185         */
3186        @SuppressWarnings(value={"unchecked"})
3187        protected void addEventColumn( final String name, final String evCol , final String evVal, final String url,
3188                                                final String renderer, final String editor, final String rendParam, final String editParam ) {
3189                if( evCol == null || evCol.isEmpty() ){ return; }
3190
3191                String key = (String)getRequestAttribute( HybsSystem.USE_EVENT_COLUMN_KEY );
3192                if( key == null || key.isEmpty() ) {
3193                        key = HybsSystem.USE_EVENT_COLUMN_KEY + System.currentTimeMillis();
3194                        setRequestAttribute( HybsSystem.USE_EVENT_COLUMN_KEY, key );
3195                }
3196
3197                Map<String, DBEventColumn> evColMap = (Map<String, DBEventColumn>)( getSessionAttribute( key ) );
3198                if( evColMap == null ){
3199                        evColMap = new HashMap<>();
3200                }
3201                if( evColMap.get( name ) == null ) {
3202                        evColMap.put( name, new DBEventColumn( name, evCol, evVal, url, renderer, editor, rendParam, editParam ) );     // 6.3.3.0 (2015/07/25)
3203                }
3204                setSessionAttribute( key, evColMap );
3205        }
3206
3207        /**
3208         * 各データベースに対応するファンクション名を返します。
3209         *
3210         * @og.rev 4.3.7.0 (2009/06/01) 新規作成
3211         * @og.rev 5.1.4.0 (2010/03/01) データベース名 でなく、DBID 名で検索するようにします。
3212         *
3213         * @param   key ファンクション名(定義文字)
3214         *
3215         * @return  実ファンクション名
3216         */
3217        protected String getDBFunctionName( final String key ) {
3218                final int idx = key.indexOf( ' ' );
3219                String func = null;
3220                String dbid = null;
3221                if( idx >= 0 ) {
3222                        func = key.substring( 0, idx );
3223                        dbid = key.substring( idx+1, key.length() );
3224                        if( StringUtil.startsChar( dbid , '@' ) ) { dbid = getRequestValue( dbid.substring( 1 ) ); }    // 6.2.0.0 (2015/02/27) 1文字 String.startsWith
3225                }
3226                else {
3227                        func = key;
3228                }
3229                // 5.1.4.0 (2010/03/01) データベース名 でなく、DBID 名で検索する。
3230                return DBFunctionName.getFunctionName( func, dbid );
3231        }
3232
3233        // /**
3234        // * データロールの設定に基づき、キー(カラム名)に対応する条件式を返します。
3235        // *
3236        // * @og.rev 4.4.0.0 (2009/08/02) 新規作成
3237        // * @og.rev 7.4.4.0 (2021/06/30) openGionV8事前準備(DataRole.java廃止)
3238        // *
3239        // * @param   key カラム名
3240        // *
3241        // * @return  条件式
3242        // */
3243        // 7.4.4.0 (2021/06/30) Delete
3244        // protected String getDataCondition( final String key ) {
3245        //      return getUser().getDataCondition( key );
3246        // }
3247
3248        /**
3249         * 与えたIPアドレスからホスト名を取得して返します。
3250         * 取得できなかった場合は空文字を返します。
3251         * IPアドレスが解決できない場合や、セキュリティマネージャーで
3252         * 許可されていない場合はエラーを返します。
3253         *
3254         * @og.rev 5.6.6.2 (2013/07/19) 新規作成
3255         *
3256         * @param   ip IPアドレス
3257         *
3258         * @return  ホスト名(取得できない場合は空文字)
3259         */
3260        protected String getHostName( final String ip ) {
3261                String hostname = "";
3262                try{
3263                        hostname =  InetAddress.getByName(ip).getHostName();
3264                }
3265                catch( final UnknownHostException ex ){
3266                        final String errMsg = "IPアドレスが解決できません。"
3267                                + ex.getMessage();
3268                        throw new HybsSystemException( errMsg,ex );
3269                }
3270                catch( final SecurityException ex ){
3271                        final String errMsg = "この操作はセキュリティ上許可されていません。"
3272                                + ex.getMessage();
3273                        throw new HybsSystemException( errMsg,ex );
3274                }
3275                return hostname;
3276        }
3277
3278        /**
3279         * 指定のURLの文字列から、最適なURLを作成します。
3280         *
3281         * 引数の url が、'/' で始まる場合は、コンテキスト以下の相対パスと判断します。
3282         * つまり、"/gf" + url で表されることになります。
3283         * ただし、経過処置として、先頭が、コンテキストを含む文字列の場合は、そのまま返します。
3284         *
3285         * それ以外は、そのまま返します。
3286         * ただし、引数が、null やゼロ文字列の時は、ゼロ文字列を返します。
3287         *
3288         * @og.rev 6.3.2.0 (2015/07/10) 指定のURLの文字列から、最適なURLを作成します。
3289         *
3290         * @param       url 指定のURLの文字列から、最適なURLを作成します。
3291         *
3292         * @return      コンテキストに応じた URL を返します。
3293         * @og.rtnNotNull
3294         */
3295        protected static String makeUrl( final String url ) {
3296                if( url == null || url.isEmpty() ) { return ""; }
3297
3298                if( url.charAt(0) == '/' ) {
3299                        final String CPATH = '/' + HybsSystem.sys( "CONTEXT_NAME" );            // CPATH = "/gf"
3300                        if( !url.startsWith( CPATH ) ) {
3301                                return CPATH + url ;
3302                        }
3303                }
3304
3305                return url ;
3306        }
3307
3308        /**
3309         * "org.opengion.hayabusa.message" の、Locale.JAPANESE リソースから取得するメッセージを文字列で返します。
3310         *
3311         * id と引数を受け取り、ResourceBundle と、MessageFormat.format で加工した
3312         * 文字列を返します。
3313         * baseName は、F_BS_NM で、Locale に、Locale.JAPANESE を指定したメッセージを作成します。
3314         * hayabusaパッケージと、pluginパッケージで主に使われる、メッセージの取得方法です。
3315         *
3316         * @og.rev 6.4.3.2 (2016/02/19) 新規追加
3317         *
3318         * @param id    リソースのキーとなるID。
3319         * @param args  リソースを、MessageFormat.format で加工する場合の引数。
3320         *
3321         * @return MessageFormat.formatで加工された文字列
3322         * @see         MsgUtil#H_BS_NM
3323         */
3324        protected String getMsg( final String id , final Object... args ) {
3325                return MsgUtil.getMsg( MsgUtil.H_BS_NM , new Locale( getLanguage() ) , id , args );
3326        }
3327
3328//      /**
3329//       * タグリブで発生したThrowableを session から取り出します。
3330//       *
3331//       * とりだした Throwable は、remove しています。
3332//       *
3333//       * @og.rev 6.8.5.0 (2018/01/09) タグリブで発生したエラーを、session に登録しておきます。
3334//       * @og.rev 6.9.2.1 (2018/03/12) タグリブで発生したエラーを、session に登録する処理を、一旦廃止
3335//       *
3336//       * @return      元のThrowableオブジェクト
3337//       */
3338//      protected Throwable getCommonTagThrowable() {
3339//              final Throwable th  = (Throwable)getSessionAttribute( "CommonTagThrowable" );
3340//
3341//              removeSessionAttribute( "CommonTagThrowable" );
3342//
3343//              return th;
3344//      }
3345
3346        /**
3347         * &#064;があればリクエストから、なければ useReq に応じて、値を返します。
3348         *
3349         * &#064;があるかどうか判断して、なければkeyそのもので、getRequestValue した値を返します。
3350         * あれば、まず、スペースが存在しているかどうか判定して、あれば、&#064;を取り除いて、
3351         * getReservedValue を、なければ、 &#064;を取り除いて、getRequestValue した値を返します。
3352         * キーが null の場合は、そのまま、null を返しますが、getRequestValue等した結果が
3353         * null かゼロ文字列の場合は、defvalを返します。
3354         *
3355         * @og.rev 7.2.3.1 (2020/04/17) 新規追加
3356         *
3357         * @param key           &#064;付き/なしのリクエスト変数のキー
3358         * @param useReq        &#064;が存在しない場合 [true:リクエストから/false:キーを返す]
3359         *
3360         * @return &#064;があればリクエストから、なければ useReq に応じて、値を返す
3361         */
3362        private String getAtmarkVas( final String key , final boolean useReq ) {
3363                if( key == null ) { return null; }
3364
3365                final String val ;
3366
3367                // 先頭が @ の場合は、リクエスト変数のキーとして、値を判定
3368                if( StringUtil.startsChar( key , '@' ) ) {                                      // 1文字 String.startsWith
3369                        if( key.indexOf( ' ' ) > 0 ) {
3370                                val = getReservedValue( key.substring( 1 ) );           // もう一度変数処理
3371                        }
3372                        else {
3373                                val = getRequestValue( key.substring( 1 ) );
3374                        }
3375                }
3376                else {
3377                        val = useReq ? getRequestValue( key ) : key ;                   // @ がない場合は、useReq で、判定する。
3378                }
3379
3380                return val;
3381        }
3382
3383        /**
3384         * このオブジェクトの文字列表現を返します。
3385         * 基本的にデバッグ目的に使用します。
3386         *
3387         * @return このクラスの文字列表現
3388         * @og.rtnNotNull
3389         */
3390        @Override
3391        public String toString() {
3392                return ToString.title( this.getClass().getName() )
3393                                .println( "Other..."    ,getAttributes().getAttribute() )
3394                                .fixForm().toString() ;
3395        }
3396}