RoleManagerUpdatable (JDA 3.2.0

java.lang.Object
- net.dv8tion.jda.core.managers.RoleManagerUpdatable

```
public class RoleManagerUpdatable
extends java.lang.Object
```
An updatable manager that allows to modify role settings like the name or the color.
This manager allows to modify multiple fields at once by getting the RoleField for specific properties and setting or resetting their values; followed by a call of update()!
Default values depend on the inherited properties of the Public Role in the parent Guild.
The RoleManager implementation simplifies this process by giving simple setters that return the update RestAction
Note: To update this manager the currently logged in account requires the Permission MANAGE_ROLES and must be more powerful according to Discord hierarchy rules (positional strength). [ee Role.canInteract(Role)]

Constructor Summary

Constructors
Constructor and Description

RoleManagerUpdatable(Role role)
Creates a new RoleManagerUpdatable instance

Constructors
Constructor and Description
`RoleManagerUpdatable(Role role)` Creates a new RoleManagerUpdatable instance

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`RoleField<java.awt.Color>`	`getColorField()` An `RoleField` for the color of the selected `Role`.
`Guild`	`getGuild()` The `Guild` this Manager's `Role` is in.
`RoleField<java.lang.Boolean>`	`getHoistedField()` An `RoleField` for the hoist state of the selected `Role`.
`JDA`	`getJDA()` The `JDA` instance of this Manager
`RoleField<java.lang.Boolean>`	`getMentionableField()` An `RoleField` for the mentionable state of the selected `Role`.
`RoleField<java.lang.String>`	`getNameField()` An `RoleField` for the name of the selected `Role`.
`PermissionField`	`getPermissionField()` An `PermissionField` for the `Permissions` of the selected `Role`.
`Role`	`getRole()` The target `Role` for this manager
`void`	`reset()` Resets all `Fields` for this manager instance by calling `Field.reset()` sequentially This is automatically called by `update()`
`AuditableRestAction<java.lang.Void>`	`update()` Creates a new `RestAction` instance that will apply all changes that have been made to this manager instance.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - RoleManagerUpdatable
```
public RoleManagerUpdatable(Role role)
```
    Creates a new RoleManagerUpdatable instance
    
    Parameters:
    
    role - The Role to manage
- Method Detail
  - getJDA
```
public JDA getJDA()
```
    The JDA instance of this Manager
    
    Returns:
    
    the corresponding JDA instance
  - getGuild
```
public Guild getGuild()
```
    The Guild this Manager's Role is in.
    This is logically the same as calling getRole().getGuild()
    
    Returns:
    
    The parent Guild
  - getRole
```
public Role getRole()
```
    The target Role for this manager
    
    Returns:
    
    The target Role
  - getNameField
```
public RoleField<java.lang.String> getNameField()
```
    An RoleField for the name of the selected Role.
    To set the value use setValue(String) on the returned RoleField instance.
    A role name must be between 1-32 characters long!
    Otherwise Field.setValue(...) will throw an IllegalArgumentException.
    
    Returns:
    
    RoleField - Type: String
  - getColorField
```
public RoleField<java.awt.Color> getColorField()
```
    An RoleField for the color of the selected Role.
    To set the value use setValue(Color) on the returned RoleField instance.
    Provide null or black to use the default color.
    
    Returns:
    
    RoleField - Type: Color
  - getHoistedField
```
public RoleField<java.lang.Boolean> getHoistedField()
```
    An RoleField for the hoist state of the selected Role.
    To set the value use setValue(Boolean) on the returned RoleField instance.
    A role hoist state must not be null!
    Otherwise Field.setValue(...) will throw an IllegalArgumentException.
    
    Returns:
    
    RoleField - Type: Boolean
  - getMentionableField
```
public RoleField<java.lang.Boolean> getMentionableField()
```
    An RoleField for the mentionable state of the selected Role.
    To set the value use setValue(Boolean) on the returned RoleField instance.
    A role mentionable state must not be null!
    Otherwise Field.setValue(...) will throw an IllegalArgumentException.
    
    Returns:
    
    RoleField - Type: Boolean
  - getPermissionField
```
public PermissionField getPermissionField()
```
    An PermissionField for the Permissions of the selected Role.
    To set the value use setPermissions(Permission...) on the returned PermissionField instance.
    A role permissions must not be null!
    Otherwise the PermissionField will throw an IllegalArgumentException.
    
    Returns:
    
    PermissionField
  - reset
```
public void reset()
```
    Resets all Fields for this manager instance by calling Field.reset() sequentially
    This is automatically called by update()
  - update
```
@CheckReturnValue
public AuditableRestAction<java.lang.Void> update()
```
    Creates a new RestAction instance that will apply all changes that have been made to this manager instance.
    If no changes have been made this will simply return EmptyRestAction.
    Before applying new changes it is recommended to call reset() to reset previous changes.
    This is automatically called if this method returns successfully.
    Possible ErrorResponses for this update include the following:
    - UNKNOWN_ROLE
      If the Role was deleted before finishing the task
    - MISSING_ACCESS
      If the currently logged in account was removed from the Guild before finishing the task
    - MISSING_PERMISSIONS
      If the currently logged in account loses the MANAGE_ROLES Permission or lost positional power before finishing the task
    Returns:
    
    AuditableRestAction
    Applies all changes that have been made in a single api-call.
    
    Throws:
    
    InsufficientPermissionException - If the currently logged in account does not have the Permission MANAGE_ROLES
    
    HierarchyException - If the currently logged in account does not meet the required hierarchy position to interact with this Role

Class RoleManagerUpdatable

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

RoleManagerUpdatable

Method Detail

getJDA

getGuild

getRole

getNameField

getColorField

getHoistedField

getMentionableField

getPermissionField

reset

update