org.microbean.kubernetes.controller

Class EventQueueCollection.SynchronizationAwaitingPropertyChangeListener

java.lang.Object

org.microbean.kubernetes.controller.EventQueueCollection.SynchronizationAwaitingPropertyChangeListener

All Implemented Interfaces:

PropertyChangeListener, EventListener

Enclosing class:

EventQueueCollection<T extends HasMetadata>

public static final class EventQueueCollection.SynchronizationAwaitingPropertyChangeListener
extends Object
implements PropertyChangeListener

A PropertyChangeListener specifically designed for reacting to a change in the synchronization status of an EventQueueCollection as represented by the firing of its synchronized bound Java Beans property.

Author:

Laird Nelson

See Also:

EventQueueCollection.addPropertyChangeListener(String, PropertyChangeListener), await(), propertyChange(PropertyChangeEvent)

Constructor Summary

Constructors

Constructor and Description
SynchronizationAwaitingPropertyChangeListener() Creates a new EventQueueCollection.SynchronizationAwaitingPropertyChangeListener.

Method Summary

Modifier and Type	Method and Description
void	await() Blocks until the conditions described in the documentation of the propertyChange(PropertyChangeEvent) method hold true.
@Blocking boolean	await(long timeout, TimeUnit timeUnit) Blocks until the conditions described in the documentation of the propertyChange(PropertyChangeEvent) method hold true or the indicated time has passed.
void	propertyChange(PropertyChangeEvent event) If the supplied PropertyChangeEvent is non-null, has a source that is an instance of EventQueueCollection, has a property name equal to synchronized and a new value equal to Boolean.TRUE, then it is guaranteed that any calls currently blocked on the await() or await(long, TimeUnit) methods will unblock, and subsequent invocations of those methods will never block again.

Methods inherited from class java.lang.Object

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

Constructor Detail

SynchronizationAwaitingPropertyChangeListener

public SynchronizationAwaitingPropertyChangeListener()

Creates a new EventQueueCollection.SynchronizationAwaitingPropertyChangeListener.

Method Detail

propertyChange

public final void propertyChange(PropertyChangeEvent event)

If the supplied PropertyChangeEvent is non-null, has a source that is an instance of EventQueueCollection, has a property name equal to synchronized and a new value equal to Boolean.TRUE, then it is guaranteed that any calls currently blocked on the await() or await(long, TimeUnit) methods will unblock, and subsequent invocations of those methods will never block again.

Specified by:

propertyChange in interface PropertyChangeListener

Parameters:

event - a PropertyChangeEvent fired by an EventQueueCollection; may be null in which case no action will be taken

See Also:

EventQueueCollection.addPropertyChangeListener(String, PropertyChangeListener), EventQueueCollection.isSynchronized()

await

@Blocking
public final void await()
                           throws InterruptedException

Blocks until the conditions described in the documentation of the propertyChange(PropertyChangeEvent) method hold true.

Throws:

InterruptedException - if the current Thread is interrupted

await

@Blocking
public final @Blocking boolean await(long timeout,
                                               TimeUnit timeUnit)
                                        throws InterruptedException

Blocks until the conditions described in the documentation of the propertyChange(PropertyChangeEvent) method hold true or the indicated time has passed.

Parameters:

timeout - the number of units of time to wait for

timeUnit - the unit of time designated by the timeout parameter; must not be null

Returns:

false if the waiting time elapsed before the bound property named synchronized changed its value to true; true otherwise

Throws:

InterruptedException - if the current Thread is interrupted

NullPointerException - if timeUnit is null

See Also:

propertyChange(PropertyChangeEvent)