org.openmrs

Class Role

java.lang.Object

org.openmrs.BaseOpenmrsObject

org.openmrs.BaseOpenmrsMetadata

org.openmrs.BaseChangeableOpenmrsMetadata

org.openmrs.Role

All Implemented Interfaces:

Serializable, Auditable, Changeable, Creatable, OpenmrsMetadata, OpenmrsObject, Retireable

public class Role
extends BaseChangeableOpenmrsMetadata

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
Set<Role>	getAllChildRoles() Recursive (if need be) method to return all child roles of this role Should only return child roles
Set<Role>	getAllParentRoles() Recursive (if need be) method to return all parent roles of this role Should only return parent roles
Set<Role>	getChildRoles()
Integer	getId()
Set<Role>	getInheritedRoles()
String	getName()
Set<Privilege>	getPrivileges()
String	getRole()
boolean	hasChildRoles() Convenience method to test whether or not this role is a parent of another role
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() Returns a string equal to the value of: ClassName{hashCode=..., uuid=...}

Methods inherited from class org.openmrs.BaseOpenmrsMetadata

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

Methods inherited from class org.openmrs.BaseOpenmrsObject

equals, getUuid, hashCode, 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

getPrivileges

public Set<Privilege> getPrivileges()

Returns:

Returns the privileges.

setPrivileges

public void setPrivileges(Set<Privilege> privileges)

Parameters:

privileges - The privileges to set.

getName

public String getName()

Specified by:

getName in interface OpenmrsMetadata

Overrides:

getName in class BaseOpenmrsMetadata

Returns:

the name

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()

Description copied from class: BaseOpenmrsObject

Returns a string equal to the value of:

ClassName{hashCode=..., uuid=...}

If the uuid field is null, it returns:

ClassName{hashCode=...}

Should include hashCode if uuid is null Should include uuid if not null

Overrides:

toString in class BaseOpenmrsObject

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 Should return true if found Should not fail given null parameter Should 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 Should only return parent roles

Returns:

Return this role's parents

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<Role> Current and inherited roles

getId

public Integer getId()

Returns:

id - The unique Identifier for the object

Since:

1.5

See Also:

OpenmrsObject.getId()

setId

public void setId(Integer id)

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.9

setChildRoles

public void setChildRoles(Set<Role> childRoles)

Parameters:

childRoles - the immediate children to set

Since:

1.9

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.9

getAllChildRoles

public Set<Role> getAllChildRoles()

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

Returns:

this role's children

Since:

1.9

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<Role> Current and child roles

Since:

1.9