【实战指南】RESTful 从入门到精通(Spring Boot)

2024-08-30 01:12
文章标签 java 实战 入门 精通 spring boot 指南 restful

本文主要是介绍【实战指南】RESTful 从入门到精通(Spring Boot)，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

文章目录

  • RESTful 从入门到进阶
    • 引言
    • 第一部分：基础知识
      • 1. REST 概念介绍
      • 2. HTTP 方法和状态码
      • 3. RESTful 资源与URI
    • 第二部分：Java 实现 RESTful API
      • 4. Spring Boot 快速搭建 RESTful 服务
      • 5. 创建 RESTful 控制器
      • 6. 使用 JPA 进行数据持久化
    • 第三部分：高级主题
      • 7. 认证与授权
      • 8. 异常处理
      • 9. 测试 RESTful API

RESTful 从入门到进阶

引言

RESTful API 已经成为现代 Web 服务的标准之一，无论是在移动应用、Web 应用还是物联网领域都有着广泛的应用。掌握 RESTful API 的设计和实现对于任何前端或后端开发者来说都是必不可少的技能之一。

  • RESTful API 的重要性与应用场景
    • RESTful API 作为现代 Web 服务的核心，为客户端与服务器之间的交互提供了一种简洁、灵活的方式。
    • RESTful API 广泛应用于各种场景，包括移动应用、Web 应用、物联网设备等，它允许不同系统之间进行无缝的数据交换。
  • RESTful 设计原则简介
    • RESTful API 遵循 REST (Representational State Transfer) 架构风格，这是一种轻量级、无状态的服务交互方式。
    • RESTful 设计强调使用标准的 HTTP 方法（如 GET, POST, PUT, DELETE）来表示对资源的操作，并利用 URL 来唯一标识资源。
  • 为什么选择 Java 和 Spring Boot？
    • Java 是一种广泛使用的编程语言，特别是在企业级应用中。
    • Spring Boot 是基于 Spring 框架的一个简化版本，它提供了快速开发 RESTful 服务的能力，同时也简化了配置和依赖管理。
    • Spring Boot 内置了对 RESTful API 的支持，使得开发者能够快速构建可维护的 Web 服务。

第一部分：基础知识

1. REST 概念介绍

1. REST 定义

  • REST 是一种用于构建 Web 服务的设计风格，它的核心理念是将网络应用视为一组资源，这些资源通过统一的接口被访问和操作。
  • RESTful API 遵循 REST 架构风格，它是一种无状态的、客户端-服务器的、基于超文本传输协议 (HTTP) 的架构风格。
    2. RESTful 架构的关键特点
  • 无状态：每次请求都包含所有必要的信息，服务器不会存储客户端的状态。
  • 客户端-服务器模型：客户端和服务端分离，客户端负责显示和用户交互，服务端负责数据管理和业务逻辑。
  • 缓存：响应可以被缓存以提高性能。
  • 分层系统：中间层可以缓存数据，提高安全性。
  • 统一接口：通过标准的 HTTP 方法和状态码进行交互。
    3. RESTful 与 SOAP 的对比
  • RESTful API 通常使用简单的 HTTP 方法进行操作，而 SOAP 则是一种更为复杂的协议，使用 XML 格式进行消息传输。
  • RESTful API 更易于理解，更轻量级，更适合互联网应用；SOAP 更适合企业级应用，特别是那些需要事务保证的应用场景。

2. HTTP 方法和状态码

1. GET, POST, PUT, DELETE 等方法的用途

  • GET: 用于检索资源的信息。
  • POST: 用于创建新的资源。
  • PUT: 用于更新现有资源。
  • DELETE: 用于删除资源。
    2. 常见 HTTP 状态码解释
  • 200 OK: 请求成功。
  • 201 Created: 资源创建成功。
  • 204 No Content: 成功但没有返回数据。
  • 400 Bad Request: 客户端发送的请求有误。
  • 401 Unauthorized: 请求未经授权。
  • 403 Forbidden: 请求被拒绝。
  • 404 Not Found: 请求的资源不存在。
  • 500 Internal Server Error: 服务器内部错误。

3. RESTful 资源与URI

