org.alfresco.repo.security.authority

Class AuthorityDAOImpl

java.lang.Object

org.alfresco.repo.security.authority.AuthorityDAOImpl

All Implemented Interfaces:

NodeServicePolicies.BeforeDeleteNodePolicy, NodeServicePolicies.OnUpdatePropertiesPolicy, ClassPolicy, Policy, AuthorityDAO, org.alfresco.util.cache.RefreshableCacheListener, org.springframework.beans.factory.InitializingBean

public class AuthorityDAOImpl
extends Object
implements AuthorityDAO, NodeServicePolicies.BeforeDeleteNodePolicy, NodeServicePolicies.OnUpdatePropertiesPolicy, org.alfresco.util.cache.RefreshableCacheListener, org.springframework.beans.factory.InitializingBean

Nested Class Summary

Nested classes/interfaces inherited from interface org.alfresco.repo.policy.Policy

Policy.Arg

Field Summary

Fields inherited from interface org.alfresco.repo.node.NodeServicePolicies.BeforeDeleteNodePolicy

QNAME

Fields inherited from interface org.alfresco.repo.node.NodeServicePolicies.OnUpdatePropertiesPolicy

ARG_0, ARG_1, ARG_2, QNAME

Fields inherited from interface org.alfresco.repo.policy.Policy

NAMESPACE

Constructor Summary

Constructors

Constructor and Description
AuthorityDAOImpl()

Method Summary

Modifier and Type	Method and Description
void	addAuthority(Collection<String> parentNames, String childName) Add a child authority to the given parent authorities
protected void	addAuthorityNameIfMatches(Set<String> authorities, String authorityName, org.alfresco.service.cmr.security.AuthorityType type)
protected void	addAuthorityNameIfMatches(Set<String> authorities, String authorityName, org.alfresco.service.cmr.security.AuthorityType type, Pattern pattern)
void	addAuthorityToZones(String authorityName, Set<String> zones) Add an authority to zones
void	afterPropertiesSet()
boolean	authorityExists(String name) Test if an authority already exists.
void	beforeDeleteNode(org.alfresco.service.cmr.repository.NodeRef nodeRef) Listen out for person removals so that we can clear cached authorities.
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.
String	getCacheId()
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
void	init()
boolean	isAuthorityContained(String authority, String authorityToFind, Set<String> positiveHits, Set<String> negativeHits)
void	onRefreshableCacheEvent(org.alfresco.util.cache.RefreshableCacheEvent refreshableCacheEvent)
void	onUpdateProperties(org.alfresco.service.cmr.repository.NodeRef nodeRef, Map<org.alfresco.service.namespace.QName,Serializable> before, Map<org.alfresco.service.namespace.QName,Serializable> after) Called after a node's properties have been changed.
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	setAclDAO(AclDAO aclDao)
void	setAuthorityBridgeDAO(AuthorityBridgeDAO authorityBridgeDAO)
void	setAuthorityBridgeTableCache(AuthorityBridgeTableAsynchronouslyRefreshedCache authorityBridgeTableCache)
void	setAuthorityDisplayName(String authorityName, String authorityDisplayName) Set the display name for an authority
void	setAuthorityLookupCache(org.alfresco.repo.cache.SimpleCache<org.alfresco.util.Pair<String,String>,org.alfresco.service.cmr.repository.NodeRef> authorityLookupCache)
void	setCannedQueryDAO(CannedQueryDAO cannedQueryDAO)
void	setCannedQueryRegistry(org.alfresco.util.registry.NamedObjectRegistry<org.alfresco.query.CannedQueryFactory<?>> cannedQueryRegistry)
void	setChildAuthorityCache(org.alfresco.repo.cache.SimpleCache<org.alfresco.service.cmr.repository.NodeRef,org.alfresco.util.Pair<Map<org.alfresco.service.cmr.repository.NodeRef,String>,List<org.alfresco.service.cmr.repository.NodeRef>>> childAuthorityCache)
void	setDictionaryService(org.alfresco.service.cmr.dictionary.DictionaryService dictionaryService)
void	setNamespacePrefixResolver(org.alfresco.service.namespace.NamespacePrefixResolver namespacePrefixResolver)
void	setNodeService(org.alfresco.service.cmr.repository.NodeService nodeService)
void	setPersonService(PersonService personService)
void	setPolicyComponent(PolicyComponent policyComponent)
void	setQnameDAO(QNameDAO qnameDAO)
void	setSearchService(org.alfresco.service.cmr.search.SearchService searchService)
void	setSingletonCache(org.alfresco.repo.cache.SimpleCache<String,Object> singletonCache)
void	setStoreUrl(String storeUrl)
void	setTenantService(org.alfresco.repo.tenant.TenantService tenantService)
void	setUseBridgeTable(boolean useBridgeTable)
void	setUserAuthorityCache(org.alfresco.repo.cache.SimpleCache<String,Set<String>> userAuthorityCache)
void	setZoneAuthorityCache(org.alfresco.repo.cache.SimpleCache<org.alfresco.util.Pair<String,String>,List<org.alfresco.service.cmr.repository.ChildAssociationRef>> zoneAuthorityCache)
void	setZoneAuthoritySampleSize(int zoneAuthoritySampleSize) Sets number of authorities in a zone to pre-cache, allowing quick generation of 'first n' results and adaption of search technique based on hit rate.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AuthorityDAOImpl

