【Spring实战】17 REST服务介绍

文章目录

- 1. 为什么出现
- 2. 拥有哪些优势
- 3. Spring中的应用
- 4. spring-boot-starter-data-rest
- 总结

REST（Representational State Transfer）是一种软件架构风格，通常用于设计网络应用程序的服务接口。RESTful 服务是基于 REST 原则构建的网络服务。

1. 为什么出现

在 REST 服务出现之前 SOAP，CORBA，RPC，RMI 这些服务架构和通信协议被广泛使用。

在这里插入图片描述

SOAP（Simple Object Access Protocol）

SOAP 是一种基于 XML 的协议，用于在网络上进行通信。它定义了一种规范的消息格式和一组规则，用于在分布式环境中交换结构化信息。SOAP 支持在不同操作系统和编程语言之间进行通信，但它的消息格式较为繁琐，相对复杂，且常常需要较多的开销。
CORBA（Common Object Request Broker Architecture）

CORBA 是一种面向对象的分布式计算系统的标准，定义了一组规范，使得不同编程语言和平台上的对象能够相互通信。CORBA 通常使用 IIOP（Internet Inter-ORB Protocol）协议进行通信，但 CORBA 的实现通常比较庞大，复杂度高。
RPC（Remote Procedure Call）

RPC 是一种允许程序在网络上请求服务而不必了解底层通信细节的协议。RPC 框架允许远程计算机上的程序像调用本地程序一样调用远程服务。然而，RPC 的实现通常依赖于特定的编程语言和平台，缺乏统一的标准。
RMI（Remote Method Invocation）

RMI 是 Java 平台上用于实现分布式计算的一种机制。它允许在 Java 虚拟机上运行的对象调用在另一个 Java 虚拟机上运行的对象的方法。然而，RMI 主要面向 Java 环境，不具备与其他平台和语言的轻松集成。

以上这些它们通常较为复杂，需要开发者处理许多细节，且缺乏一种统一、简单、轻量级的设计理念。 正是因为它们有着这些不足，就有了 REST 的出现来弥补这些不足，提供了一种更加简单、灵活、基于标准的通信方式，使得各种应用和服务能够更加轻松地相互协作。

2. 拥有哪些优势

在这里插入图片描述

简单性和可读性

REST 服务的设计理念使得 API 更加直观，易于理解并且可以快速上手
可伸缩性

由于 REST 服务是无状态的，服务器不需要维护大量的会话信息，所以更容易扩展提高了可伸缩性
通用性

REST 服务使用标准的 HTTP 协议，因此通用性非常好，使得不同技术栈的系统能够轻松地集成
易于缓存

REST 服务允许响应被缓存，在响应中设置合适的缓存标识，减轻服务器的负担提高客户端访问速度

3. Spring中的应用

Spring Framework 对 REST 服务提供了丰富的支持，使得创建和使用 REST 服务变得更加简单和灵活，常用的有下图这些
此处只做简单的介绍，下一篇【Spring实战】18 Spring中REST应用详细介绍将会结合代码逐一详细说明

在这里插入图片描述

@RestController

用于标识一个类是RESTful服务的控制器，结合 @Controller 和 @ResponseBody 的功能

表示这个类的所有方法都返回 JSON/XML 等数据，而不是视图
@RequestMapping

用于映射 HTTP 请求的 URL 到控制器的方法 , 可以用在类级别和方法级别
@ResponseBody

用于将方法的返回值直接写入 HTTP 响应体，而不是返回视图
@RequestBody

用于将 HTTP 请求的内容（如 JSON）映射到方法的参数上
@RequestParam

用于将 HTTP 请求参数映射到方法的参数上
@PathVariable

用于从 URL 模板中提取变量值，用于将 URL 中的部分作为方法参数传递
@ResponseStatus

用于设置 HTTP 响应的状态码
@RequestHeader

用于将 HTTP 请求头映射到方法的参数上
@GetMapping

用于将 HTTP 请求方法映射到控制器的 GET 方法
@PostMapping

用于将 HTTP 请求方法映射到控制器的 POST 方法
@DeleteMapping

用于将 HTTP 请求方法映射到控制器的 DELETE 方法
@PutMapping

用于将 HTTP 请求方法映射到控制器的 PUT 方法
@PatchMapping

用于将 HTTP 请求方法映射到控制器的 PATCH 方法
@ExceptionHandler

用于处理控制器方法中抛出的异常，返回自定义的错误响应

这些注解是在 Spring 中创建和使用 REST 服务时常用到的一些关键注解。通过合理地使用这些注解，可以轻松构建出清晰、灵活的 RESTful API。

4. spring-boot-starter-data-rest

Spring Boot 框架中的一个 Starter，用于简化和加速 RESTful 风格的数据暴露和操作。使用它可以使得开发者更加快速地创建具有标准化 RESTful API 的应用，尤其适用于简单的数据模型和操作，减少了手动编写 API 控制器的工作，提高了开发效率。尤其是针对与 Spring Data JPA（Java Persistence API）集成的应用。