1. 资源定义

  • 在 RESTful API 中，资源是指可以通过 URI (Uniform Resource Identifier) 访问的对象或数据集合。
  • 资源可以通过 HTTP 方法来操作。
    2. URI 的设计原则
  • URI 应该简洁明了。
  • 使用名词而不是动词来命名资源。
  • 使用复数形式来表示资源集合。
  • 使用路径参数来表示特定资源的实例。
    3. 示例：设计一个用户资源的 URI
  • 用户资源集合的 URI 可以设计为 /users。
  • 特定用户的 URI 可以设计为 /users/{userId}，其中 {userId} 是路径变量，代表用户的唯一标识符。

第二部分：Java 实现 RESTful API

在这个部分，我们将详细介绍如何使用 Java 和 Spring Boot 快速搭建 RESTful 服务，并通过具体的代码示例来展示如何创建 RESTful 控制器以及如何使用 JPA 进行数据持久化。

4. Spring Boot 快速搭建 RESTful 服务

Spring Boot 简介

Spring Boot 是 Spring 框架的一个衍生项目，旨在简化 Spring 应用的初始设置和配置。它提供了自动配置机制，使得开发者能够专注于编写业务逻辑代码，而不是繁琐的配置。

创建 Spring Boot 项目

为了创建一个新的 Spring Boot 项目，我们可以使用 Spring Initializr 来快速生成项目骨架。打开 Spring Initializr 网站 (https://start.spring.io/)，选择以下选项：

  • Project: Maven Project
  • Language: Java
  • Packaging: Jar
  • Java: 11
  • Dependencies: Web, Thymeleaf (可选), Spring Data JPA, MySQL Driver (或您选择的数据库驱动)

点击“Generate”按钮下载项目模板。

添加 RESTful 支持

Spring Boot 默认已经包含了 RESTful 支持，我们不需要额外添加依赖。但是，为了方便测试 RESTful API，可以添加如下依赖：

<!-- pom.xml 文件 -->
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope>
</dependency>

启动类和配置文件示例

在 src/main/java 目录下创建 com.example.restapi 包，并在该包下创建 RestApiApplication.java 文件作为启动类：

package com.example.restapi;import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication
public class RestApiApplication {public static void main(String[] args) {SpringApplication.run(RestApiApplication.class, args);}
}

接着，在 src/main/resources 目录下的 application.properties 文件中添加数据库连接配置：

spring.datasource.url=jdbc:mysql://localhost:3306/rest_api?useSSL=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=password
spring.jpa.hibernate.ddl-auto=update

请确保替换数据库连接字符串、用户名和密码为您的实际配置。

5. 创建 RESTful 控制器

使用 @RestController 注解

@RestController 注解是一个组合注解，它结合了 @Controller 和 @ResponseBody 注解的功能，用于标记一个类为 RESTful 控制器。

处理 HTTP 请求

下面是一个简单的例子，展示如何创建一个用户资源控制器：

package com.example.restapi.controller;import com.example.restapi.model.User;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;import java.util.ArrayList;
import java.util.List;
import java.util.Optional;@RestController
@RequestMapping("/api/users")
public class UserController {private List<User> users = new ArrayList<>();@PostMappingpublic ResponseEntity<User> createUser(@RequestBody User user) {users.add(user);return ResponseEntity.status(201).body(user);}@GetMapping("/{id}")public ResponseEntity<User> getUserById(@PathVariable Long id) {Optional<User> user = users.stream().filter(u -> u.getId().equals(id)).findFirst();return user.map(ResponseEntity::ok).orElseGet(() -> ResponseEntity.notFound().build());}
}

返回 JSON 数据

在上面的例子中，我们使用了 ResponseEntity 类来控制响应的状态码和内容类型。默认情况下，Spring Boot 会将 Java 对象转换为 JSON 格式返回给客户端。

6. 使用 JPA 进行数据持久化

JPA 简介

Java Persistence API (JPA) 是 Java EE 规范的一部分，它提供了一个面向对象的方法来处理关系型数据库。Spring Data JPA 是 JPA 的一个简化版，它简化了数据访问层的编码。

创建实体类

首先，我们需要定义一个实体类来映射数据库表。例如，定义一个 User 类：

package com.example.restapi.model;import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;@Entity
public class User {@Id@GeneratedValue(strategy = GenerationType.IDENTITY)private Long id;private String name;private String email;// Getters and setters
}

创建 Repository 接口

接着，我们创建一个 UserRepository 接口来处理数据访问：

package com.example.restapi.repository;import com.example.restapi.model.User;
import org.springframework.data.jpa.repository.JpaRepository;public interface UserRepository extends JpaRepository<User, Long> {User findByEmail(String email);
}

示例：实现 CRUD 操作

现在我们可以使用 UserRepository 来实现 CRUD (Create, Read, Update, Delete) 操作。修改 UserController 类来使用 UserRepository：

package com.example.restapi.controller;import com.example.restapi.model.User;
import com.example.restapi.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;import java.util.List;
import java.util.Optional;@RestController
@RequestMapping("/api/users")
public class UserController {@Autowiredprivate UserRepository userRepository;@PostMappingpublic ResponseEntity<User> createUser(@RequestBody User user) {User createdUser = userRepository.save(user);return ResponseEntity.status(201).body(createdUser);}@GetMappingpublic ResponseEntity<List<User>> getAllUsers() {List<User> users = userRepository.findAll();return ResponseEntity.ok(users);}@GetMapping("/{id}")public ResponseEntity<User> getUserById(@PathVariable Long id) {Optional<User> user = userRepository.findById(id);return user.map(ResponseEntity::ok).orElseGet(() -> ResponseEntity.notFound().build());}@PutMapping("/{id}")public ResponseEntity<User> updateUser(@PathVariable Long id, @RequestBody User updatedUser) {return userRepository.findById(id).map(user -> {user.setName(updatedUser.getName());user.setEmail(updatedUser.getEmail());User savedUser = userRepository.save(user);return ResponseEntity.ok(savedUser);}).orElseGet(() -> ResponseEntity.notFound().build());}@DeleteMapping("/{id}")public ResponseEntity<?> deleteUser(@PathVariable Long id) {return userRepository.findById(id).map(user -> {userRepository.delete(user);return ResponseEntity.ok().build();}).orElseGet(() -> ResponseEntity.notFound().build());}
}

第三部分：高级主题

在这个部分，我们将深入探讨 RESTful API 的一些高级主题，包括认证与授权、异常处理以及如何测试 RESTful API。

7. 认证与授权

基本认证

基本认证是一种简单的身份验证机制，客户端通过 HTTP 头部发送用户名和密码。虽然简单易用，但它并不安全，不建议在生产环境中使用。

OAuth 2.0 简介

OAuth 2.0 是一种开放标准，用于授权应用程序访问受保护资源。它定义了客户端如何获取访问令牌，以及如何使用这些令牌来访问资源。

JWT (JSON Web Tokens)

JWT 是一种用于在各方之间安全地传输信息的标准格式。JWT 由三部分组成：头部、载荷和签名。JWT 通常用于认证过程，因为它可以包含用户的身份信息，并且可以在客户端和服务器之间传递。

示例：使用 Spring Security 配置 JWT

为了实现 JWT 认证，我们需要配置 Spring Security 并创建 JWT 相关的组件。

首先，在 pom.xml 中添加 Spring Security 依赖：

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-security</artifactId>
</dependency>

接着，创建一个配置类来配置 Spring Security：

package com.example.restapi.config;import com.example.restapi.security.JwtAuthenticationEntryPoint;
import com.example.restapi.security.JwtAuthenticationFilter;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.authentication.AuthenticationManager;
import org.springframework.security.config.annotation.authentication.builders.AuthenticationManagerBuilder;
import org.springframework.security.config.annotation.method.configuration.EnableGlobalMethodSecurity;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
import org.springframework.security.config.http.SessionCreationPolicy;
import org.springframework.security.core.userdetails.UserDetailsService;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.security.crypto.password.PasswordEncoder;
import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter;@Configuration
@EnableWebSecurity
@EnableGlobalMethodSecurity(prePostEnabled = true)
public class SecurityConfig extends WebSecurityConfigurerAdapter {@Autowiredprivate UserDetailsService userDetailsService;@Autowiredprivate JwtAuthenticationEntryPoint unauthorizedHandler;@Beanpublic JwtAuthenticationFilter authenticationJwtTokenFilter() {return new JwtAuthenticationFilter();}@Overridepublic void configure(AuthenticationManagerBuilder authenticationManagerBuilder) throws Exception {authenticationManagerBuilder.userDetailsService(userDetailsService).passwordEncoder(passwordEncoder());}@Bean@Overridepublic AuthenticationManager authenticationManagerBean() throws Exception {return super.authenticationManagerBean();}@Beanpublic PasswordEncoder passwordEncoder() {return new BCryptPasswordEncoder();}@Overrideprotected void configure(HttpSecurity httpSecurity) throws Exception {httpSecurity.cors().and().csrf().disable().exceptionHandling().authenticationEntryPoint(unauthorizedHandler).and().sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS).and().authorizeRequests().antMatchers("/api/auth/**").permitAll().antMatchers("/api/test/**").permitAll().anyRequest().authenticated();httpSecurity.addFilterBefore(authenticationJwtTokenFilter(), UsernamePasswordAuthenticationFilter.class);}
}

