标签 Spring框架 下的文章

在之前的步骤中,我们创建了一些资源,但是这些资源还没有被安全保护起来。还没有用户ID和密码来访问这些资源。在这一部分中,我们将实现基本认证。有多种方法可以对我们的RESTful Web服务进行身份验证。最基本的方法是使用基本认证。在基本认证中,我们在请求中发送用户名和密码。当我们提供用户名和密码时,它允许我们访问资源。

- 阅读剩余部分 -

RESTful Web服务版本控制 - 使用URI的基本方法版本控制是API中最重要且最具挑战性的部分,因为它需要向后兼容的API。版本控制有助于在识别更改时更快地进行迭代。我们应该始终为我们的Web API进行版本控制。考虑这样一种情况:我们有一个正在运行的Web API。用户正在使用该API。现在,我们想在Web API中添加更多功能,但希望保持现有功能不变。可能仍有一些用户希望使用旧的API,而其他用户则希望获得具有新功能或扩展功能的新版本的API。这就是Web API版本控制出现的情况。

- 阅读剩余部分 -

为RESTful服务实现动态过滤在前一节中,我们进行了静态过滤。现在我们要转向动态过滤。在动态过滤中,我们根据需要为不同的服务定义不同的过滤器。因此,存在动态过滤的概念。假设有三个字段:姓名(name)、电话(phone)和工资(salary)。我们想要在第一个服务中发送姓名和工资,在第二个服务中发送姓名和电话。

- 阅读剩余部分 -

实现 RESTful 服务的静态过滤在本节中,我们将学习如何对请求进行过滤。过滤器是 JAX-RS 框架提供的重要功能之一。它在各种上下文中使用。它可以应用于对资源的请求或来自资源的响应,或者两者兼而有之。考虑这样一个场景,在响应中我们不想显示某些类成员。这个过程称为过滤。Jackson 有两个用于过滤的注解:@JsonIgnore 和 @JsonIgnoreProperties。

- 阅读剩余部分 -

使用 Spring Boot Actuator 进行 API 监控Spring Boot ActuatorSpring Boot 提供了 Actuator 来有效地监控和管理应用程序。它是一个具有 HTTP 端点的工具(资源所在的地方)。它是 Spring Boot 的子项目。它可以在应用程序中添加多个生产级别的服务,减少了工作量。当服务的性能下降或发生故障时,我们应该尽快了解原因。特别是在构建微服务时,我们需要在 API 周围构建监控。Spring Boot 在提供监控方面具有很好的支持。

- 阅读剩余部分 -

Swagger 文档格式介绍在本节中,我们将详细查看生成的文档。Swagger 是一种用于文档化 REST API 的规范。它指定了一种描述 REST Web 服务的格式(URL、方法和表示方法)。它还提供了从应用程序代码生成/计算文档的工具。作为应用程序开发人员,我们使用框架编写 Web 服务,Swagger 扫描应用程序代码,并在 URL 上公开文档。客户端可以使用此 URL 并学习如何使用 REST Web 服务:在哪个 URL 上调用哪个 HTTP 方法,发送哪些输入文档,期望哪些状态码等。

- 阅读剩余部分 -

配置自动生成 Swagger 文档SwaggerSwagger 是一个开源工具,它围绕 OpenAPI 规范构建,帮助开发人员设计、构建、文档化和消费 RESTful API。它是用于 RESTful Web 服务的最流行的 API 文档格式。它提供了 JSON 和用户界面(UI)支持。JSON 可以用作机器可读的格式,Swagger-UI 则用于可视化展示,使人们只需浏览 API 文档就能理解。主要的 Swagger 工具包括:

- 阅读剩余部分 -

实现对XML的内容协商支持在本节中,我们将讨论RESTful Web服务的另一个概念,即内容协商。内容协商资源可以具有多种表示形式,主要是因为可能有多个客户端期望不同的表示形式。内容协商是在存在多种表示形式时选择给定响应的最佳表示形式的过程。它是HTTP的一部分,使得在同一URI下提供不同版本的文档成为可能。

- 阅读剩余部分 -

RESTful 服务的国际化在这一部分,我们将讨论 RESTful Web 服务的国际化。国际化国际化是这样一个过程:设计 Web 应用程序或服务以自动提供对各个国家和各种语言的支持,而无需对应用程序进行更改。国际化也称为 I18N,因为国际化一词的总长度为 18 个字符,从字母 "I" 到 "N"。国际化通过添加特定于区域设置的组件(例如翻译后的文本、描述区域设置特定行为的数据等)来执行本地化。它支持完全集成到提供语言或文化相关功能的类和包中。

- 阅读剩余部分 -