8、《5分钟构建RESTful API：Spring Boot Web开发入门》
5分钟构建RESTful API：Spring Boot Web开发入门
一、RESTful API核心认知
REST（Representational State Transfer）通过HTTP协议实现资源操作，其核心特征包括：
- 资源以URI标识（
/api/users） - 通过HTTP方法表达操作语义（GET/POST/PUT/DELETE）
- 无状态通信
- 返回标准状态码（200/404/500等）
二、项目快速搭建
使用Spring Initializr创建项目：
<!-- pom.xml核心依赖 -->
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>1.18.30</version>
</dependency>
三、@RestController深度实践
3.1 基础控制器
@RestController
@RequestMapping("/api/users")
public class UserController {// 模拟内存数据库private Map<Long, User> users = new ConcurrentHashMap<>();@GetMapping("/{id}")public User getUser(@PathVariable Long id) {return users.get(id);}
}
3.2 完整CRUD示例
@PostMapping
public ResponseEntity<Void> createUser(@RequestBody User user) {users.put(user.getId(), user);return ResponseEntity.created(URI.create("/users/"+user.getId())).build();
}@PutMapping("/{id}")
public ResponseEntity<User> updateUser(@PathVariable Long id, @RequestBody User user) {if (!users.containsKey(id)) {return ResponseEntity.notFound().build();}users.put(id, user);return ResponseEntity.ok(user);
}@DeleteMapping("/{id}")
public ResponseEntity<Void> deleteUser(@PathVariable Long id) {users.remove(id);return ResponseEntity.noContent().build();
}
四、统一响应封装
4.1 响应体标准化
@Data
public class ApiResponse<T> {private int code; // 业务状态码private String message; // 提示信息private T data; // 业务数据private long timestamp; // 响应时间戳public ApiResponse(int code, String message, T data) {this.code = code;this.message = message;this.data = data;this.timestamp = System.currentTimeMillis();}// 快速构建成功响应public static <T> ApiResponse<T> success(T data) {return new ApiResponse<>(200, "Success", data);}
}
4.2 控制器改造示例
@GetMapping("/{id}")public ResponseEntity<ApiResponse<User>> getUser(@PathVariable Integer id) {User user = users.get(id);if (user == null) {return ResponseEntity.status(HttpStatus.NOT_FOUND).body(new ApiResponse<>(404, "User NOT exists", null));}return ResponseEntity.status(HttpStatus.OK).body(ApiResponse.success(user));}
五、全局异常处理
@ControllerAdvice
public class GlobalExceptionHandler {@ExceptionHandler(Exception.class)@ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)public ApiResponse<Void> handleGlobalException(Exception ex) {return new ApiResponse<>(500, "Server Error: " + ex.getMessage(), null);}
}
六、HTTP状态码精准控制
6.1 状态码使用规范
| 状态码 | 使用场景 |
|---|---|
| 200 OK | 常规成功请求 |
| 201 Created | 资源创建成功 |
| 204 No Content | 成功无返回体 |
| 400 Bad Request | 请求参数错误 |
| 401 Unauthorized | 未认证 |
| 403 Forbidden | 无权限访问 |
| 404 Not Found | 资源不存在 |
| 500 Internal Server Error | 服务器内部错误 |
6.2 状态码实战应用
@PostMapping
public ResponseEntity<ApiResponse<User>> createUser(@Valid @RequestBody User user) {if (users.containsKey(user.getId())) {return ResponseEntity.status(HttpStatus.CONFLICT).body(new ApiResponse<>(409, "User already exists", null));}users.put(user.getId(), user);return ResponseEntity.status(HttpStatus.CREATED).body(ApiResponse.success(user));
}
项目结构参考：
src/main/java
└── com.example.demo├── config # 配置类├── controller # 控制器层├── exception # 自定义异常├── model # 数据模型└── response # 响应封装└── Application # 启动类
本文完整源码：
通过标准化响应封装、精确的状态码控制和全局异常处理，开发者可以快速构建出符合RESTful规范的健壮API。这种设计模式不仅提升接口的可维护性，更能显著降低前后端联调成本。后续可结合Spring Data JPA、Redis等组件构建完整的企业级应用。
相关文章：
8、《5分钟构建RESTful API：Spring Boot Web开发入门》
5分钟构建RESTful API：Spring Boot Web开发入门 一、RESTful API核心认知 REST（Representational State Transfer）通过HTTP协议实现资源操作，其核心特征包括： 资源以URI标识（/api/users）通过…...
【Java八股文】01-Java基础面试篇
【Java八股文】01-Java基础面试篇 概念Java特点Java为什么跨平台JVM、JDK、JRE关系 面向对象什么是面向对象，什么是封装继承多态？多态体现的方面面向对象设计原则重载重写的区别抽象类和实体类区别Java抽象类和接口的区别抽象类可以被实例化吗 深拷贝浅拷…...
读取本地excel删除第一行，并生成List数组
在 pom.xml 里添加如下依赖： <dependencies><dependency><groupId>org.apache.poi</groupId><artifactId>poi</artifactId><version>5.2.3</version></dependency><dependency><groupId>org.ap…...
【核心特性】Go 模块化开发入门（go mod 深度解析）
Go 模块化开发入门（go mod 深度解析） 一、引言 在 Go 语言的开发过程中，随着项目规模的不断扩大，依赖管理变得愈发重要。Go Modules 作为 Go 语言官方的依赖管理工具，自 Go 1.11 版本引入后，极大地简化了项…...
【新品解读】AI 应用场景全覆盖！解码超高端 VU+ FPGA 开发平台 AXVU13F
「AXVU13F」Virtex UltraScale XCVU13P Jetson Orin NX 继发布 AMD Virtex UltraScale FPGA PCIE3.0 开发平台 AXVU13P 后，ALINX 进一步研究尖端应用市场，面向 AI 场景进行优化设计，推出 AXVU13F。 AXVU13F 和 AXVU13P 采用相同的 AMD Vir…...
Flask和Django相比哪个更适合新手？
Flask 与 Django：哪个更适合新手？ 对于新手来说，选择 Flask 还是 Django 主要取决于你的具体需求和项目复杂度。以下是两者的详细对比，帮助你做出选择： 1. Flask 优点 简单易用：Flask 是一个轻量级的微框架，代码简洁，易于理解和上手。适合初学者快速入门。灵活性高：…...
高通android WIFI debug
参考高通文档：80-76240-16_REV_AA_Wi-Fi_Debug_Techniques 大纲 一、 WLAN Debug Logs –logcat ■ Logcat log logcat is a command-line tool that dumps the log of system messages, ■ Including stack traces when the device throws an error. ■ Need t…...
ADC 的音频实验,无线收发模块（ nRF24L01）
nRF24L01 采用 QFN20 封装，有 20 个引脚，以下是各引脚的详细介绍： 1. 电源引脚 ◦ VDD：电源输入端，一般接 3V 电源，为芯片提供工作电压，供电电压范围为 1.9V～3.6V。 ◦ VSS…...
Swagger2 Knife4jConfig 配置,父子项目swagger扫描多个子模块中的Controller生成接口文档:
问题: 需求父子项目swagger扫描多个子模块中的Controller生成接口文档: Swagger2Knife4jConfig 配置放在了 springboot-app 启动项目里，而 tiger-web 和 tiger-web2 这两个子项目有自己的 Controller。这种情况下，Swagger 可能无法正确扫描 tiger-web 和…...
Unity UI 道路线跟随：让图标沿道路轨迹移动
在 Unity UI 开发中，有时需要让图标沿着一条道路轨迹移动，比如地图上的车辆行驶动画、导航路径指示等。本文介绍如何基于 UI 图片中的道路线生成曲线，并使用 Slider 控制图标沿轨迹运动，适用于 UI 导航、路径跟随动画等场景。 1. …...
Springboot核心：拦截器
拦截器是 Spring 框架提供的核心功能之一,属于一种设计模式，它允许在某个方法调用或请求处理前后执行自定义逻辑，是一种AOP（面向切面编程）机制。它们可以在不修改原有业务逻辑的情况下，对进入系统的请求进行预处理和后…...
【AI学习笔记】基于Unity+DeepSeek开发的一些BUG记录解决方案
【AI学习笔记】基于UnityDeepSeek开发的一些BUG记录&解决方案 背景前摇：（省流可不看） Unity是大学学的，AI是研究生学的，DeepSeek是第一份实习偷师的，三合一的梦是最近开始做的，BUG是今天遇…...
六西格玛设计培训如何破解风电设备制造质量与成本困局
2023年，中国风电行业装机容量突破4.3亿千瓦，稳居全球第一，但高速扩张背后暗藏隐忧： 质量痛点：叶片开裂、齿轮箱故障等缺陷频发，运维成本占项目全生命周期成本超30%；成本压力：原材料…...
xml 和json互转工具
工具1 有个问题会导致springboot返回捕获的异常编程xml格式 import com.fasterxml.jackson.databind.ObjectMapper; import com.fasterxml.jackson.dataformat.xml.XmlMapper; import org.json.JSONObject; import org.json.XML; import org.w3c.dom.Document;import javax.xm…...
【STM32】舵机SG90
1.舵机原理 舵机内部有一个电位器，当转轴随电机旋转，电位器的电压会发生改变，电压会带动转一定的角度，舵机中的控制板就会电位器输出的电压所代表的角度，与输入的PWM所代表的角度进行比较，从而得出一个旋转…...
【RK3588嵌入式图形编程】-SDL2-鼠标输入处理
鼠标输入处理 文章目录 鼠标输入处理1、概述2、鼠标移动事件3、鼠标点击事件4、鼠标点击位置5、鼠标双击6、鼠标进入和离开事件7、总结在本文中，将介绍如何在 SDL2 中检测和处理鼠标输入事件，包括鼠标移动、按钮点击以及窗口进入/退出。 1、概述 在本文中，我们将详细介绍如…...
知识管理成功：关键指标和策略，研究信息的投资回报率
信息过载会影响生产力。没有人工智能的帮助，信息过载会影响生产力。大量的可用信息，知识工作者不仅仅是超负荷工作；他们感到不知所措，他们倾向于浪费时间（和脑细胞）来应付他们被大量的数据抛向他们…...
Linux权限提升-内核溢出
一：Web到Linux-内核溢出Dcow 复现环境：https://www.vulnhub.com/entry/lampiao-1,249/ 1.信息收集：探测⽬标ip及开发端⼝ 2.Web漏洞利⽤： 查找drupal相关漏洞 search drupal # 进⾏漏洞利⽤ use exploit/unix/webapp/drupal_dr…...
Bootstrap5 折叠功能详解
Bootstrap5 折叠功能详解 引言 Bootstrap 是一个流行的前端框架，它提供了许多组件和工具，使得开发者可以轻松构建响应式网站。在 Bootstrap5 中，折叠（Collapse）组件得到了增强，使其更加灵活和易于使用。本…...
JAVA：Spring Boot 项目中自定义 Banner 的技术指南
1、简述 在 Spring Boot 项目中，当应用启动时会显示默认的 Spring 标志和版本信息。定制化的启动 Banner 不仅可以美化应用，还能在项目中增加个性化的品牌印记，甚至可以提供一些关键信息。本文将介绍如何在 Spring Boot 项目中自定义启动 Ba…...
【虚幻引擎UE】UE4.23到UE5.5的核心功能变化
简单总结从UE4.23到UE5.5，虚幻引擎的重大变化： 1. WebGL/HTML5 平台支持和像素流 UE4.23-UE4.25：移除官方HTML5支持，改为社区插件维护。 但通过第三方插件（如WebAssemblyWebGPU）可在浏览器运行部分项目。U…...
信号检测和信道均衡的联系
1. 系统模型 假设一个通信系统的数学模型如下： 发送信号： s [ s 1 , s 2 , … , s N ] T \mathbf{s} [s_1, s_2, \dots, s_N]^T s[s1,s2,…,sN]T，其中 s i s_i si 是发送符号。信道矩阵： H \mathbf{H} H（…...
在WPS中通过JavaScript宏（JSA）调用本地DeepSeek API优化文档教程
既然我们已经在本地部署了DeepSeek，肯定希望能够利用本地的模型对自己软件开发、办公文档进行优化使用，接下来就先在WPS中通过JavaScript宏（JSA）调用本地DeepSeek API优化文档的教程奉上。 前提： （1）已经部署好了DeepSeek，可以看我的文章：个人windows电脑上安装DeepSe…...
26、深度学习-自学之路-NLP自然语言处理-理解加程序，怎么把现实的词翻译给机器识别。
一、怎么能让机器能够理解我们的语言呢，我们可以利用神经网络干很多的事情，那么我们是不是也可以用神经元做自然语言处理呢，现在很多的实际应用已经说明了这个问题，可以这么做。 那我们考虑一下该怎么做，首先我们应该…...
微信服务号推送消息
这里如果 没有 就需要点新的功能去申请一下 申请成功之后就可以设置模版消息 推送到用户接受的页面是 需要后端调用接口 传递token 发送给客户...
Excel常用操作
Excel常用操作 学习资源 37_电子表格处理考点精讲_设置数据格式_哔哩哔哩_bilibili 快速输入数据与编辑数据 一个工作簿可以包含多个工作表 特殊数据的添加格式 输入负数, 例如-3、-5 常规输入, 直接输入-3、-5;使用(), 例如在单元格中输入(3)回车即可变为-3;上述括号不区分中…...
得物端智能视频封面推荐
一、背景 什么要做智能封面？ 用户可以在得物购物，也可以在得物社区分享自己的生活。 得物社区中的视频使用双列流，每条内容包含封面、标题等。 对得物社区的创作者而言，选择视频封面是创作链路的重要环节。对得物社区的消费者…...
【Stable Diffusion部署至GNU/Linux】安装流程
以下是安装Stable Diffusion的步骤，以Ubuntu 22.04 LTS为例子。 显卡与计算架构介绍 CUDA是NVIDIA GPU的专用并行计算架构 技术层级说明CUDA Toolkit提供GPU编译器(nvcc)、数学库(cuBLAS)等开发工具cuDNN深度神经网络加速库（需单独下载）GPU驱动包含CUDA Driver（需与CUDA …...
介绍 Liquibase、Flyway、Talend 和 Apache NiFi：选择适合的工具
在现代软件开发中，尤其是在数据库管理和数据集成方面，选择合适的工具至关重要。本文将介绍四个流行的工具：Liquibase、Flyway、Talend 和 Apache NiFi，分析它们的应用、依赖以及如何选择适合的工具。 1. Liquibase 简介ÿ…...
Unity 接入Tripo 文生模型，图生模型
官方网站：https://www.tripo3d.ai/app/home自行注册账号并且登陆下载Unity插件：https://cdn-web.tripo3d.ai/plugin/tripo-unity.zip申请apikey： https://platform.tripo3d.ai/api-keys使用（后续过程就按照第二步下载的插件里面的…...
黑马Redis详细笔记（实战篇---短信登录）
目录 一.短信登录 1.1 导入项目 1.2 Session 实现短信登录 1.3 集群的 Session 共享问题 1.4 基于 Redis 实现共享 Session 登录 一.短信登录 1.1 导入项目 数据库准备 -- 创建用户表 CREATE TABLE user (id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 用户ID,phone …...
Unity 增量打包AssetBundle
背景 打包太慢了，想要没改动的资源不重新打包浪费时间。 来源 官方文章：https://forum.unity.com/threads/about-incremental-build-and-asset-bundle-hashes.1436032/ 官网AB介绍：https://learn.unity.com/tutorial/assets-resources-and…...
前端 TypeError 错误永久消失术
作者：来自 vivo 互联网大前端团队- Sun Maobin 通过开发 Babel 插件，打包时自动为代码添加 可选链运算符(?.)，从而有效避免 TypeError 的发生。 一、背景介绍 在 JS 中当获取引用对象为空值的属性时，程序会立即终止运行并报错&…...
【视频总结】Deep Dive into LLMs like ChatGPT 深入探索像ChatGPT这样的大语言模型｜Andrej Karpathy
【视频总结】Deep Dive into LLMs like ChatGPT 深入探索像ChatGPT这样的大语言模型｜Andrej Karpathy 大型语言模型（LLM）工作原理与使用指南核心观点模型训练三阶段1. 预训练阶段2. 后训练阶段（Post-training）3. 强化学…...
内网ip网段记录
1.介绍 常见的内网IP段有： A类： 10.0.0.0/8 大型企业内部网络（如 AWS、阿里云） 10.0.0.0 - 10.255.255.255 B类：172.16.0.0/12 中型企业、学校 172.16.0.0 - 172.31.255.255 C类：192.168.0.0/16 家庭…...
本地部署DeepSeek + AnythingLLM 搭建高效安全的个人知识库
环境准备： 本地部署方案请参考博客：windows平台本地部署DeepSeek大模型+Open WebUI网页界面（可以离线使用）-CSDN博客 windows平台本地部署DeepSeek大模型+Chatbox界面（可以离线使用）-CSDN博客 根据本人电脑配置：windows11 + i9-13900HX+RTX4060+DDR5 5600 32G内存 确…...
Xcode证书密钥导入
证书干嘛用 渠道定期会给xcode证书，用来给ios打包用，证书里面有记录哪些设备可以打包进去。 怎么换证书 先更新密钥 在钥匙串访问中，选择系统。(选登录也行，反正两个都要导入就是了)。 mac中双击所有 .p12 后缀的密钥ÿ…...
机械学习基础-5.分类-数据建模与机械智能课程自留
data modeling and machine intelligence - CLASSIFICATION 为什么我们不将回归技术用于分类？贝叶斯分类器（The Bayes Classifier）逻辑回归（Logistic Regression）对逻辑回归的更多直观理解逻辑 /sigmoid 函数的导数我们…...
springcloud集成gateway
本篇文章只介绍gateway模块的搭建步骤，并无gateway详细介绍 gateway详解请查看：SpringCloudGateway官方文档详解 前置处理 父模块中已指定版本 不知道如何选择版本看这篇： 手把手教你梳理springcloud与springboot与springcloudalibaba的版本…...
RocketMQ之偏移量Offset
偏移量：偏移量是 ConsumerQueue 文件中的逻辑位置，表示消息在队列中的顺序。每次消费通过偏移量在索引文件ConsumerQueue中快速找到对应的消息内容。 1.Broker端 Broker端主要通过ConsumerManageProcessor类来处理Offset的更新查询的请求，真…...
2024-2025年主流的开源向量数据库推荐
以下是2024-2025年主流的开源向量数据库推荐，涵盖其核心功能和应用场景： 1. Milvus 特点：专为大规模向量搜索设计，支持万亿级向量数据集的毫秒级搜索，适用于图像搜索、聊天机器人、化学结构搜索等场景。采用无状态架…...
和基础的操作 部署实操篇)
Redis 集群(Cluster)和基础的操作 部署实操篇
三主三从 集群概念 Redis 的哨兵模式，提高了系统的可用性，但是正在用来存储数据的还是 master 和 slave 节点，所有的数据都需要存储在单个 master 和 salve 节点中。 如果数据量很大，接近超出了 master / slave 所在机器的物理内…...
RTD2775QT/RTD2795QT瑞昱显示器芯片方案
RTD2775QT与RTD2795QT：高性能4K显示驱动芯片 RTD2775QT与RTD2795QT是瑞昱半导体公司推出的两款高性能显示驱动芯片，专为满足现代显示设备对高清、高分辨率的需求而设计。这两款芯片不仅支持4K分辨率，还具备丰富的功能和卓越的性能࿰…...
Java进阶面试题
Java 进阶面试问题列表翻译自Java developer interview questions: The hard part，从属于笔者的Java入门与工程实践系列。最近公司打算招几个 Java 开发人员，正巧在 Reddit 上看到了该文，顺手翻译了一波。只是单纯的问题列表，可能…...
Spring Cloud-Sentinel
Sentinel服务熔断与限流 Sentinel 是面向分布式、多语言异构化服务架构的流量治理组件，主要以流量为切入点，从流量控制、流量路由、熔断降级、系统自适应保护等多个维度来帮助用户保障微服务的稳定性。 官网地址：home | Sentinelhttps://sen…...
21道关于Vue3的面试题及其解析
Vue 3是一种流行的JavaScript框架，它是Vue.js的第三个主要版本，于2020年9月18日正式发布。关于Vue 3的一些关键信息： 文章目录 1. 性能优化2. 组合式API（Composition API）3. 响应式系统改进4. 更好的TypeScript支持5. …...
 开发 Python 图形界面程序)
