spring-boot获取form-data数据及json数据

本文介绍了一个用于获取课程信息的RESTful API实现细节。该API通过POST请求接收客户端发送的课程查询参数,并支持根据地区筛选课程。文章展示了如何处理请求头中的城市参数以及如何在请求体缺失电话号码时从请求参数中获取。此外,还提供了获取JSON请求体及参数映射的实用工具类。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

@PostMapping("/")
public ObjectNode getCourses(Request request, @RequestHeader(value = "area") String city) {

    if(StringUtils.isBlank(request.getPhone())){
        Map<String, Object> reqMap = GetParamsUtils.getParamsMap();
        request.setPhone(reqMap.get("phone").toString());
    }
    BusinessWrapper<List<Object>> wrapper = indexService.getCourses(request,city);
    return ApiResponse.buildObjectNode(wrapper);
}
@Slf4j
public class GetParamsUtils {

    public static String jsonReq(HttpServletRequest request) {
        BufferedReader br;
        StringBuilder sb = null;
        String reqBody = null;
        try {
            br = new BufferedReader(new InputStreamReader(request.getInputStream()));
            String line = null;
            sb = new StringBuilder();
            while ((line = br.readLine()) != null) {
                sb.append(line);
            }
            br.close();
            if (sb.length() < 1) return "";
            reqBody = URLDecoder.decode(sb.toString(), "UTF-8");
            reqBody = reqBody.substring(reqBody.indexOf("{"));
            return reqBody;
        } catch (IOException e) {
            log.error("获取json参数错误!{}", e.getMessage());
            return "";
        }
    }

    public static Map<String, Object> getParamsMap(HttpServletRequest request) {
        Map<String, Object> paramsMap = new HashMap<>();
        String json = jsonReq(request);
        if (StringUtils.isNotBlank(json)) {
            return JSONObject.parseObject(json, Map.class);
        }
        return paramsMap;
    }

    public static Map<String, Object> getParamsMap() {
        Map<String, Object> paramsMap = new HashMap<>();
        try {
            ServletRequestAttributes sra = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();
            HttpServletRequest request = sra.getRequest();
            String json = jsonReq(request);
            if (StringUtils.isNotBlank(json)) {
                return JSONObject.parseObject(json, Map.class);
            }
        } catch (Exception e) {
            log.error("json参数转换错误!{}", e.getMessage());
        }
        return paramsMap;
    }
}

