Spring Cloud Oracle, eases the integration with Oracle Database and OCI services with the help of OCI Java SDK internally. It offers a convenient way to interact with Oracle Database and OCI-provided services using well-known Spring idioms and APIs, such as the messaging or storage API. Developers can build their applications around the hosted services without having to care about infrastructure or maintenance. Spring Cloud Oracle contains autoconfiguration support for Oracle Database and OCI-managed services.
All Spring Cloud Oracle artifacts are made available through Maven Central. With Spring Cloud Oracle, developers only need to add some annotations and a small number of configuration parameters to connect Spring Cloud applications to Oracle Database and OCI services.
For a deep dive into the project, refer to the Spring Cloud Oracle documentation:
| Version | Reference Docs | API Docs |
|---|---|---|
| Spring Cloud Oracle 1.0.0 | Reference Docs | API Docs |
| Spring Cloud Oracle 1.0.1 | Reference Docs | API Docs |
| Spring Cloud Oracle 1.1.0 | Reference Docs | API Docs |
This project has dependency and transitive dependencies on Spring Projects. The table below outlines the versions of Spring Cloud, Spring Boot and Spring Framework versions that are compatible with certain Spring Cloud Oracle version.
| Spring Cloud Oracle | Spring Cloud | Spring Boot | OCI Java SDK |
|---|---|---|---|
| 1.0.0 | 2022.0.x | 3.1.x, 3.0.x | 3.24.0 |
| 1.0.1 | 2023.0.x | 3.2.x | 3.44.3 |
| 1.1.0 | 2023.0.x | 3.2.x | 3.44.x |
Samples for each service supported by Spring Cloud Oracle below:
If you would like to clone this repo in your OCI tenancy, click on 'Open in Code Editor' button below to clone and launch OCI Code Editor for this sample.
or
To check out the project manually and build it from source, do the following:
git clone https://github.com/oracle/spring-cloud-oci.git
cd spring-cloud-oci
mvn packageTo build and install jars into your local Maven cache:
mvn installFor faster builds, we recommend using Maven Daemon and using following commands:
Build:
make buildClean:
make cleanJava docs can be generated with below command
make javadocsJavaDocs generated at target/site/
This project welcomes contributions from the community. Before submitting a pull request, please review our contribution guide
Please consult the security guide for our responsible security vulnerability disclosure process
Copyright (c) 2023, 2024, Oracle and/or its affiliates.
Released under the Universal Permissive License v1.0 as shown at https://oss.oracle.com/licenses/upl/.