Spring认证中国教育管理中心-Spring Data REST框架教程一

简介: Spring认证中国教育管理中心-Spring Data REST框架教程一

原标题:Spring认证中国教育管理中心-Spring Data REST框架教程一(Spring中国教育管理中心)

参考文档

  1. 介绍

REST Web 服务已成为 Web 上应用程序集成的首选方法。在其核心,REST 定义了一个系统,该系统由客户端交互的资源组成。这些资源以超媒体驱动的方式实现。Spring MVC和Spring WebFlux都为构建这些类型的服务提供了坚实的基础。然而,即使为多域对象系统实现最简单的 REST Web 服务原则也可能非常乏味,并会产生大量样板代码。

Spring Data REST 构建在 Spring Data 存储库之上,并自动将它们导出为 REST 资源。它利用超媒体让客户端自动查找存储库公开的功能,并将这些资源集成到相关的基于超媒体的功能中。

  1. 入门

Spring Data REST 本身就是一个 Spring MVC 应用程序,它的设计方式使其可以轻松地与您现有的 Spring MVC 应用程序集成。现有(或未来)的服务层可以与 Spring Data REST 一起运行,只需少量的额外工作。

3.1.将 Spring Data REST 添加到 Spring Boot 项目
最简单的入门方法是构建一个 Spring Boot 应用程序,因为 Spring Boot 有一个适用于 Spring Data REST 的启动器并使用自动配置。以下示例展示了如何使用 Gradle 在 Spring Boot 项目中包含 Spring Data Rest:

示例 3. 使用 Gradle 配置 Spring Boot

dependencies {
...
compile("org.springframework.boot:spring-boot-starter-data-rest")
...
}
以下示例展示了如何使用 Maven 在 Spring Boot 项目中包含 Spring Data Rest:

示例 4. 使用 Maven 配置 Spring Boot


...

<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-rest</artifactId>


...

如果您使用Spring Boot Gradle 插件或Spring Boot Maven 插件,则无需提供版本号。

当您使用 Spring Boot 时,Spring Data REST 会自动配置。

3.2.将 Spring Data REST 添加到 Gradle 项目
要将 Spring Data REST 添加到基于 Gradle 的项目,请将spring-data-rest-webmvc工件添加到编译时依赖项,如下所示:

dependencies {
… other project dependencies
compile("org.springframework.data:spring-data-rest-webmvc:3.6.0")
}
3.3.将 Spring Data REST 添加到 Maven 项目
要将 Spring Data REST 添加到基于 Maven 的项目,请将spring-data-rest-webmvc工件添加到编译时依赖项,如下所示:


org.springframework.data
spring-data-rest-webmvc
3.6.0

3.4.配置 Spring Data REST
要将 Spring Data REST 与现有 Spring MVC 应用程序一起安装,您需要包含适当的 MVC 配置。Spring Data REST 配置在一个名为的类中定义,
RepositoryRestMvcConfiguration您可以将该类导入到应用程序的配置中。

如果您使用 Spring Boot 的自动配置,则不需要此步骤。当您包含
spring-boot-starter-data-rest并且在您的依赖项列表中,您的应用程序被标记为@SpringBootApplication或时,Spring Boot 会自动启用 Spring Data REST @EnableAutoConfiguration。

要自定义配置,请注册 aRepositoryRestConfigurer并实施或覆盖与configure…您的用例相关的-methods。

确保您还为您使用的商店配置 Spring Data 存储库。有关详细信息,请参阅相应 Spring Data 模块的参考文档。

3.5.Spring Data REST 的基本设置
本节介绍在配置 Spring Data REST 应用程序时可以操作的基本设置,包括:

设置存储库检测策略
更改基本 URI
更改其他 Spring Data REST 属性
3.5.1.设置存储库检测策略
Spring Data REST 使用
RepositoryDetectionStrategy来确定存储库是否作为 REST 资源导出。的RepositoryDiscoveryStrategies列举包括以下值:

Spring认证中国教育管理中心-Spring Data REST框架教程一
3.5.2.更改基本 URI
默认情况下,Spring Data REST 在根 URI“/”处提供 REST 资源。有多种方法可以更改基本路径。

对于 Spring Boot 1.2 及更高版本,您可以通过在 中设置单个属性来更改基本 URI application.properties,如下所示:

spring.data.rest.basePath=/api
使用 Spring Boot 1.1 或更早版本,或者如果您不使用 Spring Boot,您可以执行以下操作:

