All Superinterfaces:: AuditableRestAction<PermissionOverride>, RestAction<PermissionOverride>

public interface PermissionOverrideAction extends AuditableRestAction<PermissionOverride>

Extension of AuditableRestAction specifically designed to create a PermissionOverride for a GuildChannel. This extension allows setting properties before executing the action.

Since:

3.0

See Also:

Method Summary

Modifier and Type

Method

Description

PermissionOverrideAction

clear(long inheritedBits)

Clears the provided Permissions bits from the PermissionOverride.

default PermissionOverrideAction

clear(Collection<Permission> permissions)

Clears the provided Permissions bits from the PermissionOverride.

default PermissionOverrideAction

clear(Permission... permissions)

Clears the provided Permissions bits from the PermissionOverride.

PermissionOverrideAction

deadline(long timestamp)

Similar to RestAction.timeout(long, TimeUnit) but schedules a deadline at which the request has to be completed.

PermissionOverrideAction

deny(long denyBits)

Denies the specified permissions.

default PermissionOverrideAction

deny(Collection<Permission> permissions)

Denies the specified permissions.

default PermissionOverrideAction

deny(Permission... permissions)

Denies the specified permissions.

long

getAllow()

The currently set of allowed permission bits.

default EnumSet<Permission>

getAllowedPermissions()

Set of Permissions that would be granted by the PermissionOverride that is created by this action.

GuildChannel

getChannel()

The GuildChannel this will be created in

default EnumSet<Permission>

getDeniedPermissions()

Set of Permissions that would be denied by the PermissionOverride that is created by this action.

long

getDeny()

The currently set of denied permission bits.

default Guild

getGuild()

The Guild for this override

long

getInherited()

The currently set of inherited permission bits.

default EnumSet<Permission>

getInheritedPermissions()

Set of Permissions that would be inherited from other permission holders.

Member

getMember()

The Member for this override

Role

getRole()

The Role for this override

PermissionOverrideAction

grant(long allowBits)

Grants the specified permissions.

default PermissionOverrideAction

grant(Collection<Permission> permissions)

Grants the specified permissions.

default PermissionOverrideAction

grant(Permission... permissions)

Grants the specified permissions.

boolean

isMember()

Whether this Action will create a PermissionOverride for a Member or not

boolean

isRole()

Whether this Action will create a PermissionOverride for a Role or not

default PermissionOverrideAction

reset()

Shortcut for resetAllow().resetDeny().

PermissionOverrideAction

resetAllow()

Resets the allowed permissions to the current original value.

PermissionOverrideAction

resetDeny()

Resets the denied permissions to the current original value.

PermissionOverrideAction

setAllow(long allowBits)

Sets the value of explicitly granted permissions using the bitwise representation of a set of Permissions.

default PermissionOverrideAction

setAllow(Collection<Permission> permissions)

Sets the value of explicitly granted permissions using a Collection of Permissions.

default PermissionOverrideAction

setAllow(Permission... permissions)

Sets the value of explicitly granted permissions using a set of Permissions.

PermissionOverrideAction

setCheck(BooleanSupplier checks)

Sets the last-second checks before finally executing the http request in the queue.

PermissionOverrideAction

setDeny(long denyBits)

Sets the value of explicitly denied permissions using the bitwise representation of a set of Permissions.

default PermissionOverrideAction

setDeny(Collection<Permission> permissions)

Sets the value of explicitly denied permissions using a Collection of Permissions.

default PermissionOverrideAction

setDeny(Permission... permissions)

Sets the value of explicitly denied permissions using a set of Permissions.

PermissionOverrideAction

setPermissions(long allowBits, long denyBits)

Combination of setAllow(long) and setDeny(long)
First sets the allow bits and then the deny bits.

default PermissionOverrideAction

setPermissions(Collection<Permission> grantPermissions, Collection<Permission> denyPermissions)

Combination of setAllow(java.util.Collection) and setDeny(java.util.Collection)
First sets the granted permissions and then the denied permissions.

PermissionOverrideAction

timeout(long timeout, TimeUnit unit)

Timeout for this RestAction instance.

Methods inherited from interface net.dv8tion.jda.api.requests.restaction.AuditableRestAction
reason

Methods inherited from interface net.dv8tion.jda.api.requests.RestAction
addCheck, and, and, complete, complete, completeAfter, delay, delay, delay, delay, flatMap, flatMap, getCheck, getJDA, map, mapToResult, onErrorFlatMap, onErrorFlatMap, onErrorMap, onErrorMap, queue, queue, queue, queueAfter, queueAfter, queueAfter, queueAfter, queueAfter, queueAfter, submit, submit, submitAfter, submitAfter, zip

