Spring Cloud Oracle brings Oracle AI Database, Oracle AI Database-native messaging, and Oracle Cloud Infrastructure (OCI) into the Spring application model. It provides Spring Boot starters, auto-configuration, templates, integrations, and sample applications for teams building data-intensive and cloud-connected services with Oracle technologies.

Spring AI Oracle is in development and is not released yet.

Spring teams using Oracle technologies often need more than raw client libraries. They need integrations that fit Spring Boot configuration, auto-configuration, resource handling, observability, and messaging conventions.

Spring Cloud Oracle focuses on that integration layer:

• Oracle AI Database starters for connection pooling, Wallet support, AQ/JMS, OKafka, JSON Collections, JSON Relational Duality Views, spatial data, and OpenTelemetry
• A Spring Cloud Stream binder for Oracle AI Database Transactional Event Queues (TxEventQ)
• OCI integrations exposed through Spring-friendly APIs such as property sources, resources, templates, and auto-configured clients
• Sample applications that show dependencies, configuration, and usage patterns in context

• The 1.x release line tracks Spring Boot 3.
• The 2.x release line tracks Spring Boot 4 and Spring Framework 7.

Start with the current Docusaurus documentation:

• Spring Cloud Oracle reference documentation
• Changelog

Current API documentation:

The repository includes sample applications for each major project area:

• Spring Cloud OCI samples
• Oracle AI Database starter samples
• TxEventQ binder sample

Planned and in-progress work includes:

• OpenRewrite recipes to help migrate from HikariCP to Oracle Universal Connection Pool
• Further simplification for running Spring Boot applications as OCI Functions, including native images with GraalVM Native Image
• More idiomatic OCI service modules and broader use of Spring template patterns
• Additional Spring CLI project templates and sample applications, especially around Spring AI, retrieval augmented generation, and agentic workflows
• Deeper Oracle AI Database integration for Spring applications, including Spring Kafka support for Transactional Event Queues

Please open an issue in this repository to share feedback, report bugs, or suggest additional integrations.

If you are building Spring Boot applications with Oracle AI Database, Oracle Backend Microservices and AI provides patterns for building, testing, and operating microservices platforms on any cloud or in your own infrastructure.

CloudBank AI is a free self-paced hands-on lab that covers Spring Boot microservices, REST APIs, asynchronous services with JMS, Oracle AI Database-backed persistence, service discovery, Spring Actuator, Prometheus, Grafana, Loki, OpenTelemetry, Jaeger, long-running actions, APISIX API Gateway, and an AI chatbot built with Ollama.

The Oracle AI Microservices Sandbox is a developer-preview environment for exploring generative AI and retrieval augmented generation with Oracle AI Database vector search. It can run on a developer desktop, on-premises, in a container, or in Kubernetes.

This project welcomes contributions from the community. Before submitting a pull request, please review the contribution guide.

Please consult the security guide for the responsible security vulnerability disclosure process.

Copyright (c) 2023, 2026, Oracle and/or its affiliates.

Released under the Universal Permissive License v1.0 as shown at https://oss.oracle.com/licenses/upl/.