Skip to main content
Version: 2.0.4

Spring Cloud Oracle

Spring Cloud Oracle brings Oracle AI Database, Oracle AI Database-native messaging, Oracle Cloud Infrastructure (OCI), and OCI Generative AI into the Spring application model. It's a collection of Spring Boot starters, auto-configuration, templates, integrations, and samples for teams building data-intensive, AI-enabled, and cloud-connected services with Oracle technologies.

Overview​

Spring Cloud Oracle is organized as four complementary subprojects:

  • Oracle AI Database Spring Boot Starters
  • Spring Cloud Stream Binder for Oracle TxEventQ
  • Spring Cloud OCI
  • Spring AI Oracle

Together, they provide a consistent way to build Spring applications that connect to Oracle AI Database with production-ready connection management, build event-driven services on top of Oracle AI Database Transactional Event Queues (TxEventQ), extend those applications with managed OCI services such as Vault, Object Storage, Streaming, and Functions, and use OCI Generative AI through Spring AI model APIs.

Spring Cloud Oracle architecture showing database starters, TxEventQ, OCI integrations, and Spring AI Oracle

Why Spring Cloud Oracle?​

Spring teams using Oracle technologies often need more than raw client libraries. They need infrastructure that fits naturally into Spring Boot applications, works with existing configuration conventions, and supports both local development and production deployment.

Spring Cloud Oracle focuses on that integration layer:

  • Database-first Spring Boot starters for connectivity, messaging, JSON data, and spatial workloads
  • Event-driven architectures built on Oracle AI Database Transactional Event Queues through Spring Cloud Stream
  • OCI integrations exposed through Spring Boot abstractions such as property sources, resources, templates, and auto-configured clients
  • OCI Generative AI chat and embedding models exposed through standard Spring AI APIs
  • Sample applications that show the dependencies, configuration, and usage patterns in context

Oracle AI Database Spring Boot Starters​

The database starters are the foundation of the project. They make Oracle AI Database feel like a natural part of a Spring Boot application instead of a separate integration concern.

Key capabilities include:

  • Universal Connection Pool (UCP) for Oracle-backed DataSource configuration and connection pooling
  • Wallet support for secure database connectivity using Oracle Wallet
  • AQ/JMS support for Oracle Advanced Queuing and Transactional Event Queues with Spring JMS-style applications
  • OKafka support for applications that want to use Apache Kafka Java APIs backed by Oracle AI Database Transactional Event Queues
  • JSON Collections support for document-style development on Oracle AI Database
  • JSON Relational Duality Views tooling for modern JSON-relational application models
  • OpenTelemetry support for instrumenting the OJDBC driver in Spring Boot applications

These starters are intended for teams building CRUD services, data APIs, event-driven services, and modern database applications on Oracle AI Database without giving up the conventions of Spring Boot.

Spring Cloud Stream Binder for Oracle TxEventQ​

The TxEventQ binder brings Oracle AI Database Transactional Event Queues into the Spring Cloud Stream programming model. Instead of treating the database and the messaging system as separate infrastructure layers, this binder lets Spring applications produce and consume messages against Oracle AI Database-backed queues using standard Spring Cloud Stream patterns.

That makes it a strong fit for applications that want:

  • Spring Cloud Stream Supplier, Function, and Consumer bindings
  • Oracle AI Database-backed transactional messaging
  • A converged architecture where application data and message flows live in the same platform
  • High-throughput event processing using Oracle AI Database TxEventQ

For teams on Oracle AI Database, the binder offers a direct path to event-driven microservices without introducing a separate broker to participate in the Spring Cloud Stream ecosystem.

Spring Cloud OCI​

Spring Cloud OCI extends the project beyond the database and into Oracle Cloud Infrastructure. It provides a core starter for OCI authentication and shared configuration, plus service-specific starters that expose OCI capabilities through Spring-friendly APIs and auto-configuration.

Supported integrations include:

  • Object Storage
  • Autonomous Database lifecycle operations
  • Vault as an API client and Spring property source
  • Streaming
  • Queue
  • Notifications
  • Logging
  • Email Delivery
  • Functions
  • Oracle NoSQL Database
  • Generative AI

This lets Spring applications combine Oracle AI Database with surrounding managed services for configuration, messaging, storage, logging, AI features, and runtime integration on OCI.

Spring AI Oracle​

Spring AI Oracle is a released integration that brings OCI Generative AI into Spring AI applications through auto-configured model implementations. Applications can use OCI-backed ChatModel, ChatClient, and EmbeddingModel APIs while keeping the application code aligned with Spring AI conventions.

Start with the dedicated guides for:

How the Pieces Fit Together​

A typical adoption path starts with the database starters. Teams use UCP, Wallet support, JSON features, AQ/JMS, or OKafka to build Spring Boot services directly on Oracle AI Database. From there, they can add the TxEventQ binder for Spring Cloud Stream workloads and bring in Spring Cloud OCI starters when the application needs managed cloud services such as Vault, Object Storage, Functions, or Generative AI.

The result is a project that supports both database-centered application design and broader OCI-connected architectures, while keeping the programming model aligned with Spring Boot and Spring Cloud.

Getting Started​

Start with the repository and project overview:

Explore each subproject:

Samples and Resources​

The repository includes sample applications that show how the project is intended to be used in real Spring applications:

Contributing​

Spring Cloud Oracle is an open project, and contributions are welcome. See the repository contribution guide for details: