chore(ci): add java build workflow. (#34)

* Add java build workflow.

* Add doc string to callbackId() method.

* Apply spotless.

Author: phipag

.github/workflows/build.yml

@@ -0,0 +1,61 @@
+# Build and Test
+#
+# Description:
+#   Builds the project and runs unit tests for every supported Java version.
+#
+# Triggers:
+#   - pull_request: when a PR targets main
+#   - push: when code is pushed to main
+#
+# Notes:
+#   Builds against Java 17, 21, and 25.
+
+name: Build
+run-name: Build - ${{ github.event_name }}
+
+on:
+  workflow_dispatch:
+  pull_request:
+    branches:
+      - main
+    paths:
+      - 'sdk/**'
+      - 'sdk-testing/**'
+      - 'sdk-integration-tests/**'
+      - 'examples/**'
+      - 'pom.xml'
+  push:
+    branches:
+      - main
+    paths:
+      - 'sdk/**'
+      - 'sdk-testing/**'
+      - 'sdk-integration-tests/**'
+      - 'examples/**'
+      - 'pom.xml'
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        java:
+          - 17
+          - 21
+          - 25
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+
+      - name: Setup Java ${{ matrix.java }}
+        uses: actions/setup-java@v5
+        with:
+          distribution: corretto
+          java-version: ${{ matrix.java }}
+          cache: maven
+
+      - name: Build and test
+        run: mvn -B -q install --file pom.xml

sdk/src/main/java/com/amazonaws/lambda/durable/DurableCallbackFuture.java

@@ -16,6 +16,13 @@ public DurableCallbackFuture(String callbackId, DurableOperation<T> operation) {
         this.callbackId = callbackId;
     }
 
+    /**
+     * Returns the unique identifier for this callback.
+     *
+     * <p>External systems use this ID to send callback results back to the durable execution.
+     *
+     * @return the callback ID
+     */
     public String callbackId() {
         return callbackId;
     }

sdk/src/main/java/com/amazonaws/lambda/durable/DurableContext.java

@@ -227,8 +227,8 @@ public DurableLogger getLogger() {
      * Returns metadata about the current durable execution.
      *
      * <p>The execution context provides information that remains constant throughout the execution lifecycle, such as
-     * the durable execution ARN. This is useful for tracking execution progress, correlating logs, and referencing
-     * this execution in external systems.
+     * the durable execution ARN. This is useful for tracking execution progress, correlating logs, and referencing this
+     * execution in external systems.
      *
      * @return the execution context
      */

sdk/src/main/java/com/amazonaws/lambda/durable/ExecutionContext.java

@@ -27,8 +27,8 @@ public class ExecutionContext {
      *   <li>Reference this execution when calling Lambda APIs
      * </ul>
      *
-     * <p>Example ARN format: {@code
-     * arn:aws:lambda:us-east-1:123456789012:function:my-function:$LATEST/durable-execution/349beff4-a89d-4bc8-a56f-af7a8af67a5f/20dae574-53da-37a1-bfd5-b0e2e6ec715d}
+     * <p>Example ARN format:
+     * {@code arn:aws:lambda:us-east-1:123456789012:function:my-function:$LATEST/durable-execution/349beff4-a89d-4bc8-a56f-af7a8af67a5f/20dae574-53da-37a1-bfd5-b0e2e6ec715d}
      *
      * @return the durable execution ARN
      */