SpringBoot请求参数传递与接收示例详解

 更新时间:2025年08月21日 10:55:38   作者:Whitekuma0914  
本文给大家介绍SpringBoot请求参数传递与接收示例详解,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧

I. 基础参数传递

i.查询参数(Query Parameters)

请求示例:GET /user?name=John&age=25

@GetMapping("/user")
public String getUser(
    @RequestParam String name, 
    @RequestParam(defaultValue = "20") int age) {
    return "Name: " + name + ", Age: " + age;
}

ii.路径参数(Path Variables)

请求示例:GET /product/123

@GetMapping("/product/{id}")
public String getProduct(@PathVariable Long id) {
    return "Product ID: " + id;
}

iii.混合

请求示例:GET /order/456?status=shipped

@GetMapping("/order/{orderId}")
public String getOrder(
    @PathVariable String orderId,
    @RequestParam String status) {
    return "Order " + orderId + " is " + status;
}

II. 对象绑定

i.自动绑定到实体类

请求示例:GET /search?keyword=spring&page=2&size=10

public class SearchParams {
    private String keyword;
    private int page = 1;
    private int size = 20;
    // getters/setters方法
}
​
@GetMapping("/search")
public String search(SearchParams params) {
    return "Searching: " + params.getKeyword() 
           + " Page: " + params.getPage();
}

ii.嵌套对象绑定

请求示例:GET /user?name=Alice&address.city=Beijing&address.zip=100001

public class UserQuery {
    private String name;
    private Address address;
    // getters/setters
}
​
public class Address {
    private String city;
    private String zip;
}
​
@GetMapping("/user")
public String findUser(UserQuery query) {
    return query.getName() + " in " + query.getAddress().getCity();
}

III. JSON 请求体(POST/PUT/PATCH)

请求示例:POST /users Body: {"name":"Mike","email":"mike@example.com"}

// User实体
public class User {
    private String id;
    private String name;
    private String email;
    // getters/setters
}
​
@PostMapping("/users")
public User createUser(@RequestBody User user) {
    user.setId(UUID.randomUUID().toString());
    return user; // 自动转为JSON
}

IV、数组/集合参数

i.查询参数数组

请求示例:GET /products?ids=101,102,103

@GetMapping("/products")
public String getProducts(@RequestParam List<Long> ids) {
    return "IDs: " + ids.toString();
}

ii.JSON 数组

请求示例:POST /batch Body: [{"name":"Item1"},{"name":"Item2"}]

@PostMapping("/batch")
public String batchCreate(@RequestBody List<Item> items) {
    return "Created " + items.size() + " items";
}

V、特殊参数处理

i.日期格式化

请求示例:GET /events?date=2023-05-15

@GetMapping("/events")
public String getEvents(@DateTimeFormat(pattern = "yyyy-MM-dd") Date date) {
    return "Events on: " + date.toString();
}

ii.可选参数

@GetMapping("/optional")
public String optionalParam(@RequestParam(required = false) String filter) {
    return filter != null ? "Filter: " + filter : "No filter";
}

iii.请求头参数

@GetMapping("/auth")
public String auth(@RequestHeader("Authorization") String token) {
    return "Token: " + token.substring(0, 5) + "...";
}

VI、文件上传

表单请求:multipart/form-data

@PostMapping("/upload")
public String uploadFile(@RequestParam("file") MultipartFile file) {
    return "File received: " + file.getOriginalFilename() 
           + " Size: " + file.getSize();
}

VII、验证参数(需spring-boot-starter-validation)

POST /register

public class Registration {
    @NotBlank
    private String username;
    @Email
    private String email;
    @Min(18)
    private int age;
}
@PostMapping("/register")
public ResponseEntity<?> register(@Valid @RequestBody Registration form) {
    // 自动验证参数
    return ResponseEntity.ok("Valid");
}
// 全局异常处理
@ControllerAdvice
public class ValidationHandler {
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public Map<String, String> handleValidation(MethodArgumentNotValidException ex) {
        Map<String, String> errors = new HashMap<>();
        ex.getBindingResult().getFieldErrors().forEach(error -> 
            errors.put(error.getField(), error.getDefaultMessage()));
        return errors;
    }
}

VIII、注解总结

注解用途示例场景
@RequestParam获取查询参数?name=value
@PathVariable获取路径参数/users/{id}
@RequestBody获取JSON/XML请求体POST/PUT请求
@ModelAttribute绑定表单数据HTML表单提交
@RequestHeader获取请求头值Authorization
@DateTimeFormat日期参数格式化?date=2023-01-01
@RequestPart文件上传multipart/form-data
@Valid触发参数验证配合JSR-303验证注解

到此这篇关于SpringBoot请求参数传递与接收示例整理的文章就介绍到这了,更多相关SpringBoot请求参数内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Java拷贝文件夹和删除文件夹代码实例

    Java拷贝文件夹和删除文件夹代码实例

    这篇文章主要介绍了Java拷贝文件夹和删除文件夹代码实例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-04-04
  • 通过实例深入学习Java的Struts框架中的OGNL表达式使用

    通过实例深入学习Java的Struts框架中的OGNL表达式使用

    这篇文章主要通过实例介绍了Java的Strus框架中的OGNL表达式使用,Struts框架是Java的SSH三大web开发框架之一,需要的朋友可以参考下
    2015-11-11
  • java中多线程加锁的四种方式

    java中多线程加锁的四种方式

    Java中实现多线程安全的关键是加锁,主要方式有synchronized关键字、ReentrantLock类、ReadWriteLock接口和Semaphore类,本文就来介绍一下这四种方式,感兴趣的可以了解一下
    2024-10-10
  • SpringBoot整合高德地图天气查询的全过程

    SpringBoot整合高德地图天气查询的全过程

    这篇文章主要给大家介绍了关于SpringBoot整合高德地图天气查询的相关资料,文中通过图文介绍的非常详细,对大家学习或者使用springboot具有一定的参考学习价值,需要的朋友可以参考下
    2021-12-12
  • 如何通过SpringBoot实现商城秒杀系统

    如何通过SpringBoot实现商城秒杀系统

    这篇文章主要介绍了如何通过SpringBoot实现商城秒杀系统,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-11-11
  • java虚拟机学习笔记进阶篇

    java虚拟机学习笔记进阶篇

    在本篇内容里小编给大家分享了关于java虚拟机学习笔记的进阶内容,需要的朋友们跟着学习下。
    2019-06-06
  • Java开发微信Navicat支付完整版

    Java开发微信Navicat支付完整版

    这篇文章主要介绍了Java开发微信Navicat支付完整版,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-08-08
  • 使用Springboot自定义转换器实现参数去空格功能

    使用Springboot自定义转换器实现参数去空格功能

    这篇文章主要介绍了使用Springboot自定义转换器实现参数去空格功能,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-08-08
  • 关于JSON解析中获取不存在的key问题

    关于JSON解析中获取不存在的key问题

    这篇文章主要介绍了关于JSON解析中获取不存在的key问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-07-07
  • Struts 2 数据校验功能及校验问题的解决方案

    Struts 2 数据校验功能及校验问题的解决方案

    这篇文章主要介绍了Struts 2 数据校验功能及校验问题的解决方案的相关资料,需要的朋友可以参考下
    2016-09-09

最新评论