com.atlassian.bitbucket.event.permission

Class RepositoryPermissionModificationRequestedEvent

java.lang.Object

java.util.EventObject

com.atlassian.bitbucket.event.ApplicationEvent

com.atlassian.bitbucket.event.permission.PermissionEvent

com.atlassian.bitbucket.event.permission.RepositoryPermissionEvent

com.atlassian.bitbucket.event.permission.AbstractRepositoryPermissionModificationEvent

com.atlassian.bitbucket.event.permission.RepositoryPermissionModificationRequestedEvent

All Implemented Interfaces:

CancelableEvent, PermissionModificationRequestedEvent, CancelState, Serializable

@TransactionAware(value=IMMEDIATE)
public class RepositoryPermissionModificationRequestedEvent
extends AbstractRepositoryPermissionModificationEvent
implements PermissionModificationRequestedEvent

This event is raised before a user or group's repository permission is modified. This event is synchronous, allowing listeners to perform operations in the same database transaction where the permission is modified.

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

This event is internally audited with CoverageLevel.BASE level.

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor and Description
RepositoryPermissionModificationRequestedEvent(Object source, Permission oldValue, Permission newValue, Repository repository, String affectedGroup, ApplicationUser affectedUser, CancelState cancelState)

Method Summary

Modifier and Type	Method and Description
void	cancel(KeyedMessage message) Cancels the operation, providing a message explaining why.
boolean	isCanceled() Retrieves a flag indicating whether the operation has been canceled.

Methods inherited from class com.atlassian.bitbucket.event.permission.AbstractRepositoryPermissionModificationEvent

getNewValue, getOldValue

Methods inherited from class com.atlassian.bitbucket.event.permission.RepositoryPermissionEvent

getRepository

Methods inherited from class com.atlassian.bitbucket.event.permission.PermissionEvent

getAffectedGroup, getAffectedUser, getPermission

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

Methods inherited from interface com.atlassian.bitbucket.event.permission.PermissionModificationRequestedEvent

getNewValue, getOldValue

Constructor Detail

RepositoryPermissionModificationRequestedEvent

public RepositoryPermissionModificationRequestedEvent(@Nonnull
                                                      Object source,
                                                      @Nonnull
                                                      Permission oldValue,
                                                      @Nonnull
                                                      Permission newValue,
                                                      @Nonnull
                                                      Repository repository,
                                                      @Nullable
                                                      String affectedGroup,
                                                      @Nullable
                                                      ApplicationUser affectedUser,
                                                      @Nonnull
                                                      CancelState cancelState)

Method Detail

cancel

public void cancel(@Nonnull
                   KeyedMessage message)

Description copied from interface: CancelState

Cancels the operation, providing a message explaining why.

The cancellation message is required, and should be as descriptive and clear as possible to allow end users to correct, if possible, the issue that triggered cancellation.

Specified by:

cancel in interface CancelState

Parameters:

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

isCanceled

public boolean isCanceled()

Description copied from interface: CancelState

Retrieves a flag indicating whether the operation has been canceled.

In situations where multiple observers have the option to cancel an operation, for example when multiple listeners receive the same CancelableEvent, this flag can be useful for determining that another observer has already canceled the operation.

Specified by:

isCanceled in interface CancelState

Returns:

true if the operation has been canceled; otherwise, false