    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.fukurou.util.StringUtil;
    021import static org.opengion.fukurou.util.StringUtil.nval ;
    022
    023import org.apache.commons.codec.binary.Base64 ;
    024import java.nio.charset.Charset;                // 5.5.2.6 (2012/05/25)
    025
    026/**
    027 * Cookie を読み書きするタグです。
    028 *
    029 * Cookie は少量の情報を Servlet から Web ブラウザに送り、 ブラウザにそれを
    030 * 維持しもらい、以降のアクセスでサーバに送り返してもらう仕組です。
    031 * Cookie の値はクライアントを一意に識別できるようになっているので一般に
    032 * セッション管理に用いられています。
    033 *
    034 * Cookie には名前と値が一つありますが、他にコメントやパス、ドメイン、
    035 * 最長存続期間、バージョンといったオプショナルな属性もあります。
    036 * Web ブラウザの中にはオプショナルな属性の扱いにバグがあるものがあります。
    037 * このため、Servlet の相互運用性を高めるためにはあまり使わないほうがいいでしょう。
    038 *
    039 * 標準の JavaScript で登録機能はサポートしていましたが、メモリのみで、かつ
    040 * 画面単位の書き込みのみでした。
    041 * 今回の cookie タグでは、永続化(maxAge)の設定や、システム内(CONTEXT_NAME以下)
    042 * での共有(デフォルト)や、その変更、ドメインを指定しての共有(domain)などの
    043 * 機能を持っています。
    044 * また、漢字コードでの読み書き(useBase64)にも対応しています。
    045 * 読み込みに関しては、漢字を指定しなければ、{&#064;SYS.COOKIE.カラム名}で、使用可能です。
    046 * 複数の読み込み、また、漢字コードを含むクッキーの場合は、読み込み(action="LOAD")
    047 * してください。指定のキー以外に、別名に読み込む(aliasNames)事も可能です。
    048 *
    049 * @og.formSample
    050 * ●形式：
    051 *    &lt;og:cookie
    052 *        action    = "SAVE"       Cookie に対するアクションを指定します。(SAVE|LOAD|DELETE)
    053 *        keys      = "AAA,BBB"    キーをCSV形式で複数指定できます。
    054 *        vals      = "VAL1,VAL2"  値をCSV形式で複数指定できます。
    055 *        path      = "/ge"        クライアントがこの Cookie を返さなくてはいけないパスを指定します。
    056 *        domain    = ".foo.com"   この Cookie がどこで生成されたかを表すドメインを指定します。
    057 *        maxAge    = "3600"       Cookie の最長存続期間を秒単位で設定します。
    058 *        useBase64 = "false"      漢字等の２Byte文字を使用する場合に、BASE64で処理します。[true/false]
    059 *    &gt;
    060 * ●body：なし
    061 *
    062 * ●Tag定義：
    063 *   &lt;og:cookie
    064 *       action           ○【TAG】アクション(SAVE,LOAD,DELETE)をセットします(必須)。
    065 *       keys             ○【TAG】クッキーのキーをCSV形式で複数指定します(必須)。
    066 *       vals               【TAG】keys属性に対応する値をCSV形式で複数指定します
    067 *       aliasNames         【TAG】クッキーのキーの別名をCSV形式で複数指定します
    068 *       path               【TAG】クライアントがこの Cookie を返さなくてはいけないパスを指定します(初期値:/+CONTEXT_NAME)
    069 *       domain             【TAG】この Cookie がどこで生成されたかを表すドメインを指定します(初期値:付与したサーバ)
    070 *       maxAge             【TAG】Cookie の最長存続期間を秒単位で設定します(初期値: -1 )
    071 *       useBase64          【TAG】漢字等の文字を扱う場合に、BASE64で処理を行うかどうか[true/false]を設定します(初期値:false )
    072 *       debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
    073 *   /&gt;
    074 *
    075 * ●使用例
    076 *    例１)設定:複数キーを同時に書き込むことが可能です。
    077 *        &lt;og:cookie
    078 *            action="SAVE" keys="CDJ,FG_NAME" vals="{&#064;CDJ},{&#064;NAME}"
    079 *        /&gt;
    080 *
    081 *    例２)取得:cookieタグで取得すると、それ以降では {&#064;CDJ} や {&#064;NAME} で扱えます。
    082 *          aliasNames 属性を使わない場合は、keys に指定した変数にセットされます。
    083 *        &lt;og:cookie
    084 *            action="LOAD" keys="CDJ,FG_NAME" aliasNames="CDJ,NAME"
    085 *        /&gt;
    086 *
    087 *    例３)取得:SYS パラメータでの取得も可能です。
    088 *        {&#064;SYS.COOKIE.CDJ}
    089 *
    090 *    例４) QUERY画面では値の表示(LOAD)を行い、RESULT画面で値の設定(SAVE)を行うケース
    091 *
    092 *        QUERY画面
    093 *        &lt;og:cookie action="LOAD" useBase64="true"
    094 *                        keys="CLM,NAME" aliasNames="CLM,LABEL_NAME" /&gt;
    095 *
    096 *        &lt;og:column name="CLM"        defaultVal="{&#064;CLM}" /&gt;
    097 *        &lt;og:column name="LABEL_NAME" defaultVal="{&#064;LABEL_NAME}"/&gt;
    098 *
    099 *        RESULT画面
    100 *        &lt;og:cookie action="SAVE" maxAge="360000" useBase64="true"
    101 *                        keys="CLM,NAME" vals="{&#064;CLM},{&#064;LABEL_NAME}" /&gt;
    102 *
    103 *    例５) QUERY画面では、{&#064;SYS.COOKIE.カラム名} で取得。
    104 *        RESULT画面では、ムラタ内全システム共通に使える値をセット。
    105 *
    106 *        QUERY画面
    107 *        &lt;og:column name="SYSTEM_ID" defaultVal="{&#064;SYS.COOKIE.SYSTEM_ID}" /&gt;
    108 *
    109 *        RESULT画面
    110 *        &lt;og:cookie action="SAVE" maxAge="360000" domain=".opengion.org"
    111 *                        keys="SYSTEM_ID" vals="{&#064;SYSTEM_ID}" /&gt;
    112 *
    113 * @og.rev 3.8.0.2 (2005/06/30) 新規作成
    114 * @og.group 画面制御
    115 *
    116 * @version  0.9.0  2000/10/17
    117 * @author   Kazuhiko Hasegawa
    118 * @since    JDK5.0,
    119 */
    120public class CookieTag extends CommonTagSupport {
    121        //* このプログラムのVERSION文字列を設定します。   {@value} */
    122        private static final String VERSION = "5.5.2.6 (2012/05/25)" ;
    123
    124        private static final long serialVersionUID = 552620120525L ;
    125
    126        /**
    127         * プラットフォーム依存のデフォルトの Charset です。
    128         * プラットフォーム依存性を考慮する場合、エンコード指定で作成しておく事をお勧めします。
    129         *
    130         * @og.rev 5.5.2.6 (2012/05/25) findbugs対応
    131         */
    132        private static final Charset DEFAULT_CHARSET = Charset.defaultCharset() ;
    133
    134        /** action 引数に渡す事の出来る アクション  設定 {@value} */
    135        public static final String ACT_SAVE = "SAVE" ;
    136        /** action 引数に渡す事の出来る アクション  取得 {@value} */
    137        public static final String ACT_LOAD = "LOAD" ;
    138        /** action 引数に渡す事の出来る アクション  削除 {@value} */
    139        public static final String ACT_DELETE = "DELETE" ;
    140
    141        /** action 引数に渡す事の出来る アクション リスト  */
    142        private static final String[] ACTION_LIST = new String[] { ACT_SAVE , ACT_LOAD , ACT_DELETE };
    143
    144        private String   action         = null;
    145        private String[] keys           = null;
    146        private String[] vals           = null;
    147        private String[] aliasNames     = null;
    148        private String   path           = "/" + HybsSystem.sys( "CONTEXT_NAME" );
    149        private String   domain         = null;
    150        private int      maxAge         = -1;
    151        private boolean  useBase64      = false;
    152
    153        /**
    154         * Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
    155         *
    156         * @return      後続処理の指示(EVAL_PAGE)
    157         */
    158        @Override
    159        public int doEndTag() {
    160                debugPrint();           // 4.0.0 (2005/02/28)
    161                actionExec( action );
    162
    163                return(EVAL_PAGE);
    164        }
    165
    166        /**
    167         * タグリブオブジェクトをリリースします。
    168         * キャッシュされて再利用されるので、フィールドの初期設定を行います。
    169         *
    170         */
    171        @Override
    172        protected void release2() {
    173                super.release2();
    174                action          = null;
    175                keys            = null;
    176                vals            = null;
    177                aliasNames      = null;
    178                path            = "/" + HybsSystem.sys( "CONTEXT_NAME" );
    179                domain          = null;
    180                maxAge          = -1;
    181                useBase64       = false;
    182        }
    183
    184        /**
    185         * アクションを実行します。
    186         *
    187         * アクションは action 属性で指定します。
    188         *
    189         * @param       action  アクション(public static final 宣言されている文字列)
    190         */
    191        private void actionExec( final String action ) {
    192
    193                if( ACT_SAVE.equals( action ) ) {
    194                        saveCookies( maxAge );
    195                }
    196                else if( ACT_LOAD.equals( action ) ) {
    197                        loadCookies();
    198                }
    199                else if( ACT_DELETE.equals( action ) ) {
    200                        saveCookies( 0 );       // maxAge にゼロをセットすると削除されます。
    201                }
    202                else {
    203                        String errMsg = "指定のアクションは実行できません。アクションエラー"
    204                                                        + HybsSystem.CR
    205                                                        + "action=[" + action + "] "
    206                                                        + HybsSystem.CR
    207                                                        + StringUtil.array2csv( ACTION_LIST ) ;
    208                        throw new HybsSystemException( errMsg );
    209                }
    210        }
    211
    212        /**
    213         * SAVE アクションを実行します。
    214         *
    215         * クッキーに書き込みを行います。
    216         *
    217         * @param       maxAge  最長存続期間( 0 なら削除 )
    218         */
    219        private void saveCookies( final int maxAge ) {
    220        //      BASE64Encoder encoder = null;
    221                for( int i=0; i<keys.length; i++ ) {
    222                        String value = nval (vals[i],"" );
    223                        if( useBase64 && value.length() > 0 ) {
    224        //                      if( encoder == null ) { encoder = new BASE64Encoder(); }
    225        //                      value = encoder.encode( value.getBytes() ) ;
    226
    227//                              byte[] encoded = Base64.encodeBase64( value.getBytes() );
    228//                              value = new String( encoded );
    229                                byte[] encoded = Base64.encodeBase64( value.getBytes( DEFAULT_CHARSET ) );              // 5.5.2.6 (2012/05/25) findbugs対応
    230                                value = new String( encoded,DEFAULT_CHARSET );                                                                  // 5.5.2.6 (2012/05/25) findbugs対応
    231                        }
    232                        setCookie( keys[i], value, maxAge );
    233                }
    234        }
    235
    236        /**
    237         * LOAD アクションを実行します。
    238         *
    239         * クッキーから読み込みを行います。
    240         *
    241         */
    242        private void loadCookies() {
    243        //      BASE64Decoder decoder = null;
    244                if( aliasNames == null ) { aliasNames = keys; }
    245
    246        //      try {
    247                        for( int i=0; i<keys.length; i++ ) {
    248                                String value = getCookie( keys[i] );
    249                                if( useBase64 && value != null && value.length() > 0 ) {
    250        //                              if( decoder == null ) { decoder = new BASE64Decoder(); }
    251        //                              byte[] decoded = decoder.decodeBuffer( value );
    252//                                      byte[] decoded = Base64.decodeBase64( value.getBytes() );
    253//                                      value = new String( decoded );
    254                                        byte[] decoded = Base64.decodeBase64( value.getBytes( DEFAULT_CHARSET ) );              // 5.5.2.6 (2012/05/25) findbugs対応
    255                                        value = new String( decoded,DEFAULT_CHARSET );                                                                  // 5.5.2.6 (2012/05/25) findbugs対応
    256                                }
    257                                if( value != null ) {
    258                                        setRequestAttribute( aliasNames[i],value );
    259                                }
    260                        }
    261        //      }
    262        //      catch( IOException ex ) {
    263        //              String errMsg = "BASE64Decoder エラー " + ex.toString();
    264        //              throw new HybsSystemException( errMsg );
    265        //      }
    266        }
    267
    268        /**
    269         * 【TAG】アクション(SAVE,LOAD,DELETE)をセットします。
    270         *
    271         * @og.tag
    272         * アクションは,HTMLから(get/post)指定されますので,ACT_xxx で設定される
    273         * フィールド定数値のいづれかを、指定できます。
    274         * 無指定の場合は、なにもしません。
    275         *
    276         * <table border="1" frame="box" rules="all" >
    277         *   <caption>アクションの説明</caption>
    278         *   <tr><th>action </th><th>名称</th><th>機能</th></tr>
    279         *   <tr><td>SAVE   </td><td>登録</td><td>指定の keys のキーに vals の値をセットします。</td></tr>
    280         *   <tr><td>LOAD   </td><td>取得</td><td>指定の keys のクッキーを(リクエスト中に)取得します。</td></tr>
    281         *   <tr><td>DELETE </td><td>削除</td><td>指定の keys のクッキーを削除します。</td></tr>
    282         * </table>
    283         *
    284         * @param       act アクション(public static final 宣言されている文字列)
    285         * @see         <a href="../../../../constant-values.html#org.opengion.hayabusa.taglib.CookieTag.ACT_DELETE">アクション定数</a>
    286         */
    287        public void setAction( final String act ) {
    288                action = nval( getRequestParameter( act ),action );
    289
    290                if( action != null && !check( action, ACTION_LIST ) ) {
    291                        String errMsg = "指定のアクションは実行できません。アクションエラー"
    292                                                        + HybsSystem.CR
    293                                                        + "action=[" + action + "] "
    294                                                        + HybsSystem.CR
    295                                                        + StringUtil.array2csv( ACTION_LIST ) ;
    296                        throw new HybsSystemException( errMsg );
    297                }
    298        }
    299
    300        /**
    301         * 【TAG】クッキーのキーをCSV形式で複数指定します。
    302         *
    303         * @og.tag
    304         * クッキーにセットするときのキーを指定します。カンマ区切りで複数指定できます。
    305         * vals 属性には、キーに対応する値を、設定してください。
    306         * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
    307         * こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。
    308         *
    309         * @param       key     クッキーのキー
    310         */
    311        public void setKeys( final String key ) {
    312                keys = getCSVParameter( key );
    313        }
    314
    315        /**
    316         * 【TAG】クッキーのキーの別名をCSV形式で複数指定します。
    317         *
    318         * @og.tag
    319         * クッキーから値を取得する(action="LOAD")場合に、読み込みキー(keys)に対応する
    320         * 別名を指定することで、別名の変数に読み込んだ値を登録することが出来ます。
    321         * 別名を指定しない場合は、keys に指定された名前が、使用されます。
    322         * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
    323         * こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。
    324         *
    325         * @param       names   クッキーの別名
    326         */
    327        public void setAliasNames( final String names ) {
    328                aliasNames = getCSVParameter( names );
    329        }
    330
    331        /**
    332         * 【TAG】keys属性に対応する値をCSV形式で複数指定します。
    333         *
    334         * @og.tag
    335         * キーに設定した値を、カンマ区切り文字で複数して出来ます。
    336         * 指定順序は、キーと同じにしておいて下さい。
    337         * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
    338         * こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。
    339         *
    340         * @param       val     keys属性に対応する値
    341         */
    342        public void setVals( final String val ) {
    343                vals = getCSVParameter( val );
    344        }
    345
    346        /**
    347         * 【TAG】クライアントがこの Cookie を返さなくてはいけないパスを指定します(初期値:/+CONTEXT_NAME)。
    348         *
    349         * @og.tag
    350         * この値を指定すると Cookie が該当するディレクトリ内、さらに、
    351         * サブディレクトリに存在する全てのページから参照できるようになります。
    352         * Cookie のパスには Cookie をセットした Servlet が含まれていなければなりません。
    353         * 例えば、/catalog を指定したとします。このとき、 サーバの /catalog 以下の全ての
    354         * ディレクトリから Cookie が見えるようになります。
    355         * 初期値は、"/" + CONTEXT_NAME です。
    356         *
    357         * Cookie のパス名指定についての詳細は RFC2109 を参照してください。
    358         *
    359         * @param       uri パスを指定するString
    360         */
    361        public void setPath( final String uri ) {
    362                path = nval( getRequestParameter( uri ),path );
    363        }
    364
    365        /**
    366         * 【TAG】この Cookie がどこで生成されたかを表すドメインを指定します(初期値:付与したサーバ)。
    367         *
    368         * @og.tag
    369         * ドメイン名の形式は RFC2109 で指定されています。
    370         * ドメイン名は (.foo.com のように) ドットで始まります。 このように設定すると、
    371         * Cookie は指定された Domain Name System (DNS) のゾーン内のサーバから見える
    372         * ようになります(例えば、www.foo.com) からは見えるけれど、a.b.foo.com からは
    373         * 見えないというようにです)。 デフォルトでは Cookie を付与したサーバにしか送り返しません。
    374         *
    375         * @param       pattern この Cookie が見えてもよいドメイン名を指定するString
    376         */
    377        public void setDomain( final String pattern ) {
    378                domain = nval( getRequestParameter( pattern ),domain );
    379        }
    380
    381        /**
    382         * 【TAG】Cookie の最長存続期間を秒単位で設定します(初期値: -1 )。
    383         *
    384         * @og.tag
    385         * 正の値が指定されると Cookie はある秒数が過ぎた後、削除されます。
    386         * この値は、Cookie の有効期限が切れる 最長 存続期間であることに注意してください。
    387         * Cookie の現在までの存続期間ではありません。
    388         *
    389         * 負の値は Cookie が永続的に保存されないことを意味しています。 この場合、
    390         * Web ブラウザが終了すると Cookie も削除されます。 0 という値を指定すると
    391         * Cookie が削除されることになります。
    392         * 初期値は、-1(永続的に保存されない)です。
    393         *
    394         * @param       expiry Cookie の最長存続期間を秒単位で指定する整数値。 負の値は Cookie を保存しない、 0 なら Cookie を削除する意味となる。
    395         */
    396        public void setMaxAge( final String expiry ) {
    397                maxAge = nval( getRequestParameter( expiry ),maxAge );
    398        }
    399
    400        /**
    401         * 【TAG】漢字等の文字を扱う場合に、BASE64で処理を行うかどうか[true/false]を設定します(初期値:false )。
    402         *
    403         * @og.tag
    404         * クッキーへの読み書きは、ASCII に限られます。漢字等のコードを書き込む場合は、
    405         * BASE64でエンコードして書き込む必要があります。読み込む場合も同様です。
    406         * ただし、一般のASCIIは、BASE64 ではエンコードしないため、外部で指定する必要があります。
    407         * BASE64 で書き込んだ場合ば、{&#064;SYS.COOKIE.CDJ} での取得はできませんので、
    408         * action="LOAD" で、取得してください。
    409         * 初期値は、false(使用しない)です。
    410         *
    411         * @param       flag 漢字等の文字を扱う場合に、BASE64で処理を行うかどうか[true/false]
    412         */
    413        public void setUseBase64( final String flag ) {
    414                useBase64 = nval( getRequestParameter( flag ),useBase64 );
    415        }
    416
    417        /**
    418         * このオブジェクトの文字列表現を返します。
    419         * 基本的にデバッグ目的に使用します。
    420         *
    421         * @return このクラスの文字列表現
    422         */
    423        @Override
    424        public String toString() {
    425                return org.opengion.fukurou.util.ToString.title( this.getClass().getName() )
    426                                .println( "VERSION"             ,VERSION        )
    427                                .println( "action"              ,action         )
    428                                .println( "keys"                ,keys           )
    429                                .println( "vals"                ,vals           )
    430                                .println( "aliasNames"  ,aliasNames     )
    431                                .println( "path"                ,path           )
    432                                .println( "domain"              ,domain         )
    433                                .println( "maxAge"              ,maxAge         )
    434                                .println( "useBase64"   ,useBase64      )
    435                                .println( "Other..."    ,getAttributes().getAttribute() )
    436                                .fixForm().toString() ;
    437        }
    438}