Publish docs for release 3.5.18

.github/workflows/pr-akka-samples.yml

@@ -113,7 +113,7 @@ jobs:
           if [ -n "$(git status --porcelain)" ]; then
             git add -f .idea/runConfigurations/Run_locally.xml
             git add .
-            git commit . -m "chore: bump SDK version to $sdk_version"
+            git commit . -m "bump: SDK $sdk_version"
             git push --set-upstream origin $BRANCH
             gh pr create -B main -t "Auto PR - Bump SDK version to $sdk_version" \
               -b "This PR should update SDK (pom.xml) and latest source code.  [$GITHUB_SHA]($COMMIT_URL$GITHUB_SHA)"
@@ -204,7 +204,7 @@ jobs:
 
           if [ -n "$(git status --porcelain)" ]; then
             git add .
-            git commit . -m "chore: bump SDK version to $sdk_version"
+            git commit . -m "bump: SDK $sdk_version"
             git push --set-upstream origin $BRANCH
             gh pr create -B main -t "Auto PR - Bump SDK version to $sdk_version" \
               -b "This PR should update SDK (pom.xml).  [$GITHUB_SHA]($COMMIT_URL$GITHUB_SHA)"

.github/workflows/update-sdk-version.yml

@@ -63,7 +63,7 @@ jobs:
           git checkout -b ${BRANCH}
           git config user.name "github-actions[bot]"
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          git commit . -m "chore: bump SDK versions to ${SDK_VERSION}"
+          git commit . -m "bump: SDK ${SDK_VERSION}"
           git push --set-upstream origin ${BRANCH}
 
           gh pr create -B main -t "Auto PR - Bump SDK versions to ${SDK_VERSION}" -b "This PR should update all existing samples (pom.xml and plugins.sbt) and the maven poms. Please review, and merge if okay." || echo "No changes"; exit 0

LICENSE

@@ -3,10 +3,10 @@ Business Source License 1.1
 Parameters
 
 Licensor:             Lightbend, Inc.
-Licensed Work:        Akka SDK for Java v 3.5.17
+Licensed Work:        Akka SDK for Java v 3.5.18
                       The Licensed Work is (c) 2026 Lightbend Inc.
 
-Change Date:          2029-04-08
+Change Date:          2029-04-16
 
 Change License:       Apache License, Version 2.0
 

Makefile

@@ -40,7 +40,7 @@ attributes: prepare
 		> "${managed_partials}/attributes.adoc"
 	docs/bin/version.sh | xargs -0  printf ":akka-javasdk-version: %s" \
 		> "${managed_partials}/attributes.adoc"
-	echo ":akka-cli-version: 3.0.56" >> "${managed_partials}/attributes.adoc"
+	echo ":akka-cli-version: 3.0.59" >> "${managed_partials}/attributes.adoc"
 	echo ":akka-cli-min-version: 3.0.4" >> "${managed_partials}/attributes.adoc"
 	# see https://adoptium.net/marketplace/
 	echo ":java-version: 21" \

RELEASING.md

@@ -1,9 +1,9 @@
 # Releasing Akka SDK
 
