org.acegisecurity.acl.basic
Interface BasicAclEntryCache

All Known Implementing Classes:
EhCacheBasedAclEntryCache, NullAclEntryCache

public interface BasicAclEntryCache

Provides a cache of BasicAclEntry objects.

Implementations should provide appropriate methods to set their cache parameters (eg time-to-live) and/or force removal of entities before their normal expiration. These are not part of the BasicAclEntryCache interface contract because they vary depending on the type of caching system used (eg in-memory vs disk vs cluster vs hybrid).

Version:
$Id: BasicAclEntryCache.java 1784 2007-02-24 21:00:24Z luke_t $
Author:
Ben Alex

Method Summary
 BasicAclEntry[] getEntriesFromCache(AclObjectIdentity aclObjectIdentity)
          Obtains an array of BasicAclEntrys from the cache.
 void putEntriesInCache(BasicAclEntry[] basicAclEntry)
          Places an array of BasicAclEntrys in the cache.
 void removeEntriesFromCache(AclObjectIdentity aclObjectIdentity)
          Removes all ACL entries related to an AclObjectIdentity from the cache.
 

Method Detail

getEntriesFromCache

BasicAclEntry[] getEntriesFromCache(AclObjectIdentity aclObjectIdentity)
Obtains an array of BasicAclEntrys from the cache.

Parameters:
aclObjectIdentity - which should be obtained from the cache
Returns:
any applicable BasicAclEntrys (no nulls are permitted in the returned array) or null if the object identity could not be found or if the cache entry has expired

putEntriesInCache

void putEntriesInCache(BasicAclEntry[] basicAclEntry)
Places an array of BasicAclEntrys in the cache.

No nulls are allowed in the passed array. If any null is passed, the implementation may throw an exception.

Parameters:
basicAclEntry - the ACL entries to cache (the key will be extracted from the BasicAclEntry.getAclObjectIdentity() method

removeEntriesFromCache

void removeEntriesFromCache(AclObjectIdentity aclObjectIdentity)
Removes all ACL entries related to an AclObjectIdentity from the cache.

Parameters:
aclObjectIdentity - which should be removed from the cache


Copyright © 2004-2012 Interface21, Inc. All Rights Reserved.