org.alfresco.repo.security.authority

Interface AuthorityDAO

All Known Implementing Classes:

AuthorityDAOImpl

public interface AuthorityDAO

Method Summary

Modifier and Type	Method and Description
void	addAuthority(Collection<String> parentNames, String childName) Add a child authority to the given parent authorities
void	addAuthorityToZones(String authorityName, Set<String> zones) Add an authority to zones
boolean	authorityExists(String name) Test if an authority already exists.
void	createAuthority(String name, String authorityDisplayName, Set<String> authorityZones) Create an authority.
void	deleteAuthority(String name) Delete an authority.
Set<String>	findAuthorities(org.alfresco.service.cmr.security.AuthorityType type, String parentAuthority, boolean immediate, String displayNamePattern, String zoneName) Find authorities by display name pattern.
Set<String>	getAllAuthoritiesInZone(String zoneName, org.alfresco.service.cmr.security.AuthorityType type) Gets the names of all authorities in a zone, optionally filtered by type.
org.alfresco.query.PagingResults<String>	getAuthorities(org.alfresco.service.cmr.security.AuthorityType type, String zoneName, String displayNameFilter, boolean sortByDisplayName, boolean sortAscending, org.alfresco.query.PagingRequest pagingRequest) Get authority names by type and/or zone (both cannot be null).
org.alfresco.query.PagingResults<AuthorityInfo>	getAuthoritiesInfo(org.alfresco.service.cmr.security.AuthorityType type, String zoneName, String displayNameFilter, String sortBy, boolean sortAscending, org.alfresco.query.PagingRequest pagingRequest) Get AuthorityInfo by type and/or zone (both cannot be null).
String	getAuthorityDisplayName(String authorityName) Get the display name for an authority
String	getAuthorityName(org.alfresco.service.cmr.repository.NodeRef authorityRef) Gets the name for the given authority node
org.alfresco.service.cmr.repository.NodeRef	getAuthorityNodeRefOrNull(String name) Get a node ref for the authority if one exists
Set<String>	getAuthorityZones(String name) Gets the name of the zone containing the specified authority.
Set<String>	getContainedAuthorities(org.alfresco.service.cmr.security.AuthorityType type, String parentName, boolean immediate) Get contained authorities.
Set<String>	getContainingAuthorities(org.alfresco.service.cmr.security.AuthorityType type, String name, boolean immediate) Get the authorities that contain the one given.
Set<String>	getContainingAuthoritiesInZone(org.alfresco.service.cmr.security.AuthorityType type, String authority, String zoneName, AuthorityService.AuthorityFilter filter, int size) Get a set of authorities with varying filter criteria
long	getGroupCount() Count groups i.e.
String	getName(org.alfresco.service.cmr.security.AuthorityType type, String shortName) Create the full identifier for an authority given its short name and type.
org.alfresco.service.cmr.repository.NodeRef	getOrCreateZone(String zoneName) Gets or creates an authority zone node with the specified name
long	getPersonCount() Count people i.e.
Set<String>	getRootAuthorities(org.alfresco.service.cmr.security.AuthorityType type, String zoneName) Get root authorities
String	getShortName(String name) Extract the short name of an authority from its full identifier.
org.alfresco.service.cmr.repository.NodeRef	getZone(String zoneName) Gets an authority zone node with the specified name
boolean	isAuthorityContained(String authority, String authorityToFind, Set<String> positiveHits, Set<String> negativeHits)
void	removeAuthority(String parentName, String childName) Remove an authority.
void	removeAuthority(String parentName, String childName, boolean cacheRefresh) Remove an authority without authorityBridgeTableCache refresh.
void	removeAuthorityFromZones(String authorityName, Set<String> zones) Remove an authority from zones.
void	setAuthorityDisplayName(String authorityName, String authorityDisplayName) Set the display name for an authority

Method Detail

getPersonCount

long getPersonCount()

Count people i.e. nodes of type cm:person.

Returns:

the number of people

getGroupCount

long getGroupCount()

Count groups i.e. nodes of type cm:authorityContainer.

Returns:

the number of groups

addAuthority

void addAuthority(Collection<String> parentNames,
                  String childName)

Add a child authority to the given parent authorities

createAuthority

void createAuthority(String name,
                     String authorityDisplayName,
                     Set<String> authorityZones)

Create an authority.

deleteAuthority

void deleteAuthority(String name)

Delete an authority.

getContainedAuthorities

Set<String> getContainedAuthorities(org.alfresco.service.cmr.security.AuthorityType type,
                                    String parentName,
                                    boolean immediate)

Get contained authorities.

Parameters:

parentName - the name of the containing authority

isAuthorityContained

boolean isAuthorityContained(String authority,
                             String authorityToFind,
                             Set<String> positiveHits,
                             Set<String> negativeHits)

removeAuthority

void removeAuthority(String parentName,
                     String childName)

Remove an authority.