-Create a release issue (using the [GitHub CLI](https://cli.github.com/))
+Create a release issue:
 
 ```shell
-gh issue create --title 'Release Akka SDK' --label akka-javasdk --body-file docs/release-issue-template.md -w
+bin/create-release-issue.sh 3.1.0
 ````
 
 and follow the instructions.

akka-javasdk-annotation-processor-tests/component-validation-descriptors/src/test/resources/test-sources/invalid/ViewWithListOptionalField.java

@@ -0,0 +1,34 @@
+/*
+ * Copyright (C) 2021-2026 Lightbend Inc. <https://www.lightbend.com>
+ */
+
+package com.example;
+
+import akka.javasdk.annotations.Component;
+import akka.javasdk.annotations.Consume;
+import akka.javasdk.annotations.Query;
+import akka.javasdk.view.TableUpdater;
+import akka.javasdk.view.View;
+import java.util.List;
+import java.util.Optional;
+
+@Component(id = "view-list-optional-field")
+public class ViewWithListOptionalField extends View {
+
+  @Query("SELECT * FROM items")
+  public QueryEffect<ItemRow> getItems() {
+    return null;
+  }
+
+  public static class ItemRow {
+    public String id;
+    public List<Optional<String>> values;
+  }
+
+  @Consume.FromTopic("items-topic")
+  public static class Items extends TableUpdater<ItemRow> {
+    public Effect<ItemRow> onEvent(String event) {
+      return effects().updateRow(new ItemRow());
+    }
+  }
+}

akka-javasdk-annotation-processor-tests/component-validation-descriptors/src/test/resources/test-sources/invalid/ViewWithLocalDateField.java

@@ -0,0 +1,33 @@
+/*
+ * Copyright (C) 2021-2026 Lightbend Inc. <https://www.lightbend.com>
+ */
+
+package com.example;
+
+import akka.javasdk.annotations.Component;
+import akka.javasdk.annotations.Consume;
+import akka.javasdk.annotations.Query;
+import akka.javasdk.view.TableUpdater;
+import akka.javasdk.view.View;
+import java.time.LocalDate;
+
+@Component(id = "view-localdate-field")
+public class ViewWithLocalDateField extends View {
+
+  @Query("SELECT * FROM items")
+  public QueryEffect<ItemRow> getItems() {
+    return null;
+  }
+
+  public static class ItemRow {
+    public String id;
+    public LocalDate createdDate;
+  }
+
+  @Consume.FromTopic("items-topic")
+  public static class Items extends TableUpdater<ItemRow> {
+    public Effect<ItemRow> onEvent(String event) {
+      return effects().updateRow(new ItemRow());
+    }
+  }
+}

akka-javasdk-annotation-processor-tests/component-validation-descriptors/src/test/resources/test-sources/invalid/ViewWithLocalDateTimeField.java

@@ -0,0 +1,33 @@
+/*
+ * Copyright (C) 2021-2026 Lightbend Inc. <https://www.lightbend.com>
+ */
+
+package com.example;
+
+import akka.javasdk.annotations.Component;
+import akka.javasdk.annotations.Consume;
+import akka.javasdk.annotations.Query;
+import akka.javasdk.view.TableUpdater;
+import akka.javasdk.view.View;
+import java.time.LocalDateTime;
+
+@Component(id = "view-localdatetime-field")
+public class ViewWithLocalDateTimeField extends View {
+
+  @Query("SELECT * FROM items")
+  public QueryEffect<ItemRow> getItems() {
+    return null;
+  }
+
+  public static class ItemRow {
+    public String id;
+    public LocalDateTime createdAt;
+  }
+
+  @Consume.FromTopic("items-topic")
+  public static class Items extends TableUpdater<ItemRow> {
+    public Effect<ItemRow> onEvent(String event) {
+      return effects().updateRow(new ItemRow());
+    }
+  }
+}

akka-javasdk-annotation-processor-tests/component-validation-descriptors/src/test/resources/test-sources/invalid/ViewWithMapField.java

@@ -0,0 +1,33 @@
+/*
+ * Copyright (C) 2021-2026 Lightbend Inc. <https://www.lightbend.com>
+ */
+
+package com.example;
+
+import akka.javasdk.annotations.Component;
+import akka.javasdk.annotations.Consume;
+import akka.javasdk.annotations.Query;
+import akka.javasdk.view.TableUpdater;
+import akka.javasdk.view.View;
+import java.util.Map;
+
+@Component(id = "view-map-field")
+public class ViewWithMapField extends View {
+
+  @Query("SELECT * FROM items")
+  public QueryEffect<ItemRow> getItems() {
+    return null;
+  }
+
+  public static class ItemRow {
+    public String id;
+    public Map<String, String> metadata;
+  }
+
+  @Consume.FromTopic("items-topic")
+  public static class Items extends TableUpdater<ItemRow> {
+    public Effect<ItemRow> onEvent(String event) {
+      return effects().updateRow(new ItemRow());
+    }
+  }
+}

akka-javasdk-annotation-processor-tests/component-validation-descriptors/src/test/resources/test-sources/invalid/ViewWithNestedCollectionField.java

@@ -0,0 +1,33 @@
+/*
+ * Copyright (C) 2021-2026 Lightbend Inc. <https://www.lightbend.com>
+ */
+
+package com.example;
+
+import akka.javasdk.annotations.Component;
+import akka.javasdk.annotations.Consume;
+import akka.javasdk.annotations.Query;
+import akka.javasdk.view.TableUpdater;
+import akka.javasdk.view.View;
+import java.util.List;
+
+@Component(id = "view-nested-collection-field")
+public class ViewWithNestedCollectionField extends View {
+
+  @Query("SELECT * FROM items")
+  public QueryEffect<ItemRow> getItems() {
+    return null;
+  }
+
+  public static class ItemRow {
+    public String id;
+    public List<List<String>> nested;
+  }
+
+  @Consume.FromTopic("items-topic")
+  public static class Items extends TableUpdater<ItemRow> {
+    public Effect<ItemRow> onEvent(String event) {
+      return effects().updateRow(new ItemRow());
+    }
+  }
+}

akka-javasdk-annotation-processor-tests/component-validation-descriptors/src/test/resources/test-sources/invalid/ViewWithOptionalListField.java

@@ -0,0 +1,34 @@
+/*
+ * Copyright (C) 2021-2026 Lightbend Inc. <https://www.lightbend.com>
+ */
+
+package com.example;
+
+import akka.javasdk.annotations.Component;
+import akka.javasdk.annotations.Consume;
+import akka.javasdk.annotations.Query;
+import akka.javasdk.view.TableUpdater;
+import akka.javasdk.view.View;
+import java.util.List;
+import java.util.Optional;
+
+@Component(id = "view-optional-list-field")
+public class ViewWithOptionalListField extends View {
+
+  @Query("SELECT * FROM items")
+  public QueryEffect<ItemRow> getItems() {
+    return null;
+  }
+
+  public static class ItemRow {
+    public String id;
+    public Optional<List<String>> tags;
+  }
+
+  @Consume.FromTopic("items-topic")
+  public static class Items extends TableUpdater<ItemRow> {
+    public Effect<ItemRow> onEvent(String event) {
+      return effects().updateRow(new ItemRow());
+    }
+  }
+}

akka-javasdk-annotation-processor-tests/component-validation-descriptors/src/test/resources/test-sources/invalid/ViewWithOptionalOptionalField.java

@@ -0,0 +1,33 @@
+/*
+ * Copyright (C) 2021-2026 Lightbend Inc. <https://www.lightbend.com>
+ */
+
+package com.example;
+
+import akka.javasdk.annotations.Component;
+import akka.javasdk.annotations.Consume;
+import akka.javasdk.annotations.Query;
+import akka.javasdk.view.TableUpdater;
+import akka.javasdk.view.View;
+import java.util.Optional;
+
+@Component(id = "view-optional-optional-field")
+public class ViewWithOptionalOptionalField extends View {
+
+  @Query("SELECT * FROM items")
+  public QueryEffect<ItemRow> getItems() {
+    return null;
+  }
+
+  public static class ItemRow {
+    public String id;
+    public Optional<Optional<String>> name;
+  }
+
+  @Consume.FromTopic("items-topic")
+  public static class Items extends TableUpdater<ItemRow> {
+    public Effect<ItemRow> onEvent(String event) {
+      return effects().updateRow(new ItemRow());
+    }
+  }
+}

akka-javasdk-annotation-processor-tests/component-validation-descriptors/src/test/resources/test-sources/invalid/ViewWithOptionalSetField.java

@@ -0,0 +1,34 @@
+/*
+ * Copyright (C) 2021-2026 Lightbend Inc. <https://www.lightbend.com>
+ */
+
+package com.example;
+
+import akka.javasdk.annotations.Component;
+import akka.javasdk.annotations.Consume;
+import akka.javasdk.annotations.Query;
+import akka.javasdk.view.TableUpdater;
+import akka.javasdk.view.View;
+import java.util.Optional;
+import java.util.Set;
+
+@Component(id = "view-optional-set-field")
+public class ViewWithOptionalSetField extends View {
+
+  @Query("SELECT * FROM items")
+  public QueryEffect<ItemRow> getItems() {
+    return null;
+  }
+
+  public static class ItemRow {
+    public String id;
+    public Optional<Set<String>> tags;
+  }
+
+  @Consume.FromTopic("items-topic")
+  public static class Items extends TableUpdater<ItemRow> {
+    public Effect<ItemRow> onEvent(String event) {
+      return effects().updateRow(new ItemRow());
+    }
+  }
+}

akka-javasdk-annotation-processor-tests/component-validation-descriptors/src/test/scala/com/example/ViewValidationSpec.scala

@@ -205,6 +205,51 @@ abstract class AbstractViewValidationSpec(val validationMode: ValidationMode)
         "Methods annotated with @FunctionTool must be public. Method [privateMethod] cannot be annotated with @FunctionTool")
     }
 
+    // View row type field validations
+    "reject View with Optional<List<...>> field" in {
+      assertInvalid("invalid/ViewWithOptionalListField.java", "Optional<List<...>> which is not supported", "tags")
+    }
+
+    "reject View with List<Optional<...>> field" in {
+      assertInvalid("invalid/ViewWithListOptionalField.java", "List<Optional<...>> which is not supported", "values")
+    }
+
+    "reject View with nested collection field" in {
+      assertInvalid(
+        "invalid/ViewWithNestedCollectionField.java",
+        "nested collection type which is not supported",
+        "nested")
+    }
+
+    "reject View with Optional<Set<...>> field" in {
+      assertInvalid("invalid/ViewWithOptionalSetField.java", "Optional<Set<...>> which is not supported", "tags")
+    }
+
+    "reject View with Map field" in {
+      assertInvalid("invalid/ViewWithMapField.java", "Map which is not supported", "metadata")
+    }
+
+    "reject View with LocalDate field" in {
+      assertInvalid(
+        "invalid/ViewWithLocalDateField.java",
+        "LocalDate which is not supported",
+        "Supported date/time types are Instant and ZonedDateTime")
+    }
+
+    "reject View with LocalDateTime field" in {
+      assertInvalid(
+        "invalid/ViewWithLocalDateTimeField.java",
+        "LocalDateTime which is not supported",
+        "Supported date/time types are Instant and ZonedDateTime")
+    }
+
+    "reject View with Optional<Optional<...>> field" in {
+      assertInvalid(
+        "invalid/ViewWithOptionalOptionalField.java",
+        "Optional<Optional<...>> which is not supported",
+        "name")
+    }
+
     // SnapshotHandler validations
     "accept valid View TableUpdater with @SnapshotHandler for EventSourcedEntity subscription" in {
       assertValid("valid/ValidViewWithSnapshotHandler.java")