还需要创建 JwtAuthenticationFilter 和 JwtAuthenticationEntryPoint 类来处理 JWT 的认证过滤和未授权的请求。

8. 异常处理

自定义异常类

在 RESTful API 中，我们经常需要自定义异常类来处理特定的错误情况。例如，定义一个 BadRequestException：

package com.example.restapi.exception;public class BadRequestException extends RuntimeException {public BadRequestException(String message) {super(message);}
}

全局异常处理器

为了统一处理异常，我们可以创建一个全局异常处理器来捕获并处理异常：

package com.example.restapi.exception;import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.context.request.WebRequest;
import org.springframework.web.servlet.mvc.method.annotation.ResponseEntityExceptionHandler;import java.util.Date;@ControllerAdvice
public class GlobalExceptionHandler extends ResponseEntityExceptionHandler {@ExceptionHandler(value = {BadRequestException.class})public ResponseEntity<Object> handleBadRequest(BadRequestException ex, WebRequest request) {ErrorResponse error = new ErrorResponse(new Date(),ex.getMessage(),request.getDescription(false));return new ResponseEntity<>(error, HttpStatus.BAD_REQUEST);}@Overrideprotected ResponseEntity<Object> handleMethodArgumentNotValid(MethodArgumentNotValidException ex,org.springframework.http.HttpHeaders headers,HttpStatus status,WebRequest request) {ErrorResponse error = new ErrorResponse(new Date(),"Validation Failed",ex.getBindingResult().getAllErrors().get(0).getDefaultMessage());return new ResponseEntity<>(error, HttpStatus.BAD_REQUEST);}
}

