PointcutInterface.php 1.8KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354
  1. <?php
  2. /*
  3. * Copyright 2011 Johannes M. Schmitt <schmittjoh@gmail.com>
  4. *
  5. * Licensed under the Apache License, Version 2.0 (the "License");
  6. * you may not use this file except in compliance with the License.
  7. * You may obtain a copy of the License at
  8. *
  9. * http://www.apache.org/licenses/LICENSE-2.0
  10. *
  11. * Unless required by applicable law or agreed to in writing, software
  12. * distributed under the License is distributed on an "AS IS" BASIS,
  13. * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14. * See the License for the specific language governing permissions and
  15. * limitations under the License.
  16. */
  17. namespace JMS\AopBundle\Aop;
  18. /**
  19. * Pointcut Interface.
  20. *
  21. * Implementations of this class are responsible for making a decision on whether
  22. * a certain method call matches the advice which is associated with this pointcut.
  23. *
  24. * @author Johannes M. Schmitt <schmittjoh@gmail.com>
  25. */
  26. interface PointcutInterface
  27. {
  28. /**
  29. * Determines whether the advice applies to instances of the given class.
  30. *
  31. * There are some limits as to what you can do in this method. Namely, you may
  32. * only base your decision on resources that are part of the ContainerBuilder.
  33. * Specifically, you may not use any data in the class itself, such as
  34. * annotations.
  35. *
  36. * @param \ReflectionClass $class
  37. * @return boolean
  38. */
  39. function matchesClass(\ReflectionClass $class);
  40. /**
  41. * Determines whether the advice applies to the given method.
  42. *
  43. * This method is not limited in the way the matchesClass method is. It may
  44. * use information in the associated class to make its decision.
  45. *
  46. * @param \ReflectionMethod $method
  47. * @return boolean
  48. */
  49. function matchesMethod(\ReflectionMethod $method);
  50. }