com.atlassian.bitbucket.event.attachment

Class AttachmentDeletionRequestedEvent

java.lang.Object

java.util.EventObject

com.atlassian.bitbucket.event.ApplicationEvent

com.atlassian.bitbucket.event.attachment.AttachmentEvent

com.atlassian.bitbucket.event.attachment.AttachmentDeletionRequestedEvent

All Implemented Interfaces:

CancelableEvent, CancelState, Serializable

@TransactionAware(value=IMMEDIATE)
public class AttachmentDeletionRequestedEvent
extends AttachmentEvent
implements CancelableEvent

Raised just before an attachment is deleted. This event is synchronous, allowing listeners to perform operations in the same database transaction where the attachment will be deleted.

This event is cancelable. A listener may prevent the attachment from being deleted by canceling this event. Throwing an exception will not prevent the attachment from being deleted; the exception will be logged and ignored.

Since:

7.0

See Also:

AttachmentService.delete(Repository, long), Serialized Form

Field Summary

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor and Description
AttachmentDeletionRequestedEvent(Object source, Repository repository, Attachment attachment, CancelState cancelState)

Method Summary

Modifier and Type	Method and Description
void	cancel(KeyedMessage message) Cancels attachment deletion, providing a message explaining why.
boolean	isCanceled() Retrieves a flag indicating whether attachment deletion has already been canceled by another listener.

Methods inherited from class com.atlassian.bitbucket.event.attachment.AttachmentEvent

getAttachment, getRepository

Methods inherited from class com.atlassian.bitbucket.event.ApplicationEvent

getDate, getUser

Methods inherited from class java.util.EventObject

getSource, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

AttachmentDeletionRequestedEvent

public AttachmentDeletionRequestedEvent(@Nonnull
                                        Object source,
                                        @Nonnull
                                        Repository repository,
                                        @Nonnull
                                        Attachment attachment,
                                        @Nonnull
                                        CancelState cancelState)

Method Detail

cancel

public void cancel(@Nonnull
                   KeyedMessage message)

Cancels attachment deletion, providing a message explaining why.

Specified by:

cancel in interface CancelState

Parameters:

message - a descriptive message explaining why the operation has been canceled

isCanceled

public boolean isCanceled()

Retrieves a flag indicating whether attachment deletion has already been canceled by another listener.

Specified by:

isCanceled in interface CancelState

Returns:

true if another listener has already canceled attachment deletion; otherwise false