org.apache.struts.util
クラス FastTreeMap

java.lang.Object
  |
  +--java.util.AbstractMap
        |
        +--java.util.TreeMap
              |
              +--org.apache.struts.util.FastTreeMap
すべての実装インタフェース:
java.lang.Cloneable, java.util.Map, java.io.Serializable, java.util.SortedMap

推奨されていません。 Struts 1.0 final以降のいずれかの時点で、 Jakarta Commons Collections パッケージ中の同等なクラスに置き換えられます。

public class FastTreeMap
extends java.util.TreeMap

/**

java.util.TreeMap のカスタム実装で、構造の変更ではなく読取り専用のメソッド呼び出しが大多数を占めるようなマルチスレッド環境での操作を想定してデザインされています。 "fast"モードで操作した場合、読取りは非同期で行われ、書き込みは以下のような振る舞いをします:

最初に生成された時点では、このクラスのオブジェクトにはデフォルトで"slow"モードが設定されており、 あらゆるアクセスは同期され、クローニングは行われません。 この状態はコレクションの初期化を行うのに適しており、初期化終了後 (setFast(true)を呼び出すことにより)"fast"モードに切り替えられます。

: もし、シングルスレッドでのみTreeMapを生成したりアクセスするのなら、 最大限のパフォーマンスを得るために、java.util.TreeMapを(同期化せずに)直接利用すべきです。

バージョン:
$Revision: 1.3.2.1 $ $Date: 2001/05/20 21:06:43 $
作成者:
Craig R. McClanahan
関連項目:
直列化された形式

入れ子クラスの概要
 
クラス java.util.TreeMap から継承した入れ子クラス
 
クラス java.util.AbstractMap から継承した入れ子クラス
 
クラス java.util.Map から継承した入れ子クラス
java.util.Map.Entry
 
フィールドの概要
protected  boolean fast
          推奨されていません。 "fast"モードで動作しているか?
protected  java.util.TreeMap map
          推奨されていません。 内部で管理されるマップ.
 
クラス java.util.TreeMap から継承したフィールド
 
クラス java.util.AbstractMap から継承したフィールド
 
コンストラクタの概要
FastTreeMap()
          推奨されていません。 空のマップを作成します。
FastTreeMap(java.util.Comparator comparator)
          推奨されていません。 指定されたコンパレータで空のマップを作成します。
FastTreeMap(java.util.Map map)
          推奨されていません。 指定されたマップと同じマッピングをもつ新しいマップを作成します。
FastTreeMap(java.util.SortedMap map)
          推奨されていません。 指定されたマップと同じマッピングをもつ新しいマップを作成します。
 
メソッドの概要
 void clear()
          推奨されていません。 マップから全てのマッピングを削除します。
 java.lang.Object clone()
          推奨されていません。 FastTreeMap のインスタンスのシャローコピーを返します。
 java.util.Comparator comparator()
          推奨されていません。 現在使用しているコンパレータを返します。
 boolean containsKey(java.lang.Object key)
          推奨されていません。 マップが指定のキーのマッピングを保持する場合に true を返します。
 boolean containsValue(java.lang.Object value)
          推奨されていません。 マップが 1 つ以上のキーを指定の値にマップする場合に true を返します。
 java.util.Set entrySet()
          推奨されていません。 マップに格納されているマッピングのコレクションビューを返します。
 boolean equals(java.lang.Object o)
          推奨されていません。 指定されたオブジェクトがこのマップと等しいかどうかを比較します。
 java.lang.Object firstKey()
          推奨されていません。 現在この順序を持つマップに格納されている最初の(一番下の)キーを返します。
 java.lang.Object get(java.lang.Object key)
          推奨されていません。 マップが指定のキーにマップしている値を返します。
 boolean getFast()
          推奨されていません。  
 int hashCode()
          推奨されていません。 マップのハッシュコード値を返します。
 java.util.SortedMap headMap(java.lang.Object key)
          推奨されていません。 指定されたキーより下のキーをもつ部分のビューを返します。
 boolean isEmpty()
          推奨されていません。 内部に要素を保持していないかどうかテストします。
 java.util.Set keySet()
          推奨されていません。 マップに格納されているキーのセットビューを返します。
 java.lang.Object lastKey()
          推奨されていません。 現在この順序を持つマップに格納されている最後の(一番上の)キーを返します。
 java.lang.Object put(java.lang.Object key, java.lang.Object value)
          推奨されていません。 指定の値をマップ内の指定のキーと関連付けます。
 void putAll(java.util.Map in)
          推奨されていません。 指定されたマップからこのマップにすべてのマッピングをコピーします。
 java.lang.Object remove(java.lang.Object key)
          推奨されていません。 指定されたキーに関連付けられた値を削除し、 関連付けられていた値を返します。
 void setFast(boolean fast)
          推奨されていません。  
 int size()
          推奨されていません。 マップ内のキーと値のマッピングの数を返します。
 java.util.SortedMap subMap(java.lang.Object fromKey, java.lang.Object toKey)
          推奨されていません。 マップの fromKey (これを含む) から toKey (これを含まない) のキー範囲を持つ部分ビューを返します。
 java.util.SortedMap tailMap(java.lang.Object key)
          推奨されていません。 指定されたキー以上のキーをもつ部分ビューを返します。
 java.util.Collection values()
          推奨されていません。 マップに格納されている値のコレクションビューを返します。
 
クラス java.util.TreeMap から継承したメソッド
 
クラス java.util.AbstractMap から継承したメソッド
toString
 
クラス java.lang.Object から継承したメソッド
finalize, getClass, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

map

protected java.util.TreeMap map
推奨されていません。 
内部で管理されるマップ.


fast

protected boolean fast
推奨されていません。 
"fast"モードで動作しているか?

コンストラクタの詳細

FastTreeMap

public FastTreeMap()
推奨されていません。 
空のマップを作成します。


FastTreeMap

public FastTreeMap(java.util.Comparator comparator)
推奨されていません。 
指定されたコンパレータで空のマップを作成します。

パラメータ:
comparator - ツリー要素を順序付けするためのコンパレータ

FastTreeMap

public FastTreeMap(java.util.Map map)
推奨されていません。 
指定されたマップと同じマッピングをもつ新しいマップを作成します。 マップ内の要素はキーの「自然順序付け」でソートされます。

パラメータ:
map - マップ生成時にコピーするマッピングを持ったマップ

FastTreeMap

public FastTreeMap(java.util.SortedMap map)
推奨されていません。 
指定されたマップと同じマッピングをもつ新しいマップを作成します。 マップ内の要素は指定されたマップど同じ条件でソートされます。

パラメータ:
map - マップ生成時にコピーするマッピングを持ったマップ
メソッドの詳細

getFast

public boolean getFast()
推奨されていません。 

setFast

public void setFast(boolean fast)
推奨されていません。 

clear

public void clear()
推奨されていません。 
マップから全てのマッピングを削除します。

定義:
インタフェース java.util.Map 内の clear
オーバーライド:
クラス java.util.TreeMap 内の clear

clone

public java.lang.Object clone()
推奨されていません。 
FastTreeMap のインスタンスのシャローコピーを返します。 内部のキーと値自体は複製されません。

オーバーライド:
クラス java.util.TreeMap 内の clone

comparator

public java.util.Comparator comparator()
推奨されていません。 
現在使用しているコンパレータを返します。 「自然順序付け」が使用されている場合には null を返します。

定義:
インタフェース java.util.SortedMap 内の comparator
オーバーライド:
クラス java.util.TreeMap 内の comparator

containsKey

public boolean containsKey(java.lang.Object key)
推奨されていません。 
マップが指定のキーのマッピングを保持する場合に true を返します。

定義:
インタフェース java.util.Map 内の containsKey
オーバーライド:
クラス java.util.TreeMap 内の containsKey
パラメータ:
key - Key 存在するか確認するキー

containsValue

public boolean containsValue(java.lang.Object value)
推奨されていません。 
マップが 1 つ以上のキーを指定の値にマップする場合に true を返します。

定義:
インタフェース java.util.Map 内の containsValue
オーバーライド:
クラス java.util.TreeMap 内の containsValue
パラメータ:
value - 存在するか確認する値

entrySet

public java.util.Set entrySet()
推奨されていません。 
マップに格納されているマッピングのコレクションビューを返します。 返されるコレクションの各要素は Map.Entry です。

定義:
インタフェース java.util.Map 内の entrySet
オーバーライド:
クラス java.util.TreeMap 内の entrySet

equals

public boolean equals(java.lang.Object o)
推奨されていません。 
指定されたオブジェクトがこのマップと等しいかどうかを比較します。 この実装では、Map.equalsメソッドのドキュメントで Mapの同値関数を定義するのに使われているコードをそのまま使っています。

定義:
インタフェース java.util.Map 内の equals
オーバーライド:
クラス java.util.AbstractMap 内の equals
パラメータ:
o - マップと等しいかどうかを比較するオブジェクト

firstKey

public java.lang.Object firstKey()
推奨されていません。 
現在この順序を持つマップに格納されている最初の(一番下の)キーを返します。

定義:
インタフェース java.util.SortedMap 内の firstKey
オーバーライド:
クラス java.util.TreeMap 内の firstKey

get

public java.lang.Object get(java.lang.Object key)
推奨されていません。 
マップが指定のキーにマップしている値を返します。 マップがこのキーのマッピングを保持していない場合、または このキーに対してnullがマッピングされているときには null を返します。 containsKey() メソッドにて、この2つの場合を見分けることができます。

定義:
インタフェース java.util.Map 内の get
オーバーライド:
クラス java.util.TreeMap 内の get
パラメータ:
key - 返される値に関連付けられたキー

hashCode

public int hashCode()
推奨されていません。 
マップのハッシュコード値を返します。 この実装では、Map.hashCodeメソッドのドキュメントで Mapのハッシュ関数を定義するのに使われているコードをそのまま使っています。

定義:
インタフェース java.util.Map 内の hashCode
オーバーライド:
クラス java.util.AbstractMap 内の hashCode

headMap

public java.util.SortedMap headMap(java.lang.Object key)
推奨されていません。 
指定されたキーより下のキーをもつ部分のビューを返します。(指定されたキーは含まれません)

定義:
インタフェース java.util.SortedMap 内の headMap
オーバーライド:
クラス java.util.TreeMap 内の headMap
パラメータ:
key - Key 返されるマップに含まれるキーより上に位置するキー

isEmpty

public boolean isEmpty()
推奨されていません。 
内部に要素を保持していないかどうかテストします。

定義:
インタフェース java.util.Map 内の isEmpty
オーバーライド:
クラス java.util.AbstractMap 内の isEmpty

keySet

public java.util.Set keySet()
推奨されていません。 
マップに格納されているキーのセットビューを返します。

定義:
インタフェース java.util.Map 内の keySet
オーバーライド:
クラス java.util.TreeMap 内の keySet

lastKey

public java.lang.Object lastKey()
推奨されていません。 
現在この順序を持つマップに格納されている最後の(一番上の)キーを返します。

定義:
インタフェース java.util.SortedMap 内の lastKey
オーバーライド:
クラス java.util.TreeMap 内の lastKey

put

public java.lang.Object put(java.lang.Object key,
                            java.lang.Object value)
推奨されていません。 
指定の値をマップ内の指定のキーと関連付けます。 マップが既にこのキーのマッピングを保持していた場合、 古い値は置き換えられ、リターンされます。

定義:
インタフェース java.util.Map 内の put
オーバーライド:
クラス java.util.TreeMap 内の put
パラメータ:
key - 指定された値に関連付けられるキー
value - 指定されたキーに関連付けられる値

putAll

public void putAll(java.util.Map in)
推奨されていません。 
指定されたマップからこのマップにすべてのマッピングをコピーします。 全てのマッピングは指定されたマップが持つものと置き換わります。

定義:
インタフェース java.util.Map 内の putAll
オーバーライド:
クラス java.util.TreeMap 内の putAll
パラメータ:
in - マップに格納されるマッピング

remove

public java.lang.Object remove(java.lang.Object key)
推奨されていません。 
指定されたキーに関連付けられた値を削除し、 関連付けられていた値を返します。

定義:
インタフェース java.util.Map 内の remove
オーバーライド:
クラス java.util.TreeMap 内の remove
パラメータ:
key - マッピングがマップから削除されるキー

size

public int size()
推奨されていません。 
マップ内のキーと値のマッピングの数を返します。

定義:
インタフェース java.util.Map 内の size
オーバーライド:
クラス java.util.TreeMap 内の size

subMap

public java.util.SortedMap subMap(java.lang.Object fromKey,
                                  java.lang.Object toKey)
推奨されていません。 
マップの fromKey (これを含む) から toKey (これを含まない) のキー範囲を持つ部分ビューを返します。

定義:
インタフェース java.util.SortedMap 内の subMap
オーバーライド:
クラス java.util.TreeMap 内の subMap
パラメータ:
fromKey - 返すマップに含めるキーの下端点
toKey - 返すマップに含めるキーの上端点

tailMap

public java.util.SortedMap tailMap(java.lang.Object key)
推奨されていません。 
指定されたキー以上のキーをもつ部分ビューを返します。

定義:
インタフェース java.util.SortedMap 内の tailMap
オーバーライド:
クラス java.util.TreeMap 内の tailMap
パラメータ:
key - 返されるマップの下端となるキー

values

public java.util.Collection values()
推奨されていません。 
マップに格納されている値のコレクションビューを返します。

定義:
インタフェース java.util.Map 内の values
オーバーライド:
クラス java.util.TreeMap 内の values


このドキュメントは、Ja-Jakartaにより訳されました。コメントがある場合は、report@jajakarta.orgまでお願いします。
Copyright (C) 2000-2002 - Apache Software Foundation