Package net.dv8tion.jda.api.managers

Interface RoleManager

All Superinterfaces:

AuditableRestAction<Void>, Manager<RoleManager>, RestAction<Void>

public interface RoleManager
extends Manager<RoleManager>

Manager providing functionality to update one or more fields for a Role.

Example

 manager.setName("Administrator")
        .setColor(null)
        .queue();
 manager.reset(RoleManager.PERMISSION | RoleManager.NAME)
        .setName("Traitor")
        .setColor(Color.RED)
        .queue();
 

See Also:

• Role.getManager()

Field Summary

Fields

Modifier and Type	Field	Description
static final long	COLOR	Used to reset the color field
static final long	HOIST	Used to reset the hoisted field
static final long	ICON	Used to reset the icon field
static final long	MENTIONABLE	Used to reset the mentionable field
static final long	NAME	Used to reset the name field
static final long	PERMISSION	Used to reset the permission field

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

MAX_REASON_LENGTH

Method Summary

Modifier and Type	Method	Description
default Guild	getGuild()	The Guild this Manager's Role is in.
Role	getRole()	The target Role for this manager
RoleManager	givePermissions(Collection<Permission> perms)	Adds the specified Permissions to the selected Role.
default RoleManager	givePermissions(Permission... perms)	Adds the specified Permissions to the selected Role.
RoleManager	reset(long fields)	Resets the fields specified by the provided bit-flag pattern.
RoleManager	reset(long... fields)	Resets the fields specified by the provided bit-flag patterns.
RoleManager	revokePermissions(Collection<Permission> perms)	Revokes the specified Permissions from the selected Role.
default RoleManager	revokePermissions(Permission... perms)	Revokes the specified Permissions from the selected Role.
RoleManager	setColor(int rgb)	Sets the rgb color of the selected Role.
default RoleManager	setColor(Color color)	Sets the Color of the selected Role.
RoleManager	setHoisted(boolean hoisted)	Sets the hoist state of the selected Role.
RoleManager	setIcon(String emoji)	Sets the Unicode Emoji of this Role instead of a custom image.
default RoleManager	setIcon(UnicodeEmoji emoji)	Sets the Unicode Emoji of this Role instead of a custom image.
RoleManager	setIcon(Icon icon)	Sets the Icon of this Role.
RoleManager	setMentionable(boolean mentionable)	Sets the mentionable state of the selected Role.
RoleManager	setName(String name)	Sets the name of the selected Role.
RoleManager	setPermissions(long perms)	Sets the Permissions of the selected Role.
default RoleManager	setPermissions(Collection<Permission> permissions)	Sets the Permissions of the selected Role.
default RoleManager	setPermissions(Permission... permissions)	Sets the Permissions of the selected Role.

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

reason

Methods inherited from interface net.dv8tion.jda.api.managers.Manager

deadline, reset, setCheck, timeout

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, onSuccess, queue, queue, queue, queueAfter, queueAfter, queueAfter, queueAfter, queueAfter, queueAfter, submit, submit, submitAfter, submitAfter, zip

Field Details

NAME

static final long NAME

Used to reset the name field

See Also:

• Constant Field Values

COLOR

static final long COLOR

Used to reset the color field

See Also:

• Constant Field Values

PERMISSION

static final long PERMISSION

Used to reset the permission field

See Also:

• Constant Field Values

HOIST

static final long HOIST

Used to reset the hoisted field

See Also:

• Constant Field Values

MENTIONABLE

static final long MENTIONABLE

Used to reset the mentionable field

See Also:

• Constant Field Values

ICON

static final long ICON

Used to reset the icon field

See Also:

• Constant Field Values

Method Details

reset

@Nonnull
RoleManager reset(long fields)

Resets the fields specified by the provided bit-flag pattern. You can specify a combination by using a bitwise OR concat of the flag constants.
Example: manager.reset(RoleManager.COLOR | RoleManager.NAME);

Flag Constants:

• NAME
• COLOR
• PERMISSION
• HOIST
• MENTIONABLE
• ICON

Specified by:

reset in interface Manager<RoleManager>

Parameters:

fields - Integer value containing the flags to reset.

Returns:

RoleManager for chaining convenience

reset

@Nonnull
RoleManager reset(long... fields)

Resets the fields specified by the provided bit-flag patterns.
Example: manager.reset(RoleManager.COLOR, RoleManager.NAME);

Flag Constants:

• NAME
• COLOR
• PERMISSION
• HOIST
• MENTIONABLE
• ICON

Specified by:

reset in interface Manager<RoleManager>

Parameters:

fields - Integer values containing the flags to reset.

Returns:

RoleManager for chaining convenience

getRole

@Nonnull
Role getRole()

The target Role for this manager

Returns:

The target Role

getGuild

@Nonnull
default Guild getGuild()

The Guild this Manager's Role is in.
This is logically the same as calling getRole().getGuild()

Returns:

The parent Guild

setName

@Nonnull
@CheckReturnValue
RoleManager setName(@Nonnull
 String name)

Sets the name of the selected Role.

A role name must not be null nor less than 1 characters or more than 32 characters long!

Parameters:

name - The new name for the selected Role

Returns:

RoleManager for chaining convenience

Throws:

IllegalArgumentException - If the provided name is null or not between 1-100 characters long

setPermissions

@Nonnull
@CheckReturnValue
RoleManager setPermissions(long perms)

Sets the Permissions of the selected Role.

Permissions may only include already present Permissions for the currently logged in account.
You are unable to give permissions you don't have!

Parameters:

perms - The new raw permission value for the selected Role

Returns:

RoleManager for chaining convenience

Throws:

InsufficientPermissionException - If the currently logged in account does not have permission to apply one of the specified permissions

See Also:

