首页 > 其他分享 >Spring Boot中的RESTful API详细介绍及使用

Spring Boot中的RESTful API详细介绍及使用

时间:2024-06-12 10:33:47浏览次数:23  
标签:Spring Boot id API GetMapping User ResponseEntity public user

在Spring Boot中,RESTful API的实现通过控制器类中的方法和特定的注解来完成。每个注解对应不同的HTTP请求方法,并通过处理请求参数和返回响应来实现不同的操作。

下面将详细解释RESTful API中的各个方面,包括@GetMapping, @PostMapping, @PutMapping, 和 @DeleteMapping的作用及区别、请求参数和返回参数。

作用及区别

  1. @GetMapping:

    • 作用: 处理HTTP GET请求,用于获取资源。通常用于读取数据,不应更改服务器上的资源。
    • 区别: 是幂等的,多次请求相同资源不会改变服务器状态。
    • 示例:
      @GetMapping("/users")
      public List<User> getAllUsers() {
          // 获取所有用户
      }
      
      @GetMapping("/users/{id}")
      public User getUserById(@PathVariable Long id) {
          // 获取指定ID的用户
      }
      
  2. @PostMapping:

    • 作用: 处理HTTP POST请求,用于创建新资源。通常用于提交数据,服务器会创建新的资源。
    • 区别: 不是幂等的,多次请求会创建多个资源。
    • 示例:
      @PostMapping("/users")
      public User createUser(@RequestBody User user) {
          // 创建新用户
      }
      
  3. @PutMapping:

    • 作用: 处理HTTP PUT请求,用于更新资源。通常用于更新现有资源的全部内容。
    • 区别: 是幂等的,多次请求相同资源会导致相同的更新结果。
    • 示例:
      @PutMapping("/users/{id}")
      public User updateUser(@PathVariable Long id, @RequestBody User user) {
          // 更新指定ID的用户
      }
      
  4. @DeleteMapping:

    • 作用: 处理HTTP DELETE请求,用于删除资源。通常用于删除服务器上的资源。
    • 区别: 是幂等的,多次请求相同资源删除操作只会导致资源被删除一次。
    • 示例:
      @DeleteMapping("/users/{id}")
      public void deleteUser(@PathVariable Long id) {
          // 删除指定ID的用户
      }
      

请求参数

  1. @RequestBody:

    • 作用: 将请求体中的JSON数据绑定到方法参数上。
    • 使用场景: 常用于@PostMapping@PutMapping
    • 示例:
      @PostMapping("/users")
      public User createUser(@RequestBody User user) {
          // 请求体中的JSON数据将绑定到user对象
      }
      
  2. @PathVariable:

    • 作用: 将URL路径中的变量绑定到方法参数上。
    • 使用场景: 常用于@GetMapping, @PutMapping, 和 @DeleteMapping
    • 示例:
      @GetMapping("/users/{id}")
      public User getUserById(@PathVariable Long id) {
          // URL中的id将绑定到方法参数id
      }
      
  3. @RequestParam:

    • 作用: 将查询参数绑定到方法参数上。
    • 使用场景: 适用于各种HTTP方法。
    • 示例:
      @GetMapping("/users")
      public List<User> getUsersByAge(@RequestParam int age) {
          // URL中的查询参数age将绑定到方法参数age
      }
      

返回参数

  1. 返回对象:

    • 作用: 方法可以直接返回对象,Spring Boot会自动将其转换为JSON格式。
    • 示例:
      @GetMapping("/users/{id}")
      public User getUserById(@PathVariable Long id) {
          // 返回User对象,自动转换为JSON
      }
      
  2. ResponseEntity:

    • 作用: 可以自定义HTTP响应状态码、响应头和响应体。
    • 示例:
      @PostMapping("/users")
      public ResponseEntity<User> createUser(@RequestBody User user) {
          User createdUser = userService.createUser(user);
          return ResponseEntity.status(HttpStatus.CREATED).body(createdUser);
      }
      

综合示例

@RestController
@RequestMapping("/api/users")
public class UserController {

    @GetMapping
    public List<User> getAllUsers() {
        // 获取所有用户
        return userService.findAll();
    }

    @GetMapping("/{id}")
    public ResponseEntity<User> getUserById(@PathVariable Long id) {
        User user = userService.findById(id);
        if (user == null) {
            return ResponseEntity.notFound().build();
        }
        return ResponseEntity.ok(user);
    }

    @PostMapping
    public ResponseEntity<User> createUser(@RequestBody User user) {
        User createdUser = userService.createUser(user);
        return ResponseEntity.status(HttpStatus.CREATED).body(createdUser);
    }