public AuthorityDAOImpl()

Method Detail

setZoneAuthoritySampleSize

public void setZoneAuthoritySampleSize(int zoneAuthoritySampleSize)

Sets number of authorities in a zone to pre-cache, allowing quick generation of 'first n' results and adaption of search technique based on hit rate.

Parameters:

zoneAuthoritySampleSize - the zoneAuthoritySampleSize to set

setStoreUrl

public void setStoreUrl(String storeUrl)

setDictionaryService

public void setDictionaryService(org.alfresco.service.cmr.dictionary.DictionaryService dictionaryService)

setNamespacePrefixResolver

public void setNamespacePrefixResolver(org.alfresco.service.namespace.NamespacePrefixResolver namespacePrefixResolver)

setNodeService

public void setNodeService(org.alfresco.service.cmr.repository.NodeService nodeService)

setSearchService

public void setSearchService(org.alfresco.service.cmr.search.SearchService searchService)

setAuthorityLookupCache

public void setAuthorityLookupCache(org.alfresco.repo.cache.SimpleCache<org.alfresco.util.Pair<String,String>,org.alfresco.service.cmr.repository.NodeRef> authorityLookupCache)

setUserAuthorityCache

public void setUserAuthorityCache(org.alfresco.repo.cache.SimpleCache<String,Set<String>> userAuthorityCache)

setZoneAuthorityCache

public void setZoneAuthorityCache(org.alfresco.repo.cache.SimpleCache<org.alfresco.util.Pair<String,String>,List<org.alfresco.service.cmr.repository.ChildAssociationRef>> zoneAuthorityCache)

setChildAuthorityCache

public void setChildAuthorityCache(org.alfresco.repo.cache.SimpleCache<org.alfresco.service.cmr.repository.NodeRef,org.alfresco.util.Pair<Map<org.alfresco.service.cmr.repository.NodeRef,String>,List<org.alfresco.service.cmr.repository.NodeRef>>> childAuthorityCache)

setAuthorityBridgeTableCache

public void setAuthorityBridgeTableCache(AuthorityBridgeTableAsynchronouslyRefreshedCache authorityBridgeTableCache)

setUseBridgeTable

public void setUseBridgeTable(boolean useBridgeTable)

Parameters:

useBridgeTable - the useBridgeTable to set

setPersonService

public void setPersonService(PersonService personService)

setTenantService

public void setTenantService(org.alfresco.repo.tenant.TenantService tenantService)

