java.lang.Object
java.lang.Number
java.util.concurrent.atomic.LongAccumulator
- すべての実装されたインタフェース:
Serializable
public class LongAccumulator extends Number implements Serializable
指定された関数を使用して更新される処理中の
long
値を一緒に保持する1つ以上の変数。 更新(メソッドaccumulate(long)
)がスレッド間で競合すると、競合を減らすために変数セットが動的に拡大する場合があります。 メソッドget()
(または、等価のlongValue()
)は、更新を保持している変数にまたがる現在の値を返します。
きめ細かい同期制御のためではなく統計収集などの目的に使用される共通の値が、複数のスレッドによって更新される場合、通常はAtomicLong
よりもこのクラスをお薦めします。 更新の競合が少ないときは、2つのクラスの特徴は似ています。 競合が多いときは、期待されるスループットはこのクラスの方がかなり高くなります。ただし、容量消費も多くなります。
スレッド内またはスレッド間での累積の順序は保証されていないため、それに依存することはできません。したがって、累積の順序が重要でない関数に対してのみ、このクラスを適用できます。 指定されたアキュムレータ関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。 予測可能な結果のためには、アキュムレータ関数は連想的かつ可換でなければなりません。 この関数は、既存の値(または同一性)を1つの引数として、与えられた更新をもう1つの引数として適用します。 たとえば、処理中の最大値を保持するために、 Long::max
とともにLong.MIN_VALUE
を単位元として指定することができます。
クラスLongAdder
は、このクラスの機能に似た、カウントと合計を保持するという共通の特殊ケースのための機能を提供します。 new LongAdder()
呼出しはnew LongAccumulator((x, y) -> x + y, 0L)
と等価です。
このクラスはNumber
を拡張しますが、equals
、hashCode
、 compareTo
などのメソッドを定義しません。インスタンスでは変更が想定されているため、コレクション・キーとしては役立たないからです。
- 導入されたバージョン:
- 1.8
- 関連項目:
- 直列化された形式
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 LongAccumulator(LongBinaryOperator accumulatorFunction, long identity)
指定されたアキュムレータ関数と単位元を使用して、新しいインスタンスを作成します。 -
メソッドのサマリー
修飾子と型 メソッド 説明 void
accumulate(long x)
指定された値で更新します。double
doubleValue()
現在の値の拡張プリミティブ変換後の値をdouble
として返します。float
floatValue()
現在の値の拡張プリミティブ変換後の値をfloat
として返します。long
get()
現在の値を返します。long
getThenReset()
int
intValue()
現在の値の縮小プリミティブ変換後の値をint
として返します。long
longValue()
get()
と等価です。void
reset()
更新を保持する変数を単位元値にリセットします。String
toString()
現在値の文字列表記を返します。クラス java.lang.Numberで宣言されたメソッド
byteValue, shortValue
-
コンストラクタの詳細
-
LongAccumulator
public LongAccumulator(LongBinaryOperator accumulatorFunction, long identity)指定されたアキュムレータ関数と単位元を使用して、新しいインスタンスを作成します。- パラメータ:
accumulatorFunction
- 2つの引数を取る、副作用のない関数identity
- アキュムレータ関数の単位元(初期値)
-
-
メソッドの詳細
-
ACCUMulate
public void accumulate(long x)指定された値で更新します。- パラメータ:
x
- 値
-
get
public long get()現在の値を返します。 返される値は原子的スナップショットではありません。並行更新がない場合の呼出しでは正確な結果が返されますが、値の計算中に発生した並行更新は組み込まれない可能性があります。- 戻り値:
- 現行値
-
reset
public void reset()更新を保持する変数を単位元値にリセットします。 このメソッドは、新しいアップデータを作成する代わりに利用できますが、並行更新がない場合のみ有効です。 このメソッドは本質的に危ういので、並行して更新を行っているスレッドがないことがわかっている場合のみ使用するようにしてください。 -
getThenReset
public long getThenReset()get()
に続いてreset()
を実行した場合と効果は同じです。 たとえば、マルチスレッド計算の間の静止点の期間中に、このメソッドが適用される場合があります。 このメソッドと並行して更新が行われている場合、返される値は、リセット前に発生した最終の値であることは保証されません。- 戻り値:
- リセット前の値
-
toString
public String toString()現在値の文字列表記を返します。 -
longValue
public long longValue()get()
と等価です。 -
intValue
public int intValue()現在の値の縮小プリミティブ変換後の値をint
として返します。 -
floatValue
public float floatValue()現在の値の拡張プリミティブ変換後の値をfloat
として返します。- 定義:
floatValue
、クラス:Number
- 戻り値:
- このオブジェクトが表す数値を
float
型に変換した値。
-
doubleValue
public double doubleValue()現在の値の拡張プリミティブ変換後の値をdouble
として返します。- 定義:
doubleValue
、クラス:Number
- 戻り値:
- このオブジェクトが表す数値を
double
型に変換した値。
-