构建强大的RESTful API:@RestController与@Controller的对比与应用
构建强大的RESTful API:@RestController与@Controller的对比与应用
- 前言
- 什么是RESTful API
- @RestController,@Controller,@ResponseBody
- 1. `@Controller`注解:
- 2. `@RestController`注解:
- 3. `@ResponseBody`注解:
- 示例
- 非thymeleaf示例实现
- thymeleaf示例实现
前言
你是否曾想过,当您在浏览网页或调用API时,后台是如何处理请求并生成响应的?这就是Spring MVC的任务。在这篇博客中,我们将带您进入Spring MVC的精彩世界,深入探讨
@RestController
、@Controller
和@ResponseBody
注解的工作原理和用法。无论您是初学者还是有经验的开发者,本文都将为您提供清晰的指南,以帮助您构建强大的Web应用程序和RESTful API。
什么是RESTful API
RESTful API(Representational State Transfer API)是一种基于REST架构风格的应用程序接口。它是一种设计理念,旨在使网络应用程序更加简单、可伸缩和易于理解。RESTful API 的核心思想是将资源(Resource)作为核心概念,并通过标准的HTTP方法来对资源进行操作。
以下是关于RESTful API的主要特点和概念:
-
资源(Resource):在RESTful API中,一切皆资源。资源可以是实际的数据对象,也可以是虚拟的概念,如用户、产品、订单等。每个资源都有一个唯一的标识符(通常是URL)。
-
HTTP方法:RESTful API 使用标准的HTTP方法来执行操作。最常用的HTTP方法包括:
- GET:用于检索资源的信息。
- POST:用于创建新资源。
- PUT:用于更新现有资源。
- DELETE:用于删除资源。
-
状态无关性(Statelessness):RESTful API是无状态的,每个请求都包含了足够的信息以便服务器能够理解并处理请求,而不依赖于之前的请求状态。这使得API设计更加简单和可伸缩。
-
URL作为资源标识符:每个资源都由一个唯一的URL标识符来表示。通过URL,客户端可以访问和操作资源。
-
使用HTTP状态码:HTTP状态码用于指示请求的成功或失败以及失败的原因。常见的状态码包括200(成功)、201(已创建)、404(未找到)、500(服务器错误)等。
-
数据格式:RESTful API通常使用JSON或XML等标准数据格式来传递数据。这些格式易于解析和生成,同时具有良好的可读性。
-
无需保存状态(Stateless):RESTful API不需要在服务器端保存客户端的状态信息。每个请求都应包含足够的信息,以便服务器可以理解和处理请求。
-
可伸缩性:由于RESTful API的无状态性和资源导向性,它们通常具有良好的可伸缩性,可以应对高负载和大规模使用。
-
安全性:RESTful API可以使用标准的HTTP安全机制(如HTTPS)来保护通信,同时可以使用认证和授权机制来限制访问资源的权限。
总之,RESTful API是一种使用HTTP协议和REST原则来设计和构建的API。它的目标是使Web服务更加简单、易于理解和可伸缩。由于其广泛的采用和标准化,RESTful API已成为构建现代Web应用程序和移动应用程序的常见方式。
@RestController,@Controller,@ResponseBody
@RestController,@Controller和@ResponseBody是Spring框架中常用的注解,用于构建RESTful Web应用程序。下面详细说明它们的用法和含义:
1. @Controller
注解:
- 含义:
@Controller
注解用于标识一个类是Spring MVC中的控制器。控制器负责处理客户端的请求,并根据请求的信息来调用相应的方法来处理请求和生成响应。 - 使用方法:您需要将这个注解放在一个类的前面,以表明这个类是一个控制器。通常,您还需要在方法级别使用其他注解来指定哪些方法用于处理特定的请求。
2. @RestController
注解:
- 含义:
@RestController
注解是@Controller
的一个特化版本,它结合了@Controller
和@ResponseBody
的功能。它表示这个类的每个方法都会返回一个对象,而不是一个视图,这些对象会被自动序列化为JSON或XML,然后发送给客户端。 - 使用方法:与
@Controller
类似,您需要将这个注解放在一个类的前面,以表明这个类是一个REST控制器。然后,您可以在方法级别使用@RequestMapping
等注解来指定处理不同HTTP请求的方法。
3. @ResponseBody
注解:
- 含义:
@ResponseBody
注解用于指示一个方法的返回值应该被直接写入HTTP响应体中,而不是解析为视图。这通常用于返回JSON、XML或其他数据格式的响应。 - 使用方法:您可以将
@ResponseBody
注解放在一个方法的前面,以表明这个方法的返回值将直接作为HTTP响应的内容。通常,您需要在方法上使用@RequestMapping
等注解来指定请求的URL和HTTP方法。
示例
非thymeleaf示例实现
下面是一个示例,演示了如何在Spring控制器中使用这些注解:
@RestController
@RequestMapping("/api")
public class MyRestController {@GetMapping("/hello")public String sayHello() {return "Hello, World!";}@PostMapping("/add")public ResponseEntity<String> addData(@RequestBody DataObject data) {// 处理请求并返回响应return ResponseEntity.ok("Data added successfully");}
}
在上面的示例中,@RestController
注解表明MyRestController
是一个REST控制器,@GetMapping
和@PostMapping
注解指定了不同的HTTP请求处理方法,而@ResponseBody
注解用于返回直接写入HTTP响应体的数据。同时,@RequestMapping
注解定义了URL映射路径。
thymeleaf示例实现
现在,让我们结合Thymeleaf创建一个示例:
首先,确保您的项目中配置了Thymeleaf模板引擎。然后,创建一个Spring MVC控制器,如下所示:
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;@Controller
public class MyController {@GetMapping("/hello")public String sayHello(Model model) {model.addAttribute("message", "Hello, World!");return "hello"; // 这里返回的是Thymeleaf模板的名称}
}
在上面的示例中,@Controller
注解标识MyController
类为控制器,@GetMapping("/hello")
注解映射了/hello
路径的GET请求。在sayHello
方法中,我们使用了Model
对象来传递数据到视图。
接下来,创建一个Thymeleaf模板,假设模板文件名为hello.html
,并放置在适当的模板目录中:
<!DOCTYPE html>
<html>
<head><title>Hello Page</title>
</head>
<body><h1 th:text="${message}"></h1>
</body>
</html>
在这个模板中,我们使用Thymeleaf的语法来渲染从控制器传递过来的消息。
最后,确保您的Spring配置正确,包括Thymeleaf的模板解析器配置。这样,当用户访问/hello
路径时,Spring MVC将调用sayHello
方法,渲染Thymeleaf模板,并将消息传递到模板中。
这个示例演示了如何结合Spring MVC的注解和Thymeleaf模板引擎来创建一个简单的Web应用程序。确保根据您的项目需要进行配置和扩展。
相关文章:
构建强大的RESTful API:@RestController与@Controller的对比与应用
构建强大的RESTful API:RestController与Controller的对比与应用 前言什么是RESTful APIRestController,Controller,ResponseBody1. Controller注解:2. RestController注解:3. ResponseBody注解: 示例非thy…...
【Java-LangChain:使用 ChatGPT API 搭建系统-10】评估(下)-当不存在一个简单的正确答案时
第十章,评估(下)-当不存在一个简单的正确答案时 在上一章中,了解了如何评估 LLM 模型在 有明确正确答案 的情况下的输出,我们可以编写一个函数来判断 LLM 输出是否正确地分类并列出产品。 然而,如果 LLM …...
【微服务的集成测试】python实现-附ChatGPT解析
1.题目 微服务的集成测试 知识点:深搜 时间限制: 1s 空间限制: 256MB 限定语言:不限 题目描述: 现在有n个容器服务,服务的启动可能有一定的依赖性 (有些服务启动没有依赖)其次服务自身启动加载会消耗一些时间。 给你一个 nxn 的二维矩阵 useTime,其中 useTime[i][i]=10 表示…...

Mesa新版来袭
Mesa 17.1.6 发布了,Mesa 是一个三维(3D)图形库的开源集合,其主要目标是在 Linux / UNIX 操作系统下实现各种 API(应用程序编程接口)和 OpenGL 规范。 它面向 3D 计算机图形,硬件加速 3D 渲染和…...

基于 SpringBoot 2.7.x 使用最新的 Elasticsearch Java API Client 之 ElasticsearchClient
1. 从 RestHighLevelClient 到 ElasticsearchClient 从 Java Rest Client 7.15.0 版本开始,Elasticsearch 官方决定将 RestHighLevelClient 标记为废弃的,并推荐使用新的 Java API Client,即 ElasticsearchClient. 为什么要将 RestHighLevelC…...
辅助驾驶功能开发-功能对标篇(15)-NOA领航辅助系统-吉利
1.横向对标参数 厂商吉利车型FX11/EX11/DCY11/G636上市时间2022Q4方案6V5R+1DMS摄像头前视摄像头1*(8M)侧视摄像头/后视摄像头1环视摄像头4DMS摄像头1雷达毫米波雷达54D毫米波雷达/超声波雷达12激光雷达/域控供应商福瑞泰克辅助驾驶软件供应商福瑞泰克高精度地图百度芯片TDA4 T…...

javascript: Sorting Algorithms
// Sorting Algorithms int JavaScript https://www.geeksforgeeks.org/sorting-algorithms/ /** * file Sort.js * 1. Bubble Sort冒泡排序法 * param arry * param nszie */ function BubbleSort(arry, nszie) {var i, j, temp;var swapped;for (i 0; i < nszie - 1; i)…...

嵌入式Linux应用开发-驱动大全-同步与互斥④
嵌入式Linux应用开发-驱动大全-同步与互斥④ 第一章 同步与互斥④1.5 自旋锁spinlock的实现1.5.1 自旋锁的内核结构体1.5.2 spinlock在UP系统中的实现1.5.3 spinlock在SMP系统中的实现 1.6 信号量semaphore的实现1.6.1 semaphore的内核结构体1.6.2 down函数的实现1.6.3 up函数的…...

2023年【高压电工】证考试及高压电工复审模拟考试
题库来源:安全生产模拟考试一点通公众号小程序 高压电工证考试根据新高压电工考试大纲要求,安全生产模拟考试一点通将高压电工模拟考试试题进行汇编,组成一套高压电工全真模拟考试试题,学员可通过高压电工复审模拟考试全真模拟&a…...

C/C++学习 -- 分组密算法(3DES算法)
1. 3DES算法概述 3DES(Triple Data Encryption Standard),又称为TDEA(Triple Data Encryption Algorithm),是一种对称加密算法,是DES(Data Encryption Standard)的加强版…...
C/C++面试题总结
1.new与malloc的区别 new操作符从自由存储区上为对象动态分配内存空间,而malloc函数从堆上动态分配内存。 使用new操作符申请内存分配时无须指定内存块的大小,而malloc则需要显式地指出所需内存的尺寸。 int *p new int; delete p;//一定要配对使用n…...

Java下正面解除警告Unchecked cast: ‘java.lang.Object‘ to ‘java.util.ArrayList‘
就是我在反序列化时,遇到这样一个警告: Unchecked cast: java.lang.Object to java.util.ArrayList<com.work1.Student>然后我去网上查,有些人说用SuppressWarnings(“unchecked”)去忽略警告,但是我觉得作为一名合格的程序…...

图像处理与计算机视觉--第四章-图像滤波与增强-第二部分
目录 1.图像噪声化处理与卷积平滑 2.图像傅里叶快速变换处理 3.图像腐蚀和膨胀处理 4 图像灰度调整处理 5.图像抖动处理算法 学习计算机视觉方向的几条经验: 1.学习计算机视觉一定不能操之过急,不然往往事倍功半! 2.静下心来,理解每一个…...
[前端基础]typescript安装以及类型拓展
(0)写在前面: 作者之前都是在写js,所以这里介绍ts肯定是不能从头开始介绍了,主要在js的基础上介绍ts关于类型的几个特性,以及ts的安装还有配置问题 (1)ts和js是什么关系 通俗点来…...
网络参考资料汇总(1)
将这段时间参考的各路大佬的资料加以汇总分类: (1)FFmpeg: 基于FFmpeg进行rtsp推流及拉流(详细教程) Linux 编译安装 FFmpeg 步骤(带ffplay) Jetson 环境安装(三):jetson nano配置ffmpeg和ngin…...
Remove和RemoveLast用法
LeetCode 46 全排列 先贴代码 class Solution {List<List<Integer>> result new ArrayList<>();List<Integer> temp new ArrayList<>();public List<List<Integer>> permute(int[] nums) {dfs(nums, 0);return result;}public v…...

(一) 使用 Hugo 搭建个人博客保姆级教程(上篇)
手把手教你如何从0开始构建一个静态网站,这不需要有太多的编程和开发经验和时间投入,也基本不需要多少成本(除了个性化域名),使用GitHub和Hugo模板即可快速构建和上线一个网站。 目标读者 本文档适用于以下用户&…...

数据结构之栈
栈的模拟实现 1.栈的概念2.栈的方法3.栈的模拟实现(代码)3.1 接口My_Stack3.2 StackList3.3 异常类StackException3.4 测试类Test 1.栈的概念 2.栈的方法 3.栈的模拟实现(代码) 3.1 接口My_Stack 3.2 StackList 3.3 异常类StackException 3.4 测试类Test...

wireshark of tshark tools v3.4.0版本 支持json
tshark(1) Install tshark (Wireshark) Ver.3.4.0 on CentOS7 --It must be "ps", "text", "pdml", "psml" or "fields". TCP 协议中的三次握手和四次挥手是 TCP 连接建立和关闭的过程。 三次握手 客户端向服务器发送 SYN…...

Python开源项目月排行 2023年9月
#2023年9月2023年9月9日1fishdraw这个项目是用来随机生成一条鱼的,这条鱼特别的稀奇古怪,这个项目不依赖任何库,支持 svg, json, csv 等格式。2vizro一个用于创建模块化数据可视化应用程序的工具包。在几分钟内快速自助组装定制仪表板 - 无需…...

CMake基础:构建流程详解
目录 1.CMake构建过程的基本流程 2.CMake构建的具体步骤 2.1.创建构建目录 2.2.使用 CMake 生成构建文件 2.3.编译和构建 2.4.清理构建文件 2.5.重新配置和构建 3.跨平台构建示例 4.工具链与交叉编译 5.CMake构建后的项目结构解析 5.1.CMake构建后的目录结构 5.2.构…...

智能在线客服平台:数字化时代企业连接用户的 AI 中枢
随着互联网技术的飞速发展,消费者期望能够随时随地与企业进行交流。在线客服平台作为连接企业与客户的重要桥梁,不仅优化了客户体验,还提升了企业的服务效率和市场竞争力。本文将探讨在线客服平台的重要性、技术进展、实际应用,并…...

P3 QT项目----记事本(3.8)
3.8 记事本项目总结 项目源码 1.main.cpp #include "widget.h" #include <QApplication> int main(int argc, char *argv[]) {QApplication a(argc, argv);Widget w;w.show();return a.exec(); } 2.widget.cpp #include "widget.h" #include &q…...
Caliper 配置文件解析:config.yaml
Caliper 是一个区块链性能基准测试工具,用于评估不同区块链平台的性能。下面我将详细解释你提供的 fisco-bcos.json 文件结构,并说明它与 config.yaml 文件的关系。 fisco-bcos.json 文件解析 这个文件是针对 FISCO-BCOS 区块链网络的 Caliper 配置文件,主要包含以下几个部…...
浅谈不同二分算法的查找情况
二分算法原理比较简单,但是实际的算法模板却有很多,这一切都源于二分查找问题中的复杂情况和二分算法的边界处理,以下是博主对一些二分算法查找的情况分析。 需要说明的是,以下二分算法都是基于有序序列为升序有序的情况…...

智能分布式爬虫的数据处理流水线优化:基于深度强化学习的数据质量控制
在数字化浪潮席卷全球的今天,数据已成为企业和研究机构的核心资产。智能分布式爬虫作为高效的数据采集工具,在大规模数据获取中发挥着关键作用。然而,传统的数据处理流水线在面对复杂多变的网络环境和海量异构数据时,常出现数据质…...
Android第十三次面试总结(四大 组件基础)
Activity生命周期和四大启动模式详解 一、Activity 生命周期 Activity 的生命周期由一系列回调方法组成,用于管理其创建、可见性、焦点和销毁过程。以下是核心方法及其调用时机: onCreate() 调用时机:Activity 首次创建时调用。…...

解析奥地利 XARION激光超声检测系统:无膜光学麦克风 + 无耦合剂的技术协同优势及多元应用
在工业制造领域,无损检测(NDT)的精度与效率直接影响产品质量与生产安全。奥地利 XARION开发的激光超声精密检测系统,以非接触式光学麦克风技术为核心,打破传统检测瓶颈,为半导体、航空航天、汽车制造等行业提供了高灵敏…...

通过 Ansible 在 Windows 2022 上安装 IIS Web 服务器
拓扑结构 这是一个用于通过 Ansible 部署 IIS Web 服务器的实验室拓扑。 前提条件: 在被管理的节点上安装WinRm 准备一张自签名的证书 开放防火墙入站tcp 5985 5986端口 准备自签名证书 PS C:\Users\azureuser> $cert New-SelfSignedCertificate -DnsName &…...

实战设计模式之模板方法模式
概述 模板方法模式定义了一个操作中的算法骨架,并将某些步骤延迟到子类中实现。模板方法使得子类可以在不改变算法结构的前提下,重新定义算法中的某些步骤。简单来说,就是在一个方法中定义了要执行的步骤顺序或算法框架,但允许子类…...