Merge pull request aws-samples#1637 from msailes/scf-update

Author: boyney123

apigw-lambda-snapstart/README.md

@@ -8,6 +8,35 @@ to improve startup performance.
 
 Learn more about this pattern at Serverless Land Patterns: https://serverlessland.com/patterns/apigw-lambda-snapstart.
 
+## Spring Web support in Lambda
+
+This pattern uses the Spring Web ```@Controller``` to support different REST endpoints in the same Lambda function. 
+There are two supported ways to achieve this with the AWS Serverless Java Container.
+
+### Delegating the handler to Spring
+
+The first is to specify a Spring class as the function handler and reference the SpringBootApplication class as an 
+environment variable.
+
+```yaml
+    Type: AWS::Serverless::Function
+    Properties:
+      Handler: com.amazonaws.serverless.proxy.spring.SpringDelegatingLambdaContainerHandler
+      ...
+      Environment:
+         Variables:
+            MAIN_CLASS: com.unicorn.store.StoreApplication
+```
+
+This is useful as you don't need to make any changes to your existing application to run it in Lambda.
+
+### Starting Spring in your own handler
+
+An alternative is to create your own handler and start Spring within it. The class ```StreamLambdaHandler``` is an 
+example of this.
+
+This is useful when you want control over the handler method, for example to add an annotation.
+
 ## Requirements
 
 * [Create an AWS account](https://portal.aws.amazon.com/gp/aws/developer/registration/index.html) if you do not already have one and log in. The IAM user that you use must have sufficient permissions to make necessary AWS service calls and manage AWS resources.

apigw-lambda-snapstart/UnicornFunction/pom.xml

@@ -45,7 +45,7 @@
         <dependency>
             <groupId>com.amazonaws.serverless</groupId>
             <artifactId>aws-serverless-java-container-springboot3</artifactId>
-            <version>2.0.0-M1</version>
+            <version>2.0.0-M2</version>
         </dependency>
 
         <dependency>

apigw-lambda-snapstart/example-pattern.json

@@ -0,0 +1,63 @@
+{
+  "title": "Synchronous REST API with Lambda SnapStart",
+  "description": "This pattern demonstrates how to create a synchronous REST API using API Gateway, AWS Lambda and DynamoDB.",
+  "language": "Java",
+  "level": "400",
+  "framework": "SAM",
+  "introBox": {
+    "headline": "How it works",
+    "text": [
+      "This pattern is built using [Spring Boot 3](https://spring.io/projects/spring-boot) and leverages the [AWS Serverless Java Container](https://github.com/awslabs/aws-serverless-java-container) for seamless integration with AWS Lambda.",
+      "This pattern also demonstrates the usage of [SnapStart](https://aws.amazon.com/blogs/compute/reducing-java-cold-starts-on-aws-lambda-functions-with-snapstart/) to improve startup performance."
+    ]
+  },
+  "gitHub": {
+    "template": {
+      "repoURL": "https://github.com/aws-samples/serverless-patterns/tree/main/apigw-lambda-snapstart",
+      "templateURL": "serverless-patterns/apigw-lambda-snapstart",
+      "projectFolder": "apigw-lambda-snapstart",
+      "templateFile": "template.yaml"
+    }
+  },
+  "resources": {
+    "bullets": [
+      {
+        "text": "Lambda Replatforming Guide",
+        "link": "https://serverlessland.com/content/service/lambda/paved-path/java-replatforming/introduction"
+      },
+      {
+        "text": "AWS Serverless Java Container",
+        "link": "https://github.com/awslabs/aws-serverless-java-container/"
+      },
+      {
+        "text": "Lambda SnapStart",
+        "link": "https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html"
+      }
+    ]
+  },
+  "deploy": {
+    "text": [
+      "sam build",
+      "sam deploy --stack-name unicorn-store --guided"
+    ]
+  },
+  "testing": {
+    "text": [
+      "See the GitHub repo for detailed testing instructions."
+    ]
+  },
+  "cleanup": {
+    "text": [
+      "Delete the stack: <code>sam delete</code>."
+    ]
+  },
+  "authors": [
+    {
+      "name": "Mark Sailes",
+      "image": "https://serverlessland.com/assets/images/resources/contributors/mark-sailes.jpg",
+      "bio": "Mark is a specialist solutions architect working at AWS. His primary focus is improving the developer experience of builders using Java on AWS Lambda.",
+      "linkedin": "mark-sailes",
+      "twitter": "MarkSailes3"
+    }
+  ]
+}

apigw-lambda-snapstart/template.yaml

@@ -18,11 +18,12 @@ Resources:
   UnicornStoreSpringFunction:
     Type: AWS::Serverless::Function
     Properties:
-      Handler: com.unicorn.store.StreamLambdaHandler
+      Handler: com.amazonaws.serverless.proxy.spring.SpringDelegatingLambdaContainerHandler
       CodeUri: UnicornFunction
       Tracing: Active
       Environment:
         Variables:
+          MAIN_CLASS: com.unicorn.store.StoreApplication
           AWS_SERVERLESS_JAVA_CONTAINER_INIT_GRACE_TIME: 500
           UNICORN_TABLE_NAME: !Ref UnicornTable
           POWERTOOLS_LOG_LEVEL: INFO