Method Details
- setCheck
  
  @Nonnull PermissionOverrideAction setCheck(@Nullable BooleanSupplier checks)
  
  Description copied from interface: AuditableRestAction
  
  Sets the last-second checks before finally executing the http request in the queue.
  If the provided supplier evaluates to false or throws an exception this will not be finished. When an exception is thrown from the supplier it will be provided to the failure callback.
  Specified by:
  
  setCheck in interface AuditableRestAction<PermissionOverride>
  
  Specified by:
  
  setCheck in interface RestAction<PermissionOverride>
  
  Parameters:
  
  checks - The checks to run before executing the request, or null to run no checks
  
  Returns:
  
  The current RestAction for chaining convenience
  
  See Also:
  
  RestAction.getCheck()
  
  RestAction.addCheck(BooleanSupplier)
- timeout
  
  @Nonnull PermissionOverrideAction timeout(long timeout, @Nonnull TimeUnit unit)
  
  Description copied from interface: AuditableRestAction
  Timeout for this RestAction instance.
  If the request doesn't get executed within the timeout it will fail.
  When a RestAction times out, it will fail with a TimeoutException. This is the same as deadline(System.currentTimeMillis() + unit.toMillis(timeout)).
  Example
  
  action.timeout(10, TimeUnit.SECONDS) // 10 seconds from now .queueAfter(20, SECONDS); // request will not be executed within deadline and timeout immediately after 20 seconds
  Specified by:
  
  timeout in interface AuditableRestAction<PermissionOverride>
  
  Specified by:
  
  timeout in interface RestAction<PermissionOverride>
  
  Parameters:
  
  timeout - The timeout to use
  
  unit - Unit for the timeout value
  
  Returns:
  
  The same RestAction instance with the applied timeout
  
  See Also:
  
  RestAction.setDefaultTimeout(long, TimeUnit)
- deadline
  
  @Nonnull PermissionOverrideAction deadline(long timestamp)
  
  Description copied from interface: AuditableRestAction
  Similar to RestAction.timeout(long, TimeUnit) but schedules a deadline at which the request has to be completed.
  If the deadline is reached, the request will fail with a TimeoutException.
  This does not mean that the request will immediately timeout when the deadline is reached. JDA will check the deadline right before executing the request or within intervals in a worker thread. This only means the request will timeout if the deadline has passed.
  Example
  
  action.deadline(System.currentTimeMillis() + 10000) // 10 seconds from now .queueAfter(20, SECONDS); // request will not be executed within deadline and timeout immediately after 20 seconds
  Specified by:
  
  deadline in interface AuditableRestAction<PermissionOverride>
  
  Specified by:
  
  deadline in interface RestAction<PermissionOverride>
  
  Parameters:
  
  timestamp - Millisecond timestamp at which the request will timeout
  
  Returns:
  
  The same RestAction with the applied deadline
  
  See Also:
  
  RestAction.timeout(long, TimeUnit)
  
  RestAction.setDefaultTimeout(long, TimeUnit)
- reset
  
  @Nonnull default PermissionOverrideAction reset()
  
  Shortcut for resetAllow().resetDeny().
  The permission override will be empty after this operation
  
  Returns:
  
  The current PermissionOverrideAction for chaining convenience
- resetAllow
  
  @Nonnull PermissionOverrideAction resetAllow()
  
  Resets the allowed permissions to the current original value.
  For a new override this will just be 0.
  
  Returns:
  
  The current PermissionOverrideAction for chaining convenience
- resetDeny
  
  @Nonnull PermissionOverrideAction resetDeny()
  
  Resets the denied permissions to the current original value.
  For a new override this will just be 0.
  
  Returns:
  
  The current PermissionOverrideAction for chaining convenience
- getChannel
  
  @Nonnull GuildChannel getChannel()
  
  The GuildChannel this will be created in
  
  Returns:
  
  The channel
- getRole
  
  @Nullable Role getRole()
  
  The Role for this override
  
  Returns:
  
  The role, or null if this is a member override
- getMember
  
  @Nullable Member getMember()
  
  The Member for this override
  
  Returns:
  
  The member, or null if this is a role override
- getGuild
  
  @Nonnull default Guild getGuild()
  
  The Guild for this override
  
  Returns:
  
  The guild
- getAllow
  
  long getAllow()
  
  The currently set of allowed permission bits.
  This value represents all granted permissions in the raw bitwise representation.
  Use getAllowedPermissions() to retrieve a List with Permissions for this value
  
  Returns:
  
  long value of granted permissions
