spring-data-examples

此仓库包含不同 Spring Data 模块的示例项目，展示了 API 和如何使用这些模块提供的功能。

我们为各个模块的示例设置了单独的文件夹：

== Apache Cassandra 的 Spring Data

== Spring Data Elasticsearch

运行测试需要本地 Elasticsearch 实例正在运行。

== Spring Data JDBC

basic - Spring Data JDBC 的基本用法。
graalvm-native - 此示例将基本的 Spring Data JDBC 应用程序编译为 GraalVM 原生镜像。
howto - 与 https://spring.io/blog/2021/09/09/spring-data-jdbc-how-to-use-custom-id-generation[Spring Data JDBC - 如何使用博客文章] 相关的项目集合。
immutables - 展示 Spring Data JDBC 与 https://immutables.github.io/[Immutables] 的使用。
jmolecules - 演示 jMolecules 与 Spring Data JDBC 的交互。
jooq - 演示如何同时使用 jOOQ 和 Spring Data JDBC。
mybatis - 演示如何使用 MyBatis 为 Spring Data JDBC 生成 SQL。
singlequeryloading - 演示如何启用单查询加载。

== Spring Data JPA

eclipselink - 展示如何使用 Spring Data JPA 与 Spring Boot 和 https://www.eclipse.org/eclipselink/[Eclipselink] 的示例项目。
example - 可能是您首先想要查看的项目。包含各种示例包，展示了可以使用 Spring Data JPA 的不同层级。查看 simple 包以了解最基本的设置。还包含在虚拟线程上运行的示例。
interceptors - 如何使用 AOP 增强仓库的示例。
jpa21 - 展示对 JPA 2.1 特定功能的支持（存储过程支持）。
multiple-datasources - 如何使用多个 DataSource 的 Spring Data JPA 示例。
query-by-example - 展示 Spring Data JPA 使用查询示例的示例项目。
security - 如何将 Spring Data JPA 仓库与 Spring Security 集成的示例。
showcase - 重构展示，说明如何通过使用 Spring Data JPA 改进基于纯 JPA 的持久层（即：删除几乎所有实现代码）。按照 demo.txt 文件的详细说明进行操作。
vavr - 展示对查询方法返回类型支持 https://www.vavr.io[Vavr] 集合类型。

== Spring Data LDAP

== Spring Data MongoDB

aggregation - 展示 MongoDB 聚合框架支持的示例项目。
example - 展示一般仓库功能（包括地理空间功能）、Querydsl 集成和高级主题的示例项目。
fluent-api - 展示新的流式 API（MongoTemplate 替代方案）与 MongoDB 交互的示例项目。
geo-json - 展示 MongoDB 使用 http://geojson.org[GeoJSON] 的示例项目。
gridfs - 展示 MongoDB 使用 gridFS 的示例项目。
jmolecules - Spring Data MongoDB 与基于 jMolecules 的领域模型配合使用的示例。
kotlin - 使用 https://kotlinlang.org/[Kotlin] 和 MongoDB 的示例。
linking - 演示链接文档的可能性。
query-by-example - 展示 MongoDB 使用查询示例的示例项目。
querydsl - 展示 MongoDB 的命令式和响应式 https://github.com/querydsl/querydsl[Querydsl] 支持的示例项目。
reactive - 展示响应式模板和仓库支持的示例项目。
repository-metrics - 展示如何收集仓库方法调用指标的示例项目。
security - 展示 MongoDB 使用 Spring Security 的示例项目。
text-search - 展示 MongoDB 文本搜索功能使用的示例项目。
transactions - 展示 MongoDB 4.0 命令式和响应式事务支持的示例项目。

== Spring Data Neo4j

== Spring Data R2DBC

== Spring Data Redis

运行测试需要本地 Redis 实例正在运行。一种选择是在单独的终端中使用 Docker：

$ docker run -p 6379:6379 redis:5.0

警告：如果您使用完毕，别忘了关闭它！

== Spring Data REST

== Spring Data Web 支持

projections - Spring Data Web 支持在投影接口上使用 JSONPath 和 XPath 表达式的示例。
querydsl - Spring Data Querydsl Web 集成的示例（从 Web 请求创建 Predicate）。
web - Spring Data Web 集成的示例（将 Pageable 实例绑定到 Spring MVC 控制器方法，使用接口绑定 Spring MVC 请求负载）。

== 其他

== 注意

示例项目使用了 https://projectlombok.org/[Lombok] 插件。要在 IDE 中获得正确的代码导航，您必须单独安装它。Lombok 在 IntelliJ 插件仓库中可用，也可以为基于 Eclipse 的 IDE https://projectlombok.org/download[下载]。
代码使用了 Java 16 语言特性，因此您需要 Java 16 或更新版本来运行和编译示例。
除非另有说明，大多数存储模块示例通过 Testcontainers 或作为嵌入式/内存服务器启动其数据库。