org.xwiki.observation.event
Class AbstractCancelableEvent

java.lang.Object
  org.xwiki.observation.event.AbstractFilterableEvent
      org.xwiki.observation.event.AbstractCancelableEvent

All Implemented Interfaces:

java.io.Serializable, CancelableEvent, Event, FilterableEvent

public abstract class AbstractCancelableEvent
extends AbstractFilterableEvent
implements CancelableEvent

Abstract base class for cancelable events.

Since:

2.5M1

Version:

$Id$

See Also:

Serialized Form

Constructor Summary

protected	AbstractCancelableEvent() Constructor initializing the event filter with an AlwaysMatchingEventFilter, meaning that this event will match any other event of the same type.
protected	AbstractCancelableEvent(EventFilter eventFilter) Constructor using a custom EventFilter.
protected	AbstractCancelableEvent(java.lang.String name) Constructor initializing the event filter with a FixedNameEventFilter, meaning that this event will match only events of the same type affecting the same passed name.

Method Summary

void	cancel() Cancel the event.
void	cancel(java.lang.String reason) Cancel the event, giving a reason why.
java.lang.String	getReason() Get the reason why the event was canceled.
boolean	isCanceled() Check if this event was canceled by one of the receivers.

Methods inherited from class org.xwiki.observation.event.AbstractFilterableEvent

getEventFilter, matches

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.xwiki.observation.event.Event

matches

Constructor Detail

AbstractCancelableEvent

protected AbstractCancelableEvent()

Constructor initializing the event filter with an AlwaysMatchingEventFilter, meaning that this event will match any other event of the same type.

AbstractCancelableEvent

protected AbstractCancelableEvent(java.lang.String name)

Constructor initializing the event filter with a FixedNameEventFilter, meaning that this event will match only events of the same type affecting the same passed name.

Parameters:

name - a generic name that uniquely identifies an event type

AbstractCancelableEvent

protected AbstractCancelableEvent(EventFilter eventFilter)

Constructor using a custom EventFilter.

Parameters:

eventFilter - the filter to use for matching events

Method Detail

isCanceled

public boolean isCanceled()

Check if this event was canceled by one of the receivers.

Specified by:

isCanceled in interface CancelableEvent

Returns:

true if the event was canceled, false otherwise

See Also:

CancelableEvent.isCanceled()

cancel

public void cancel()

Cancel the event. The actual canceling will be performed by the sender.

Specified by:

cancel in interface CancelableEvent

See Also:

CancelableEvent.cancel()

cancel

public void cancel(java.lang.String reason)

Cancel the event, giving a reason why. The actual canceling will be performed by the sender.

Specified by:

cancel in interface CancelableEvent

Parameters:

reason - the reason why the event was canceled

See Also:

CancelableEvent.cancel(java.lang.String)

getReason

public java.lang.String getReason()

Get the reason why the event was canceled.

Specified by:

getReason in interface CancelableEvent

Returns:

reason for cancel or null of the event was not canceled or canceled using CancelableEvent.cancel()

See Also:

CancelableEvent.getReason()