removeAuthority

void removeAuthority(String parentName,
                     String childName,
                     boolean cacheRefresh)

Remove an authority without authorityBridgeTableCache refresh.

getContainingAuthorities

Set<String> getContainingAuthorities(org.alfresco.service.cmr.security.AuthorityType type,
                                     String name,
                                     boolean immediate)

Get the authorities that contain the one given.

getContainingAuthoritiesInZone

Set<String> getContainingAuthoritiesInZone(org.alfresco.service.cmr.security.AuthorityType type,
                                           String authority,
                                           String zoneName,
                                           AuthorityService.AuthorityFilter filter,
                                           int size)

Get a set of authorities with varying filter criteria

Parameters:

type - authority type or null for all types

authority - if non-null, only return those authorities who contain this authority

zoneName - if non-null, only include authorities in the named zone

filter - optional callback to apply further filter criteria or null

size - if greater than zero, the maximum results to return. The search strategy used is varied depending on this number.

Returns:

a set of authorities

getAuthoritiesInfo

org.alfresco.query.PagingResults<AuthorityInfo> getAuthoritiesInfo(org.alfresco.service.cmr.security.AuthorityType type,
                                                                   String zoneName,
                                                                   String displayNameFilter,
                                                                   String sortBy,
                                                                   boolean sortAscending,
                                                                   org.alfresco.query.PagingRequest pagingRequest)

Get AuthorityInfo by type and/or zone (both cannot be null).

Parameters:

sortBy - either "displayName", "shortName", "authorityName" or null if no sorting.

getAuthorities

org.alfresco.query.PagingResults<String> getAuthorities(org.alfresco.service.cmr.security.AuthorityType type,
                                                        String zoneName,
                                                        String displayNameFilter,
                                                        boolean sortByDisplayName,
                                                        boolean sortAscending,
                                                        org.alfresco.query.PagingRequest pagingRequest)

Get authority names by type and/or zone (both cannot be null).

authorityExists

boolean authorityExists(String name)

Test if an authority already exists.

getAuthorityNodeRefOrNull

org.alfresco.service.cmr.repository.NodeRef getAuthorityNodeRefOrNull(String name)

Get a node ref for the authority if one exists

getAuthorityName

String getAuthorityName(org.alfresco.service.cmr.repository.NodeRef authorityRef)

Gets the name for the given authority node

Parameters:

authorityRef - authority node

getAuthorityDisplayName

String getAuthorityDisplayName(String authorityName)

Get the display name for an authority

Returns:

the display name

setAuthorityDisplayName

void setAuthorityDisplayName(String authorityName,
                             String authorityDisplayName)

Set the display name for an authority

getRootAuthorities

Set<String> getRootAuthorities(org.alfresco.service.cmr.security.AuthorityType type,
                               String zoneName)

Get root authorities

findAuthorities

Set<String> findAuthorities(org.alfresco.service.cmr.security.AuthorityType type,
                            String parentAuthority,
                            boolean immediate,
                            String displayNamePattern,
                            String zoneName)

Find authorities by display name pattern.

Parameters:

parentAuthority - if non-null, will look only for authorities who are a child of the named parent

immediate - if true then only search root groups if parentAuthority is null, or immediate children of parentAuthority if it is non-null.

zoneName - - may be null to indicate all zones

getShortName

String getShortName(String name)

Extract the short name of an authority from its full identifier.

getName

String getName(org.alfresco.service.cmr.security.AuthorityType type,
               String shortName)

Create the full identifier for an authority given its short name and type.

getOrCreateZone

org.alfresco.service.cmr.repository.NodeRef getOrCreateZone(String zoneName)

Gets or creates an authority zone node with the specified name

Parameters:

zoneName - the zone name

Returns:

reference to the zone node

getZone

org.alfresco.service.cmr.repository.NodeRef getZone(String zoneName)

Gets an authority zone node with the specified name

Parameters:

zoneName - the zone name

Returns:

reference to the zone node ot null if the zone does not exists

getAuthorityZones

Set<String> getAuthorityZones(String name)

Gets the name of the zone containing the specified authority.

Parameters:

name - the authority long name

Returns:

the set of names of all zones containing the specified authority, an empty set if the authority exists but has no zone, or null if the authority does not exist.

getAllAuthoritiesInZone

Set<String> getAllAuthoritiesInZone(String zoneName,
                                    org.alfresco.service.cmr.security.AuthorityType type)

Gets the names of all authorities in a zone, optionally filtered by type.

Parameters:

zoneName - the zone name

type - the authority type to filter by or null for all authority types

Returns:

the names of all authorities in a zone, optionally filtered by type

addAuthorityToZones

void addAuthorityToZones(String authorityName,
                         Set<String> zones)

Add an authority to zones

removeAuthorityFromZones

void removeAuthorityFromZones(String authorityName,
                              Set<String> zones)

Remove an authority from zones.