示例：处理无效请求

下面是一个处理无效请求的示例：

package com.example.restapi.controller;import com.example.restapi.exception.BadRequestException;
import com.example.restapi.model.User;
import com.example.restapi.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;import javax.validation.Valid;@RestController
@RequestMapping("/api/users")
public class UserController {@Autowiredprivate UserService userService;@PostMappingpublic ResponseEntity<User> createUser(@Valid @RequestBody User user, BindingResult result) {if (result.hasErrors()) {throw new BadRequestException("Invalid user data");}return ResponseEntity.status(201).body(userService.createUser(user));}
}

9. 测试 RESTful API

单元测试

单元测试是为了确保每个函数或方法按预期工作。例如，测试 UserService 中的方法：

package com.example.restapi.service;import com.example.restapi.model.User;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;import static org.junit.jupiter.api.Assertions.assertNotNull;@SpringBootTest
public class UserServiceTests {@Autowiredprivate UserService userService;@Testpublic void testCreateUser() {User user = new User("John Doe", "johndoe@example.com");User createdUser = userService.createUser(user);assertNotNull(createdUser);}
}

集成测试

集成测试是为了确保多个组件一起工作时的行为符合预期。例如，使用 MockMvc 来模拟 HTTP 请求：

package com.example.restapi.controller;import com.example.restapi.model.User;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.test.web.servlet.MockMvc;import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;@WebMvcTest(UserController.class)
public class UserControllerTests {@Autowiredprivate MockMvc mockMvc;@Testpublic void shouldCreateUser() throws Exception {User user = new User("John Doe", "johndoe@example.com");mockMvc.perform(post("/api/users").contentType("application/json").content(objectMapper.writeValueAsString(user))).andExpect(status().isCreated());}
}

使用 MockMvc 进行模拟请求

在上面的测试示例中，我们使用了 MockMvc 来发送 POST 请求，并验证了返回的状态码是否为 201 Created。

这篇关于【实战指南】RESTful 从入门到精通(Spring Boot)的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1119374。

相关文章

在React中引入Tailwind CSS的完整指南

在React中引入Tailwind CSS的完整指南

