spring-projects / spring-data-examples Goto Github PK

Spring Data Example Projects

License: Apache License 2.0

Java 98.86% CSS 0.01% HTML 0.34% Kotlin 0.79%

spring-data-examples's Introduction

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

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.

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

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 Spring Data JDBC - How to blog posts.
immutables - Showing Spring Data JDBC usage with 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

eclipselink - Sample project to show how to use Spring Data JPA with Spring Boot and 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 `DataSource`s.
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 Vavr collection types as return types for query methods.

Spring Data LDAP

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

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 and 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 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 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 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.

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.
pubsub - Example project to show 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 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

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 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 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.

spring-data-examples's People

Contributors

Stargazers

Watchers

Forkers

mohsinh smeda2205 michaellavelle iyangming andra83 samuelteixeiras zhanghqgit xucxichpopot vladimir-krasikov hjforever gregturn rkarnam04 albz657 ramakrishna580 karaatli springone2gx-2014 popkart kleber1982 jtburbine maitelmouden akonczak bys-levi-lu hrajesh4u jbbarquero vegeraju srsk79 eddumelendez zhangwei5095 bmeurant noure wgorder odedmar aazanovich guotechfin thomasdarimont love-wizard sleeping113 wgpshashank cloudbyte sharmanikhil04 dalugama lgscofield acsadam0404 karthikshetty05 ketananand rxcai h0shekhar rubandeventhiran sylvestor88 jamesnguyen101 jrrickard jcoffeebean jafamo civanblaze josephmokenela dailindl harshithatlb rlitto guoxw diator kickasshard ceip mozartlino smiyashita ajasuja liuzhengyang codependent zhihaoqiu tejaswigk maniook leyfon18 kbaylosis wilkinsona seshnagineni jamalahmedmaaz supermohit giangvt8x sramani sachinrasal srinivasaprasads florianschmitt jimlgx ashraf-revo msimu frahd ethanliang8 mindis sfernandotech thanray tjayant sbcoba h-t-ren oleersoy piotrlochowski felipeg48 khoadoan sairamworld abhijeet-adarsh balajivm jingyanghub

spring-data-examples's Issues

Create a dedicated example on Spring Data REST and Spring Security

show @Secured working
show filtering in @Query working (there should be a basic sample like this in the jpa module already)
show URI security config

Create a (simple as possible) web UI for the REST / Starbucks example

To showcase the Starbucks store search built on top of Spring Data MongoDB and Spring Data REST a bit better it would be cool to have a minimal UI consisting of the following:

UI controls to define the input location. This could be direct inputs for longitude and latitude, a button to obtain the location from the browser and maybe two or three predefined spots (e.g. Times Square, NY)
UI controls to define the distance
A result view that lists the found results and optionally (read: in case internet access is available) displays a map to visualize the results.

I'd prefer the most simple solution that could possibly work. Letting the general functionality work without JavaScript (enter location and receive the results) would be nice to have but is not required as I am assuming that to require an additional controller and template rendering which might add too much additional code and distract from the main focus.

Please, no JavaScript package managers involved. We need Maven and MongoDB to be the only infrastructure requirements. This is all that can be expected by the users:

$ git clone https://github.com/spring-projects/spring-data-examples
$ cd spring-data-examples/rest/starbucks
$ mvn spring-boot:run &
$ open http://localhost:8080

A core requirement is that the client must use hypermedia to discover the resource providing the search results based on this information:

a set of link relations that will allow the client to discover the final resource.
a description of the input parameters of the URI template of the search resource.

Appreciate all PRs submitted but will probably resort to the simplest one submitted.

Upgrade to Spring Boot 1.2.2

Add example for customization of all repositories

Upgrade to Spring HATEOAS 0.17

Upgrade to Spring Data Evans GA

Update dependencies

Add spring-boot-maven-plugin to root pom

The root pom need the spring-boot-maven-plugin so every example can benefit from the various options including runnable jar files.

Add samples for Spring Data Solr

Add example for Java 8 Streams in JPA.

We should add an example that demonstrates how to use Java 8 Stream's for streaming JPA query results.

Move to Spring Security 4.0 RC1 for REST/Security example once it has been released

Upgrade to Spring Security 4.0

Add examples for web support

Resolving Pageable instances from the request.
Using interfaces to bind request data to controller method arguments.

Add and check code samples for Spring Data MongoDB

Add example for calling Stored Procedure with multiple OUT parameters

I couldn't find anywhere if there's a way to call a SP with multiple out params using @procedure notation

Create Sample Stored Procedure with cursor

Add example for Spring Data Cassandra.

Delayed loading problems under multiple data sources to solve?

Add sample for Map-based repositories

Only build jars with main-class if needed.

Currently a mvn clean installin the examples root fails because the default configuration for the spring boot maven plugin looks for a main class in every project and cannot find one in some cases.

Spring Boot 1.2.0 contains ca skip property with which you can disable that, but since we're on 1.1.8 right now we have to do something else.
http://docs.spring.io/spring-boot/docs/current-SNAPSHOT/maven-plugin/repackage-mojo.html#skip

Fortunately if we configure the layout-property of the spring-boot-maven-plugin to NONE in the parent pom - we avoid creating jars and thus avoid the problem.
http://docs.spring.io/spring-boot/docs/current-SNAPSHOT/maven-plugin/repackage-mojo.html#layout

<build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>

                <configuration>
                    <layout>NONE</layout>
                </configuration>
            </plugin>
        </plugins>
    </build>

For those project where we actually need the main methods we can just define the layout and the main class explicitly.

like for the starbucks example:

<build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <mainClass>example.stores.StoreApp</mainClass>
                    <layout>JAR</layout>
                </configuration>
            </plugin>
        </plugins>
    </build>

Check and add samples for Spring Data REST

ALPS
Projections
JSON Patch

Check and potentially add examples for Spring Data JPA

SpEL support, Spring Security integration, potentially a custom SpEL extension
stored procedures
findTop10By…(…)

Move to new Travis build infrastructure

Add sample for JSR-310 AttributeConverters

Create JPA example based on EclipseLink

Based on this request.

Spring Boot with Eclipselink instead of Hibernate
Project configured to use static weaving

Enable -parameters during compile so that we can get rid off @Param

Spring attempts to create a query for custom JPA Repository method

Hi,

I created a custom JPA Repository as shown in the examples, but when I use it Spring attempts to find a property for the @Entity base on the method name of the custom Repository, e.g.:

interface UserRepositoryCustom {

    /**
     * Custom repository operation.
     * 
     * @return
     */
    List<User> myCustomBatchOperation();
}

Then Spring throws a PropertyReferenceException with this message:

No property my found for type User

I'm using Spring Boot 1.1.4, which in turn uses spring-data-commons-1.8.1 and spring-data-jpa-1.6.1.

Thanks,

Mariano.

A lot of thanks for you support !!!!!

Hibernate: {call plus1inout(?)}