org.jasig.portal.security
Interface IPermissionManager

All Known Subinterfaces:

IUpdatingPermissionManager

All Known Implementing Classes:

PermissionManagerImpl, UpdatingPermissionManagerImpl

public interface IPermissionManager

An interface for retrieving IAuthorizationPrincipals and their Permissions on behalf of a Permission owner.

Version:

$Revision: 19776 $

Author:

Dan Ellentuck

Method Summary

IPermission[]	getAllPermissions(IAuthorizationPrincipal principal, String activity, String target) Returns IPermissions granted to the IAuthorizationPrincipal by the owner of this IPermissionManager, for the given activity and target.
IAuthorizationPrincipal[]	getAuthorizedPrincipals(String activity, String target) Returns IAuthorizationPrincipals granted Permissions by the owner of this IPermissionManager, for the given activity and target.
String	getOwner()
IPermission[]	getPermissions(IAuthorizationPrincipal principal, String activity, String target) Returns IPermissions granted to the IAuthorizationPrincipal by the owner of this IPermissionManager, for the given activity and target.
IPermission[]	getPermissions(String activity, String target) Retrieve an array of IPermission objects based on the given parameters.

Method Detail

getAllPermissions

IPermission[] getAllPermissions(IAuthorizationPrincipal principal,
                                String activity,
                                String target)
                                throws AuthorizationException

Returns IPermissions granted to the IAuthorizationPrincipal by the owner of this IPermissionManager, for the given activity and target. This includes inherited IPermissions. If any parameter is null, it is ignored.

Parameters:

principal - IAuthorizationPrincipal

activity - String - the Permission activity

target - String - the Permission target

Returns:

IPermission[]

Throws:

AuthorizationException

getAuthorizedPrincipals

IAuthorizationPrincipal[] getAuthorizedPrincipals(String activity,
                                                  String target)
                                                  throws AuthorizationException

Returns IAuthorizationPrincipals granted Permissions by the owner of this IPermissionManager, for the given activity and target. If either parameter is null, it is ignored.

Parameters:

activity - String - the Permission activity

target - String - the Permission target

Returns:

IAuthorizationPrincipal[]

Throws:

AuthorizationException

getOwner

String getOwner()

Returns:

java.lang.String

getPermissions

IPermission[] getPermissions(String activity,
                             String target)
                             throws AuthorizationException

Retrieve an array of IPermission objects based on the given parameters. Any null parameters will be ignored.

Parameters:

activity - String

target - String

Returns:

Permission[]

Throws:

AuthorizationException

getPermissions

IPermission[] getPermissions(IAuthorizationPrincipal principal,
                             String activity,
                             String target)
                             throws AuthorizationException

Returns IPermissions granted to the IAuthorizationPrincipal by the owner of this IPermissionManager, for the given activity and target. If any parameter is null, it is ignored.

Parameters:

principal - IAuthorizationPrincipal

activity - String - the Permission activity

target - String - the Permission target

Returns:

IPermission[]

Throws:

AuthorizationException