《在React中引入TailwindCSS的完整指南》在现代前端开发中,使用UI库可以显著提高开发效率,TailwindCSS是一个功能类优先的CSS框架,本文将详细介绍如何在Reac... 目录前言一、Tailwind css 简介二、创建 React 项目使用 Create React App 创建项目
阅读更多...
SpringBoot3实现Gzip压缩优化的技术指南

SpringBoot3实现Gzip压缩优化的技术指南

《SpringBoot3实现Gzip压缩优化的技术指南》随着Web应用的用户量和数据量增加,网络带宽和页面加载速度逐渐成为瓶颈,为了减少数据传输量,提高用户体验,我们可以使用Gzip压缩HTTP响应,... 目录1、简述2、配置2.1 添加依赖2.2 配置 Gzip 压缩3、服务端应用4、前端应用4.1 N
阅读更多...
Java编译生成多个.class文件的原理和作用

Java编译生成多个.class文件的原理和作用

《Java编译生成多个.class文件的原理和作用》作为一名经验丰富的开发者,在Java项目中执行编译后,可能会发现一个.java源文件有时会产生多个.class文件,从技术实现层面详细剖析这一现象... 目录一、内部类机制与.class文件生成成员内部类（常规内部类）局部内部类（方法内部类）匿名内部类二、
阅读更多...
SpringBoot实现数据库读写分离的3种方法小结

SpringBoot实现数据库读写分离的3种方法小结

《SpringBoot实现数据库读写分离的3种方法小结》为了提高系统的读写性能和可用性,读写分离是一种经典的数据库架构模式,在SpringBoot应用中,有多种方式可以实现数据库读写分离,本文将介绍三... 目录一、数据库读写分离概述二、方案一：基于AbstractRoutingDataSource实现动态
阅读更多...
使用Jackson进行JSON生成与解析的新手指南

使用Jackson进行JSON生成与解析的新手指南

《使用Jackson进行JSON生成与解析的新手指南》这篇文章主要为大家详细介绍了如何使用Jackson进行JSON生成与解析处理,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1. 核心依赖2. 基础用法2.1 对象转 jsON（序列化）2.2 JSON 转对象（反序列化）3.
阅读更多...
Springboot @Autowired和@Resource的区别解析

Springboot @Autowired和@Resource的区别解析

《Springboot@Autowired和@Resource的区别解析》@Resource是JDK提供的注解,只是Spring在实现上提供了这个注解的功能支持,本文给大家介绍Springboot@... 目录【一】定义【1】@Autowired【2】@Resource【二】区别【1】包含的属性不同【2】@
阅读更多...
springboot循环依赖问题案例代码及解决办法

springboot循环依赖问题案例代码及解决办法

《springboot循环依赖问题案例代码及解决办法》在SpringBoot中,如果两个或多个Bean之间存在循环依赖（即BeanA依赖BeanB,而BeanB又依赖BeanA）,会导致Spring的... 目录1. 什么是循环依赖？2. 循环依赖的场景案例3. 解决循环依赖的常见方法方法 1：使用 @La
阅读更多...
Java枚举类实现Key-Value映射的多种实现方式

Java枚举类实现Key-Value映射的多种实现方式

《Java枚举类实现Key-Value映射的多种实现方式》在Java开发中,枚举(Enum)是一种特殊的类,本文将详细介绍Java枚举类实现key-value映射的多种方式,有需要的小伙伴可以根据需要... 目录前言一、基础实现方式1.1 为枚举添加属性和构造方法二、http://www.cppcns.co
阅读更多...
Elasticsearch 在 Java 中的使用教程

Elasticsearch 在 Java 中的使用教程

《Elasticsearch在Java中的使用教程》Elasticsearch是一个分布式搜索和分析引擎,基于ApacheLucene构建,能够实现实时数据的存储、搜索、和分析,它广泛应用于全文... 目录1. Elasticsearch 简介2. 环境准备2.1 安装 Elasticsearch2.2 J
阅读更多...
Java中的String.valueOf()和toString()方法区别小结

Java中的String.valueOf()和toString()方法区别小结

《Java中的String.valueOf()和toString()方法区别小结》字符串操作是开发者日常编程任务中不可或缺的一部分,转换为字符串是一种常见需求,其中最常见的就是String.value... 目录String.valueOf()方法方法定义方法实现使用示例使用场景toString()方法方法
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2