More docs

Author: scottgerring

examples/powertools-examples-parameters/README.md

@@ -4,8 +4,7 @@ This project contains an example of Lambda function using the parameters module
 
 The example uses the [SSM Parameter Store](https://docs.powertools.aws.dev/lambda/java/utilities/parameters/#ssm-parameter-store)
 and the [Secrets Manager](https://docs.powertools.aws.dev/lambda/java/utilities/parameters/#secrets-manager) to inject
-runtime parameters into the application.
-
+runtime parameters into the application. 
 Have a look at [ParametersFunction.java](src/main/java/org/demo/parameters/ParametersFunction.java) for the full details.
 
 ## Deploy the sample application
@@ -15,3 +14,25 @@ started with SAM in [the examples directory](../README.md)
 
 ## Test the application
 
+First, hit the URL of the application. You can do this with curl or your browser:
+
+```bash
+ curl https://[REST-API-ID].execute-api.[REGION].amazonaws.com/Prod/params/
+```
+You will get your IP address back. The contents of the logs will be more interesting, and show you the values
+of the parameters injected into the handler:
+
+```bash
+sam logs --stack-name $MY_STACK_NAME --tail
+```
+
+```json
+{
+  ...
+  "thread": "main",
+  "level": "INFO",
+  "loggerName": "org.demo.parameters.ParametersFunction",
+  "message": "secretjsonobj=MyObject{id=23443, code='hk38543oj24kn796kp67bkb234gkj679l68'}\n",
+  ...
+}
+```

examples/powertools-examples-parameters/template.yaml

@@ -19,9 +19,9 @@ Resources:
       Handler: org.demo.parameters.ParametersFunction::handleRequest
       MemorySize: 512
       Tracing: Active
-#      Environment:
-#        Variables:
-#          LOG_LEVEL: INFO
+      Environment:
+        Variables:
+          LOG_LEVEL: INFO
       Policies:
         - AWSSecretsManagerGetSecretValuePolicy:
             SecretArn: !Ref UserPwd

examples/powertools-examples-serialization/README.md

@@ -2,20 +2,26 @@
 
 This project contains an example of Lambda function using the serialization utilities module of Powertools for AWS Lambda (Java). For more information on this module, please refer to the [documentation](https://docs.powertools.aws.dev/lambda-java/utilities/serialization/).
 
-## Deploy the sample application
+The project contains two `RequestHandler`s - 
+
+* [APIGatewayRequestDeserializationFunction](src/main/java/org/demo/serialization/APIGatewayRequestDeserializationFunction.java) - Uses the serialization library to deserialize an API Gateway request body
+* [SQSEventDeserializationFunction](src/main/java/org/demo/serialization/SQSEventDeserializationFunction.java) - Uses the serialization library to deserialize an SQS message body
+
+In both cases, the output of the serialized message will be printed to the function logs. The message format
+in JSON looks like this:
 
-This sample is based on Serverless Application Model (SAM) and you can use the SAM Command Line Interface (SAM CLI) to build it and deploy it to AWS.
+```json
+{
+  "id":1234, 
+  "name":"product", 
+  "price":42
+}
+```
 
-To use the SAM CLI, you need the following tools.
+## Deploy the sample application
 
-* SAM CLI - [Install the SAM CLI](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-cli-install.html)
-* Java11 - [Install the Java 11](https://docs.aws.amazon.com/corretto/latest/corretto-11-ug/downloads-list.html)
-* Maven - [Install Maven](https://maven.apache.org/install.html)
-* Docker - [Install Docker community edition](https://hub.docker.com/search/?type=edition&offering=community)
+This sample is based on Serverless Application Model (SAM). To deploy it, check out the instructions for getting
+started with SAM in [the examples directory](../README.md)
 
-To build and deploy your application for the first time, run the following in your shell:
+## Test the application
 
-```bash
-sam build
-sam deploy --guided
-```