Generate Exceptions (#921)

* Generate Exceptions

* Add documentation on top of class

* Leverage the new AwsErrorFactory

* Fix __constructor signature in  GeneratedException

* Fix private vs protected

* Generate all methods

* Fix things

* Add constraint in composer.Json

* Add changelog entry

Author: jderusse

CHANGELOG.md

@@ -6,6 +6,7 @@
 
 - Changed case of object's properties to camelCase.
 - Added documentation in class's headers.
+- Added Business Exceptions.
 
 ## 1.0.1
 

composer.json

@@ -14,7 +14,7 @@
         "php": "^7.2.5 || ^8.0",
         "ext-filter": "*",
         "ext-json": "*",
-        "async-aws/core": "^1.2"
+        "async-aws/core": "^1.9"
     },
     "conflict": {
         "symfony/http-client": "<4.4.16,<5.1.7"

src/DynamoDbClient.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace AsyncAws\DynamoDb\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+/**
+ * A condition specified in the operation could not be evaluated.
+ */
+final class ConditionalCheckFailedException extends ClientException
+{
+    protected function populateResult(ResponseInterface $response): void
+    {
+        $data = $response->toArray(false);
+
+        if (null !== $v = (isset($data['message']) ? (string) $data['message'] : null)) {
+            $this->message = $v;
+        }
+    }
+}

src/Exception/ConditionalCheckFailedException.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace AsyncAws\DynamoDb\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+/**
+ * An error occurred on the server side.
+ */
+final class InternalServerErrorException extends ClientException
+{
+    protected function populateResult(ResponseInterface $response): void
+    {
+        $data = $response->toArray(false);
+
+        if (null !== $v = (isset($data['message']) ? (string) $data['message'] : null)) {
+            $this->message = $v;
+        }
+    }
+}

src/Exception/InternalServerErrorException.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace AsyncAws\DynamoDb\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+/**
+ * An item collection is too large. This exception is only returned for tables that have one or more local secondary
+ * indexes.
+ */
+final class ItemCollectionSizeLimitExceededException extends ClientException
+{
+    protected function populateResult(ResponseInterface $response): void
+    {
+        $data = $response->toArray(false);
+
+        if (null !== $v = (isset($data['message']) ? (string) $data['message'] : null)) {
+            $this->message = $v;
+        }
+    }
+}

src/Exception/ItemCollectionSizeLimitExceededException.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace AsyncAws\DynamoDb\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+/**
+ * There is no limit to the number of daily on-demand backups that can be taken.
+ * Up to 50 simultaneous table operations are allowed per account. These operations include `CreateTable`,
+ * `UpdateTable`, `DeleteTable`,`UpdateTimeToLive`, `RestoreTableFromBackup`, and `RestoreTableToPointInTime`.
+ * The only exception is when you are creating a table with one or more secondary indexes. You can have up to 25 such
+ * requests running at a time; however, if the table or index specifications are complex, DynamoDB might temporarily
+ * reduce the number of concurrent operations.
+ * There is a soft account quota of 256 tables.
+ */
+final class LimitExceededException extends ClientException
+{
+    protected function populateResult(ResponseInterface $response): void
+    {
+        $data = $response->toArray(false);
+
+        if (null !== $v = (isset($data['message']) ? (string) $data['message'] : null)) {
+            $this->message = $v;
+        }
+    }
+}

src/Exception/LimitExceededException.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace AsyncAws\DynamoDb\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+/**
+ * Your request rate is too high. The AWS SDKs for DynamoDB automatically retry requests that receive this exception.
+ * Your request is eventually successful, unless your retry queue is too large to finish. Reduce the frequency of
+ * requests and use exponential backoff. For more information, go to Error Retries and Exponential Backoff in the
+ * *Amazon DynamoDB Developer Guide*.
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.Errors.html#Programming.Errors.RetryAndBackoff
+ */
+final class ProvisionedThroughputExceededException extends ClientException
+{
+    protected function populateResult(ResponseInterface $response): void
+    {
+        $data = $response->toArray(false);
+
+        if (null !== $v = (isset($data['message']) ? (string) $data['message'] : null)) {
+            $this->message = $v;
+        }
+    }
+}

src/Exception/ProvisionedThroughputExceededException.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace AsyncAws\DynamoDb\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+/**
+ * Throughput exceeds the current throughput quota for your account. Please contact AWS Support at AWS Support to
+ * request a quota increase.
+ *
+ * @see https://aws.amazon.com/support
+ */
+final class RequestLimitExceededException extends ClientException
+{
+    protected function populateResult(ResponseInterface $response): void
+    {
+        $data = $response->toArray(false);
+
+        if (null !== $v = (isset($data['message']) ? (string) $data['message'] : null)) {
+            $this->message = $v;
+        }
+    }
+}

src/Exception/RequestLimitExceededException.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace AsyncAws\DynamoDb\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+/**
+ * The operation conflicts with the resource's availability. For example, you attempted to recreate an existing table,
+ * or tried to delete a table currently in the `CREATING` state.
+ */
+final class ResourceInUseException extends ClientException
+{
+    protected function populateResult(ResponseInterface $response): void
+    {
+        $data = $response->toArray(false);
+
+        if (null !== $v = (isset($data['message']) ? (string) $data['message'] : null)) {
+            $this->message = $v;
+        }
+    }
+}

src/Exception/ResourceInUseException.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace AsyncAws\DynamoDb\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+/**
+ * The operation tried to access a nonexistent table or index. The resource might not be specified correctly, or its
+ * status might not be `ACTIVE`.
+ */
+final class ResourceNotFoundException extends ClientException
+{
+    protected function populateResult(ResponseInterface $response): void
+    {
+        $data = $response->toArray(false);
+
+        if (null !== $v = (isset($data['message']) ? (string) $data['message'] : null)) {
+            $this->message = $v;
+        }
+    }
+}

src/Exception/ResourceNotFoundException.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace AsyncAws\DynamoDb\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+/**
+ * Operation was rejected because there is an ongoing transaction for the item.
+ */
+final class TransactionConflictException extends ClientException
+{
+    protected function populateResult(ResponseInterface $response): void
+    {
+        $data = $response->toArray(false);
+
+        if (null !== $v = (isset($data['message']) ? (string) $data['message'] : null)) {
+            $this->message = $v;
+        }
+    }
+}