cz.cuni.amis.pogamut.base.component.bus.event

Class WaitForEvent

java.lang.Object

cz.cuni.amis.pogamut.base.component.bus.event.WaitForEvent

public class WaitForEvent
extends Object

Allows you to wait for some event on the bus.

WARNING: if you want to stop using this object (throw away the pointer) call DESTROY(), you will usually use try{}finally{} for this.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	WaitForEvent.IEventFilter<T> Note that only events that implements IComponentEvent may be really substitued as T.

Constructor Summary

Constructors

Constructor and Description
WaitForEvent(IComponentBus bus, WaitForEvent.IEventFilter accept)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	await() Awaits the event (forever) ...
boolean	await(long timeoutMillis) Awaits the event for a specific amount of time.
void	destroy() Destroys the object ...

Methods inherited from class java.lang.Object

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

Constructor Detail

WaitForEvent

public WaitForEvent(IComponentBus bus,
            WaitForEvent.IEventFilter accept)

Method Detail

await

public boolean await()
              throws cz.cuni.amis.utils.exception.PogamutInterruptedException

Awaits the event (forever) ... do not use! Always use version with timeout!

Returns:

whether the event has been received (false == fatal error happened)

Throws:

cz.cuni.amis.utils.exception.PogamutInterruptedException

await

public boolean await(long timeoutMillis)
              throws cz.cuni.amis.utils.exception.PogamutInterruptedException

Awaits the event for a specific amount of time.

WARNING: If the event is not received and you do not plan to use the object further - call destroy()!

Parameters:

timeoutMillis -

Returns:

whether the event has been received (false == timeout or fatal error has happened)

Throws:

InterruptedException

cz.cuni.amis.utils.exception.PogamutInterruptedException

destroy

public void destroy()

Destroys the object ... any await() call will just go through after this call.