- getAllowedPermissions
  
  @Nonnull default EnumSet<Permission> getAllowedPermissions()
  
  Set of Permissions that would be granted by the PermissionOverride that is created by this action.
  Changes to the returned set do not affect this entity directly.
  
  Returns:
  
  set of granted Permissions
- getDeny
  
  long getDeny()
  
  The currently set of denied permission bits.
  This value represents all denied permissions in the raw bitwise representation.
  Use getDeniedPermissions() to retrieve a List with Permissions for this value
  
  Returns:
  
  long value of denied permissions
- getDeniedPermissions
  
  @Nonnull default EnumSet<Permission> getDeniedPermissions()
  
  Set of Permissions that would be denied by the PermissionOverride that is created by this action.
  Changes to the returned set do not affect this entity directly.
  
  Returns:
  
  set of denied Permissions
- getInherited
  
  long getInherited()
  
  The currently set of inherited permission bits.
  This value represents all permissions that are not explicitly allowed or denied in their raw bitwise representation.
  Inherited Permissions are permissions that are defined by other rules from maybe other PermissionOverrides or a Role.
  Use getInheritedPermissions() to retrieve a List with Permissions for this value
  
  Returns:
  
  long value of inherited permissions
- getInheritedPermissions
  
  @Nonnull default EnumSet<Permission> getInheritedPermissions()
  
  Set of Permissions that would be inherited from other permission holders.
  Permissions returned are not explicitly granted or denied!
  Changes to the returned set do not affect this entity directly.
  Returns:
  
  set of inherited Permissions
  
  See Also:
  
  getInherited()
- isMember
  
  boolean isMember()
  
  Whether this Action will create a PermissionOverride for a Member or not
  
  Returns:
  
  True, if this is targeting a Member If this is false it is targeting a Role. (isRole())
- isRole
  
  boolean isRole()
  
  Whether this Action will create a PermissionOverride for a Role or not
  
  Returns:
  
  True, if this is targeting a Role. If this is false it is targeting a Member. (isMember())
- setAllow
  
  @Nonnull @CheckReturnValue PermissionOverrideAction setAllow(long allowBits)
  
  Sets the value of explicitly granted permissions using the bitwise representation of a set of Permissions.
  This value can be retrieved through Permissions.getRaw(Permission...)!
  Note: Permissions not marked as isChannel() will have no affect!
  All newly granted permissions will be removed from the currently set denied permissions.
  allow = allowBits; deny = deny & ~allowBits;
  Parameters:
  
  allowBits - The positive bits representing the granted permissions for the new PermissionOverride
  
  Returns:
  
  The current PermissionOverrideAction - for chaining convenience
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_PERMISSIONS on the channel and tries to set permissions it does not have in the channel
  
  See Also:
  
  setAllow(Collection)
  
  setAllow(Permission...)
- setAllow
  
  @Nonnull @CheckReturnValue default PermissionOverrideAction setAllow(@Nullable Collection<Permission> permissions)
  
  Sets the value of explicitly granted permissions using a Collection of Permissions.
  Note: Permissions not marked as isChannel() will have no affect!
  Example: setAllow(EnumSet.of(Permission.VIEW_CHANNEL))
  Parameters:
  
  permissions - The Collection of Permissions representing the granted permissions for the new PermissionOverride.
  If the provided value is null the permissions are reset to the default of none
  
  Returns:
  
  The current PermissionOverrideAction - for chaining convenience
  
  Throws:
  
  IllegalArgumentException - If the any of the specified Permissions is null
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_PERMISSIONS on the channel and tries to set permissions it does not have in the channel
  
  See Also:
  
  EnumSet
  
  setAllow(Permission...)
- setAllow
  
  @Nonnull @CheckReturnValue default PermissionOverrideAction setAllow(@Nullable Permission... permissions)
  
  Sets the value of explicitly granted permissions using a set of Permissions.
  Note: Permissions not marked as isChannel() will have no affect!
  
  Parameters:
  
  permissions - The Permissions representing the granted permissions for the new PermissionOverride.
  If the provided value is null the permissions are reset to the default of none
  
  Returns:
  
  The current PermissionOverrideAction - for chaining convenience
  
  Throws:
  
  IllegalArgumentException - If the any of the specified Permissions is null
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_PERMISSIONS on the channel and tries to set permissions it does not have in the channel
- grant
  
  @Nonnull @CheckReturnValue PermissionOverrideAction grant(long allowBits)
  
  Grants the specified permissions.
  This does not override already granted permissions.
  
  Parameters:
  
  allowBits - The permissions to grant, in addition to already allowed permissions
  
  Returns:
  
  The current PermissionOverrideAction - for chaining convenience
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_PERMISSIONS on the channel and tries to set permissions it does not have in the channel
- grant
  
  @Nonnull @CheckReturnValue default PermissionOverrideAction grant(@Nonnull Collection<Permission> permissions)
  
  Grants the specified permissions.
  This does not override already granted permissions.
  
  Parameters:
  
  permissions - The permissions to grant, in addition to already allowed permissions
  
  Returns:
  
  The current PermissionOverrideAction - for chaining convenience
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_PERMISSIONS on the channel and tries to set permissions it does not have in the channel
  
  IllegalArgumentException - If any provided argument is null
