BEA WebLogic Server 9.1 API Reference

weblogic.security.service
Interface SecurityRole

public interface SecurityRole

The SecurityRole interface represents the abstract notion of a security role.

Users/groups can have different roles at different times, depending upon what they are trying to do. For example, a user may have the role "Admin" while doing administrative tasks, but the same user might not be allowed to have that role outside normal work hours. Users/groups can have multiple roles at the same time, depending upon what the security providers grant. The methods on the SecurityRole interface allow one to obtain basic information about the SecurityRole, or to compare it to another security role. These methods are designed for the convenience of security providers.

Note: SecurityRole implementations are returned as a Map by the getRoles method.

See Also:

RoleMapper.getRoles(Subject subject, Resource resource, ContextHandler handler)

Copyright © 2005 BEA Systems, Inc. All Rights Reserved.

Method Summary

boolean	equals(Object another) Compares this security role to the security role in the specified object.
String	getDescription() Gets a description of this security role.
String	getName() Gets the name of this security role.
int	hashCode() Returns a hashcode for this security role.
String	toString() Returns a String representation of this security role.

Method Detail

equals

public boolean equals(Object another)

Compares this security role to the security role in the specified object.

Parameters:

another - the other security role with which to compare this security role.

Returns:

TRUE if the security role passed in matches the security role represented by the implementation of this interface, and FALSE otherwise.

getDescription

public String getDescription()

Gets a description of this security role. The description should describe the purpose of this security role.

Returns:

a description of this security role, represented as a String.

getName

public String getName()

Gets the name of this security role.

Returns:

the name of this security role, represented as a String.

hashCode

public int hashCode()

Returns a hashcode for this security role.

Returns:

a hashcode for this security role, represented as an int.

toString

public String toString()

Returns a String representation of this security role.

Returns:

this security role, represented as a String.