More docs

Author: scottgerring

examples/powertools-examples-serialization/README.md

@@ -25,3 +25,53 @@ started with SAM in [the examples directory](../README.md)
 
 ## Test the application
 
+### 1. API Gateway Endpoint
+
+To test the HTTP endpoint, we can post a product to the test URL:
+
+```bash
+curl -X POST https://[REST-API-ID].execute-api.[REGION].amazonaws.com/Prod/product/ -H "Content-Type: application/json" -d '{"id": 1234, "name": "product", "price": 42}'
+```
+
+The result will indicate that the handler has successfully deserialized the request body:
+
+```
+Received request for productId: 1234
+```
+
+If we look at the logs using `sam logs --tail --stack-name $MY_STACK`, we will see the full deserialized request:
+
+```json
+{
+  ...
+  "level": "INFO",
+  "loggerName": "org.demo.serialization.APIGatewayRequestDeserializationFunction",
+  "message": "product=Product{id=1234, name='product', price=42.0}\n",
+   ...
+}
+```
+
+### 2. SQS Queue
+For the SQS handler, we have to send a request to our queue. We can either construct the Queue URL (see below), or
+find it from the SQS section of the AWS console.
+
+```bash
+ aws sqs send-message --queue-url "https://sqs.[REGION].amazonaws.com/[ACCOUNT-ID]/sqs-event-deserialization-queue" --message-body '{"id": 1234, "name": "product", "price"
+```
+
+Here we can find the message by filtering through the logs for messages that have come back from our SQS handler:
+
+```bash
+sam logs --tail --stack-name $MY_STACK --filter SQS 
+```
+
+```bash
+ {
+ ...
+  "level": "INFO",
+  "loggerName": "org.demo.serialization.SQSEventDeserializationFunction",
+  "message": "products=[Product{id=1234, name='product', price=42.0}]\n",
+  ...
+}
+
+```

examples/powertools-examples-serialization/template.yaml

@@ -32,7 +32,7 @@ Resources:
   SQSEventDeserializationFunction:
     Type: AWS::Serverless::Function
     Properties:
-      CodeUri: Function
+      CodeUri: .
       Handler: org.demo.serialization.SQSEventDeserializationFunction::handleRequest
       Policies:
         - Statement: