diff --git a/core/src/main/java/org/acegisecurity/acl/basic/BasicAclProvider.java b/core/src/main/java/org/acegisecurity/acl/basic/BasicAclProvider.java index ccbf7e3c9b..71e9591096 100644 --- a/core/src/main/java/org/acegisecurity/acl/basic/BasicAclProvider.java +++ b/core/src/main/java/org/acegisecurity/acl/basic/BasicAclProvider.java @@ -36,18 +36,24 @@ import java.util.Map; /** - *
Retrieves access control lists (ACL) entries for domain object instances from a data access object (DAO).
- *This implementation will provide ACL lookup services for any object that it can determine the {@link + * Retrieves access control lists (ACL) entries for domain object instances from a data access object (DAO). + *
+ * This implementation will provide ACL lookup services for any object that it can determine the {@link
* AclObjectIdentity} for by calling the {@link #obtainIdentity(Object)} method. Subclasses can override this method
- * if they only want the BasicAclProvider responding to particular domain object instances.
BasicAclProvider will walk an inheritance hierarchy if a BasicAclEntry returned by
- * the DAO indicates it has a parent. NB: inheritance occurs at a domain instance object level. It does not
- * occur at an ACL recipient level. This means allBasicAclEntrys for a given domain instance
- * object must have the same parent identity, or allBasicAclEntrys must have
- * null as their parent identity.
A cache should be used. This is provided by the {@link BasicAclEntryCache}. BasicAclProvider by
- * default is setup to use the {@link NullAclEntryCache}, which performs no caching.
To implement the {@link #getAcls(Object, Authentication)} method, BasicAclProvider requires a
+ * if they only want the BasicAclProvider responding to particular domain object instances.
+ *
+ * BasicAclProvider will walk an inheritance hierarchy if a BasicAclEntry returned by
+ * the DAO indicates it has a parent. NB: inheritance occurs at a domain instance object level. It does not
+ * occur at an ACL recipient level. This means allBasicAclEntrys for a given domain instance
+ * object must have the same parent identity, or allBasicAclEntrys must have
+ * null as their parent identity.
+ *
+ * A cache should be used. This is provided by the {@link BasicAclEntryCache}. BasicAclProvider by
+ * default is setup to use the {@link NullAclEntryCache}, which performs no caching.
+ *
To implement the {@link #getAcls(Object, Authentication)} method, BasicAclProvider requires a
* {@link EffectiveAclsResolver} to be configured against it. By default the {@link
* GrantedAuthorityEffectiveAclsResolver} is used.