diff -r 000000000000 -r 7f95f8617b0b vendor/symfony/src/Symfony/Component/Security/Acl/Model/MutableAclProviderInterface.php --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/vendor/symfony/src/Symfony/Component/Security/Acl/Model/MutableAclProviderInterface.php Sat Sep 24 15:40:41 2011 +0200 @@ -0,0 +1,52 @@ + + * + * 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 support for creating and storing ACL instances. + * + * @author Johannes M. Schmitt + */ +interface MutableAclProviderInterface extends AclProviderInterface +{ + /** + * Creates a new ACL for the given object identity. + * + * @throws AclAlreadyExistsException when there already is an ACL for the given + * object identity + * @param ObjectIdentityInterface $oid + * @return AclInterface + */ + function createAcl(ObjectIdentityInterface $oid); + + /** + * Deletes the ACL for a given object identity. + * + * This will automatically trigger a delete for any child ACLs. If you don't + * want child ACLs to be deleted, you will have to set their parent ACL to null. + * + * @param ObjectIdentityInterface $oid + * @return void + */ + function deleteAcl(ObjectIdentityInterface $oid); + + /** + * Persists any changes which were made to the ACL, or any associated + * access control entries. + * + * Changes to parent ACLs are not persisted. + * + * @param MutableAclInterface $acl + * @return void + */ + function updateAcl(MutableAclInterface $acl); +}