setSingletonCache

public void setSingletonCache(org.alfresco.repo.cache.SimpleCache<String,Object> singletonCache)

setQnameDAO

public void setQnameDAO(QNameDAO qnameDAO)

setCannedQueryDAO

public void setCannedQueryDAO(CannedQueryDAO cannedQueryDAO)

setAclDAO

public void setAclDAO(AclDAO aclDao)

setPolicyComponent

public void setPolicyComponent(PolicyComponent policyComponent)

setCannedQueryRegistry

public void setCannedQueryRegistry(org.alfresco.util.registry.NamedObjectRegistry<org.alfresco.query.CannedQueryFactory<?>> cannedQueryRegistry)

setAuthorityBridgeDAO

public void setAuthorityBridgeDAO(AuthorityBridgeDAO authorityBridgeDAO)

Parameters:

authorityBridgeDAO - the authorityBridgeDAO to set

getPersonCount

public long getPersonCount()

Description copied from interface: AuthorityDAO

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

Specified by:

getPersonCount in interface AuthorityDAO

Returns:

the number of people

getGroupCount

public long getGroupCount()

Description copied from interface: AuthorityDAO

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

Specified by:

getGroupCount in interface AuthorityDAO

Returns:

the number of groups

authorityExists

public boolean authorityExists(String name)

Description copied from interface: AuthorityDAO

Test if an authority already exists.

Specified by:

authorityExists in interface AuthorityDAO

addAuthority

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

Description copied from interface: AuthorityDAO

Add a child authority to the given parent authorities

Specified by:

addAuthority in interface AuthorityDAO

createAuthority

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

Description copied from interface: AuthorityDAO

Create an authority.

Specified by:

createAuthority in interface AuthorityDAO

deleteAuthority

public void deleteAuthority(String name)

Description copied from interface: AuthorityDAO

Delete an authority.

Specified by:

deleteAuthority in interface AuthorityDAO

getAuthoritiesInfo

public 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)

Description copied from interface: AuthorityDAO

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

Specified by:

getAuthoritiesInfo in interface AuthorityDAO

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

getAuthorities

public 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)

Description copied from interface: AuthorityDAO

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

Specified by:

getAuthorities in interface AuthorityDAO

getRootAuthorities

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

Description copied from interface: AuthorityDAO

Get root authorities

Specified by:

getRootAuthorities in interface AuthorityDAO

findAuthorities

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

Description copied from interface: AuthorityDAO

Find authorities by display name pattern.

Specified by:

findAuthorities in interface AuthorityDAO

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

getContainedAuthorities

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

Description copied from interface: AuthorityDAO

Get contained authorities.

Specified by:

getContainedAuthorities in interface AuthorityDAO

parentName - the name of the containing authority

removeAuthority

public void removeAuthority(String parentName,
                            String childName)

Description copied from interface: AuthorityDAO

Remove an authority.

Specified by:

removeAuthority in interface AuthorityDAO

removeAuthority

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

Description copied from interface: AuthorityDAO

Remove an authority without authorityBridgeTableCache refresh.

Specified by:

removeAuthority in interface AuthorityDAO

getContainingAuthorities

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

Description copied from interface: AuthorityDAO

Get the authorities that contain the one given.

Specified by:

getContainingAuthorities in interface AuthorityDAO

getContainingAuthoritiesInZone

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

Description copied from interface: AuthorityDAO

Get a set of authorities with varying filter criteria

Specified by:

getContainingAuthoritiesInZone in interface AuthorityDAO

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

getShortName

public String getShortName(String name)

Description copied from interface: AuthorityDAO

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

Specified by:

getShortName in interface AuthorityDAO

getName

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

Description copied from interface: AuthorityDAO

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

Specified by:

getName in interface AuthorityDAO

addAuthorityNameIfMatches

protected void addAuthorityNameIfMatches(Set<String> authorities,
                                         String authorityName,
                                         org.alfresco.service.cmr.security.AuthorityType type)

