org.nuxeo.ecm.core.api.security
Interface PermissionProvider

All Known Subinterfaces:

PermissionProviderLocal, PermissionProviderLocal

All Known Implementing Classes:

DefaultPermissionProvider, PermissionProviderBean

public interface PermissionProvider

Provider for existing permission and permission groups.

Author:

Bogdan Stefanescu, Olivier Grisel

Method Summary

java.lang.String[]	getAliasPermissions(java.lang.String perm)
java.lang.String[]	getPermissionGroups(java.lang.String perm)
java.lang.String[]	getPermissions()
java.lang.String[]	getSubPermissions(java.lang.String perm)
java.util.List<UserVisiblePermission>	getUserVisiblePermissionDescriptors()
java.util.List<UserVisiblePermission>	getUserVisiblePermissionDescriptors(java.lang.String typeName)

Method Detail

getPermissions

java.lang.String[] getPermissions()

Returns:

an array of a all registered permission names

getPermissionGroups

java.lang.String[] getPermissionGroups(java.lang.String perm)

Parameters:

perm - the name of a registered permissions that belongs to permission groups (aka compound permissions)

Returns:

an array of a all compound permissions 'perm' is a sub-permission of, directly or not ; returns null if 'perm' is not registered or if 'perm' does not belong to any compound permission

getUserVisiblePermissionDescriptors

java.util.List<UserVisiblePermission> getUserVisiblePermissionDescriptors()
                                                                          throws ClientException

Returns:

get the sorted list of UserVisiblePermission objects to be used in the permission management screen of the UI (be it web based, a rich client or any-thing else)

Throws:

ClientException

getUserVisiblePermissionDescriptors

java.util.List<UserVisiblePermission> getUserVisiblePermissionDescriptors(java.lang.String typeName)
                                                                          throws ClientException

Parameters:

typeName - the name of a Core type of the document whose ACP is to be edited by the user

Returns:

get the sorted list of UserVisiblePermission objects to be used in the permission management screen of the UI (be it web based, a rich client or any-thing else) ; if no specific permissions are registered for typeName, the default list is returned

Throws:

ClientException

getSubPermissions

java.lang.String[] getSubPermissions(java.lang.String perm)
                                     throws ClientException

Parameters:

perm - the name of a registered compound permission

Returns:

the list of permission names of sub-permissions of 'perm'

Throws:

ClientException - if 'perm' is not a registered permission

getAliasPermissions

java.lang.String[] getAliasPermissions(java.lang.String perm)
                                       throws ClientException

Parameters:

perm - the name of a registered permission

Returns:

the list of alias permissions to 'perm'

Throws:

ClientException - if 'perm' is not a registered permission