• setPermissions(Collection)
• setPermissions(Permission...)

setPermissions

@Nonnull
@CheckReturnValue
default RoleManager setPermissions(@Nonnull
 Permission... permissions)

Sets the Permissions of the selected Role.

Permissions may only include already present Permissions for the currently logged in account.
You are unable to give permissions you don't have!

Parameters:

permissions - The new permission for the selected Role

Returns:

RoleManager for chaining convenience

Throws:

InsufficientPermissionException - If the currently logged in account does not have permission to apply one of the specified permissions

IllegalArgumentException - If any of the provided values is null

See Also:

• setPermissions(Collection)
• setPermissions(long)
• Permission.getRaw(Permission...)

setPermissions

@Nonnull
@CheckReturnValue
default RoleManager setPermissions(@Nonnull
 Collection<Permission> permissions)

Sets the Permissions of the selected Role.

Permissions may only include already present Permissions for the currently logged in account.
You are unable to give permissions you don't have!

Parameters:

permissions - The new permission for the selected Role

Returns:

RoleManager for chaining convenience

Throws:

InsufficientPermissionException - If the currently logged in account does not have permission to apply one of the specified permissions

IllegalArgumentException - If any of the provided values is null

See Also:

• setPermissions(Permission...)
• setPermissions(long)
• EnumSet
• Permission.getRaw(Collection)

setColor

@Nonnull
@CheckReturnValue
default RoleManager setColor(@Nullable
 Color color)

Sets the Color of the selected Role.

Parameters:

color - The new color for the selected Role

Returns:

RoleManager for chaining convenience

setColor

@Nonnull
@CheckReturnValue
RoleManager setColor(int rgb)

Sets the rgb color of the selected Role.

Parameters:

rgb - The new color for the selected Role

Returns:

RoleManager for chaining convenience

See Also:

• Role.DEFAULT_COLOR_RAW

setHoisted

@Nonnull
@CheckReturnValue
RoleManager setHoisted(boolean hoisted)

Sets the hoist state of the selected Role.

Parameters:

hoisted - Whether the selected Role should be hoisted

Returns:

RoleManager for chaining convenience

setMentionable

@Nonnull
@CheckReturnValue
RoleManager setMentionable(boolean mentionable)

Sets the mentionable state of the selected Role.

Parameters:

mentionable - Whether the selected Role should be mentionable

Returns:

RoleManager for chaining convenience

setIcon

@Nonnull
@CheckReturnValue
RoleManager setIcon(@Nullable
 Icon icon)

Sets the Icon of this Role.

Parameters:

icon - The new icon for this Role or null to reset

Returns:

RoleManager for chaining convenience

setIcon

@Nonnull
@CheckReturnValue
RoleManager setIcon(@Nullable
 String emoji)

Sets the Unicode Emoji of this Role instead of a custom image.

Parameters:

emoji - The new Unicode Emoji for this Role or null to reset

Returns:

RoleManager for chaining convenience

setIcon

@Nonnull
@CheckReturnValue
default RoleManager setIcon(@Nullable
 UnicodeEmoji emoji)

Sets the Unicode Emoji of this Role instead of a custom image.

Parameters:

emoji - The new Unicode Emoji for this Role or null to reset

Returns:

RoleManager for chaining convenience

See Also:

• Emoji.fromUnicode(String)
• UnicodeEmoji

givePermissions

@Nonnull
@CheckReturnValue
default RoleManager givePermissions(@Nonnull
 Permission... perms)

Adds the specified Permissions to the selected Role.

Permissions may only include already present Permissions for the currently logged in account.
You are unable to give permissions you don't have!

Parameters:

perms - The permission to give to the selected Role

Returns:

RoleManager for chaining convenience

Throws:

InsufficientPermissionException - If the currently logged in account does not have permission to apply one of the specified permissions

See Also:

• setPermissions(Collection)
• setPermissions(Permission...)
• Permission.getRaw(Permission...)

givePermissions

@Nonnull
@CheckReturnValue
RoleManager givePermissions(@Nonnull
 Collection<Permission> perms)

Adds the specified Permissions to the selected Role.

Permissions may only include already present Permissions for the currently logged in account.
You are unable to give permissions you don't have!

Parameters:

perms - The permission to give to the selected Role

Returns:

RoleManager for chaining convenience

Throws:

InsufficientPermissionException - If the currently logged in account does not have permission to apply one of the specified permissions

See Also:

• setPermissions(Collection)
• setPermissions(Permission...)
• EnumSet
• Permission.getRaw(Collection)

revokePermissions

@Nonnull
@CheckReturnValue
default RoleManager revokePermissions(@Nonnull
 Permission... perms)

Revokes the specified Permissions from the selected Role.

Permissions may only include already present Permissions for the currently logged in account.
You are unable to revoke permissions you don't have!

Parameters:

perms - The permission to give to the selected Role

Returns:

RoleManager for chaining convenience

Throws:

InsufficientPermissionException - If the currently logged in account does not have permission to revoke one of the specified permissions

See Also:

• setPermissions(Collection)
• setPermissions(Permission...)
• Permission.getRaw(Permission...)

revokePermissions

@Nonnull
@CheckReturnValue
RoleManager revokePermissions(@Nonnull
 Collection<Permission> perms)

Revokes the specified Permissions from the selected Role.

Permissions may only include already present Permissions for the currently logged in account.
You are unable to revoke permissions you don't have!

Parameters:

perms - The permission to give to the selected Role

Returns:

RoleManager for chaining convenience

Throws:

InsufficientPermissionException - If the currently logged in account does not have permission to revoke one of the specified permissions

See Also:

• setPermissions(Collection)
• setPermissions(Permission...)
• EnumSet
• Permission.getRaw(Collection)