com.neeve.ods
Interface IStoreBindingFailedEvent

All Superinterfaces:

IAlertEvent, IEvent, ILifecycleEvent, IStoreAlertEvent, IStoreEvent, IStoreLifecycleEvent, UtlReferenceTracker.HasReferenceTracker

public interface IStoreBindingFailedEvent
extends IStoreLifecycleEvent, IStoreAlertEvent

Represents the event indicating that a store binding has failed.

Threading:

This event is safe for concurrent access by multiple threads.

A store binding dispatches this event to indicates that it has 'failed'. A binding 'failure' is, essentially, a binding closure triggered implicitly by a binding on the occurrence of certain events that the binding deems fatal enough that it cannot continue operations. On a failure, a binding performs all closure operations, transitions to the failed state and then dispatches this event to the user. Although it is permissible to do, it is not necessary to close a binding on a failure (since it is already implicitly closed). Note that, if the user does choose to close the binding on subsequent to a failure, the close should not be invoked from within the binding event handler. Doing so may cause a deadlock.

Method Summary

Exception

getCause() Get the reason why the binding failed.

Methods inherited from interface com.neeve.event.lifecycle.ILifecycleEvent

getBackingMessage, getEventTime, setBackingMessage

Methods inherited from interface com.neeve.ods.IStoreEvent

getSource

Methods inherited from interface com.neeve.event.alert.IAlertEvent

getBackingMessage, getEventTime, getTriggeringMessage, setBackingMessage

Methods inherited from interface com.neeve.event.IEvent

acquire, dispose, getAcknowledger, getAttachment, getDelay, getDispatchTime, getInstanceNumber, getRemainingTime, getScheduledTime, getType, isEndOfBatch, isHandled, owners, setAcknowledger, setAttachment, setDelay, setEndOfBatch, setHandled, setSource

Methods inherited from interface com.neeve.util.UtlReferenceTracker.HasReferenceTracker

referenceTracker

Method Detail

getCause

Exception getCause()

Get the reason why the binding failed.

Threading:

This method is safe for concurrent access by multiple threads.