Refactor exceptions, add new exceptions, make batch exception final, make all exceptions immutable

Author: sagikazarmark

src/Exception/BatchException.php

@@ -0,0 +1,97 @@
+<?php
+
+namespace Http\Client\Exception;
+
+use Psr\Http\Message\ResponseInterface;
+
+/**
+ * @author GeLo <[email protected]>
+ */
+final class BatchException extends TransferException
+{
+    /**
+     * @var TransferException[]
+     */
+    private $exceptions;
+
+    /**
+     * @var ResponseInterface[]
+     */
+    private $responses;
+
+    /**
+     * @param TransferException[] $exceptions
+     * @param ResponseInterface[]   $responses
+     */
+    public function __construct(array $exceptions = [], array $responses = [])
+    {
+        parent::__construct('An error occurred when sending multiple requests.');
+
+        $this->setExceptions($exceptions);
+        $this->setResponses($responses);
+    }
+
+    /**
+     * Returns all exceptions
+     *
+     * @return TransferException[]
+     */
+    public function getExceptions()
+    {
+        return $this->exceptions;
+    }
+
+    /**
+     * Checks if a specific exception exists
+     *
+     * @param TransferException $exception
+     *
+     * @return boolean TRUE if there is the exception else FALSE.
+     */
+    public function hasException(TransferException $exception)
+    {
+        return array_search($exception, $this->exceptions, true) !== false;
+    }
+
+    /**
+     * Checks if any exception exists
+     *
+     * @return boolean
+     */
+    public function hasExceptions()
+    {
+        return !empty($this->exceptions);
+    }
+
+    /**
+     * Returns all responses
+     *
+     * @return ResponseInterface[]
+     */
+    public function getResponses()
+    {
+        return $this->responses;
+    }
+
+    /**
+     * Checks if a specific response exists
+     *
+     * @param ResponseInterface $response
+     *
+     * @return boolean
+     */
+    public function hasResponse(ResponseInterface $response)
+    {
+        return array_search($response, $this->responses, true) !== false;
+    }
+
+    /**
+     * Checks if any response exists
+     *
+     * @return boolean
+     */
+    public function hasResponses()
+    {
+        return !empty($this->responses);
+    }
+}

src/Exception/ClientException.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace Http\Client\Exception;
+
+/**
+ * Thrown when a client error (4xx) is encountered
+ *
+ * @author Márk Sági-Kazár <[email protected]>
+ */
+class ClientException extends HttpException
+{
+
+}

src/Exception/HttpClientException.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace Http\Client\Exception;
+
+use Psr\Http\Message\RequestInterface;
+use Psr\Http\Message\ResponseInterface;
+
+/**
+ * Thrown when both a request and a response are available
+ *
+ * @author Márk Sági-Kazár <[email protected]>
+ */
+class HttpException extends RequestException
+{
+    /**
+     * @var ResponseInterface
+     */
+    protected $response;
+
+    /**
+     * @param string            $message
+     * @param RequestInterface  $request
+     * @param ResponseInterface $response
+     * @param \Exception|null   $previous
+     */
+    public function __construct(
+        $message,
+        RequestInterface $request,
+        ResponseInterface $response,
+        \Exception $previous = null
+    ) {
+        $this->response = $response;
+
+        parent::__construct($message, $request, $previous);
+
+        $this->code = $response->getStatusCode();
+    }
+
+    /**
+     * Returns the response
+     *
+     * @return ResponseInterface
+     */
+    public function getResponse()
+    {
+        return $this->response;
+    }
+}