<think>我们正在实现一个Spring Boot接口,用于接收form-data格式的文件上传。根据引用内容,我们可以采用以下两种方式之一: 1. 使用@RequestParam分别接收文件和普通参数(适合参数较少的情况) 2. 使用一个自定义的类(如引用[1]中的UploadRequest)通过@ModelAttribute接收(适合参数较多,且需要封装的情况) 同时,注意引用[3]和引用[4]中提到的可能出现的错误,比如参数类型换错误、不支持的内容类型等。 下面分别给出两种实现方式: 方式一:使用@RequestParam(简单直接) ```java @RestController public class FileUploadController { @PostMapping("/upload") public ResponseEntity<String> uploadFile( @RequestParam("file") MultipartFile file, @RequestParam("json") String json) { // 假设有一个json字符串参数 // 处理文件上传 if (file.isEmpty()) { return ResponseEntity.badRequest().body("文件不能为空"); } // 处理json字符串(可以将其换为对象) // 业务逻辑... return ResponseEntity.ok("上传成功"); } } ``` 方式二:使用自定义类(封装参数) 首先,创建一个请求封装类,如引用[1]中的UploadRequest: ```java public class UploadRequest { private String json; // 普通参数 private MultipartFile file; // 文件参数 // 必须提供getter和setter public String getJson() { return json; } public void setJson(String json) { this.json = json; } public MultipartFile getFile() { return file; } public void setFile(MultipartFile file) { this.file = file; } } ``` 然后在控制器中使用: ```java @RestController public class FileUploadController { @PostMapping("/upload") public ResponseEntity<String> uploadFile(@ModelAttribute UploadRequest request) { MultipartFile file = request.getFile(); String json = request.getJson(); if (file.isEmpty()) { return ResponseEntity.badRequest().body("文件不能为空"); } // 处理json和文件... return ResponseEntity.ok("上传成功"); } } ``` 注意:使用@ModelAttribute时,前端表单中的字段名必须与UploadRequest类中的属性名一致。 另外,根据引用[2]中的前端示例,我们需要注意前端发送请求时,form-data的字段名要与后端匹配。例如,如果后端使用@RequestParam("file"),则前端formData.append('file', ...)。 配置方面,确保在application.yml中配置了multipart(如之前回答中的配置),以支持大文件上传。 可能遇到的错误及解决: 1. 如果出现“Content type not supported”错误(如引用[3]),请检查请求头Content-Type是否为multipart/form-data,并且确保后端控制器方法配置正确。 2. 如果出现参数类型换错误(如引用[4]),请检查普通参数的类型是否正确,比如字符串整数等。 最后,提供一个简单的前端示例(基于引用[2]的axios): ```javascript let formData = new FormData(); formData.append('file', file); // 文件对象,注意字段名与后端一致 formData.append('json', JSON.stringify({key: 'value'})); // 普通参数 axios.post('/upload', formData, { headers: { 'Content-Type': 'multipart/form-data' } }).then(response => { console.log(response.data); }); ``` 这样,一个完整的文件上传接口就实现了。 相关问题: 1. 如何同时接收多个文件? 2. 如何限制上传文件的类型? 3. 如何实现文件上传的进度条? 4. 如何处理文件上传过程中的异常?</think>### Spring Boot 接收 form-data 文件上传接口实现方法 #### 一、基础实现方案(推荐) 使用 `@ModelAttribute` 封装参数(参考引用[1]): ```java @PostMapping(value = "/upload", consumes = MediaType.MULTIPART_FORM_DATA_VALUE) public ResponseEntity<String> handleUpload( @ModelAttribute FileUploadRequest request // 封装所有参数 ) { // 1. 验证文件 if (request.getFile().isEmpty()) { return ResponseEntity.badRequest().body("文件不能为空"); } // 2. 处理普通参数 String jsonData = request.getJson(); // JSON字符串参数 // 解析JSONJSONObject json = new JSONObject(jsonData); // 3. 处理文件 try { String fileName = request.getFile().getOriginalFilename(); request.getFile().transferTo(new File("/uploads/" + fileName)); return ResponseEntity.ok("上传成功: " + fileName); } catch (IOException e) { return ResponseEntity.status(500).body("文件保存失败"); } } ``` #### 二、请求参数封装类(参考引用[1]) ```java public class FileUploadRequest { private String json; // 普通参数 private MultipartFile file; // 文件参数 // 必须提供getter/setter public String getJson() { return json; } public void setJson(String json) { this.json = json; } public MultipartFile getFile() { return file; } public void setFile(MultipartFile file) { this.file = file; } } ``` #### 三、前端调用示例(参考引用[2]) ```javascript // 使用FormData组织数据 const formData = new FormData(); formData.append('file', fileInput.files[0]); // 文件字段 formData.append('json', JSON.stringify({ // 普通参数 userId: "123", type: "avatar" })); // Axios发送请求 axios.post('/upload', formData, { headers: { 'Content-Type': 'multipart/form-data' } }).then(response => { console.log(response.data); }); ``` #### 四、常见问题解决 1. **参数类型错误**(参考引用[4]) ```java // 错误示例:空字符串数值 @RequestParam int id // 空字符串会导致NumberFormatException // 正确做法:使用包装类 @RequestParam Integer id // 允许接收null ``` 2. **多文件上传**(参考引用[3]) ```java // 接收多个文件 @PostMapping("/multi-upload") public String multiUpload( @RequestParam("files") MultipartFile[] files, // 文件数组 @RequestParam("tags") List<String> tags // 普通参数数组 ) { // 处理逻辑 } ``` 3. **配置限制**(application.yml) ```yaml spring: servlet: multipart: max-file-size: 10MB max-request-size: 30MB enabled: true location: /tmp # 临时存储目录 ``` #### 五、错误排查技巧 1. **Content-Type 错误**(参考引用[3]): - 确保请求头包含:`Content-Type: multipart/form-data` - Spring Boot 2.1+ 无需额外配置即可支持 2. **空参数处理**(参考引用[4]): ```java // 设置默认值 @RequestParam(defaultValue = "0") int page ``` 3. **文件名校验**: ```java String fileName = file.getOriginalFilename(); if (fileName.contains("..")) { // 防止路径遍历攻击 throw new InvalidFileNameException(fileName); } ``` > 此方案完整支持文件+普通参数混合上传,已解决常见类型换问题[^1][^2][^3][^4]。 --- ### 相关问题
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值