feat(Query): add support for parametrized queries

Closes #505

Author: jenschude

src/Core/Request/QueryTrait.php

@@ -22,12 +22,16 @@ abstract public function addParamObject(ParameterInterface $param);
 
     /**
      * @param string $where
+     * @param array $params
      * @return $this
      */
-    public function where($where)
+    public function where($where, array $params = [])
     {
         if (!is_null($where)) {
             $this->addParamObject(new MultiParameter('where', $where));
+            foreach ($params as $paramName => $paramValue) {
+                $this->addParam($paramName, $paramValue);
+            }
         }
 
         return $this;

tests/integration/Product/ProductQueryRequestTest.php

@@ -15,6 +15,7 @@
 use Commercetools\Core\Model\Product\ProductDraft;
 use Commercetools\Core\Model\Product\ProductProjection;
 use Commercetools\Core\Model\Product\ProductVariantDraft;
+use Commercetools\Core\Model\Product\ProductVariantDraftCollection;
 use Commercetools\Core\Request\Products\ProductByIdGetRequest;
 use Commercetools\Core\Request\Products\ProductByKeyGetRequest;
 use Commercetools\Core\Request\Products\ProductCreateRequest;
@@ -60,7 +61,8 @@ public function testQuery()
         $draft = $this->getDraft();
         $product = $this->createProduct($draft);
 
-        $request = ProductQueryRequest::of()->where('masterData(current(name(en="' . $draft->getName()->en . '")))');
+        $request = ProductQueryRequest::of()->where('masterData(current(name(en=:name)))', ['name' => $draft->getName()->en]);
+
         $response = $request->executeWithClient($this->getClient());
         $result = $request->mapResponse($response);
 
@@ -125,7 +127,7 @@ public function testPriceSelectProductQuery()
         $this->createProduct($draft);
 
         $request = ProductQueryRequest::of()
-            ->where('masterData(current(name(en="' . $draft->getName()->en . '")))')
+            ->where('masterData(current(name(en=:name)))', ['name' => $draft->getName()->en])
             ->currency('EUR')
         ;
         $response = $request->executeWithClient($this->getClient());
@@ -197,6 +199,33 @@ public function testPriceSelectProductProjectionQuery()
         $this->assertSame(100, $result->current()->getMasterVariant()->getPrice()->getValue()->getCentAmount());
     }
 
+    public function testSkuParametrized()
+    {
+        $draft = $this->getDraft();
+        $sku1 = 'sku1' . uniqid();
+        $sku2 = 'sku2' . uniqid();
+        $draft->setMasterVariant(ProductVariantDraft::of()->setSku($sku1));
+        $draft->setVariants(ProductVariantDraftCollection::of()->add(ProductVariantDraft::of()->setSku($sku2)));
+        $this->createProduct($draft);
+
+        $request = ProductProjectionQueryRequest::of()
+            ->where(
+                'masterVariant(sku in (:skus1, :skus2)) or variants(sku in (:skus1, :skus2))',
+                [
+                    'skus1' => 'whatever',
+                    'skus2' => $sku2
+                ]
+            )
+            ->staged(true)
+        ;
+        $response = $request->executeWithClient($this->getClient());
+        $result = $request->mapResponse($response);
+        $this->assertCount(1, $result);
+        $this->assertInstanceOf(ProductProjection::class, $result->getAt(0));
+        $this->assertSame($sku1, $result->current()->getMasterVariant()->getSku());
+        $this->assertSame($sku2, $result->current()->getVariants()->current()->getSku());
+    }
+
     public function testPriceSelectProductProjectionById()
     {
         $draft = $this->getDraft();