org.acegisecurity.acls.jdbc

Class BasicLookupStrategy

java.lang.Object

org.acegisecurity.acls.jdbc.BasicLookupStrategy

All Implemented Interfaces:

LookupStrategy

public final class BasicLookupStrategy
extends Object
implements LookupStrategy

Performs lookups in a manner that is compatible with ANSI SQL.

NB: This implementation does attempt to provide reasonably optimised lookups - within the constraints of a normalised database and standard ANSI SQL features. If you are willing to sacrifice either of these constraints (eg use a particular database feature such as hierarchical queries or materalized views, or reduce normalisation) you are likely to achieve better performance. In such situations you will need to provide your own custom LookupStrategy. This class does not support subclassing, as it is likely to change in future releases and therefore subclassing is unsupported.

Version:

$Id: BasicLookupStrategy.java 1784 2007-02-24 21:00:24Z luke_t $

Author:

Ben Alex

Constructor Summary

Constructors

Constructor and Description
BasicLookupStrategy(DataSource dataSource, AclCache aclCache, AclAuthorizationStrategy aclAuthorizationStrategy, AuditLogger auditLogger) Constructor accepting mandatory arguments

Method Summary

Modifier and Type	Method and Description
Map	readAclsById(ObjectIdentity[] objects, Sid[] sids) The main method.
void	setBatchSize(int batchSize)

Methods inherited from class java.lang.Object

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

Constructor Detail

BasicLookupStrategy

public BasicLookupStrategy(DataSource dataSource,
                           AclCache aclCache,
                           AclAuthorizationStrategy aclAuthorizationStrategy,
                           AuditLogger auditLogger)

Constructor accepting mandatory arguments

Parameters:

dataSource - to access the database

aclCache - the cache where fully-loaded elements can be stored

aclAuthorizationStrategy - authorization strategy (required)

Method Detail

readAclsById

public Map readAclsById(ObjectIdentity[] objects,
                        Sid[] sids)
                 throws NotFoundException

The main method.

WARNING: This implementation completely disregards the "sids" parameter! Every item in the cache is expected to contain all SIDs. If you have serious performance needs (eg a very large number of SIDs per object identity), you'll probably want to develop a custom LookupStrategy implementation instead.

The implementation works in batch sizes specfied by batchSize.

Specified by:

readAclsById in interface LookupStrategy

Parameters:

objects - DOCUMENT ME!

sids - DOCUMENT ME!

Returns:

DOCUMENT ME!

Throws:

NotFoundException - DOCUMENT ME!

IllegalStateException - DOCUMENT ME!

setBatchSize

public void setBatchSize(int batchSize)