Added annotations for documentation

.github/workflows/maven-build-all.yml

@@ -0,0 +1,33 @@
+# This workflow will build all Java packages in this project with Maven (Java 8)
+
+name: Java CI with Maven
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ '*' ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up JDK 1.8
+      uses: actions/setup-java@v1
+      with:
+        java-version: 1.8
+
+    # Install base modules
+    - name: Build core with Maven
+      run: mvn -B install --file aws-lambda-java-core/pom.xml
+    - name: Build events with Maven
+      run: mvn -B install --file aws-lambda-java-events/pom.xml
+
+    # Package modules that depend on base modules
+    - name: Build events-sdk-transformer with Maven
+      run: mvn -B package --file aws-lambda-java-events-sdk-transformer/pom.xml
+    - name: Build log4j2 with Maven
+      run: mvn -B package --file aws-lambda-java-log4j2/pom.xml

.gitignore

@@ -10,3 +10,10 @@
 
 # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
 hs_err_pid*
+
+# Maven build
+target/
+
+# IDEA internal
+*.iml
+.idea

README.md

@@ -1,22 +1,24 @@
 # AWS Lambda Java Support Libraries
 Interface definitions for Java code running on the AWS Lambda platform.
 
-For issues and questions, you can start with our [FAQ](https://aws.amazon.com/lambda/faqs/) and the [AWS forums](https://forums.aws.amazon.com/forum.jspa?forumID=186)
+For issues and questions, you can start with our [FAQ](https://aws.amazon.com/lambda/faqs/)
+ and the [AWS forums](https://forums.aws.amazon.com/forum.jspa?forumID=186)
 
-To get started writing AWS Lambda functions in Java, check out the [official documentation] (http://docs.aws.amazon.com/lambda/latest/dg/java-gs.html).
+To get started writing AWS Lambda functions in Java, check out the [official documentation](http://docs.aws.amazon.com/lambda/latest/dg/java-gs.html).
 
 # Disclaimer of use
 
 Each of the supplied packages should be used without modification. Removing
 dependencies, adding conflicting dependencies, or selectively including classes
 from the packages can result in unexpected behavior.
 
-# Recent Updates!
+# Release Notes
 
-* ### [SQS Support](https://github.com/aws/aws-lambda-java-libs/commit/9a74fdc9d92b5d7f73ae05660090e65cbd098360)
-* ### [Kinesis Analytics Support](https://github.com/aws/aws-lambda-java-libs/commit/943352c7f0256afe82773e664e887e1593303508)
-* ### [2017 Java Events Update](https://github.com/aws/aws-lambda-java-libs/tree/master/aws-lambda-java-events)
-* ### [Log4j2 Support](https://github.com/aws/aws-lambda-java-libs/tree/master/aws-lambda-java-log4j2)
+Check out the per-module release notes:
+- [aws-lambda-java-core](aws-lambda-java-core/RELEASE.CHANGELOG.md)
+- [aws-lambda-java-events](aws-lambda-java-events/RELEASE.CHANGELOG.md)
+- [aws-lambda-java-events-sdk-transformer](aws-lambda-java-events-sdk-transformer/RELEASE.CHANGELOG.md)
+- [aws-lambda-java-log4j2](aws-lambda-java-log4j2/RELEASE.CHANGELOG.md)
 
 # Where to get packages
 ___
@@ -27,67 +29,69 @@ ___
 <dependency>
   <groupId>com.amazonaws</groupId>
   <artifactId>aws-lambda-java-core</artifactId>
-  <version>1.1.0</version>
+  <version>1.2.1</version>
 </dependency>
 <dependency>
   <groupId>com.amazonaws</groupId>
   <artifactId>aws-lambda-java-events</artifactId>
-  <version>2.2.2</version>
+  <version>3.4.0</version>
 </dependency>
 <dependency>
   <groupId>com.amazonaws</groupId>
-  <artifactId>aws-lambda-java-log4j</artifactId>
-  <version>1.0.0</version>
+  <artifactId>aws-lambda-java-events-sdk-transformer</artifactId>
+  <version>2.0.6</version>
 </dependency>
 <dependency>
   <groupId>com.amazonaws</groupId>
   <artifactId>aws-lambda-java-log4j2</artifactId>
-  <version>1.0.0</version>
+  <version>1.2.0</version>
 </dependency>
 ```
 
 [Gradle](https://gradle.org)
 
 ```groovy
-'com.amazonaws:aws-lambda-java-core:1.1.0'
-'com.amazonaws:aws-lambda-java-events:2.2.2'
-'com.amazonaws:aws-lambda-java-log4j:1.0.0'
-'com.amazonaws:aws-lambda-java-log4j2:1.0.0'
+'com.amazonaws:aws-lambda-java-core:1.2.1'
+'com.amazonaws:aws-lambda-java-events:3.4.0'
+'com.amazonaws:aws-lambda-java-events-sdk-transformer:2.0.6'
+'com.amazonaws:aws-lambda-java-log4j2:1.2.0'
 ```
 
 [Leiningen](http://leiningen.org) and [Boot](http://boot-clj.com)
 
 ```clojure
-[com.amazonaws/aws-lambda-java-core "1.1.0"]
-[com.amazonaws/aws-lambda-java-events "2.2.2"]
-[com.amazonaws/aws-lambda-java-log4j "1.0.0"]
-[com.amazonaws/aws-lambda-java-log4j2 "1.0.0"]
+[com.amazonaws/aws-lambda-java-core "1.2.1"]
+[com.amazonaws/aws-lambda-java-events "3.4.0"]
+[com.amazonaws/aws-lambda-java-events-sdk-transformer "2.0.6"]
+[com.amazonaws/aws-lambda-java-log4j2 "1.2.0"]
 ```
 
 [sbt](http://www.scala-sbt.org)
 
 ```scala
-"com.amazonaws" % "aws-lambda-java-core" % "1.1.0"
-"com.amazonaws" % "aws-lambda-java-events" % "2.2.2"
-"com.amazonaws" % "aws-lambda-java-log4j" % "1.0.0"
-"com.amazonaws" % "aws-lambda-java-log4j2" % "1.0.0"
+"com.amazonaws" % "aws-lambda-java-core" % "1.2.1"
+"com.amazonaws" % "aws-lambda-java-events" % "3.4.0"
+"com.amazonaws" % "aws-lambda-java-events-sdk-transformer" % "2.0.6"
+"com.amazonaws" % "aws-lambda-java-log4j2" % "1.2.0"
 ```
 
 # Using aws-lambda-java-core
 
-This package defines the Lambda [Context](http://docs.aws.amazon.com/lambda/latest/dg/java-context-object.html)
-object as well as [interfaces](http://docs.aws.amazon.com/lambda/latest/dg/java-handler-using-predefined-interfaces.html) that Lambda accepts.
+This package defines the Lambda [Context](http://docs.aws.amazon.com/lambda/latest/dg/java-context-object.html) object
+ as well as [interfaces](http://docs.aws.amazon.com/lambda/latest/dg/java-handler-using-predefined-interfaces.html) that Lambda accepts.
 
 # Using aws-lambda-java-events
 
-This package defines [event sources](http://docs.aws.amazon.com/lambda/latest/dg/intro-invocation-modes.html) that AWS Lambda natively accepts. See the [documentation](https://github.com/aws/aws-lambda-java-libs/tree/master/aws-lambda-java-events) for more information.
+This package defines [event sources](http://docs.aws.amazon.com/lambda/latest/dg/intro-invocation-modes.html) that AWS Lambda natively accepts. 
+See the [documentation](aws-lambda-java-events/README.md) for more information.
 
-# Using aws-lambda-java-log4j2
+# Using aws-lambda-java-events-sdk-transformer
 
-This package defines the Lambda adapter to use with log4j version 2. See
-[documentation](https://github.com/aws/aws-lambda-java-libs/tree/master/aws-lambda-java-log4j2) for how to use the adapter.
+This package provides helper classes/methods to use alongside `aws-lambda-java-events` in order to transform
+ Lambda input event model objects into SDK-compatible output model objects.  
+See the [documentation](aws-lambda-java-events-sdk-transformer/README.md) for more information.
 
-# Using aws-lambda-java-log4j (Not recommended)
+# Using aws-lambda-java-log4j2
 
-This package defines the Lambda adapter to use with log4j version 1. See
-the [official documentation](http://docs.aws.amazon.com/lambda/latest/dg/java-logging.html#java-wt-logging-using-log4j) for how to use this adapter.
+This package defines the Lambda adapter to use with log4j version 2. 
+See the [README](aws-lambda-java-log4j2/README.md) or the [official documentation](http://docs.aws.amazon.com/lambda/latest/dg/java-logging.html#java-wt-logging-using-log4j) for information on how to use the adapter.

aws-lambda-java-core/RELEASE.CHANGELOG.md

@@ -0,0 +1,18 @@
+### April 28, 2020
+`1.2.1`:
+- Added missing XML namespace declarations to `pom.xml` file ([#97](https://github.com/aws/aws-lambda-java-libs/issues/97))
+- Updated `nexusUrl` in `pom.xml` file ([#108](https://github.com/aws/aws-lambda-java-libs/issues/108))
+
+### November 21, 2017
+`1.2.0`:
+- Added method to log byte array to `LambdaLogger`
+
+### October 07, 2015
+`1.1.0`:
+- Added `LambdaRuntime` and `LambdaRuntimeInternal`
+- Added `getInstallationId()` to `Client`
+- Added `getFunctionVersion()` and `getInvokedFunctionArn()` to `Context`
+
+### June 15, 2015
+`1.0.0`:
+- Initial support for java in AWS Lambda

aws-lambda-java-core/pom.xml

@@ -1,9 +1,11 @@
-<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/maven-v4_0_0.xsd">
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/maven-v4_0_0.xsd">
   <modelVersion>4.0.0</modelVersion>
 
   <groupId>com.amazonaws</groupId>
   <artifactId>aws-lambda-java-core</artifactId>
-  <version>1.2.0</version>
+  <version>1.2.1</version>
   <packaging>jar</packaging>
 
   <name>AWS Lambda Java Core Library</name>
@@ -29,6 +31,11 @@
     </developer>
   </developers>
 
+  <properties>
+    <maven.compiler.source>1.8</maven.compiler.source>
+    <maven.compiler.target>1.8</maven.compiler.target>
+  </properties>
+
   <distributionManagement>
     <repository>
       <id>sonatype-nexus-staging</id>
@@ -114,7 +121,7 @@
             <extensions>true</extensions>
             <configuration>
               <serverId>sonatype-nexus-staging</serverId>
-              <nexusUrl>https://oss.sonatype.org/</nexusUrl>
+              <nexusUrl>https://aws.oss.sonatype.org/</nexusUrl>
               <autoReleaseAfterClose>false</autoReleaseAfterClose>
             </configuration>
           </plugin>

aws-lambda-java-core/src/main/java/com/amazonaws/services/lambda/runtime/Endpoint.java

@@ -0,0 +1,17 @@
+package com.amazonaws.services.lambda.runtime;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Indicates this the API Gateway endpoint for this Lambda Function.
+ */
+@Target(ElementType.TYPE)
+@Retention(RetentionPolicy.SOURCE)
+public @interface Endpoint {
+
+    String value();
+
+}

aws-lambda-java-core/src/main/java/com/amazonaws/services/lambda/runtime/FunctionName.java

@@ -0,0 +1,17 @@
+package com.amazonaws.services.lambda.runtime;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Indicates that the name of this Lambda Function in the AWS Console.
+ */
+@Target(ElementType.TYPE)
+@Retention(RetentionPolicy.SOURCE)
+public @interface FunctionName {
+
+    String value();
+
+}

aws-lambda-java-events-sdk-transformer/README.md

@@ -0,0 +1,115 @@
+# AWS Lambda Java Events SDK Transformer Library
+
+### About
+
+Provides helper classes/methods to use alongside `aws-lambda-java-events` in order to transform Lambda input event model
+ objects into SDK-compatible output model objects 
+ (eg. DynamodbEvent to a List of records writable back to DynamoDB through the AWS DynamoDB SDK v2).
+
+
+### Getting started
+
+Add the following Apache Maven dependencies to your `pom.xml` file:
+
+```xml
+<dependencies>
+    <dependency>
+        <groupId>com.amazonaws</groupId>
+        <artifactId>aws-lambda-java-events-sdk-transformer</artifactId>
+        <version>2.0.8</version>
+    </dependency>
+    <dependency>
+        <groupId>com.amazonaws</groupId>
+        <artifactId>aws-lambda-java-events</artifactId>
+        <version>3.6.0</version>
+    </dependency>
+</dependencies>
+```
+
+To use this library as a transformer to the AWS DynamoDB Java SDK v2, also add the following dependency to your `pom.xml` file:
+
+```xml
+<dependencies>
+    <dependency>
+        <groupId>software.amazon.awssdk</groupId>
+        <artifactId>dynamodb</artifactId>
+        <version>2.13.18</version>
+    </dependency>
+</dependencies>
+```
+
+
+### Example Usage
+
+To convert a full `DynamodbEvent` object to an SDK v2 compatible `List<Record>`:
+```java
+import com.amazonaws.services.lambda.runtime.events.transformers.DynamodbEventTransformer;
+
+public class DDBEventProcessor implements RequestHandler<DynamodbEvent, String> {
+
+    public String handleRequest(DynamodbEvent ddbEvent, Context context) {
+        // Process input event
+        List<Record> convertedRecords = DynamodbEventTransformer.toRecordsV2(ddbEvent);
+        // Modify records as needed and write back to DynamoDB using the DynamoDB AWS SDK for Java 2.0
+    }
+}
+```
+
+To convert a single `DynamodbEvent.DynamodbStreamRecord` object to an SDK v2 compatible `Record`:
+```java
+import com.amazonaws.services.lambda.runtime.events.transformers.dynamodb.DynamodbRecordTransformer;
+
+public class MyClass {
+
+    public void myMethod(DynamodbEvent.DynamodbStreamRecord record) {
+        // ...
+        Record convertedRecord = DynamodbRecordTransformer.toRecordV2(record);
+        // ...
+    }
+}
+```
+
+To convert a `StreamRecord` object originating from a `DynamodbEvent` to an SDK v2 compatible `StreamRecord`:
+```java
+import com.amazonaws.services.lambda.runtime.events.transformers.dynamodb.DynamodbStreamRecordTransformer;
+
+public class MyClass {
+
+    public void myMethod(StreamRecord streamRecord) {
+        // ...
+        software.amazon.awssdk.services.dynamodb.model.StreamRecord convertedStreamRecord = 
+                DynamodbStreamRecordTransformer.toStreamRecordV2(streamRecord);
+        // ...
+    }
+}
+```
+
+To convert an `AttributeValue` object originating from a `DynamodbEvent` to an SDK v2 compatible `AttributeValue`:
+```java
+import com.amazonaws.services.lambda.runtime.events.transformers.dynamodb.DynamodbAttributeValueTransformer;
+
+public class MyClass {
+
+    public void myMethod(AttributeValue attributeValue) {
+        // ...
+        software.amazon.awssdk.services.dynamodb.model.AttributeValue convertedAttributeValue = 
+                DynamodbAttributeValueTransformer.toAttributeValueV2(attributeValue);
+        // ...
+    }
+}
+```
+
+To convert an `Identity` object originating from a `DynamodbEvent` to an SDK v2 compatible `Identity`:
+```java
+import com.amazonaws.services.lambda.runtime.events.transformers.dynamodb.DynamodbIdentityTransformer;
+
+public class MyClass {
+
+    public void myMethod(Identity identity) {
+        // ...
+        software.amazon.awssdk.services.dynamodb.model.Identity convertedIdentity =
+                DynamodbIdentityTransformer.toIdentityV2(identity);
+        // ...
+    }
+}
+```