    @PutMapping("/{id}")
    public ResponseEntity<User> updateUser(@PathVariable Long id, @RequestBody User user) {
        User updatedUser = userService.updateUser(id, user);
        if (updatedUser == null) {
            return ResponseEntity.notFound().build();
        }
        return ResponseEntity.ok(updatedUser);
    }

    @DeleteMapping("/{id}")
    public ResponseEntity<Void> deleteUser(@PathVariable Long id) {
        userService.deleteUser(id);
        return ResponseEntity.noContent().build();
    }
}

总结

Spring Boot中的RESTful API通过使用@GetMapping, @PostMapping, @PutMapping, 和 @DeleteMapping注解,使得每种HTTP请求类型都能简便地映射到控制器的方法上。

通过@RequestBody, @PathVariable, 和 @RequestParam处理请求参数,并利用返回对象或ResponseEntity构建响应,使得RESTful API的开发变得高效且易维护。

标签:Spring,Boot,id,API,GetMapping,User,ResponseEntity,public,user
From: https://blog.csdn.net/qq_35759769/article/details/139619082

相关文章

  • JavaWeb开发基础 (5) :后端框架进阶(事务管理、AOP、Spring原理、Maven高级)
    JavaWeb开发基础:后端框架进阶——事务管理、AOP、Spring原理、Maven高级文章目录1事务管理1.1Spring事务管理1.2rollbackFor和propagation2AOP2.1AOP快速入门2.2核心概念2.3通知类型2.4通知顺序2.5切入点表达式[email protected]连接点案......
  • springboot打包将配置文件和jar分开
    <?xmlversion="1.0"encoding="UTF-8"?><projectxmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0......
  • FastAPI+MemFire Cloud+LangChain开发ChatGPT应用
    为什么选择这三个组合OpenAI官方SDK是Python,此开发语言首选PythonFastAPI是Python语言编写的高性能的现代化Web框架MemFireCloud提供向量数据库支持,向量数据库是开发知识库应用的必选项MemFireCloud提供Supabase托管,LangChain原生支持SupabaseAPILangChain是AI应用开发......
  • 【Spring Boot 整合 Angular】
    今天我们尝试SpringBoot整合Angular,并决定建立一个非常简单的SpringBoot微服务,使用Angular作为前端渲编程语言进行前端页面渲染.基础环境技术版本Java1.8+SpringBoot1.5.x创建项目初始化项目bashmvnarchetype:generate-DgroupId=com.edurt.sli.sliss-Dartifact......
  • 利用聚合API平台的API接口,利用HTTP协议向服务器发送请求,并接受服务器的响应,要求利用cJ
    目录题目分析代码结果题目利用聚合API平台的API接口,利用HTTP协议向服务器发送请求,并接受服务器的响应,要求利用cJSON库对服务器的响应数据进行解析,并输出到终端分析1.需从源代码网站GitHub或SourceForge代码网站下载cJSON库及阅读下载的README相关手册如何使用cJSON库;2.使用......
  • 用Tensorflow API:tf.keras搭建网络八股:六步法
    #想要搭建属于自己的神经网络模型么,跟我做六步就好#入门课程可看Tensorflow2.0#激活函数教程#课程很好如有不懂可私信交流总览六步法的简要内容import      第一步引入相关模块train,test    第二步说明训练集(特征)和测试集(标签)是什么model=tf.k......
  • 基于jeecgboot-vue3的Flowable流程--抄送我的功能
    因为这个项目license问题无法开源,更多技术支持与服务请加入我的知识星球。1、抄送我的界面代码如下:<template><divclass="p-2"><!--查询区域--><divclass="jeecg-basic-table-form-container"><a-formref="formRef"@keyup.enter.nati......
  • spring-1-IOC、创建bean的方式、创建bean的过程
    1.背景IOC(InversionofControl,控制反转)控制反转是一种设计原则,它将对象的创建和管理责任从应用代码中移交给容器。在Spring中,IOC容器负责管理应用中的所有对象,包括它们的生命周期和相互之间的依赖关系。IOC的主要目的是为了减少代码之间的耦合,使代码更加模块化和可测试。这......
  • SpringBoot内置数据源
    回顾:在我们之前学习在配置文件当中配置对应的数据源的时候,我们设置的数据源其实都是Druid的数据源,并且其配置有两种方式,当然这两种方式都需要我们导入对应的有关德鲁伊的依赖才行一种是直接在开始设置为druid数据源类型的一种是在对应的正常的数据库配置下,设置......
  • 【Azure Spring Apps】Spring App部署上云遇见 502 Bad Gateway nginx
    问题描述在部署AzureSpringApp应用后,访问应用,遇见了502BadGatewayNginx。问题解答502BadGateway, 并且由Nginx返回。而自己的应用中,并没有定义Nginx相关内容,所以需要查看问题是否出现在AzureSpringApp服务的设置上。根据SpringApp的通信模型图判断,502的请求是由N......