如何使用HttpURLConnection在POST请求中同时发送JSON数据与CSV文件
用原生HttpURLConnection实现同时传JSON与CSV的POST请求
认知误区澄清
你之前了解的“HttpURLConnection单次请求仅可发送一种类型数据”是对简单请求场景的刻板印象。当接口需要同时传输结构化文本、文件时,对应的请求规范是multipart/form-data格式,HttpURLConnection本身支持自定义格式的请求流输出,完全可以依托Java原生能力实现需求,既不需要依赖第三方HTTP客户端库,也不需要通过ProcessBuilder调用curl命令。
目标请求的结构拆解
你提供的curl调用本质是标准的multipart/form-data类型POST请求,所有传输内容可以拆分为以下独立部分:
- 自定义请求头:携带鉴权信息
aToken: 你的实际Token值 - 文本表单字段:字段名为
json,值为指定结构的JSON字符串 - 文件表单字段:字段名为
file,内容为本地CSV文件的二进制流 - 请求目标地址:
https://the.api.com/api/23/postData
原生实现核心逻辑
整个实现不需要引入任何外部依赖,核心流程分为3步:
- 初始化HttpURLConnection实例,设置POST请求方法,开启输出流权限,手动指定
Content-Type头为multipart/form-data并附带自定义的内容分隔符(分隔符是用来区分请求体内不同字段块的随机标识,避免和实际内容重复即可) - 按照
multipart/form-data的规范,依次把JSON文本字段、CSV文件的内容按分隔符的边界拼接写入连接的输出流 - 写入请求体结束标记,刷新输出流,后续按照标准方式读取接口返回的响应内容即可
下面是对应的核心实现代码,完全匹配你给出的curl请求逻辑:
// 生成分隔符(生产环境可替换为随机UUID,降低内容冲突概率) String boundary = "----FormBoundary" + System.currentTimeMillis(); URL requestUrl = new URL("https://the.api.com/api/23/postData"); HttpURLConnection connection = (HttpURLConnection) requestUrl.openConnection(); try { // 连接基础配置 connection.setRequestMethod("POST"); connection.setDoOutput(true); connection.setDoInput(true); connection.setUseCaches(false); // 设置鉴权头 connection.setRequestProperty("aToken", "替换为你的实际Token"); // 设置请求类型与分隔符 connection.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + boundary); // 写请求体 try (DataOutputStream out = new DataOutputStream(connection.getOutputStream())) { // 写入JSON文本字段 out.writeBytes("--" + boundary + "\r\n"); out.writeBytes("Content-Disposition: form-data; name=\"json\"\r\n\r\n"); String jsonStr = "{\"project\": \"1234\", \"template\": \"5678\",\"data\":[{\"date\": \"2017-05-26\",\"place\": \"my house\"}, {\"person\":\"alice\"}]}"; out.write(jsonStr.getBytes(StandardCharsets.UTF_8)); out.writeBytes("\r\n"); // 写入CSV文件字段 File csvFile = new File("path/to/file.csv"); out.writeBytes("--" + boundary + "\r\n"); out.writeBytes("Content-Disposition: form-data; name=\"file\"; filename=\"" + csvFile.getName() + "\"\r\n"); out.writeBytes("Content-Type: text/csv\r\n\r\n"); // 分块读文件写入,避免大文件OOM try (FileInputStream fis = new FileInputStream(csvFile)) { byte[] buffer = new byte[4096]; int readCount; while ((readCount = fis.read(buffer)) != -1) { out.write(buffer, 0, readCount); } } out.writeBytes("\r\n"); // 写入请求体结束标记 out.writeBytes("--" + boundary + "--\r\n"); out.flush(); } // 读取响应逻辑:后续可通过connection.getResponseCode()获取状态码,根据状态码读取对应输入流的返回内容 } finally { connection.disconnect(); }
实现注意事项
- 严格按照RFC规范拼接multipart格式即可,不需要依赖JDK内部非公开的网络API,跨JDK版本的兼容性有保障
- 大文件传输时使用分块读取写入的逻辑,不要一次性把整个文件加载到内存,避免触发OOM
- 所有文本内容统一使用UTF-8编码写入,避免中文乱码
- 该实现完全依托Java标准库能力,不会出现调用系统curl命令时因环境差异导致的命令缺失、路径不兼容问题
内容的提问来源于stack exchange,提问作者mrcrag
相关产品推荐
相关产品推荐

