    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.fukurou.util;
    017
    018/**
    019 * HybsEntry.java は、内部に final 定義された文字列の、key と value を持つ、値クラスです。
    020 *
    021 * 全変数は、public final 宣言されており、外部より取得できますが、設定できません。
    022 * このクラスは、コンストラクタで設定されたキーと設定値を変える事が出来ません。
    023 * よって、デフォルトコンストラクタを持たないため、java.io.Serializable インターフェースは
    024 * 持ちません。また、内部の値を変更できない為、clone() をする必要がないため、
    025 * java.lang.Cloneable インターフェースも実装していません。
    026 * HybsEntry オブジェクトの同一性を確保するには、equals( Object ) と、hashCode() メソッドを
    027 * オーバーライドしておく必要があります。同一性の条件は、key と value が、ともに
    028 * String.equals の関係を持てば、成立することとします。
    029 *
    030 * @version  4.0
    031 * @author       Kazuhiko Hasegawa
    032 * @since    JDK5.0,
    033 */
    034public final class HybsEntry implements Comparable<HybsEntry> { // 4.3.3.6 (2008/11/15) Generics警告対応
    035        /** 内部のキー情報     */
    036        private final String key ;
    037        /** 内部のバリュー情報   */
    038        private final String value ;
    039        /** 内部のコメント情報   */
    040        private final String comment ;  // 4.0.0 (2005/01/31) 追加
    041
    042        // 4.0.0 (2005/01/31) private 化
    043        private final int hCode ;
    044        //      private static final ValueComparator valueComp = new ValueComparator();
    045
    046        /**
    047         * コンストラクタ
    048         * 内部変数への値の設定は、このコンストラクターで行われます。
    049         * key への null セットは認められません。value へは、セットできます。
    050         * コメントは、ゼロ文字列("") で、初期化されます。
    051         *
    052         * @param key   キー
    053         * @param value 値
    054         * @throws IllegalArgumentException key に null がセットされた場合
    055         */
    056        public HybsEntry( final String key,final String value ) {
    057                this( key,value,"" );
    058        }
    059
    060        /**
    061         * コンストラクタ
    062         * 内部変数への値の設定は、このコンストラクターで行われます。
    063         * key への null セットは認められません。value へは、セットできます。
    064         *
    065         * @param key   キー
    066         * @param value 値
    067         * @param comment コメント
    068         * @throws IllegalArgumentException key に null がセットされた場合
    069         */
    070        public HybsEntry( final String key,final String value,final String comment ) {
    071                if( key == null ) {
    072                        String errMsg = "key への null セットは認められません。" ;
    073                        throw new IllegalArgumentException( errMsg );
    074                }
    075
    076                this.key        = key;
    077                this.value      = value;
    078                this.comment = comment;
    079                hCode           = ( key + ',' + value + '.' + comment ).hashCode();
    080        }
    081
    082        /**
    083         * エントリに対応するキーを返します。
    084         *
    085         * @return      エントリに対応するキー
    086         */
    087        public String getKey() { return key; }
    088
    089        /**
    090         * エントリに対応する値を返します。
    091         *
    092         * @return      エントリに対応する値
    093         */
    094        public String getValue() { return value; }
    095
    096        /**
    097         * エントリに対応するコメントを返します。
    098         *
    099         * @return エントリに対応するコメント
    100         */
    101        public String getComment() { return comment; }
    102
    103        /**
    104         * HybsEntry の設定されている値を変更します。
    105         * これは、設定値を変更した新しい HybsEntry を作成して返します。
    106         * なお、value が、内部の値と等しい時(equals が成立する時)自分自身を返します。
    107         *
    108         * @param newValue 新しい値
    109         *
    110         * @return エントリー HybsEntry
    111         */
    112        public HybsEntry getValue( final String newValue ) {
    113                if(  ( newValue == null && value == null ) ||
    114                         ( newValue != null && newValue.equals( value ) ) ) {
    115                                return this;
    116                }
    117                else {
    118                        return new HybsEntry( key,newValue,comment );
    119                }
    120        }
    121
    122        /**
    123         * 自然比較メソッド
    124         * インタフェース Comparable の 実装です。
    125         * HybsEntryの順序は、key の順序であらわされます。
    126         * 同一keyの場合は，value の順番になります。
    127         *
    128         * @param   other 比較対象のObject
    129         *
    130         * @return  このオブジェクトが指定されたオブジェクトより小さい場合は負の整数、等しい場合はゼロ、大きい場合は正の整数
    131         * @throws ClassCastException 指定されたオブジェクトがキャストできない場合。
    132         */
    133        @Override
    134        public int compareTo( final HybsEntry other ) {         // 4.3.3.6 (2008/11/15) Generics警告対応
    135                int comp = key.compareTo( other.key );
    136
    137                if( comp == 0 ) {
    138                        if( value != null ) { comp = value.compareTo( other.value ); }
    139                        else {                            comp = ( other.value == null ) ? 0 : -1 ; }
    140
    141                        if( comp == 0 ) {
    142                                comp = comment.compareTo( other.comment );
    143                        }
    144                }
    145                return comp ;
    146        }
    147
    148        /**
    149         * このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    150         * インタフェース Comparable の 実装に関連して、再定義しています。
    151         * HybsEntryは、key が等しく、かつ valueが同一の場合に、
    152         * 等しいと判断されます。
    153         *
    154         * @param   object 比較対象の参照オブジェクト
    155         *
    156         * @return      引数に指定されたオブジェクトとこのオブジェクトが等しい場合は true、そうでない場合は false
    157         */
    158        @Override
    159        public boolean equals( final Object object ) {
    160                if( object instanceof HybsEntry ) {
    161                        HybsEntry other = (HybsEntry)object;
    162                        return  key.equals( other.key )
    163                                        && value != null && value.equals( other.value ) ;
    164                }
    165                return false ;
    166        }
    167
    168        /**
    169         * オブジェクトのハッシュコード値を返します。
    170         * このメソッドは、java.util.Hashtable によって提供されるような
    171         * ハッシュテーブルで使用するために用意されています。
    172         * equals( Object ) メソッドをオーバーライトした場合は、hashCode() メソッドも
    173         * 必ず 記述する必要があります。
    174         * ここでは、key と value の合成した文字列のハッシュコード値を返します。
    175         *
    176         * @return  このオブジェクトのハッシュコード値
    177         *
    178         */
    179        @Override
    180        public int hashCode() {
    181                return hCode ;
    182        }
    183
    184        /**
    185         * オブジェクトの識別子として，詳細なユーザー情報を返します。
    186         *
    187         * @return  詳細なユーザー情報
    188         */
    189        @Override
    190        public String toString() {
    191                return "key=[" + key + "],value=[" + value + "],comment=[" + comment + "]" ;
    192        }
    193
    194        /**
    195         * 設定値の順序を表す Comparator を返します。
    196         * HybsEntryクラス自身は、key の順番で自然順序付けを行う、Comparable インターフェースを
    197         * 実装しています。しかし、設定値でソートする場合は、この
    198         * Comparator インターフェースを実装した内部クラスを使用することで、
    199         * 対応出来ます。
    200         *
    201         * @return  設定値の順序を表す Comparator
    202         */
    203        //      public Comparator getValueComparator() {
    204        //              return valueComp ;
    205        //      }
    206
    207        /**
    208         * オブジェクトの識別子として，詳細なユーザー情報を返します。
    209         *
    210         * @return  詳細なユーザー情報
    211         */
    212        //      private static class ValueComparator implements Comparator {
    213        //              /**
    214        //               * value の順序付けのために 2 つの引数を比較します。
    215        //               * 最初の引数が 2 番目の引数より小さい場合は負の整数、両方が等しい場合は 0、
    216        //               * 最初の引数が 2 番目の引数より大きい場合は正の整数を返します。
    217        //               *
    218        //               * @param   o1 Object 比較対象の最初のオブジェクト
    219        //               * @param   o2 Objectb比較対象の 2 番目のオブジェクト
    220        //               * @return  最初の引数が 2 番目の引数より小さい場合は負の整数、両方が等しい場合は 0、最初の引数が 2 番目の引数より大きい場合は正の整数
    221        //               * @throws  ClassCastException - 引数の型がこのコンパレータによる比較を妨げる場合
    222        //               */
    223        //              public int compare(Object o1, Object o2) {
    224        //                      HybsEntry e1 = (HybsEntry)o1 ;          // キャスト失敗で、ClassCastException
    225        //                      HybsEntry e2 = (HybsEntry)o2 ;          // キャスト失敗で、ClassCastException
    226        //
    227        //                      int comp = 0;
    228        //                      if( e1 == null && e2 == null ) { comp = 0; }
    229        //                      else if( e1 == null && e2 != null ) { comp = -1; }
    230        //                      else if( e1 != null && e2 == null ) { comp = 1;  }
    231        //                      else if( e1 != null && e2 != null ) {
    232        //                              if( e1.value == null && e2.value == null ) { comp = 0; }
    233        //                              else if( e1.value == null && e2.value != null ) { comp = -1; }
    234        //                              else if( e1.value != null && e2.value == null ) { comp = 1; }
    235        //                              else {
    236        //                                      comp = e1.value.compareTo( e2.value );
    237        //                              }
    238        //                      }
    239        //                      return comp ;
    240        //              }
    241        //      }
    242}