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