QueryCache.php 1.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455
  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. For more information, see
  17. * <http://www.doctrine-project.org>.
  18. */
  19. namespace Doctrine\ORM\Cache;
  20. use Doctrine\ORM\Query\ResultSetMapping;
  21. /**
  22. * Defines the contract for caches capable of storing query results.
  23. * These caches should only concern themselves with storing the matching result ids.
  24. */
  25. interface QueryCache
  26. {
  27. /**
  28. * @return bool
  29. */
  30. public function clear();
  31. /**
  32. * @param mixed $result
  33. * @param mixed[] $hints
  34. *
  35. * @return bool
  36. */
  37. public function put(QueryCacheKey $key, ResultSetMapping $rsm, $result, array $hints = []);
  38. /**
  39. * @param mixed[] $hints
  40. *
  41. * @return mixed[]|null
  42. */
  43. public function get(QueryCacheKey $key, ResultSetMapping $rsm, array $hints = []);
  44. /**
  45. * @return Region
  46. */
  47. public function getRegion();
  48. }