Hear from the Spring team this January at SpringOne. >

Spring Data Couchbase


Spring Data for Couchbase is part of the umbrella Spring Data project which aims to provide a familiar and consistent Spring-based programming model for new datastores while retaining store-specific features and capabilities.

The Spring Data Couchbase project provides integration with the Couchbase Server database. Key functional areas of Spring Data Couchbase are a POJO centric model for interacting with Couchbase Buckets and easily writing a Repository style data access layer.


  • Spring configuration support using Java based @Configuration classes or an XML namespace for the Couchbase driver (Java SDK version 2.x).

  • CouchbaseTemplate helper class that increases productivity performing common Couchbase operations. Includes integrated object mapping between documents and POJOs.

  • Exception translation into Spring’s portable Data Access Exception hierarchy.

  • Feature Rich Object Mapping integrated with Spring’s Conversion Service.

  • Annotation based mapping metadata but extensible to support other metadata formats.

  • Automatic implementation of Repository interfaces including support for custom finder methods (backed by Couchbase’s query language, N1QL) and PagingAndSortingRepository.

  • For Couchbase server versions < 4.0, repositories can still be backed by Couchbase Views.

  • Support for geospatial and multidimensional querying (backed by Couchbase Spatial Views)

  • JMX administration and monitoring

  • Can serve as the backend for @Cacheable support, to cache any objects you need for high performance access (see sibling Spring Cache project in Couchbase’s github, couchbaselabs/couchbase-spring-cache).

Spring Initializr

Quickstart Your Project

Bootstrap your application with Spring Initializr.


Each Spring project has its own; it explains in great details how you can use project features and what you can achieve with them.
5.0.0 CURRENT GA Reference Doc. API Doc.
4.4.6 GA Reference Doc. API Doc.
4.3.10 GA Reference Doc. API Doc.