Storage object exist implementation

Author: salilg-eng

Storage/src/Connection/ConnectionInterface.php

@@ -130,6 +130,11 @@ public function composeObject(array $args = []);
      */
     public function getObject(array $args = []);
 
+    /**
+     * @param array $args
+     */
+    public function headObject(array $args = []);
+
     /**
      * @param array $args
      */

Storage/src/Connection/Rest.php

@@ -306,6 +306,31 @@ public function getObject(array $args = [])
         return $this->send('objects', 'get', $args);
     }
 
+    /**
+     * @param array $args
+     */
+    public function headObject(array $args = [])
+    {
+        $args += [
+            'prettyPrint' => false,
+        ];
+        $requestOptions = $this->pluckArray([
+            'restOptions',
+            'retries',
+            'retryHeaders',
+            'requestTimeout',
+            'restRetryFunction',
+            'restRetryListener',
+            'restDelayFunction',
+            'restCalcDelayFunction',
+        ], $args);
+
+        $request = $this->requestBuilder->build('objects', 'get', $args);
+        $request = $request->withMethod('HEAD');
+
+        return $this->requestWrapper->send($request, $requestOptions);
+    }
+
     /**
      * @param array $args
      */

Storage/src/StorageObject.php

@@ -146,7 +146,7 @@ public function acl()
     public function exists(array $options = [])
     {
         try {
-            $this->connection->getObject($this->identity + $options + ['fields' => 'name']);
+            $this->connection->headObject($this->identity + $options);
         } catch (NotFoundException $ex) {
             return false;
         }

Storage/tests/Snippet/StorageObjectTest.php

@@ -81,7 +81,7 @@ public function testExists()
         $snippet = $this->snippetFromMethod(StorageObject::class, 'exists');
         $snippet->addLocal('object', $this->object);
 
-        $this->connection->getObject(Argument::any())
+        $this->connection->headObject(Argument::any())
             ->shouldBeCalled()
             ->willReturn([]);
 

Storage/tests/Unit/StorageObjectTest.php

@@ -82,15 +82,15 @@ public function testGetAcl()
 
     public function testDoesExistTrue()
     {
-        $this->connection->getObject(Argument::any())->willReturn(['name' => self::OBJECT]);
+        $this->connection->headObject(Argument::any())->willReturn([]);
         $object = new StorageObject($this->connection->reveal(), self::OBJECT, self::BUCKET);
 
         $this->assertTrue($object->exists());
     }
 
     public function testDoesExistFalse()
     {
-        $this->connection->getObject(Argument::any())->willThrow(new NotFoundException(null));
+        $this->connection->headObject(Argument::any())->willThrow(new NotFoundException(null));
         $object = new StorageObject($this->connection->reveal(), self::OBJECT, self::BUCKET);
 
         $this->assertFalse($object->exists());