no.digipost.concurrent

Class OneTimeToggle

java.lang.Object

no.digipost.concurrent.OneTimeToggle

All Implemented Interfaces:

TargetState

public final class OneTimeToggle
extends Object
implements TargetState

A kind of specialized variant of AtomicBoolean which can only be toggled once. There is no way to "untoggle" it. Successive attempts to toggle it with now() will have no effect, but it is possible to enforce a fail-fast toggle only once policy using nowOrIfAlreadyThenThrow(Supplier) which will throw an exception if the toggle happens several times.

See Also:

TargetState

Nested Class Summary

Nested classes/interfaces inherited from interface no.digipost.concurrent.TargetState

TargetState.TaskControl

Field Summary

Fields inherited from interface no.digipost.concurrent.TargetState

IMMEDIATELY, NEVER

Constructor Summary

Constructors

Constructor and Description
OneTimeToggle()

Method Summary

Modifier and Type	Method and Description
void	now() Toggle it! This will make yet() return true.
<E extends Throwable> void	nowOrIfAlreadyThenThrow(Supplier<E> exceptionSupplier) Toggle it, or throw exception if the toggle has already been done, for instance by another thread.
boolean	yet() Tell if the target state has been reached yet.

Methods inherited from class java.lang.Object

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

Methods inherited from interface no.digipost.concurrent.TargetState

all, all, or, untilThen, untilThen

Constructor Detail

OneTimeToggle

public OneTimeToggle()

Method Detail

now

public void now()

Toggle it! This will make yet() return true.

nowOrIfAlreadyThenThrow

public <E extends Throwable> void nowOrIfAlreadyThenThrow(Supplier<E> exceptionSupplier)
                                                   throws E extends Throwable

Toggle it, or throw exception if the toggle has already been done, for instance by another thread.

Type Parameters:

E - the exception type that this method may throw.

Parameters:

exceptionSupplier - supply exception to throw if it was already toggled.

Throws:

E extends Throwable

yet

public boolean yet()

Description copied from interface: TargetState

Tell if the target state has been reached yet. Once this method returns true, it will never return false again.

Specified by:

yet in interface TargetState

Returns:

true when the target state has been reached, false otherwise.