Update Java version references from 21 to 25

Author: ujibang

docs/cloud/sophia/system-overview.adoc

@@ -16,7 +16,7 @@ The system consists of two main components:
 
 ==== Backend (sophia-restheart)
 - Built on RESTHeart framework
-- Java 21 with Maven build system
+- Java 25 with Maven build system
 - Integration with AWS Bedrock using Claude model by Anthropic
 - MongoDB database for data persistence
 - Vector store for embedding storage and semantic search
@@ -46,7 +46,7 @@ The system delivers seamless real-time communication through WebSocket-based mes
 === Technical Stack
 
 ==== Backend Technologies
-The backend infrastructure is built on RESTHeart framework running on Java 21, providing a robust and scalable foundation for enterprise applications. The system utilizes MongoDB as its primary database with full Atlas compatibility for cloud deployments. AI and machine learning capabilities are powered by LangChain4j 0.36.2, which integrates seamlessly with AWS Bedrock to access the Claude language model. The application is built and managed using Maven, while security is handled through comprehensive JWT authentication mechanisms.
+The backend infrastructure is built on RESTHeart framework running on Java 25, providing a robust and scalable foundation for enterprise applications. The system utilizes MongoDB as its primary database with full Atlas compatibility for cloud deployments. AI and machine learning capabilities are powered by LangChain4j 0.36.2, which integrates seamlessly with AWS Bedrock to access the Claude language model. The application is built and managed using Maven, while security is handled through comprehensive JWT authentication mechanisms.
 
 ==== Frontend Technologies
 The user interface is developed using Angular framework with TypeScript for type-safe development and enhanced maintainability. Styling is implemented through SCSS for advanced CSS preprocessing capabilities. The system incorporates ngx-markdown with PrismJS integration for sophisticated text rendering and code highlighting. FontAwesome provides comprehensive iconography throughout the interface, while the entire frontend build process is managed through Angular CLI for streamlined development and deployment workflows.

docs/deployment/graalvm.md