- grant
  
  @Nonnull @CheckReturnValue default PermissionOverrideAction grant(@Nonnull Permission... permissions)
  
  Grants the specified permissions.
  This does not override already granted permissions.
  
  Parameters:
  
  permissions - The permissions to grant, in addition to already allowed permissions
  
  Returns:
  
  The current PermissionOverrideAction - for chaining convenience
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_PERMISSIONS on the channel and tries to set permissions it does not have in the channel
  
  IllegalArgumentException - If any provided argument is null
- setDeny
  
  @Nonnull @CheckReturnValue PermissionOverrideAction setDeny(long denyBits)
  
  Sets the value of explicitly denied permissions using the bitwise representation of a set of Permissions.
  This value can be retrieved through Permissions.getRaw(Permission...)!
  Note: Permissions not marked as isChannel() will have no affect!
  All newly denied permissions will be removed from the currently set allowed permissions.
  deny = denyBits; allow = allow & ~denyBits;
  Parameters:
  
  denyBits - The positive bits representing the denied permissions for the new PermissionOverride
  
  Returns:
  
  The current PermissionOverrideAction - for chaining convenience
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_PERMISSIONS on the channel and tries to set permissions it does not have in the channel
  
  See Also:
  
  setDeny(Collection)
  
  setDeny(Permission...)
- setDeny
  
  @Nonnull @CheckReturnValue default PermissionOverrideAction setDeny(@Nullable Collection<Permission> permissions)
  
  Sets the value of explicitly denied permissions using a Collection of Permissions.
  Note: Permissions not marked as isChannel() will have no affect!
  Example: setDeny(EnumSet.of(Permission.MESSAGE_SEND, Permission.MESSAGE_EXT_EMOJI))
  Parameters:
  
  permissions - The Collection of Permissions representing the denied permissions for the new PermissionOverride.
  If the provided value is null the permissions are reset to the default of none
  
  Returns:
  
  The current PermissionOverrideAction - for chaining convenience
  
  Throws:
  
  IllegalArgumentException - If the any of the specified Permissions is null
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_PERMISSIONS on the channel and tries to set permissions it does not have in the channel
  
  See Also:
  
  EnumSet
  
  setDeny(Permission...)
- setDeny
  
  @Nonnull @CheckReturnValue default PermissionOverrideAction setDeny(@Nullable Permission... permissions)
  
  Sets the value of explicitly denied permissions using a set of Permissions.
  Note: Permissions not marked as isChannel() will have no affect!
  
  Parameters:
  
  permissions - The Permissions representing the denied permissions for the new PermissionOverride.
  If the provided value is null the permissions are reset to the default of none
  
  Returns:
  
  The current PermissionOverrideAction - for chaining convenience
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_PERMISSIONS on the channel and tries to set permissions it does not have in the channel
  
  IllegalArgumentException - If the any of the specified Permissions is null
- deny
  
  @Nonnull @CheckReturnValue PermissionOverrideAction deny(long denyBits)
  
  Denies the specified permissions.
  This does not override already denied permissions.
  
  Parameters:
  
  denyBits - The permissions to deny, in addition to already denied permissions
  
  Returns:
  
  The current PermissionOverrideAction - for chaining convenience
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_PERMISSIONS on the channel and tries to set permissions it does not have in the channel
- deny
  
  @Nonnull @CheckReturnValue default PermissionOverrideAction deny(@Nonnull Collection<Permission> permissions)
  
  Denies the specified permissions.
  This does not override already denied permissions.
  
  Parameters:
  
  permissions - The permissions to deny, in addition to already denied permissions
  
  Returns:
  
  The current PermissionOverrideAction - for chaining convenience
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_PERMISSIONS on the channel and tries to set permissions it does not have in the channel
  
  IllegalArgumentException - If any provided argument is null
