流程图图解@RequestBody @RequestPart @RequestParam @ModelAttribute

@RequestBody 只能用一次,因为只有一个请求体
@RequestBody 流程 application/json 自动转换 Spring接收请求 前端发送JSON数据 Java对象 处理业务逻辑

示例代码:

javascript 复制代码
// 1. @RequestBody示例 - 用于接收JSON数据
// 前端代码:
const user = {
    name: "张三",
    age: 25,
    phone: "13812345678"
};

fetch('/api/user', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(user)
});

// 后端代码:
@PostMapping("/api/user")
public R createUser(@RequestBody User user) {
    System.out.println(user.getName());    // 输出:张三
    return R.ok();
}

@RequestPart
@RequestPart 流程 multipart/form-data JSON部分 文件部分 Spring接收复合请求 前端发送表单数据 Java对象 MultipartFile 处理业务逻辑

示例代码:

javascript 复制代码
// 2. @RequestPart示例 - 用于文件上传+JSON
// 前端代码:
const formData = new FormData();
const userInfo = {
    name: "张三",
    age: 25
};
formData.append('userInfo', JSON.stringify(userInfo));
formData.append('avatar', fileInput.files[0]);  // 文件

fetch('/api/user/profile', {
    method: 'POST',
    body: formData
});

// 后端代码:
@PostMapping("/api/user/profile")
public R updateProfile(
    @RequestPart("userInfo") User user,
    @RequestPart("avatar") MultipartFile file
) {
    // 处理用户信息
    System.out.println(user.getName());    // 输出:张三
    // 处理文件
    String fileName = file.getOriginalFilename();
    return R.ok();
}

@ModelAttribute
@ModelAttribute 流程 form-data 自动映射字段 Spring接收表单 前端发送表单数据 Java对象 处理业务逻辑

示例代码:

javascript 复制代码
// 3. @ModelAttribute示例 - 用于接收表单数据
// 前端代码:
const formData = new FormData();
formData.append('name', '张三');
formData.append('age', '25');
formData.append('phone', '13812345678');

fetch('/api/user/create', {
    method: 'POST',
    body: formData
});

// 后端代码:
@PostMapping("/api/user/create")
public R createUser(@ModelAttribute User user) {
    System.out.println(user.getName());    // 输出:张三
    return R.ok();
}

@RequestParam
@RequestParam 流程 URL参数或表单字段 自动类型转换 Spring接收单个参数 前端发送参数 Java基本类型 处理业务逻辑

示例代码:

javascript 复制代码
// 4. @RequestParam示例 - 用于接收URL参数或单个表单字段
// 前端代码 - URL参数方式:
fetch('/api/user/search?name=张三&age=25');

// 后端代码:
@GetMapping("/api/user/search")
public R searchUser(
    @RequestParam String name,                    // 必填参数
    @RequestParam(required = false) Integer age,  // 可选参数
    @RequestParam(defaultValue = "1") int page    // 带默认值的参数
) {
    System.out.println(name);     // 输出:张三
    System.out.println(age);      // 输出:25
    System.out.println(page);     // 如果未传,输出默认值:1
    return R.ok();
}

用户登录例子

javascript 复制代码
// 实战示例:用户注册(包含基本信息和头像)
// 方式一:使用 @RequestPart(适合JSON)
@PostMapping("/register")
public R registerWithJson(
    @RequestPart("userInfo") UserRegisterDTO userInfo,  // JSON格式的用户信息
    @RequestPart("avatar") MultipartFile avatar         // 头像文件
) {
    String username = userInfo.getUsername();  // 从JSON中获取用户名
    String password = userInfo.getPassword();  // 从JSON中获取密码
    // 处理头像文件
    String avatarPath = saveAvatar(avatar);    // 保存头像
    // 处理注册逻辑
    return R.ok();
}

// 方式二:使用 @ModelAttribute(适合普通表单)
@PostMapping("/register")
public R registerWithForm(
    @ModelAttribute UserRegisterDTO userInfo,    // 表单字段自动映射
    @RequestParam("avatar") MultipartFile avatar // 头像文件
) {
    String username = userInfo.getUsername();  // 从表单中获取用户名
    String password = userInfo.getPassword();  // 从表单中获取密码
    // 处理头像文件
    String avatarPath = saveAvatar(avatar);    // 保存头像
    // 处理注册逻辑
    return R.ok();
}

简单总结一下这四种注解的使用场景:

  1. @RequestBody

    • 特点:专门用于接收JSON数据
    • 使用场景:前端传递复杂JSON对象时
    • 常见用途:RESTful API的POST请求
  2. @RequestPart

    • 特点:可以同时处理文件和JSON数据
    • 使用场景:文件上传+复杂数据提交
    • 常见用途:带文件上传的表单提交
  3. @ModelAttribute

    • 特点:自动映射表单字段到对象
    • 使用场景:普通表单提交
    • 常见用途:简单的表单处理
  4. @RequestParam

    • 特点:接收单个参数
    • 使用场景:URL参数或简单表单字段
    • 常见用途:GET请求参数处理

实际应用建议:

  1. 如果是纯JSON数据传输,用@RequestBody
  2. 如果有文件上传,用@RequestPart
  3. 如果是普通表单提交,用@ModelAttribute
  4. 如果只是几个简单参数,用@RequestParam

注意事项:

@RequestBody只能用一次,因为只有一个请求体

@RequestParam和@RequestPart的区别在于,RequestPart支持复杂对象的JSON数据

@ModelAttribute适合form表单,自动处理字段映射

文件上传一定要用multipart/form-data格式

相关推荐
努力也学不会java3 天前
【设计模式】状态模式
java·设计模式·状态模式
闲人编程4 天前
前端形态与样式风格:从古典到现代的视觉语言演进
前端·css·状态模式·组件·js·风格·响应式
zzywxc7874 天前
自动化测试框架是软件测试的核心基础设施,通过预设规则和脚本自动执行测试用例,显著提高测试效率和覆盖率。
运维·人工智能·自动化·prompt·测试用例·流程图
TextIn智能文档云平台4 天前
产品无法正确解析复杂表格和流程图,有什么替代方案或优化方法?
流程图
coder_lorraine4 天前
Drawnix:开源一体化白板工具,让你的创意无限流动!
开源·流程图
m0_555762906 天前
项目1——单片机程序审查,控制系统流程图和时序图
单片机·mongodb·流程图
摸鱼仙人~7 天前
后端错误处理的艺术:BusinessException 与 ResultUtils 的完美分工
状态模式
上优7 天前
Vue3纯前端同源跨窗口通信移动AGV小车
前端·vue.js·状态模式
zzywxc7878 天前
AI在金融、医疗、教育、制造业等领域的落地案例
人工智能·机器学习·金融·prompt·流程图
南山二毛8 天前
机器人控制器开发(部署——软件打包备份更新)
机器人·状态模式