MultipartDownloader + ObjectDownloader

src/Exception/MultipartDownloadException.php

@@ -0,0 +1,64 @@
+<?php
+namespace Aws\Exception;
+
+use Aws\HasMonitoringEventsTrait;
+use Aws\MonitoringEventsInterface;
+use Aws\Multipart\DownloadState;
+
+class MultipartDownloadException extends \RuntimeException implements
+    MonitoringEventsInterface
+{
+    use HasMonitoringEventsTrait;
+
+    /** @var DownloadState State of the erroneous transfer */
+    private $state;
+
+    /**
+     * @param DownloadState      $state Upload state at time of the exception.
+     * @param \Exception|array $prev  Exception being thrown.
+     */
+    public function __construct(DownloadState $state, $prev = null) {
+        $msg = 'An exception occurred while performing a multipart download';
+
+        if (is_array($prev)) {
+            $msg = strtr($msg, ['performing' => 'downloading parts to']);
+            $msg .= ". The following parts had errors:\n";
+            /** @var $error AwsException */
+            foreach ($prev as $part => $error) {
+                $msg .= "- Part {$part}: " . $error->getMessage(). "\n";
+            }
+        } elseif ($prev instanceof AwsException) {
+            switch ($prev->getCommand()->getName()) {
+                case 'GetObject':
+                case 'GetObject':
+                    $action = 'initiating';
+                    break;
+                case 'GetObject':
+                    $action = 'completing';
+                    break;
+            }
+            if (isset($action)) {
+                $msg = strtr($msg, ['performing' => $action]);
+            }
+            $msg .= ": {$prev->getMessage()}";
+        }
+
+        if (!$prev instanceof \Exception) {
+            $prev = null;
+        }
+
+        parent::__construct($msg, 0, $prev);
+        $this->state = $state;
+    }
+
+    /**
+     * Get the state of the transfer
+     *
+     * @return DownloadState
+     */
+    public function getState()
+    {
+        return $this->state;
+    }
+}
+