使用 Visual Studio Code (VS Code) 开发 Python 图形界面程序
安装Python、VS Code Documentation for Visual Studio Code Python Releases for Windows | Python.org 更新pip >python.exe -m pip install --upgrade pip Requirement already satisfied: pip in c:\users\xxx\appdata\local\programs\python\python312\lib\site-pa…...
深入理解 MyBatis 框架的核心对象：SqlSession
Mybatis框架中的SqlSession对象详解 引言 MyBatis 是一个优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息࿰…...
day09_实时类标签/指标
文章目录 day09_实时类标签/指标一、日志数据实时采集2、Flume简介2.3 项目日志数据采集Flume配置2.3.1 涉及的Flume组件和参数2.3.2 Nginx日志采集2.3.3 用户行为日志采集 二、Nginx日志数据统计1、日志格式说明2、数据ETL2.1 日志抽取2.1.1 正则表达式2.1.2 基于Spark实现Ngi…...
 - JS Http 应用程序)
AWTK-WEB 快速入门(4) - JS Http 应用程序
XMLHttpRequest 改变了 Web 应用程序与服务器交换数据的方式，fetch 是 XMLHttpRequest 继任者，具有更简洁的语法和更好的 Promise 集成。本文介绍一下如何使用 JS 语言开发 AWTK-WEB 应用程序，并用 fetch 访问远程数据。 用 AWTK Designer 新…...