addAuthorityNameIfMatches

protected void addAuthorityNameIfMatches(Set<String> authorities,
                                         String authorityName,
                                         org.alfresco.service.cmr.security.AuthorityType type,
                                         Pattern pattern)

isAuthorityContained

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

Specified by:

isAuthorityContained in interface AuthorityDAO

getAuthorityNodeRefOrNull

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

Description copied from interface: AuthorityDAO

Get a node ref for the authority if one exists

Specified by:

getAuthorityNodeRefOrNull in interface AuthorityDAO

getAuthorityName

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

Description copied from interface: AuthorityDAO

Gets the name for the given authority node

Specified by:

getAuthorityName in interface AuthorityDAO

Parameters:

authorityRef - authority node

getAuthorityDisplayName

public String getAuthorityDisplayName(String authorityName)

Description copied from interface: AuthorityDAO

Get the display name for an authority

Specified by:

getAuthorityDisplayName in interface AuthorityDAO

Returns:

the display name

setAuthorityDisplayName

public void setAuthorityDisplayName(String authorityName,
                                    String authorityDisplayName)

Description copied from interface: AuthorityDAO

Set the display name for an authority

Specified by:

setAuthorityDisplayName in interface AuthorityDAO

getOrCreateZone

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

Description copied from interface: AuthorityDAO

Gets or creates an authority zone node with the specified name

Specified by:

getOrCreateZone in interface AuthorityDAO

Parameters:

zoneName - the zone name

Returns:

reference to the zone node

getZone

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

Description copied from interface: AuthorityDAO

Gets an authority zone node with the specified name

Specified by:

getZone in interface AuthorityDAO

Parameters:

zoneName - the zone name

Returns:

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

getAuthorityZones

public Set<String> getAuthorityZones(String name)

Description copied from interface: AuthorityDAO

Gets the name of the zone containing the specified authority.

Specified by:

getAuthorityZones in interface AuthorityDAO

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

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

Description copied from interface: AuthorityDAO

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

Specified by:

getAllAuthoritiesInZone in interface AuthorityDAO

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

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

Description copied from interface: AuthorityDAO

Add an authority to zones

Specified by:

addAuthorityToZones in interface AuthorityDAO

removeAuthorityFromZones

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

Description copied from interface: AuthorityDAO

Remove an authority from zones.

Specified by:

removeAuthorityFromZones in interface AuthorityDAO

beforeDeleteNode

public void beforeDeleteNode(org.alfresco.service.cmr.repository.NodeRef nodeRef)

Listen out for person removals so that we can clear cached authorities.

Specified by:

beforeDeleteNode in interface NodeServicePolicies.BeforeDeleteNodePolicy

Parameters:

nodeRef - the node reference

onUpdateProperties

public void onUpdateProperties(org.alfresco.service.cmr.repository.NodeRef nodeRef,
                               Map<org.alfresco.service.namespace.QName,Serializable> before,
                               Map<org.alfresco.service.namespace.QName,Serializable> after)

Description copied from interface: NodeServicePolicies.OnUpdatePropertiesPolicy

Called after a node's properties have been changed.

Specified by:

onUpdateProperties in interface NodeServicePolicies.OnUpdatePropertiesPolicy

Parameters:

nodeRef - reference to the updated node

before - the node's properties before the change

after - the node's properties after the change

init

public void init()

onRefreshableCacheEvent

public void onRefreshableCacheEvent(org.alfresco.util.cache.RefreshableCacheEvent refreshableCacheEvent)

Specified by:

onRefreshableCacheEvent in interface org.alfresco.util.cache.RefreshableCacheListener

getCacheId

public String getCacheId()

Specified by:

getCacheId in interface org.alfresco.util.cache.RefreshableCacheListener

afterPropertiesSet

public void afterPropertiesSet()
                        throws Exception

Specified by:

afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean

Throws:

Exception