org.jclouds.abiquo.events.handlers

Class BlockingEventHandler<T>

java.lang.Object

org.jclouds.abiquo.events.handlers.AbstractEventHandler<T>

org.jclouds.abiquo.events.handlers.BlockingEventHandler<T>

Type Parameters:

T - The monitored object.

public class BlockingEventHandler<T>
extends AbstractEventHandler<T>

An event handler that blocks the thread until all monitored objects have been finished being watched.

Due to Guava Issue 786 handle(MonitorEvent) is marked finalto avoid having duplicate events.

Author:

Ignasi Barrera

Field Summary

Fields

Modifier and Type	Field and Description
protected List<T>	lockedObjects The objects being locked.

Fields inherited from class org.jclouds.abiquo.events.handlers.AbstractEventHandler

logger

Constructor Summary

Constructors

Constructor and Description
BlockingEventHandler(Logger logger, T... lockedObjects)
BlockingEventHandler(T... lockedObjects)

Method Summary

Methods

Modifier and Type	Method and Description
protected void	doBeforeRelease(MonitorEvent<T> event) Convenience method to bypass the Guava Issue 786 that forces the subscriber method to be final.
void	handle(MonitorEvent<T> event) Handles the dispatched event in a thread safe way.
protected boolean	handles(MonitorEvent<T> event) Checks if the current handler must handle the dispatched event.
void	lock() Blocks the thread until all locked objects have been released.
protected void	release(T target) Releases the lock on the given object.

Methods inherited from class org.jclouds.abiquo.events.handlers.AbstractEventHandler

getLogger, setLogger

Methods inherited from class java.lang.Object

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

Field Detail

lockedObjects

protected List<T> lockedObjects

The objects being locked.

This class handles events in a thread safe way. Otherwise this collections should be synchronised.

Constructor Detail

BlockingEventHandler

public BlockingEventHandler(T... lockedObjects)

BlockingEventHandler

public BlockingEventHandler(Logger logger,
                    T... lockedObjects)

Method Detail

handles

protected boolean handles(MonitorEvent<T> event)

Description copied from class: AbstractEventHandler

Checks if the current handler must handle the dispatched event.

Specified by:

handles in class AbstractEventHandler<T>

Parameters:

event - The event being dispatched.

Returns:

Boolean indicating if the event must be handled by the current handler.

handle

public final void handle(MonitorEvent<T> event)

Handles the dispatched event in a thread safe way.

Due to Guava Issue 786 handle(MonitorEvent) is marked finalto avoid having duplicate events.

See Also:

#doBeforeRelease(MonitorEvent)}

lock

public void lock()

Blocks the thread until all locked objects have been released.

release

protected void release(T target)

Releases the lock on the given object.

doBeforeRelease

protected void doBeforeRelease(MonitorEvent<T> event)

Convenience method to bypass the Guava Issue 786 that forces the subscriber method to be final.