Skip to content

Commit 3c6b5f9

Browse files
committed
Migrate README to asciidoctor.
See #636.
1 parent d7abdc9 commit 3c6b5f9

File tree

1 file changed

+50
-43
lines changed

1 file changed

+50
-43
lines changed

README.md README.adoc

+50-43
Original file line numberDiff line numberDiff line change
@@ -1,105 +1,112 @@
1-
# Spring Data Examples
1+
= Spring Data Examples
22

3-
[![Build Status](https://travis-ci.org/spring-projects/spring-data-examples.svg?branch=main)](https://travis-ci.org/spring-projects/spring-data-examples)
3+
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]
44

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

77
We have separate folders for the samples of individual modules:
88

9-
## Spring Data for Apache Cassandra
9+
== Spring Data for Apache Cassandra
1010

1111
* `example` - Shows core Spring Data support for Apache Cassandra.
1212
* `kotlin` - Example for using Cassandra with Kotlin.
1313
* `reactive` - Example project to show reactive template and repository support.
1414

15-
## Spring Data Elasticsearch
15+
== Spring Data Elasticsearch
1616

1717
* `example` - Example how to use basic text search, geo-spatial search and facets. It uses
18-
the High Level REST Client backing template and repository.
18+
the High Level REST Client backing template and repository.
1919
* `reactive` - Example how to use reactive client, template and repository features.
2020

2121
Local Elasticsearch instance must be running to run the tests.
2222

23-
## Spring Data for Apache Geode
23+
== Spring Data for Apache Geode
2424

2525
* `events` - In this example the test will make use of event handlers and async event
26-
queue to handle events.
26+
queue to handle events.
2727
* `expiration-eviction` - In these examples the server is configured to delete entries
28-
after a certain idle period or after a Time-To-Live period (expiration0 or remove data
29-
from memory when certain thresholds are reached (eviction).
28+
after a certain idle period or after a Time-To-Live period (expiration0 or remove data
29+
from memory when certain thresholds are reached (eviction).
3030
* `function-invocation` - In this example the server will have 3 functions registered. The
31-
client will invoke each of the functions.
31+
client will invoke each of the functions.
3232
* `queries` - In this example a client will query the data in various ways using OQl,
33-
continuous queries, and Apache Lucene indexes.
33+
continuous queries, and Apache Lucene indexes.
3434
* `security` - In this example the servers and clients are set up with security (
35-
username/password) authentication using Geode Security and Apache Shiro.
35+
username/password) authentication using Geode Security and Apache Shiro.
3636
* `storage` - In this example the server is configured to store data off of hte JVM heap
37-
using the `@EnableOffHeap` annotation and to compress region data using
38-
SnappyCompressor`.
37+
using the `@EnableOffHeap` annotation and to compress region data using
38+
SnappyCompressor`.
3939
* `transactions` - In this example the client will perform operations within a
40-
transaction. First, it will do a successful transaction where entries are saved to the
41-
server, and then a failed transaction where all changes are reverted.
40+
transaction. First, it will do a successful transaction where entries are saved to the
41+
server, and then a failed transaction where all changes are reverted.
4242
* `wan` - In these example two servers are deployed. One server populates itself with data, and the other server gets populated with that data via WAN replication.
4343

44-
## Spring Data JDBC
44+
== Spring Data JDBC
4545

4646
* `basic` - Basic usage of Spring Data JDBC.
4747
* `immutables` - Showing Spring Data JDBC usage
48-
with [Immutables](https://immutables.github.io/)
48+
with https://immutables.github.io/[Immutables]
4949

50-
## Spring Data JPA
50+
== Spring Data JPA
5151

52-
* `eclipselink` - Sample project to show how to use Spring Data JPA with Spring Boot and [Eclipselink](https://www.eclipse.org/eclipselink/).
52+
* `eclipselink` - Sample project to show how to use Spring Data JPA with Spring Boot and https://www.eclipse.org/eclipselink/[Eclipselink].
5353
* `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.
5454
* `interceptors` - Example of how to enrich the repositories with AOP.
5555
* `jpa21` - Shows support for JPA 2.1 specific features (stored procedures support).
5656
* `multiple-datasources` - Examples of how to use Spring Data JPA with multiple `DataSource`s.
5757
* `query-by-example` - Example project showing usage of Query by Example with Spring Data JPA.
5858
* `security` - Example of how to integrate Spring Data JPA Repositories with Spring Security.
5959
* `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.
60-
* `vavr` - Shows the support of [Vavr](https://www.vavr.io) collection types as return types for query methods.
60+
* `vavr` - Shows the support of https://www.vavr.io[Vavr] collection types as return types for query methods.
6161

62-
## Spring Data LDAP
62+
== Spring Data LDAP
6363

6464
* `example` - Sample for Spring Data repositories to access an LDAP store.
6565

66-
## Spring Data MongoDB
66+
== Spring Data MongoDB
6767

6868
* `aggregation` - Example project to showcase the MongoDB aggregation framework support.
6969
* `example` - Example project for general repository functionality (including geo-spatial functionality), Querydsl integration and advanced topics.
7070
* `fluent-api` - Example project to show the new fluent API (`MongoTemplate`-alternative) to interact with MongoDB.
71-
* `geo-json` - Example project showing usage of [GeoJSON](http://geojson.org) with MongoDB.
71+
* `geo-json` - Example project showing usage of http://geojson.org[GeoJSON] with MongoDB.
7272
* `gridfs` - Example project showing usage of gridFS with MongoDB.
7373
* `jmolecules` - Example of Spring Data MongoDB working with a jMolecules based domain model.
74-
* `kotlin` - Example for using [Kotlin](https://kotlinlang.org/) with MongoDB.
74+
* `kotlin` - Example for using https://kotlinlang.org/[Kotlin] with MongoDB.
75+
* `linking` - Example demonstrating possibilities for linking documents.
7576
* `query-by-example` - Example project showing usage of Query by Example with MongoDB.
76-
* `querydsl` - Example project showing imperative and reactive [Querydsl](https://github.com/querydsl/querydsl) support for MongoDB.
77+
* `querydsl` - Example project showing imperative and reactive https://github.com/querydsl/querydsl[Querydsl] support for MongoDB.
7778
* `reactive` - Example project to show reactive template and repository support.
7879
* `repository-metrics` - Example project to show how to collect repository method invocation metrics.
7980
* `security` - Example project showing usage of Spring Security with MongoDB.
8081
* `text-search` - Example project showing usage of MongoDB text search feature.
8182
* `transactions` - Example project for imperative and reactive MongoDB 4.0 transaction support.
8283

83-
## Spring Data Neo4j
84+
== Spring Data Neo4j
8485

8586
* `example` - Example to show basic node and relationship entities and repository usage.
8687

87-
## Spring Data R2DBC
88+
== Spring Data R2DBC
8889

8990
* `example` - Basic usage of Spring Data R2DBC.
9091

91-
## Spring Data Redis
92+
== Spring Data Redis
9293

9394
* `cluster` - Example for Redis Cluster support.
9495
* `example` - Example for basic Spring Data Redis setup.
9596
* `reactive` - Example project to show reactive template support.
9697
* `repositories` - Example demonstrating Spring Data repository abstraction on top of Redis.
9798
* `sentinel` - Example for Redis Sentinel support.
98-
* `streams` - Example for [Redis Streams](https://redis.io/topics/streams-intro) support.
99+
* `streams` - Example for https://redis.io/topics/streams-intro[Redis Streams] support.
99100

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

102-
## Spring Data REST
103+
```
104+
$ docker run -p 6379:6379 redis:5.0
105+
```
106+
107+
WARNING: If you're done using it, don't forget to shut it down!
108+
109+
== Spring Data REST
103110

104111
* `headers` - A sample showing the population of HTTP headers and the usage of them to perform conditional `GET` requests.
105112
* `multi-store` - A sample REST web-service based on both Spring Data JPA and Spring Data MongoDB.
@@ -108,27 +115,27 @@ Local Redis instances must be running to run the tests.
108115
* `starbucks` - A sample REST web-service built with Spring Data REST and MongoDB.
109116
* `uri-customizations` - Example project to show URI customization capabilities.
110117

111-
## Spring Data web support
118+
== Spring Data web support
112119

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

117-
## Miscellaneous
124+
== Miscellaneous
118125

119126
* `bom` - Example project how to use the Spring Data release train bom in non-Spring-Boot
120-
scenarios.
127+
scenarios.
121128
* `map` - Example project to show how to use `Map`-backed repositories.
122129
* `multi-store` - Example project to use both Spring Data MongoDB and Spring Data JPA in
123-
one project.
130+
one project.
124131

125-
## Note
132+
== Note
126133

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

0 commit comments

Comments
 (0)