diff -r 000000000000 -r 7f95f8617b0b vendor/symfony/src/Symfony/Component/Security/Acl/Model/AclProviderInterface.php --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/vendor/symfony/src/Symfony/Component/Security/Acl/Model/AclProviderInterface.php Sat Sep 24 15:40:41 2011 +0200 @@ -0,0 +1,49 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Symfony\Component\Security\Acl\Model; + +/** + * Provides a common interface for retrieving ACLs. + * + * @author Johannes M. Schmitt + */ +interface AclProviderInterface +{ + /** + * Retrieves all child object identities from the database + * + * @param ObjectIdentityInterface $parentOid + * @param Boolean $directChildrenOnly + * @return array returns an array of child 'ObjectIdentity's + */ + function findChildren(ObjectIdentityInterface $parentOid, $directChildrenOnly = false); + + /** + * Returns the ACL that belongs to the given object identity + * + * @throws AclNotFoundException when there is no ACL + * @param ObjectIdentityInterface $oid + * @param array $sids + * @return AclInterface + */ + function findAcl(ObjectIdentityInterface $oid, array $sids = array()); + + /** + * Returns the ACLs that belong to the given object identities + * + * @throws AclNotFoundException when we cannot find an ACL for all identities + * @param array $oids an array of ObjectIdentityInterface implementations + * @param array $sids an array of SecurityIdentityInterface implementations + * @return \SplObjectStorage mapping the passed object identities to ACLs + */ + function findAcls(array $oids, array $sids = array()); +}