com.whitestein.lsps.os

Interface RoleService

All Known Subinterfaces:

RoleServiceLocal, RoleServiceRemote

All Known Implementing Classes:

RoleServiceBean

public interface RoleService

Provides methods for managing and querying role definitions.

Author:

rba

Method Summary

Modifier and Type	Method and Description
void	addRoleName(RoleUnitName roleName) Adds a role name with all parameter names present in roleName to the application.
RoleUnitNameList	findRoleNames() Returns a collection of all role names that exist in the persistent storage (across all modules).
RoleUnitName	getRoleName(String roleName) Returns a role name for the given role name or null if not found.
void	updateRoleName(RoleUnitName roleName) Updates a role name in the application.

Method Detail

getRoleName

RoleUnitName getRoleName(String roleName)

Returns a role name for the given role name or null if not found. The role name contains also all the possible parameter names with null values.

Parameters:

roleName - role name (module name + '::' + local name)

Returns:

a role name

findRoleNames

RoleUnitNameList findRoleNames()

Returns a collection of all role names that exist in the persistent storage (across all modules). Each role name contains also all the possible parameter names with null values.

Returns:

a collection of all role names that exist in the application

addRoleName

void addRoleName(RoleUnitName roleName)
          throws RoleAlreadyExistsException

Adds a role name with all parameter names present in roleName to the application.

Parameters:

roleName -

Throws:

NullPointerException - if roleName is null

RoleAlreadyExistsException - if a role name with the same name already exists

updateRoleName

void updateRoleName(RoleUnitName roleName)
             throws RoleNotFoundException

Updates a role name in the application. Present parameter names are merged with the existing ones.

Parameters:

roleName -

Throws:

NullPointerException - if roleName is null

RoleNotFoundException - if no corresponding role exists