@Configuration
class CustomRestMvcConfiguration {

@Bean
public RepositoryRestConfigurer repositoryRestConfigurer() {

return new RepositoryRestConfigurer() {

  @Override
  public void configureRepositoryRestConfiguration(RepositoryRestConfiguration config, CorsRegistry cors) {
    config.setBasePath("/api");
  }
};

}
}
或者,您可以将 的自定义实现注册RepositoryRestConfigurer为 Spring bean,并确保它被组件扫描选中,如下所示:

@Component
public class CustomizedRestMvcConfiguration extends RepositoryRestConfigurer {

@Override
public void configureRepositoryRestConfiguration(RepositoryRestConfiguration config, CorsRegistry cors) {

config.setBasePath("/api");

}
}
上述两种方法都将基本路径更改为/api.

3.5.3.更改其他 Spring Data REST 属性
您可以更改以下属性:

Spring认证中国教育管理中心-Spring Data REST框架教程一
3.6.启动应用程序
此时,您还必须配置您的密钥数据存储。

Spring Data REST 官方支持:

弹簧数据 JPA
春季数据MongoDB
弹簧数据 Neo4j
Spring Data GemFire
Spring Data Cassandra
以下入门指南可以帮助您快速入门和运行:

弹簧数据 JPA
春季数据MongoDB
弹簧数据 Neo4j
Spring Data GemFire
这些链接指南介绍了如何为相关数据存储添加依赖项、配置域对象和定义存储库。

您可以将应用程序作为 Spring Boot 应用程序(使用前面显示的链接)运行,也可以将其配置为经典的 Spring MVC 应用程序。

通常,Spring Data REST 不会向给定的数据存储添加功能。这意味着,根据定义,它应该适用于任何支持存储库编程模型的 Spring Data 项目。上面列出的数据存储是我们编写集成测试以验证 Spring Data REST 与它们一起工作的数据存储。
从这一点来看,您可以使用各种选项自定义 Spring Data REST。

  1. 仓库资源

4.1.基本面
Spring Data REST 的核心功能是为 Spring Data 存储库导出资源。因此,要查看并可能自定义导出工作方式的核心工件是存储库接口。考虑以下存储库接口:

public interface OrderRepository extends CrudRepository<Order, Long> { }
对于这个存储库,Spring Data REST 在/orders. 路径源自被管理的域类的非大写、复数、简单的类名。它还为 URI 模板下的存储库管理的每个项目公开一个项目资源/orders/{id}。

默认情况下,与这些资源交互的 HTTP 方法映射到CrudRepository. 在关于收藏资源和项目资源的部分中阅读更多相关信息。

4.1.1.存储库方法暴露
为某个存储库公开哪些 HTTP 资源主要由存储库的结构驱动。换句话说,资源公开将遵循您在存储库中公开的方法。如果您扩展CrudRepository,通常会公开公开所有 HTTP 资源所需的所有方法,我们可以默认注册。下面列出的每个资源都将定义需要存在哪些方法,以便可以为每个资源公开特定的 HTTP 方法。这意味着,没有公开这些方法的存储库——要么根本不声明它们,要么显式使用它们@RestResource(exported = false) ——不会在这些资源上公开这些 HTTP 方法。

有关如何单独调整默认方法公开或专用 HTTP 方法的详细信息,请参阅自定义支持的 HTTP 方法。

4.1.2.默认状态代码
对于暴露的资源,我们使用一组默认状态代码:

200 OK: 对于普通GET请求。
201 Created:对于POST和PUT创造新的资源的请求。
204 No Content: 对于PUT、PATCH和DELETE请求,当配置设置为不返回资源更新的响应主体 ( RepositoryRestConfiguration.setReturnBodyOnUpdate(…)) 时。如果配置值设置为包括对 的响应PUT,200 OK则为更新返回,并201 Created为通过创建的资源返回PUT。
如果配置值 (
RepositoryRestConfiguration.returnBodyOnUpdate(…)和RepositoryRestConfiguration.returnBodyCreate(…)) 显式设置为null ——默认情况下是——,则使用 HTTP 接受标头的存在来确定响应代码。在收藏和物品资源的详细说明中阅读更多相关信息。

4.1.3.资源可发现性
HATEOAS 的一个核心原则是资源应该可以通过发布指向可用资源的链接来发现。关于如何在 JSON 中表示链接,有一些相互竞争的事实上的标准。默认情况下,Spring Data REST 使用HAL来呈现响应。HAL 定义要包含在返回文档的属性中的链接。

