From 4ef5db5ba71ea245d2758674d6dfc70ad1e89536 Mon Sep 17 00:00:00 2001 From: ZhangJian He Date: Mon, 26 Aug 2024 13:51:57 +0800 Subject: [PATCH] docs: add spring integration configuration doc Signed-off-by: ZhangJian He --- integrations/spring/README.md | 66 ++++++++++++++++++++++++++++++++++- 1 file changed, 65 insertions(+), 1 deletion(-) diff --git a/integrations/spring/README.md b/integrations/spring/README.md index 81ba9d0f935..fa7899b2189 100644 --- a/integrations/spring/README.md +++ b/integrations/spring/README.md @@ -8,4 +8,68 @@ This project includes three primary modules: - opendal-spring: Core integration module for [Spring](https://spring.io/) applications. - opendal-spring-boot-starter: Synchronous starter for [Spring WebMVC](https://docs.spring.io/spring-framework/reference/web/webmvc.html). -- opendal-spring-boot-starter-reactor: Asynchronous starter for [Spring WebFlux](https://docs.spring.io/spring-framework/reference/web/webflux.html). +- opendal-spring-boot-starter-reactive: Asynchronous starter for [Spring WebFlux](https://docs.spring.io/spring-framework/reference/web/webflux.html). + +## Features + +- SpringBoot autoconfiguration support for an OpenDALTemplate/ReactiveOpenDALTemplate instance. + +## Prerequisites + +This project requires JDK 17 or later and supports Spring 6 and Spring Boot 3. + +## Getting Started With Spring Boot Starter + +Below is a brief example demonstrating how to use the OpenGemini Spring Boot Starter in a Java application. + +### Maven Configuration + +Add the following dependency to your project's `pom.xml`: + +```xml + + org.apache.opendal + opendal-spring-boot-starter + ${version} + +``` + +### SpringBoot Application Configuration + +Following properties can be used in your `application.yaml`: + +```yaml +spring: + opendal: + schema: "fs" + conf: + root: "/tmp" +``` + +## Getting Started With Spring Boot Reactive Starter + +Below is a brief example demonstrating how to use the OpenGemini Spring Boot Starter in a Java application. + +### Maven Configuration + +Add the following dependency to your project's `pom.xml`: + +```xml + + org.apache.opendal + opendal-spring-boot-starter-reactive + ${version} + +``` + +### SpringBoot Reactive Application Configuration + +Following properties can be used in your `application.yaml`: + +```yaml +spring: + opendal: + schema: "fs" + conf: + root: "/tmp" +```