org.openmrs

Class Role

java.lang.Object

org.openmrs.BaseOpenmrsObject

org.openmrs.BaseOpenmrsMetadata

org.openmrs.Role

All Implemented Interfaces:

Serializable, Auditable, OpenmrsMetadata, OpenmrsObject, Retireable

public class Role
extends BaseOpenmrsMetadata
implements Serializable

A Role is just an aggregater of Privileges. Users contain a number of roles (Users DO NOT contain any privileges directly) Roles can be grouped by inheriting other roles. If a user is given Role A that inherits from Role B, the user has all rights/abilities for both Role A's privileges and for Role B's privileges.

See Also:

Privilege, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static long	serialVersionUID

Constructor Summary

Constructors

Constructor and Description
Role() default constructor
Role(String role) constructor with id
Role(String role, String description) constructor with all database required properties

Method Summary

Modifier and Type	Method and Description
void	addPrivilege(Privilege privilege) Adds the given Privilege to the list of privileges
boolean	equals(Object obj)
Set<Role>	getAllChildRoles() Recursive (if need be) method to return all child roles of this role
Set<Role>	getAllParentRoles() Recursive (if need be) method to return all parent roles of this role
Set<Role>	getChildRoles()
Integer	getId()
Set<Role>	getInheritedRoles()
Set<Privilege>	getPrivileges()
String	getRole()
boolean	hasChildRoles() Convenience method to test whether or not this role is a parent of another role
int	hashCode()
boolean	hasPrivilege(String privilegeName) Looks for the given privilegeName privilege name in this roles privileges.
boolean	inheritsRoles() Convenience method to test whether or not this role extends/ inherits from any other roles
Set<Role>	recurseOverChildren(Set<Role> total) Returns the full set of child roles be looping over children.
Set<Role>	recurseOverParents(Set<Role> total) Returns the full set of roles be looping over inherited roles.
void	removePrivilege(Privilege privilege) Removes the given Privilege from the list of privileges
void	setChildRoles(Set<Role> childRoles)
void	setId(Integer id)
void	setInheritedRoles(Set<Role> inheritedRoles)
void	setPrivileges(Set<Privilege> privileges)
void	setRole(String role)
String	toString()

Methods inherited from class org.openmrs.BaseOpenmrsMetadata

getChangedBy, getCreator, getDateChanged, getDateCreated, getDateRetired, getDescription, getName, getRetired, getRetiredBy, getRetireReason, isRetired, setChangedBy, setCreator, setDateChanged, setDateCreated, setDateRetired, setDescription, setName, setRetired, setRetiredBy, setRetireReason

Methods inherited from class org.openmrs.BaseOpenmrsObject

getUuid, setUuid

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.openmrs.OpenmrsObject

getUuid, setUuid

Field Detail

serialVersionUID

public static final long serialVersionUID

See Also:

Constant Field Values

Constructor Detail

Role

public Role()

default constructor

Role

public Role(String role)

constructor with id

Role

public Role(String role,
            String description)

constructor with all database required properties

Method Detail

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

See Also:

Object.equals(java.lang.Object)

hashCode

public int hashCode()

Overrides:

hashCode in class Object

See Also:

Object.hashCode()

getPrivileges

public Set<Privilege> getPrivileges()

Returns:

Returns the privileges.

setPrivileges

public void setPrivileges(Set<Privilege> privileges)

Parameters:

privileges - The privileges to set.

addPrivilege

public void addPrivilege(Privilege privilege)

Adds the given Privilege to the list of privileges

Parameters:

privilege - Privilege to add

removePrivilege

public void removePrivilege(Privilege privilege)

Removes the given Privilege from the list of privileges

Parameters:

privilege - Privilege to remove

getRole

public String getRole()

Returns:

Returns the role.

setRole

public void setRole(String role)

Parameters:

role - The role to set.

toString

public String toString()

Overrides:

toString in class Object

See Also:

Object.toString()

hasPrivilege

public boolean hasPrivilege(String privilegeName)

Looks for the given privilegeName privilege name in this roles privileges. This method does not recurse through the inherited roles

Parameters:

privilegeName - String name of a privilege

Returns:

true/false whether this role has the given privilege

Should:

return false if not found, return true if found, not fail given null parameter, return true for any privilegeName if super user

getInheritedRoles

public Set<Role> getInheritedRoles()

Returns:

Returns the inheritedRoles.

setInheritedRoles

public void setInheritedRoles(Set<Role> inheritedRoles)

Parameters:

inheritedRoles - The inheritedRoles to set.

inheritsRoles

public boolean inheritsRoles()

Convenience method to test whether or not this role extends/ inherits from any other roles

Returns:

true/false whether this role inherits from other roles

getAllParentRoles

public Set<Role> getAllParentRoles()

Recursive (if need be) method to return all parent roles of this role

Returns:

Return this role's parents

Should:

only return parent roles

recurseOverParents

public Set<Role> recurseOverParents(Set<Role> total)

Returns the full set of roles be looping over inherited roles. Duplicate roles are dropped.

Parameters:

total - Roles already looped over

Returns:

Set Current and inherited roles

getId

public Integer getId()

Specified by:

getId in interface OpenmrsObject

Returns:

id - The unique Identifier for the object

Since:

1.5

See Also:

OpenmrsObject.getId()

setId

public void setId(Integer id)

Specified by:

setId in interface OpenmrsObject

Parameters:

id - - The unique Identifier for the object

Since:

1.5

See Also:

OpenmrsObject.setId(java.lang.Integer)

getChildRoles

public Set<Role> getChildRoles()

Returns:

immediate children

Since:

1.8.4

setChildRoles

public void setChildRoles(Set<Role> childRoles)

Parameters:

childRoles - the immediate children to set

Since:

1.8.4

hasChildRoles

public boolean hasChildRoles()

Convenience method to test whether or not this role is a parent of another role

Returns:

true/false whether this role is a parent of another role

Since:

1.8.4

getAllChildRoles

public Set<Role> getAllChildRoles()

Recursive (if need be) method to return all child roles of this role

Returns:

this role's children

Since:

1.8.4

Should:

only return child roles

recurseOverChildren

public Set<Role> recurseOverChildren(Set<Role> total)

Returns the full set of child roles be looping over children. Duplicate roles are dropped.

Parameters:

total - Roles already looped over

Returns:

Set Current and child roles

Since:

1.8.4