vendor/symfony/src/Symfony/Component/Security/Acl/Model/MutableAclProviderInterface.php
changeset 0 7f95f8617b0b
--- /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 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * 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 <schmittjoh@gmail.com>
+ */
+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);
+}