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