Schnittstelle PermissionManager

Alle Superschnittstellen:
Serializable
Alle bekannten Implementierungsklassen:
AbstractPermissionManager

public interface PermissionManager extends Serializable
A PermissionManager performs Permission objects related tasks on behalf of the BaseSecurityService. The responsibilities of this class include loading data of an permission from the storage and putting them into the Permission objects, saving those data to the permanent storage.
Version:
$Id$
Autor:
Eric Pugh
  • Felddetails

    • ROLE

      static final String ROLE
      Avalon role - used to id the component within the manager
  • Methodendetails

    • getPermissionInstance

      <T extends Permission> T getPermissionInstance() throws DataBackendException
      Construct a blank Permission object. This method calls getPermissionClass, and then creates a new object using the default constructor.
      Typparameter:
      T - permission type
      Gibt zurück:
      an object implementing Permission interface.
      Löst aus:
      DataBackendException - if there was an error accessing the data backend.
    • getPermissionInstance

      <T extends Permission> T getPermissionInstance(String permName) throws DataBackendException
      Construct a blank Permission object. This method calls getPermissionClass, and then creates a new object using the default constructor.
      Typparameter:
      T - permission type
      Parameter:
      permName - The name of the Permission
      Gibt zurück:
      an object implementing Permission interface.
      Löst aus:
      DataBackendException - if there was an error accessing the data backend.
    • getPermissionByName

      <T extends Permission> T getPermissionByName(String name) throws DataBackendException, UnknownEntityException
      Retrieve a Permission object with specified name.
      Typparameter:
      T - permission type
      Parameter:
      name - the name of the Permission.
      Gibt zurück:
      an object representing the Permission with specified name.
      Löst aus:
      DataBackendException - if there was an error accessing the data backend.
      UnknownEntityException - if the permission does not exist.
    • getPermissionById

      <T extends Permission> T getPermissionById(Object id) throws DataBackendException, UnknownEntityException
      Retrieve a Permission object with specified Id.
      Typparameter:
      T - permission type
      Parameter:
      id - the Id of the Permission.
      Gibt zurück:
      an object representing the Permission with specified name.
      Löst aus:
      UnknownEntityException - if the permission does not exist in the database.
      DataBackendException - if there is a problem accessing the storage.
    • getAllPermissions

      PermissionSet getAllPermissions() throws DataBackendException
      Retrieves all permissions defined in the system.
      Gibt zurück:
      the names of all permissions defined in the system.
      Löst aus:
      DataBackendException - if there was an error accessing the data backend.
    • addPermission

      <T extends Permission> T addPermission(T permission) throws DataBackendException, EntityExistsException
      Creates a new permission with specified attributes.
      Parameter:
      permission - The object describing the permission to be created.
      Gibt zurück:
      the new Permission object.
      Löst aus:
      DataBackendException - if there was an error accessing the data backend.
      EntityExistsException - if the permission already exists.
    • removePermission

      void removePermission(Permission permission) throws DataBackendException, UnknownEntityException
      Removes a Permission from the system.
      Parameter:
      permission - The object describing the permission to be removed.
      Löst aus:
      DataBackendException - if there was an error accessing the data backend.
      UnknownEntityException - if the permission does not exist.
    • renamePermission

      void renamePermission(Permission permission, String name) throws DataBackendException, UnknownEntityException
      Renames an existing Permission.
      Parameter:
      permission - The object describing the permission to be renamed.
      name - the new name for the permission.
      Löst aus:
      DataBackendException - if there was an error accessing the data backend.
      UnknownEntityException - if the permission does not exist.
    • checkExists

      boolean checkExists(Permission permission) throws DataBackendException
      Determines if the Permission exists in the security system.
      Parameter:
      permission - a Permission value
      Gibt zurück:
      true if the permission exists in the system, false otherwise
      Löst aus:
      DataBackendException - when more than one Permission with the same name exists.
    • checkExists

      boolean checkExists(String permissionName) throws DataBackendException
      Determines if a Permission exists in the security system with the specified name.
      Parameter:
      permissionName - the name of a Permission to check
      Gibt zurück:
      true if the permission exists in the system, false otherwise
      Löst aus:
      DataBackendException - when more than one Permission with the same name exists.