public Role(String roleName,
    List<ObjectName> roleValue) throws IllegalArgumentException 
{
        if (roleName == null || roleValue == null) {
            String excMsg = "Invalid parameter";
            throw new IllegalArgumentException(excMsg);
        }
        setRoleName(roleName);
        setRoleValue(roleValue);
        return;
}

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

exception: IllegalArgumentException - if null parameter

 public Object clone() 
{
        try {
            return new Role(name, objectNameList);
        } catch (IllegalArgumentException exc) {
            return null; // can't happen
        }
}

Clone the role object.

 public String getRoleName() 
{
        return name;
}

Retrieves role name.

 public List<ObjectName> getRoleValue() 
{
        return objectNameList;
}

Retrieves role value.

 public static String roleValueToString(List<ObjectName> roleValue) throws IllegalArgumentException 
{
        if (roleValue == null) {
            String excMsg = "Invalid parameter";
            throw new IllegalArgumentException(excMsg);
        }
        StringBuilder result = new StringBuilder();
        for (ObjectName currObjName : roleValue) {
            if (result.length()  > 0)
                result.append("\n");
            result.append(currObjName.toString());
        }
        return result.toString();
}

Returns a string for the given role value.

 public  void setRoleName(String roleName) throws IllegalArgumentException 
{
        if (roleName == null) {
            String excMsg = "Invalid parameter.";
            throw new IllegalArgumentException(excMsg);
        }
        name = roleName;
        return;
}

Sets role name.

 public  void setRoleValue(List<ObjectName> roleValue) throws IllegalArgumentException 
{
        if (roleValue == null) {
            String excMsg = "Invalid parameter.";
            throw new IllegalArgumentException(excMsg);
        }
        objectNameList = new ArrayList< ObjectName >(roleValue);
        return;
}

Sets role value.

 public String toString() 
{
        StringBuilder result = new StringBuilder();
        result.append("role name: " + name + "; role value: ");
        for (Iterator< ObjectName > objNameIter = objectNameList.iterator();
             objNameIter.hasNext();) {
            ObjectName currObjName = objNameIter.next();
            result.append(currObjName.toString());
            if (objNameIter.hasNext()) {
                result.append(", ");
            }
        }
        return result.toString();
}

Returns a string describing the role.