spring-projects/spring-data-examples

= Spring Data Examples 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 - Examples"]

image:https://travis-ci.org/spring-projects/spring-data-examples.svg?branch=main[Build Status,link=https://travis-ci.org/spring-projects/spring-data-examples]

This repository contains example projects for the different Spring Data modules to showcase the API and how to use the features provided by the modules.

We have separate folders for the samples of individual modules:

== Spring Data for Apache Cassandra

• aot-optimization - Use Ahead-Of-Time Repositories with Spring Data for Apache Cassandra.
• example - Shows core Spring Data support for Apache Cassandra.
• kotlin - Example for using Cassandra with Kotlin.
• reactive - Example project to show reactive template and repository support.
• vector-search - Example how to do vector search with a Spring Data Cassandra repository.

== Spring Data Elasticsearch

• example - Example how to use basic text search, geo-spatial search and facets. It uses the High Level REST Client backing template and repository.
• reactive - Example how to use reactive client, template and repository features.

Local Elasticsearch instance must be running to run the tests.

== Spring Data JDBC

• aot-optimization - Use Ahead-Of-Time Repositories with Spring Data JDBC.
• basic - Basic usage of Spring Data JDBC.
• graalvm-native - This example compiles a basic Spring Data JDBC application into a GraalVM native image.
• howto - A collection of projects to go with the https://spring.io/blog/2021/09/09/spring-data-jdbc-how-to-use-custom-id-generation[Spring Data JDBC - How to blog posts].
• immutables - Showing Spring Data JDBC usage with https://immutables.github.io/[Immutables]
• jmolecules - Demonstrates the interaction of jMolecules with Spring Data JDBC.
• jooq - Demonstrates how to use jOOQ and Spring Data JDBC together.
• mybatis - Demonstrate how to use MyBatis to generate SQL for Spring Data JDBC.
• singlequeryloading - Demonstrates how to enable Single Query Loading.

== Spring Data JPA

• aot-optimization - Use Ahead-Of-Time Repositories with Spring Data JPA.
• eclipselink - Sample project to show how to use Spring Data JPA with Spring Boot and https://www.eclipse.org/eclipselink/[Eclipselink].
• example - Probably the project you want to have a look at first. Contains a variety of sample packages, showcasing the different levels at which you can use Spring Data JPA. Have a look at the simple package for the most basic setup. Contains also examples running on Virtual Threads.
• interceptors - Example of how to enrich the repositories with AOP.
• jpa21 - Shows support for JPA 2.1 specific features (stored procedures support).
• multiple-datasources - Examples of how to use Spring Data JPA with multiple DataSources.
• query-by-example - Example project showing usage of Query by Example with Spring Data JPA.
• security - Example of how to integrate Spring Data JPA Repositories with Spring Security.
• showcase - Refactoring show case of how to improve a plain-JPA-based persistence layer by using Spring Data JPA (read: removing close to all of the implementation code).Follow the demo.txt file for detailed instructions.
• vavr - Shows the support of https://www.vavr.io[Vavr] collection types as return types for query methods.
• vector-search - Example how to do vector search with a Spring Data JPA repository and hibernate-vector.

== Spring Data LDAP

• example - Sample for Spring Data repositories to access an LDAP store.

== Spring Data MongoDB

• aot-optimization - Use Ahead-Of-Time Repositories with Spring Data MongoDB.
• aggregation - Example project to showcase the MongoDB aggregation framework support.
• example - Example project for general repository functionality (including geo-spatial functionality), Querydsl integration, bulk write and other advanced topics.
• fluent-api - Example project to show the new fluent API (MongoTemplate-alternative) to interact with MongoDB.
• geo-json - Example project showing usage of http://geojson.org[GeoJSON] with MongoDB.
• gridfs - Example project showing usage of gridFS with MongoDB.
• jmolecules - Example of Spring Data MongoDB working with a jMolecules based domain model.
• kotlin - Example for using https://kotlinlang.org/[Kotlin] with MongoDB.
• linking - Example demonstrating possibilities for linking documents.
• query-by-example - Example project showing usage of Query by Example with MongoDB.
• querydsl - Example project showing imperative and reactive https://github.com/querydsl/querydsl[Querydsl] support for MongoDB.
• reactive - Example project to show reactive template and repository support.
• repository-metrics - Example project to show how to collect repository method invocation metrics.
• security - Example project showing usage of Spring Security with MongoDB.
• text-search - Example project showing usage of MongoDB text search feature.
• transactions - Example project for imperative and reactive MongoDB 4.0 transaction support.
• vector-search - Example how to do vector search with a Spring Data MongoDB repository.

== Spring Data Neo4j

• example - Example to show basic node and relationship entities and repository usage.

== Spring Data R2DBC

• example - Basic usage of Spring Data R2DBC.

== Spring Data Redis

• cluster - Example for Redis Cluster support.
• example - Example for basic Spring Data Redis setup.
• listener - Example to show declarative @RedisListener Pub/Sub.
• pubsub - Example project to show programmatic Pub/Sub usage using Platform and Virtual Threads.
• reactive - Example project to show reactive template support.
• repositories - Example demonstrating Spring Data repository abstraction on top of Redis.
• sentinel - Example for Redis Sentinel support.
• streams - Example for https://redis.io/topics/streams-intro[Redis Streams] support.

Local Redis instances must be running to run the tests. One option is to use Docker in a separate terminal:

$ docker run -p 6379:6379 redis:5.0

WARNING: If you're done using it, don't forget to shut it down!

== Spring Data REST

• headers - A sample showing the population of HTTP headers and the usage of them to perform conditional GET requests.
• multi-store - A sample REST web-service based on both Spring Data JPA and Spring Data MongoDB.
• projections - A sample REST web-service showing how to use projections.
• security - A sample REST web-service secured using Spring Security.
• starbucks - A sample REST web-service built with Spring Data REST and MongoDB.
• uri-customizations - Example project to show URI customization capabilities.

== Spring Data web support

• projections - Example for Spring Data web support for JSONPath and XPath expressions on projection interfaces.
• querydsl - Example for Spring Data Querydsl web integration (creating a Predicate from web requests).
• web - Example for Spring Data web integration (binding Pageable instances to Spring MVC controller methods, using interfaces to bind Spring MVC request payloads).

== Miscellaneous

• jdbc/typed-property-path - Example project to demonstrate usage of TypedPropertyPath for refactoring safe queries and sort.
• mongodb/fragment-spi - Example project how to use Spring Data Fragment SPI to provide reusable custom extensions.
• bom - Example project how to use the Spring Data release train bom in non-Spring-Boot scenarios.
• map - Example project to show how to use Map-backed repositories.
• multi-store - Example project to use both Spring Data MongoDB and Spring Data JPA in one project.

== Note

• The example projects make use of the https://projectlombok.org/[Lombok] plugin. To get proper code navigation in your IDE, you must install it separately. Lombok is available in the IntelliJ plugins repository and as a https://projectlombok.org/download[download] for Eclipse-based IDEs.
• The code makes use of Java 16 language features therefore you need Java 16 or newer to run and compile the examples.
• Most store modules examples start their database via Testcontainers or as embedded/in-memory server unless stated otherwise.