Role (Java Platform SE 7 b138)

java.lang.Object
- javax.management.relation.Role

All Implemented Interfaces:

Serializable
```
public class Role
extends Object
implements Serializable
```
Represents a role: includes a role name and referenced MBeans (via their ObjectNames). The role value is always represented as an ArrayList collection (of ObjectNames) to homogenize the access.
The serialVersionUID of this class is -279985518429862552L.

Since:

1.5

See Also:
Serialized Form

Constructor Summary

Constructors
Constructor and Description

Role(String roleName, List<ObjectName> roleValue)
Make a new Role object.

Constructors
Constructor and Description
`Role(String roleName, List<ObjectName> roleValue)` Make a new Role object.

Method Summary

Methods
Modifier and Type	Method and Description
`Object`	`clone()` Clone the role object.
`String`	`getRoleName()` Retrieves role name.
`List<ObjectName>`	`getRoleValue()` Retrieves role value.
`static String`	`roleValueToString(List<ObjectName> roleValue)` Returns a string for the given role value.
`void`	`setRoleName(String roleName)` Sets role name.
`void`	`setRoleValue(List<ObjectName> roleValue)` Sets role value.
`String`	`toString()` Returns a string describing the role.

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

- Constructor Detail
  - Role
```
public Role(String roleName,
    List<ObjectName> roleValue)
     throws IllegalArgumentException
```
    Make a new Role object. No check is made that the ObjectNames in the role value exist in an MBean server. That check will be made when the role is set in a relation.
    
    Parameters:
    roleName - role name
    roleValue - role value (List of ObjectName objects)
    
    Throws:
    
    IllegalArgumentException - if null parameter
- Method Detail
  - getRoleName
```
public String getRoleName()
```
    Retrieves role name.
    
    Returns:
    the role name.
    See Also:
    setRoleName(java.lang.String)
  - getRoleValue
```
public List<ObjectName> getRoleValue()
```
    Retrieves role value.
    
    Returns:
    ArrayList of ObjectName objects for referenced MBeans.
    See Also:
    setRoleValue(java.util.List)
  - setRoleName
```
public void setRoleName(String roleName)
                 throws IllegalArgumentException
```
    Sets role name.
    
    Parameters:
    roleName - role name
    
    Throws:
    
    IllegalArgumentException - if null parameter
    See Also:
    getRoleName()
  - setRoleValue
```
public void setRoleValue(List<ObjectName> roleValue)
                  throws IllegalArgumentException
```
    Sets role value.
    
    Parameters:
    roleValue - List of ObjectName objects for referenced MBeans.
    
    Throws:
    
    IllegalArgumentException - if null parameter
    See Also:
    getRoleValue()
  - toString
```
public String toString()
```
    Returns a string describing the role.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    the description of the role.
  - clone
```
public Object clone()
```
    Clone the role object.
    
    Overrides:
    
    clone in class Object
    
    Returns:
    a Role that is an independent copy of the current Role object.
    See Also:
    Cloneable
  - roleValueToString
```
public static String roleValueToString(List<ObjectName> roleValue)
                                throws IllegalArgumentException
```
    Returns a string for the given role value.
    
    Parameters:
    roleValue - List of ObjectName objects
    
    Returns:
    A String consisting of the ObjectNames separated by newlines (\n).
    
    Throws:
    
    IllegalArgumentException - if null parameter

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b138

Class Role

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Role

Method Detail

getRoleName

getRoleValue

setRoleName

setRoleValue

toString

clone

roleValueToString