Skip to content

docs: Java/Kotlin SDK v2.9.3 release notes #350

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
mintlify wants to merge 1 commit into from
Closed

docs: Java/Kotlin SDK v2.9.3 release notes #350

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions docs/changelog/java-kotlin-sdk.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,26 @@ rss: true

{/* GENERATED by scripts/generate-changelog.js — do not edit by hand. */}

<Update label="2026-07-16" description="Java/Kotlin SDK v2.9.3">
### Spring AI 2.x compatibility fix

The `sdk-serde-jackson` module now uses **victools 5.x** for JSON schema generation, resolving a classpath conflict with Spring AI 2.x (which also depends on victools 5.x). Previously, mixing `sdk-spring-boot-starter` with `spring-ai-starter-*` caused a `NoSuchMethodError` at startup.

Upgrade to 2.9.3 to use Restate alongside Spring AI 2.x without additional configuration.

### Spring Boot: Netty version requirement

Due to several CVEs, the SDK now requires **Netty ≥ 4.1.132**. Spring Boot's dependency management may pin an older version and silently downgrade it, causing runtime issues.

To avoid this:
- **Upgrade to Spring Boot ≥ 3.5.13** (ships Netty ≥ 4.1.132), or
- **Pin Netty explicitly**:
- Maven: add `<netty.version>4.1.136.Final</netty.version>` in `pom.xml`
- Gradle (with the `io.spring.dependency-management` plugin): add `netty.version=4.1.136.Final` in `gradle.properties`

[View on GitHub](https://github.com/restatedev/sdk-java/releases/tag/v2.9.3)
</Update>

<Update label="2026-07-08" description="Java/Kotlin SDK v2.9.0">
### Restate Java/Kotlin SDK 2.9.0

Expand Down
10 changes: 5 additions & 5 deletions docs/develop/java/services.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,13 +24,13 @@ Choose the one you need depending on the language you want to use and whether yo
<CodeGroup>
```kt Java/Gradle
// For deploying as HTTP service
implementation("dev.restate:sdk-java-http:2.9.0")
implementation("dev.restate:sdk-java-http:2.9.3")
// Or for deploying using AWS Lambda
implementation("dev.restate:sdk-java-lambda:2.9.0")
implementation("dev.restate:sdk-java-lambda:2.9.3")
```
```xml Java/Maven
<properties>
<restate.version>2.9.0</restate.version>
<restate.version>2.9.3</restate.version>
</properties>
<dependencies>
<!-- For deploying as HTTP service -->
Expand All @@ -49,9 +49,9 @@ implementation("dev.restate:sdk-java-lambda:2.9.0")
```
```kt Kotlin/Gradle
// For deploying as HTTP service
implementation("dev.restate:sdk-kotlin-http:2.9.0")
implementation("dev.restate:sdk-kotlin-http:2.9.3")
// Or for deploying using AWS Lambda
implementation("dev.restate:sdk-kotlin-lambda:2.9.0")
implementation("dev.restate:sdk-kotlin-lambda:2.9.3")
```
</CodeGroup>

Expand Down
12 changes: 10 additions & 2 deletions docs/develop/java/spring-boot.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,10 +14,18 @@ The Java/Kotlin SDK provides an integration module with Spring Boot: your Restat

Use the Spring Boot starter instead of the plain HTTP SDK dependency. It pulls in the SDK and auto-configures the Restate endpoint and client.

<Warning>
**Netty version requirement (SDK ≥ 2.9.3)**

The SDK requires Netty ≥ 4.1.132. Spring Boot's dependency management may pin an older version and silently downgrade it, causing runtime issues. To fix this:
- Upgrade to **Spring Boot ≥ 3.5.13**, which ships Netty ≥ 4.1.132, or
- Pin Netty explicitly in Maven (`<netty.version>4.1.136.Final</netty.version>` in `pom.xml`) or Gradle with the `io.spring.dependency-management` plugin (`netty.version=4.1.136.Final` in `gradle.properties`).
</Warning>

<CodeGroup>
```xml Java/Maven
<properties>
<restate.version>2.9.0</restate.version>
<restate.version>2.9.3</restate.version>
</properties>
<dependencies>
<dependency>
Expand All @@ -28,7 +36,7 @@ Use the Spring Boot starter instead of the plain HTTP SDK dependency. It pulls i
</dependencies>
```
```kt Kotlin/Gradle
implementation("dev.restate:sdk-spring-boot-kotlin-starter:2.9.0")
implementation("dev.restate:sdk-spring-boot-kotlin-starter:2.9.3")
```
</CodeGroup>

Expand Down
8 changes: 4 additions & 4 deletions docs/develop/java/tracing.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,13 +66,13 @@ Add the dependency:

<CodeGroup>
```kotlin Gradle (Kotlin DSL)
implementation("dev.restate:sdk-interceptor-opentelemetry:2.9.0")
implementation("dev.restate:sdk-interceptor-opentelemetry:2.9.3")
```
```xml Maven
<dependency>
<groupId>dev.restate</groupId>
<artifactId>sdk-interceptor-opentelemetry</artifactId>
<version>2.9.0</version>
<version>2.9.3</version>
</dependency>
```
</CodeGroup>
Expand Down Expand Up @@ -141,13 +141,13 @@ Add the dependency:

<CodeGroup>
```kotlin Gradle (Kotlin DSL)
implementation("dev.restate:sdk-interceptor-micrometer:2.9.0")
implementation("dev.restate:sdk-interceptor-micrometer:2.9.3")
```
```xml Maven
<dependency>
<groupId>dev.restate</groupId>
<artifactId>sdk-interceptor-micrometer</artifactId>
<version>2.9.0</version>
<version>2.9.3</version>
</dependency>
```
</CodeGroup>
Expand Down
Loading