Added interface

Author: Alessandro Frangioni

spec/SpecificationRepositoryStub.php

@@ -4,7 +4,7 @@
 
 use Doctrine\ORM\EntityRepository;
 
-class SpecificationRepositoryStub extends EntityRepository
+class SpecificationRepositoryStub extends EntityRepository implements SpecificationAware
 {
     use SpecificationRepositoryTrait;
 }

src/SpecificationAware.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace Rb\Specification\Doctrine;
+
+use Doctrine\ORM\Query;
+use Rb\Specification\Doctrine\Result\ModifierInterface;
+
+/**
+ * SpecificationAware can be used to implement custom repository.
+ */
+interface SpecificationAware
+{
+    /**
+     * Get the query after matching with given specification.
+     *
+     * @param SpecificationInterface $specification
+     * @param ModifierInterface      $modifier
+     *
+     * @return Query
+     */
+    public function match(SpecificationInterface $specification, ModifierInterface $modifier = null);
+}

src/SpecificationRepositoryTrait.php

@@ -18,14 +18,13 @@ trait SpecificationRepositoryTrait
     protected $dqlAlias = 'e';
 
     /**
-     * Get the query after matching with given specification.
+     * @see SpecificationAware::match()
      *
      * @param SpecificationInterface $specification
-     * @param ModifierInterface      $modifier
-     *
-     * @throws LogicException
+     * @param ModifierInterface|null $modifier
      *
      * @return Query
+     * @throws LogicException
      */
     public function match(SpecificationInterface $specification, ModifierInterface $modifier = null)
     {