资源发现从应用程序的顶层开始。通过向部署 Spring Data REST 应用程序的根 URL 发出请求,客户端可以从返回的 JSON 对象中提取一组链接,这些链接表示客户端可用的下一级资源。

例如,要发现应用程序根目录中有哪些资源可用,请GET向根 URL发出 HTTP ,如下所示:

curl -v http://localhost:8080/

< HTTP/1.1 200 OK
< Content-Type: application/hal+json

{ "_links" : {

"orders" : {
  "href" : "http://localhost:8080/orders"
},
"profile" : {
  "href" : "http://localhost:8080/api/alps"
}

}
}
结果文档的属性是一个对象,它由表示关系类型的键组成,并带有 HAL 中指定的嵌套链接对象。

有关该profile链接的更多详细信息,请参阅应用程序级配置文件语义 (ALPS)。

相关文章
|
2天前
|
安全 Java API
Java一分钟之-Spring Data REST:创建RESTful服务
【6月更文挑战第15天】Spring Data REST让基于Spring Data的项目轻松创建REST API,免去大量控制器代码。通过自动HTTP映射和链接生成,简化CRUD操作。文章涵盖启用REST、配置仓库、自定义端点、解决过度暴露、缺失逻辑和安全性问题,提供代码示例,如自定义Repository、投影和安全配置,强调在利用其便利性时注意潜在挑战。
19 5
|
3天前
|
JSON 安全 Java
Spring Security 与 JWT、OAuth 2.0 整合详解:构建安全可靠的认证与授权机制
Spring Security 与 JWT、OAuth 2.0 整合详解:构建安全可靠的认证与授权机制
11 0
|
6天前
|
NoSQL Java MongoDB
Java一分钟之-Spring Data MongoDB:MongoDB集成
【6月更文挑战第11天】Spring Data MongoDB简化Java应用与MongoDB集成,提供模板和Repository模型。本文介绍其基本用法、常见问题及解决策略。包括时间字段的UTC转换、异常处理和索引创建。通过添加相关依赖、配置MongoDB连接、定义Repository接口及使用示例,帮助开发者高效集成MongoDB到Spring Boot应用。注意避免时间差、异常处理不充分和忽视索引的问题。
28 0
|
7天前
|
缓存 NoSQL Java
Java一分钟之-Spring Data Redis:使用Redis做缓存
【6月更文挑战第10天】Spring Data Redis是Spring框架的一部分,简化了Java应用与Redis的集成,支持多种数据结构操作。本文介绍了其基本使用,包括添加依赖、配置Redis连接及使用RedisTemplate。还讨论了常见问题,如序列化、缓存穿透和雪崩,并提供解决方案。通过实战示例展示了缓存与数据库读写分离的实现,强调了Spring Data Redis在提升系统性能中的作用。
33 0
|
7天前
|
SQL Java 数据库
Java一分钟之-Spring Data JPA:简化数据库访问
【6月更文挑战第10天】Spring Data JPA是Spring Data项目的一部分,简化了Java数据库访问。它基于JPA,提供Repository接口,使开发者能通过方法命名约定自动执行SQL,减少代码量。快速上手包括添加相关依赖,配置数据库连接,并定义实体与Repository接口。常见问题涉及主键生成策略、查询方法命名和事务管理。示例展示了分页查询的使用。掌握Spring Data JPA能提升开发效率和代码质量。
28 0
|
1月前
|
Java 测试技术 API
Spring Boot 单元测试 0基础教程
Spring Boot 单元测试 0基础教程
19 0
|
1月前
|
SQL Java 数据库连接
Springboot框架整合Spring Data JPA操作数据
Spring Data JPA是Spring基于ORM和JPA规范封装的框架,简化了数据库操作,提供增删改查等接口,并可通过方法名自动生成查询。集成到Spring Boot需添加相关依赖并配置数据库连接和JPA设置。基础用法包括定义实体类和Repository接口,通过Repository接口可直接进行数据操作。此外,JPA支持关键字查询,如通过`findByAuthor`自动转换为SQL的`WHERE author=?`查询。
|
1月前
|
Java 关系型数据库 MySQL
优质全套Spring全套教程三
优质全套Spring全套教程三
|
1月前
|
XML Java 数据格式
优质全套Spring全套教程二
优质全套Spring全套教程二
|
1月前
|
XML Java 数据格式
优质全套Spring全套教程一
优质全套Spring全套教程一