- deny
  
  @Nonnull @CheckReturnValue default PermissionOverrideAction deny(@Nonnull Permission... permissions)
  
  Denies the specified permissions.
  This does not override already denied permissions.
  
  Parameters:
  
  permissions - The permissions to deny, in addition to already denied permissions
  
  Returns:
  
  The current PermissionOverrideAction - for chaining convenience
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_PERMISSIONS on the channel and tries to set permissions it does not have in the channel
  
  IllegalArgumentException - If any provided argument is null
- clear
  
  @Nonnull @CheckReturnValue PermissionOverrideAction clear(long inheritedBits)
  
  Clears the provided Permissions bits from the PermissionOverride.
  This will cause the provided Permissions to be inherited from other overrides or roles.
  
  Parameters:
  
  inheritedBits - The permissions to clear from the PermissionOverride
  
  Returns:
  
  The current PermissionOverrideAction - for chaining convenience
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_PERMISSIONS on the channel and tries to set permissions it does not have in the channel
- clear
  
  @Nonnull @CheckReturnValue default PermissionOverrideAction clear(@Nonnull Collection<Permission> permissions)
  
  Clears the provided Permissions bits from the PermissionOverride.
  This will cause the provided Permissions to be inherited
  
  Parameters:
  
  permissions - The permissions to clear from the PermissionOverride
  
  Returns:
  
  The current PermissionOverrideAction - for chaining convenience
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_PERMISSIONS on the channel and tries to set permissions it does not have in the channel
  
  IllegalArgumentException - If any provided argument is null
- clear
  
  @Nonnull @CheckReturnValue default PermissionOverrideAction clear(@Nonnull Permission... permissions)
  
  Clears the provided Permissions bits from the PermissionOverride.
  This will cause the provided Permissions to be inherited
  
  Parameters:
  
  permissions - The permissions to clear from the PermissionOverride
  
  Returns:
  
  The current PermissionOverrideAction - for chaining convenience
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_PERMISSIONS on the channel and tries to set permissions it does not have in the channel
  
  IllegalArgumentException - If any provided argument is null
- setPermissions
  
  @Nonnull @CheckReturnValue PermissionOverrideAction setPermissions(long allowBits, long denyBits)
  
  Combination of setAllow(long) and setDeny(long)
  First sets the allow bits and then the deny bits.
  Parameters:
  
  allowBits - An unsigned bitwise representation of granted Permissions
  
  denyBits - An unsigned bitwise representation of denied Permissions
  
  Returns:
  
  The current PermissionOverrideAction - for chaining convenience
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_PERMISSIONS on the channel and tries to set permissions it does not have in the channel
  
  See Also:
  
  setPermissions(java.util.Collection, java.util.Collection)
  
  Permission.getRaw(Permission...)
  
  Permission.getRaw(Collection)
- setPermissions
  
  @Nonnull @CheckReturnValue default PermissionOverrideAction setPermissions(@Nullable Collection<Permission> grantPermissions, @Nullable Collection<Permission> denyPermissions)
  
  Combination of setAllow(java.util.Collection) and setDeny(java.util.Collection)
  First sets the granted permissions and then the denied permissions.
  If a passed collection is null it resets the represented value to 0 - no permission specifics.
  Example: setPermissions(EnumSet.of(Permission.VIEW_CHANNEL), EnumSet.of(Permission.MESSAGE_SEND, Permission.MESSAGE_EXT_EMOJI))
  Parameters:
  
  grantPermissions - A Collection of Permissions representing all explicitly granted Permissions for the PermissionOverride
  
  denyPermissions - A Collection of Permissions representing all explicitly denied Permissions for the PermissionOverride
  
  Returns:
  
  The current PermissionOverrideAction - for chaining convenience
  
  Throws:
  
  IllegalArgumentException - If the any of the specified Permissions is null
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_PERMISSIONS on the channel and tries to set permissions it does not have in the channel
  
  See Also:
  
  EnumSet
  
  Permission.getRaw(Collection)

Interface PermissionOverrideAction

Method Summary

Methods inherited from interface net.dv8tion.jda.api.requests.restaction.AuditableRestAction

Methods inherited from interface net.dv8tion.jda.api.requests.RestAction

Method Details

setCheck

timeout

Example

deadline

Example

reset

resetAllow

resetDeny

getChannel

getRole

getMember

getGuild

getAllow

getAllowedPermissions

getDeny

getDeniedPermissions

getInherited

getInheritedPermissions

isMember

isRole

setAllow

setAllow

setAllow

grant

grant

grant

setDeny

setDeny

setDeny

deny

deny

deny

clear

clear

clear

setPermissions

setPermissions