[Summary view] [Print] [Text view]

   1  <?php
   2  /*
   3   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
   4   * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
   5   * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
   6   * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
   7   * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   8   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   9   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  10   * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  11   * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  12   * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  13   * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  14   *
  15   * This software consists of voluntary contributions made by many individuals
  16   * and is licensed under the MIT license.
  17   */
  18  
  19  namespace ProxyManager\Proxy;
  20  
  21  /**
  22   * Access interceptor object marker
  23   *
  24   * @author Marco Pivetta <ocramius@gmail.com>
  25   * @license MIT
  26   */
  27  interface AccessInterceptorInterface extends ProxyInterface
  28  {
  29      /**
  30       * Set or remove the prefix interceptor for a method
  31       *
  32       * @link https://github.com/Ocramius/ProxyManager/blob/master/docs/access-interceptor-value-holder.md
  33       *
  34       * A prefix interceptor should have a signature like following:
  35       *
  36       * <code>
  37       * $prefixInterceptor = function ($proxy, $instance, $method, $params, & $returnEarly) {};
  38       * </code>
  39       *
  40       * @param string        $methodName        name of the intercepted method
  41       * @param \Closure|null $prefixInterceptor interceptor closure or null to unset the currently active interceptor
  42       *
  43       * @return void
  44       */
  45      public function setMethodPrefixInterceptor($methodName, \Closure $prefixInterceptor = null);
  46  
  47      /**
  48       * Set or remove the suffix interceptor for a method
  49       *
  50       * @link https://github.com/Ocramius/ProxyManager/blob/master/docs/access-interceptor-value-holder.md
  51       *
  52       * A prefix interceptor should have a signature like following:
  53       *
  54       * <code>
  55       * $suffixInterceptor = function ($proxy, $instance, $method, $params, $returnValue, & $returnEarly) {};
  56       * </code>
  57       *
  58       * @param string        $methodName        name of the intercepted method
  59       * @param \Closure|null $suffixInterceptor interceptor closure or null to unset the currently active interceptor
  60       *
  61       * @return void
  62       */
  63      public function setMethodSuffixInterceptor($methodName, \Closure $suffixInterceptor = null);
  64  }