io.neba.core.blueprint

Class EventhandlingBarrier

java.lang.Object

io.neba.core.blueprint.EventhandlingBarrier

public class EventhandlingBarrier
extends Object

Contains a global Lock on which the event handlers changing the framework state (e.g. registered models or self tests) may synchronize to prevent undefined state due to concurrent modifications.
begin() must always be followed by end(), i.e. end() should be included in a finally block like so:

 EventHandling.begin();
 try {
    // do something
 } finally {
    EventHandling.end();
 }
 

Author:

Olaf Otto

Method Summary

Methods

Modifier and Type	Method and Description
static void	begin() Tries to obtain a lock.
static void	end()
static boolean	tryBegin() This method tries to obtain a lock and return false if this does not succeed.

Methods inherited from class java.lang.Object

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

Method Detail

begin

public static void begin()

Tries to obtain a lock. Waits up to ten minutes for the locking to succeed, or fails with an IllegalStateException. Rationale: Waiting indefinitely for a lock is bad practice, since it enables deadlocks.

tryBegin

public static boolean tryBegin()

This method tries to obtain a lock and return false if this does not succeed. This method can be used if the execution of the synchronous code is optional and may otherwise result in a deadlock.

See Also:

Lock.tryLock(long, java.util.concurrent.TimeUnit)

end

public static void end()

See Also:

begin()