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