<?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;

/**

 * This interface adds auditing capabilities to the ACL.

 *

 * @author Johannes M. Schmitt <schmittjoh@gmail.com>

 */

interface AuditableAclInterface extends MutableAclInterface

{

    /**

     * Updates auditing for class-based ACE

     *

     * @param integer $index

     * @param Boolean $auditSuccess

     * @param Boolean $auditFailure

     * @return void

     */

    function updateClassAuditing($index, $auditSuccess, $auditFailure);

    /**

     * Updates auditing for class-field-based ACE

     *

     * @param integer $index

     * @param string $field

     * @param Boolean $auditSuccess

     * @param Boolean $auditFailure

     * @return void

     */

    function updateClassFieldAuditing($index, $field, $auditSuccess, $auditFailure);

    /**

     * Updates auditing for object-based ACE

     *

     * @param integer $index

     * @param Boolean $auditSuccess

     * @param Boolean $auditFailure

     * @return void

     */

    function updateObjectAuditing($index, $auditSuccess, $auditFailure);

    /**

     * Updates auditing for object-field-based ACE

     *

     * @param integer $index

     * @param string $field

     * @param Boolean $auditSuccess

     * @param Boolean $auditFailure

     * @return void

     */

    function updateObjectFieldAuditing($index, $field, $auditSuccess, $auditFailure);

}