org.apache.struts.util
クラス FastHashMap

java.lang.Object
  java.util.AbstractMap
      java.util.HashMap
          org.apache.struts.util.FastHashMap

すべての実装インタフェース:

java.lang.Cloneable, java.util.Map, java.io.Serializable

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

public class FastHashMap

extends java.util.HashMap

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

• 既存のコレクションのクローンを作成
• クローンに対して修正を実施
• 既存のコレクションと(修正された)クローンを入れ替え

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

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

バージョン:

$Revision: 1.2 $ $Date: 2003/03/22 07:55:10 $

作成者:

Craig R. McClanahan

関連項目:

直列化された形式

翻訳者:

日置 聡 [日本語訳のコメントは、report@jajakarta.orgに送ってください。]

入れ子クラスの概要

クラス java.util.HashMap から継承した入れ子クラス

クラス java.util.AbstractMap から継承した入れ子クラス

フィールドの概要

protected boolean	fast 推奨されていません。 "fast"モードで動作させるか?
protected java.util.HashMap	map 推奨されていません。 内部で管理されるマップ.

クラス java.util.HashMap から継承したフィールド

クラス java.util.AbstractMap から継承したフィールド

コンストラクタの概要

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

FastHashMap(int capacity)
推奨されていません。 指定された初期容量で空のマップを作成します。

FastHashMap(int capacity, float factor)
推奨されていません。 指定された初期容量と負荷係数で空のマップを作成します。

FastHashMap(java.util.Map map)
推奨されていません。 指定されたマップと同じマッピングで新しいマップを作成します。

メソッドの概要

void	clear() 推奨されていません。 マップから全てのマッピングを削除します。
java.lang.Object	clone() 推奨されていません。 FastHashMap のインスタンスのシャローコピーを返します。.
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	get(java.lang.Object key) 推奨されていません。 マップが指定のキーにマップしている値を返します。
boolean	getFast() 推奨されていません。
int	hashCode() 推奨されていません。 マップのハッシュコード値を返します。
boolean	isEmpty() 推奨されていません。 マップがマッピングを保持しない場合に true を返します。
java.util.Set	keySet() 推奨されていません。 マップに格納されているキーのセットビューを返します。
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.Collection	values() 推奨されていません。 マップに格納されている値のコレクションビューを返します。

クラス java.util.HashMap から継承したメソッド

クラス java.util.AbstractMap から継承したメソッド

toString

クラス java.lang.Object から継承したメソッド

finalize, getClass, notify, notifyAll, wait, wait, wait

フィールドの詳細

map

protected java.util.HashMap map

推奨されていません。

内部で管理されるマップ.

fast

protected boolean fast

推奨されていません。

"fast"モードで動作させるか?

コンストラクタの詳細

FastHashMap

public FastHashMap()

推奨されていません。

空のマップを作成します。

FastHashMap

public FastHashMap(int capacity)

推奨されていません。

指定された初期容量で空のマップを作成します。

パラメータ:

capacity - マップの初期容量

FastHashMap

public FastHashMap(int capacity,
                   float factor)

推奨されていません。

指定された初期容量と負荷係数で空のマップを作成します。

パラメータ:

capacity - マップの初期容量

FastHashMap

public FastHashMap(java.util.Map map)

推奨されていません。

指定されたマップと同じマッピングで新しいマップを作成します。

パラメータ:

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

メソッドの詳細

getFast

public boolean getFast()

推奨されていません。

setFast

public void setFast(boolean fast)

推奨されていません。

clear

public void clear()

推奨されていません。

マップから全てのマッピングを削除します。

clone

public java.lang.Object clone()

推奨されていません。

FastHashMap のインスタンスのシャローコピーを返します。. 内部のキーと値自体は複製されません。

containsKey

public boolean containsKey(java.lang.Object key)

推奨されていません。

マップが指定のキーのマッピングを保持する場合に true を返します。

パラメータ:

key - Key 存在するか確認するキー

containsValue

public boolean containsValue(java.lang.Object value)

推奨されていません。

マップが 1 つまたは複数のキーと指定された値をマッピングしている場合に true を返します。

パラメータ:

value - 存在するか確認する値

entrySet

public java.util.Set entrySet()

推奨されていません。

マップに格納されているマッピングのコレクションビューを返します。 返されるコレクションの各要素は Map.Entry です。

equals

public boolean equals(java.lang.Object o)

推奨されていません。

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

パラメータ:

o - マップと等しいかどうかを比較するオブジェクト

get

public java.lang.Object get(java.lang.Object key)

推奨されていません。

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

パラメータ:

key - 返される値に関連付けられたキー

hashCode

public int hashCode()

推奨されていません。

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

isEmpty

public boolean isEmpty()

推奨されていません。

マップがマッピングを保持しない場合に true を返します。

keySet

public java.util.Set keySet()

推奨されていません。

マップに格納されているキーのセットビューを返します。

put

public java.lang.Object put(java.lang.Object key,
                            java.lang.Object value)

推奨されていません。

指定の値をマップ内の指定のキーと関連付けます。 マップが既にこのキーのマッピングを保持していた場合、 古い値は置き換えられ、リターンされます。

パラメータ:

key - 指定された値に関連付けられるキー

value - 指定されたキーに関連付けられる値

putAll

public void putAll(java.util.Map in)

推奨されていません。

指定されたマップからこのマップにすべてのマッピングをコピーします。 全てのマッピングは指定されたマップが持つものと置き換わります。

パラメータ:

in - マップに格納されるマッピング

remove

public java.lang.Object remove(java.lang.Object key)

推奨されていません。

指定されたキーに関連付けられた値を削除し、 関連付けられていた値を返します。

パラメータ:

key - マッピングがマップから削除されるキー

size

public int size()

推奨されていません。

マップ内のキーと値のマッピングの数を返します。

values

public java.util.Collection values()

推奨されていません。

マップに格納されている値のコレクションビューを返します。