モジュール java.base

パッケージ java.util.concurrent.atomic

クラスLongAccumulator

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()	get()に続いてreset()を実行した場合と効果は同じです。
int	intValue()	現在の値の縮小プリミティブ変換後の値をintとして返します。
long	longValue()	get()と等価です。
void	reset()	更新を保持する変数を単位元値にリセットします。
String	toString()	現在値の文字列表記を返します。

クラスjava.lang.Numberで宣言されたメソッド

byteValue, shortValue

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

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()

現在値の文字列表記を返します。

オーバーライド:

toString、クラスObject

戻り値:

現在値の文字列表現。

longValue

public long longValue()

get()と等価です。

定義:

longValue、クラスNumber

戻り値:

現行値

intValue

public int intValue()

現在の値の縮小プリミティブ変換後の値をintとして返します。

定義:

intValue、クラスNumber

戻り値:

このオブジェクトが表す数値をint型に変換した値。

floatValue

public float floatValue()

現在の値の拡張プリミティブ変換後の値をfloatとして返します。

定義:

floatValue、クラスNumber

戻り値:

このオブジェクトが表す数値をfloat型に変換した値。

doubleValue

public double doubleValue()

現在の値の拡張プリミティブ変換後の値をdoubleとして返します。

定義:

doubleValue、クラスNumber

戻り値:

このオブジェクトが表す数値をdouble型に変換した値。