https://github.com/spring-projects/spring-data-elasticsearch

Provide support to increase developer productivity in Java when using Elasticsearch. Uses familiar Spring concepts such as a template classes for core API usage and lightweight repository style data access.
https://github.com/spring-projects/spring-data-elasticsearch

Last synced: about 1 month ago
JSON representation

Provide support to increase developer productivity in Java when using Elasticsearch. Uses familiar Spring concepts such as a template classes for core API usage and lightweight repository style data access.

• Host: GitHub
• URL: https://github.com/spring-projects/spring-data-elasticsearch
• Owner: spring-projects
• License: apache-2.0
• Created: 2013-04-29T14:27:38.000Z (almost 13 years ago)
• Default Branch: main
• Last Pushed: 2026-03-07T17:25:48.000Z (about 1 month ago)
• Last Synced: 2026-03-09T12:33:13.965Z (about 1 month ago)
• Language: Java
• Homepage: https://spring.io/projects/spring-data-elasticsearch/
• Size: 45.3 MB
• Stars: 2,962
• Watchers: 249
• Forks: 1,336
• Open Issues: 23
• Metadata Files:
  • Readme: .github/README.template.adoc
  • Contributing: CONTRIBUTING.adoc
  • License: LICENSE.txt
  • Security: SECURITY.adoc

Awesome Lists containing this project

README

          
= Spring Data for Elasticsearch image:https://img.shields.io/badge/Revved%20up%20by-Develocity-06A0CE?logo=Gradle&labelColor=02303A["Revved up by Develocity", link="https://ge.spring.io/scans?search.rootProjectNames=Spring Data Elasticsearch"]

The primary goal of the https://projects.spring.io/spring-data[Spring Data] project is to make it easier to build Spring-powered applications that use new data access technologies such as non-relational databases, map-reduce frameworks, and cloud based data services.

The Spring Data Elasticsearch project provides integration with the https://www.elastic.co/[Elasticsearch] search engine.

Key functional areas of Spring Data Elasticsearch are a POJO centric model for interacting with Elasticsearch Documents and easily writing a Repository style data access layer.

This project is lead and maintained by the community.

== Features

* Spring configuration support using Java based `@Configuration` classes or an XML namespace for an ES client instances.

* `ElasticsearchOperations` class and implementations that increases productivity performing common ES operations.

Includes integrated object mapping between documents and POJOs.

* Feature Rich Object Mapping integrated with Spring’s Conversion Service

* Annotation based mapping metadata

* Automatic implementation of `Repository` interfaces including support for custom search methods.

* CDI support for repositories

include::https://raw.githubusercontent.com/spring-projects/spring-data-build/refs/heads/main/etc/readme/code-of-conduct.adoc[]

== Getting Started

Here is a quick teaser of an application using Spring Data Repositories in Java:

[source,java]

----

public interface PersonRepository extends CrudRepository {

  List findByLastname(String lastname);

  List findByFirstnameLike(String firstname);

}

@Service

public class MyService {

  private final PersonRepository repository;

  public MyService(PersonRepository repository) {

    this.repository = repository;

  }

  public void doWork() {

    repository.deleteAll();

    Person person = new Person();

    person.setFirstname("Oliver");

    person.setLastname("Gierke");

    repository.save(person);

    List lastNameResults = repository.findByLastname("Gierke");

    List firstNameResults = repository.findByFirstnameLike("Oli");

 }

}

----

=== Using the RestClient

Please check the https://docs.spring.io/spring-data/elasticsearch/docs/current/reference/html/#elasticsearch.clients.configuration[official documentation].

include::https://raw.githubusercontent.com/spring-projects/spring-data-build/refs/heads/main/etc/readme/dependencies.adoc[]

**Compatibility Matrix**

The compatibility between Spring Data Elasticsearch, Elasticsearch client drivers and Spring Boot versions can be found in the https://docs.spring.io/spring-data/elasticsearch/docs/current/reference/html/#preface.versions[reference documentation].

To use the Release candidate versions of the upcoming major version, use our Maven milestone repository and declare the appropriate dependency version:

[source,xml]

----

  org.springframework.data

  spring-data-elasticsearch

  ${version}.RCx 

----

include::https://raw.githubusercontent.com/spring-projects/spring-data-build/refs/heads/main/etc/readme/getting-help.adoc[]

include::https://raw.githubusercontent.com/spring-projects/spring-data-build/refs/heads/main/etc/readme/license.adoc[]