diff -r 000000000000 -r 7f95f8617b0b vendor/symfony/src/Symfony/Component/Security/Acl/Model/MutableAclInterface.php --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/vendor/symfony/src/Symfony/Component/Security/Acl/Model/MutableAclInterface.php Sat Sep 24 15:40:41 2011 +0200 @@ -0,0 +1,172 @@ + + * + * 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; + +/** + * This interface adds mutators for the AclInterface. + * + * All changes to Access Control Entries must go through this interface. Access + * Control Entries must never be modified directly. + * + * @author Johannes M. Schmitt + */ +interface MutableAclInterface extends AclInterface +{ + /** + * Deletes a class-based ACE + * + * @param integer $index + * @return void + */ + function deleteClassAce($index); + + /** + * Deletes a class-field-based ACE + * + * @param integer $index + * @param string $field + * @return void + */ + function deleteClassFieldAce($index, $field); + + /** + * Deletes an object-based ACE + * + * @param integer $index + * @return void + */ + function deleteObjectAce($index); + + /** + * Deletes an object-field-based ACE + * + * @param integer $index + * @param string $field + * @return void + */ + function deleteObjectFieldAce($index, $field); + + /** + * Returns the primary key of this ACL + * + * @return integer + */ + function getId(); + + /** + * Inserts a class-based ACE + * + * @param SecurityIdentityInterface $sid + * @param integer $mask + * @param integer $index + * @param Boolean $granting + * @param string $strategy + * @return void + */ + function insertClassAce(SecurityIdentityInterface $sid, $mask, $index = 0, $granting = true, $strategy = null); + + /** + * Inserts a class-field-based ACE + * + * @param string $field + * @param SecurityIdentityInterface $sid + * @param integer $mask + * @param integer $index + * @param Boolean $granting + * @param string $strategy + * @return void + */ + function insertClassFieldAce($field, SecurityIdentityInterface $sid, $mask, $index = 0, $granting = true, $strategy = null); + + /** + * Inserts an object-based ACE + * + * @param SecurityIdentityInterface $sid + * @param integer $mask + * @param integer $index + * @param Boolean $granting + * @param string $strategy + * @return void + */ + function insertObjectAce(SecurityIdentityInterface $sid, $mask, $index = 0, $granting = true, $strategy = null); + + /** + * Inserts an object-field-based ACE + * + * @param string $field + * @param SecurityIdentityInterface $sid + * @param integer $mask + * @param integer $index + * @param Boolean $granting + * @param string $strategy + * @return void + */ + function insertObjectFieldAce($field, SecurityIdentityInterface $sid, $mask, $index = 0, $granting = true, $strategy = null); + + /** + * Sets whether entries are inherited + * + * @param Boolean $boolean + * @return void + */ + function setEntriesInheriting($boolean); + + /** + * Sets the parent ACL + * + * @param AclInterface $acl + * @return void + */ + function setParentAcl(AclInterface $acl); + + /** + * Updates a class-based ACE + * + * @param integer $index + * @param integer $mask + * @param string $strategy if null the strategy should not be changed + * @return void + */ + function updateClassAce($index, $mask, $strategy = null); + + /** + * Updates a class-field-based ACE + * + * @param integer $index + * @param string $field + * @param integer $mask + * @param string $strategy if null the strategy should not be changed + * @return void + */ + function updateClassFieldAce($index, $field, $mask, $strategy = null); + + /** + * Updates an object-based ACE + * + * @param integer $index + * @param integer $mask + * @param string $strategy if null the strategy should not be changed + * @return void + */ + function updateObjectAce($index, $mask, $strategy = null); + + /** + * Updates an object-field-based ACE + * + * @param integer $index + * @param string $field + * @param integer $mask + * @param string $strategy if null the strategy should not be changed + * @return void + */ + function updateObjectFieldAce($index, $field, $mask, $strategy = null); +}