@@ -87,20 +87,20 @@ In some use cases, native image might result in slightly worse peak performance.
 
 We suggest to install GraalVM with [sdkman](https://sdkman.io)
 
-You need at least version 23.1.2 for Java 21:
+You need at least version 25.0.1:
 
 ```bash
-$ sdk install java 21.0.2-graalce
+$ sdk install java 25.0.1-graalce
 ```
 ## Run RESTHeart with GraalVM
 
 Check that GraalVM SDK is active:
 
 ```bash
 $ java -version
-openjdk version "21.0.2" 2024-01-16
-OpenJDK Runtime Environment GraalVM CE 21.0.2+13.1 (build 21.0.2+13-jvmci-23.1-b30)
-OpenJDK 64-Bit Server VM GraalVM CE 21.0.2+13.1 (build 21.0.2+13-jvmci-23.1-b30, mixed mode, sharing)
+openjdk version "25.0.1" 2025-10-21
+OpenJDK Runtime Environment GraalVM CE 25.0.1+8.1 (build 25.0.1+8-jvmci-b01)
+OpenJDK 64-Bit Server VM GraalVM CE 25.0.1+8.1 (build 25.0.1+8-jvmci-b01, mixed mode, sharing)
 ```
 
 Then just run RESTHeart as usual:
@@ -130,9 +130,9 @@ Check that GraalVM SDK is active:
 
 ```bash
 $ java -version
-openjdk version "21.0.2" 2024-01-16
-OpenJDK Runtime Environment GraalVM CE 21.0.2+13.1 (build 21.0.2+13-jvmci-23.1-b30)
-OpenJDK 64-Bit Server VM GraalVM CE 21.0.2+13.1 (build 21.0.2+13-jvmci-23.1-b30, mixed mode, sharing)
+openjdk version "25.0.1" 2025-10-21
+OpenJDK Runtime Environment GraalVM CE 25.0.1+8.1 (build 25.0.1+8-jvmci-b01)
+OpenJDK 64-Bit Server VM GraalVM CE 25.0.1+8.1 (build 25.0.1+8-jvmci-b01, mixed mode, sharing)
 ```
 
 You can then simply build it with:

docs/foundations/core-concepts.adoc

@@ -367,7 +367,7 @@ Check if the authenticated user has permission to perform the request (ACLs, rol
 
 == Virtual Threads
 
-RESTHeart uses Java 21's virtual threads for superior performance:
+RESTHeart uses Java 25's virtual threads for superior performance:
 
 **Benefits:**
 - **Lightweight** - Millions of virtual threads vs thousands of platform threads
@@ -380,7 +380,7 @@ RESTHeart uses Java 21's virtual threads for superior performance:
 [source,java]
 ----
 // This looks synchronous but doesn't block platform threads
-var data = mongoClient.find("db", "collection");  
+var data = mongoClient.find("db", "collection");
 response.setContent(data);
 ----
 
@@ -450,10 +450,10 @@ export function handle(request, response) {
 
 == Performance Characteristics
 
-**Startup Time:** ~100ms (with standard plugins)  
-**Memory Footprint:** ~50MB heap (configurable)  
-**Request Latency:** Sub-millisecond for simple operations  
-**Throughput:** Hundreds of thousands of requests per second  
+**Startup Time:** ~100ms (with standard plugins)
+**Memory Footprint:** ~50MB heap (configurable)
+**Request Latency:** Sub-millisecond for simple operations
+**Throughput:** Hundreds of thousands of requests per second
 **GraalVM Native:** ~40MB binary, instant startup (<10ms)
 
 **Learn more:** link:/docs/reference/performances[Performance Guide]

docs/foundations/introduction.adoc

@@ -17,7 +17,7 @@ RESTHeart is a framework for building cloud-native HTTP microservices. It's desi
 Out of the box, RESTHeart provides complete MongoDB APIs that work immediately:
 
 * **REST API** - Full CRUD operations, queries, aggregations, transactions
-* **GraphQL API** - Flexible queries with automatic MongoDB integration  
+* **GraphQL API** - Flexible queries with automatic MongoDB integration
 * **WebSocket API** - Real-time data with change streams
 * **Security** - Built-in authentication and authorization
 
@@ -86,7 +86,7 @@ plugins
 
 **What you'll use:**
 - Part 2: MongoDB REST API
-- Part 3: GraphQL & WebSocket APIs  
+- Part 3: GraphQL & WebSocket APIs
 - Part 4: Security
 - Part 5: Configuration & Deployment
 
@@ -118,7 +118,7 @@ RESTHeart prioritizes speed and simplicity. It's built with high-quality librari
 
 === Virtual Threads for Superior Performance
 
-RESTHeart fully embraces virtual threads, the groundbreaking feature introduced in Java 21. Virtual threads deliver remarkable performance and efficiency improvements:
+RESTHeart fully embraces virtual threads that deliver remarkable performance and efficiency improvements:
 
 - Faster execution
 - Lower memory footprint
@@ -131,7 +131,7 @@ This keeps RESTHeart at the forefront of high-performance, scalable frameworks.
 
 For many applications, you just need:
 - **Data access** - REST/GraphQL/WebSocket APIs for MongoDB
-- **Security** - Authentication and authorization  
+- **Security** - Authentication and authorization
 - **Configuration** - Connect to your database
 
 > Most applications require exactly this. Run a stock RESTHeart instance with zero code!

docs/foundations/quick-start.adoc

@@ -15,7 +15,7 @@ Get RESTHeart running in 5 minutes and make your first API call.
 You need one of the following:
 
 * **Docker** (recommended) - link:https://docs.docker.com/get-docker/[Get Docker]
-* **Java 21 or later** - link:https://adoptium.net/[Get Java]
+* **Java 25 or later, suggested GraalVM** - link:https://www.graalvm.org/downloads/[Get GraalVM]
 
 === Option 1: Docker Compose (Recommended)
 

docs/foundations/setup-with-docker.adoc

@@ -316,27 +316,23 @@ RESTHeart Docker images come in four different versions:
 - You need a specific version → Use version tags like `8.1.5`
 
 ==== Docker Tag Reference
-- Standard multi-arch (FROM eclipse-temurin)
-- Graalvm (FROM softinstigate/graalvm)
-- distroless (FROM gcr.io/distroless/java21-debian12)
+- Standard multi-arch (FROM softinstigate/graalvm)
 - native (FROM debian:12.6-slim)
 
 These are example tags:
 
 [cols="1,1,3"]
 |===
 |**Tag**|**Example**|**Description**
-|`<version>`|`latest`, `8`, `8.1`, `8.0.1`|**The standard image.**  This is usually the one you want to use. Keep in mind it doesn't support running JavaScript plugins. `docker pull softinstigate/restheart:latest`
-|`<version>-distroless`|`latest-distroless`, `8-distroless`, `8.1-distroless`, `8.0.1-distroless` | Similar to the standard image, this image contains only RESTHeart and its runtime dependencies. It does not contain a package manager, shells or any other programs you would expect to find in a standard Linux distribution. `docker pull softinstigate/restheart:latest-distroless`
-|`<version>-graalvm`|`latest-graalvm`, `8-graalvm`, `8.1-graalvm`, `8.0.1-graalvm` | RESTHeart running on the GraalVM that will let you JavaScript plugins. Check out the link:/docs/plugins/core-plugins-js[Plugins in JavaScript] for more info. This is the biggest image (about 600Mbytes). `docker pull softinstigate/restheart:latest-graalvm`
-|`<version>-native`|`latest-native`, `8-native`, `8.1-native`, `8.0.1-native` | RESTHeart built as a native binary. It is the smallest image with lightning-fast startup time. This is the perfect choice for deploying in a Kubernetes cluster. It can only execute JavaScript plugins. Check out link:/docs/plugins/deploy#deploy-java-plugins-on-restheart-native[Deploy Java plugins on RESTHeart Native] for more info. `docker pull softinstigate/restheart:latest-native`
+|`<version>`|`latest`, `9`, `9.0`, `9.0.0`|**The standard image.**  This is usually the one you want to use. `docker pull softinstigate/restheart:latest`
+|`<version>-native`|`latest-native`, `9-native`, `9.0-native`, `9.0.0-native` | RESTHeart built as a native binary. It is the smallest image with lightning-fast startup time. This is the perfect choice for deploying in a Kubernetes cluster. It can only execute JavaScript plugins. Check out link:/docs/plugins/deploy#deploy-java-plugins-on-restheart-native[Deploy Java plugins on RESTHeart Native] for more info. `docker pull softinstigate/restheart:latest-native`
 |===
 
+NOTE: The native image does not support Java plugins. However, you can build your own RESTHeart executable that embeds your plugins. Check the link:https://github.com/SoftInstigate/restheart-plugin-skeleton/[RESTHeart Plugin Skeleton] for more information.
+
 === Dockerfile
 
 - link:https://github.com/SoftInstigate/restheart/blob/master/core/Dockerfile[Dockerfile]
-- link:https://github.com/SoftInstigate/restheart/blob/master/core/Dockerfile.distroless[Dockerfile.distroless]
-- link:https://github.com/SoftInstigate/restheart/blob/master/core/Dockerfile.graalvm[Dockerfile.graalvm]
 - link:https://github.com/SoftInstigate/restheart/blob/master/core/Dockerfile.native[Dockerfile.native]
 
 The "distroless" images are for special deployment requirements, where having the smallest possible image size and the very minimal security attack surface is required and their tag contains a `distroless` label. You usually don't need these images unless you exactly know what you are doing.

docs/framework/deploy.adoc

@@ -241,9 +241,9 @@ Make sure you are using GraalVM.
 [source,bash]
 ----
 $ java -version
-openjdk version "21.0.2" 2024-01-16
-OpenJDK Runtime Environment GraalVM CE 21.0.2+13.1 (build 21.0.2+13-jvmci-23.1-b30)
-OpenJDK 64-Bit Server VM GraalVM CE 21.0.2+13.1 (build 21.0.2+13-jvmci-23.1-b30, mixed mode, sharing)
+openjdk version "25.0.1" 2025-10-21
+OpenJDK Runtime Environment GraalVM CE 25.0.1+8.1 (build 25.0.1+8-jvmci-b01)
+OpenJDK 64-Bit Server VM GraalVM CE 25.0.1+8.1 (build 25.0.1+8-jvmci-b01, mixed mode, sharing)
 ----
 
 Build it.

docs/framework/tutorial.adoc

@@ -16,10 +16,10 @@ IMPORTANT: **Explore Comprehensive RESTHeart Examples!** If you're looking to di
 
 To run this tutorial, the following are required:
 
-1) **Java 21**: Install it using link:https://sdkman.io[sdkman^]
+1) **Java 25**: Install it using link:https://sdkman.io[sdkman^]
 
 [source,bash]
-$ sdk install java 21.0.3-tem
+$ sdk install java 25.0.1-graalce
 
 2) **Docker**: Necessary for running RESTHeart.