Java发送POST请求详解

前言

在现代的网络编程中，发送HTTP请求已经成为了开发中常见的操作。其中POST请求是一种常用的请求方式，用于向服务器提交数据。本文将详细介绍如何使用Java发送POST请求。

1. Java发送简单的POST请求

Java提供了java.net包中的HttpURLConnection类来发送HTTP请求。下面是发送一个简单的POST请求的示例代码：

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;

public class PostRequestExample {
    public static void main(String[] args) throws IOException {
        // 创建URL对象
        URL url = new URL("http://example.com/api");

        // 创建HttpURLConnection对象
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();

        // 设置请求方法为POST
        connection.setRequestMethod("POST");

        // 启用输入输出流
        connection.setDoInput(true);
        connection.setDoOutput(true);

        // 设置请求参数
        String data = "param1=value1&param2=value2";
        OutputStream outputStream = connection.getOutputStream();
        outputStream.write(data.getBytes());
        outputStream.flush();
        outputStream.close();

        // 发送请求并获取响应
        int responseCode = connection.getResponseCode();
        InputStream inputStream;
        if (responseCode >= 200 && responseCode < 400) {
            inputStream = connection.getInputStream();
        } else {
            inputStream = connection.getErrorStream();
        }

        // 处理响应
        BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream));
        String line;
        StringBuilder response = new StringBuilder();
        while ((line = reader.readLine()) != null) {
            response.append(line);
        }
        reader.close();

        // 输出响应结果
        System.out.println(response.toString());

        // 关闭连接
        connection.disconnect();
    }
}

运行以上代码，将通过POST请求发送参数”param1=value1&param2=value2″到”http://example.com/api”，并获取服务器的响应结果。

2. 添加请求头

在发送POST请求时，可能需要添加一些自定义的请求头。可以使用HttpURLConnection类的setRequestProperty方法来添加请求头。示例代码如下：

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;

public class PostRequestWithHeadersExample {
    public static void main(String[] args) throws IOException {
        // 创建URL对象
        URL url = new URL("http://example.com/api");

        // 创建HttpURLConnection对象
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();

        // 设置请求方法为POST
        connection.setRequestMethod("POST");

        // 添加自定义请求头
        connection.setRequestProperty("Content-Type", "application/json");
        connection.setRequestProperty("Authorization", "Bearer token123");

        // 启用输入输出流
        connection.setDoInput(true);
        connection.setDoOutput(true);

        // 设置请求参数
        String data = "param1=value1&param2=value2";
        OutputStream outputStream = connection.getOutputStream();
        outputStream.write(data.getBytes());
        outputStream.flush();
        outputStream.close();

        // 发送请求并获取响应
        // ...

        // 处理响应
        // ...

        // 输出响应结果
        // ...

        // 关闭连接
        // ...
    }
}

以上代码中，通过setRequestProperty方法添加了两个自定义的请求头”Content-Type”和”Authorization”。

3. 发送JSON数据

发送POST请求时，常常需要发送JSON格式的数据。可以使用org.json包来构造JSON数据。示例代码如下：

import org.json.JSONObject;

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;

public class PostJsonRequestExample {
    public static void main(String[] args) throws IOException {
        // 创建URL对象
        URL url = new URL("http://example.com/api");

        // 创建HttpURLConnection对象
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();

        // 设置请求方法为POST
        connection.setRequestMethod("POST");

        // 添加请求头
        connection.setRequestProperty("Content-Type", "application/json");

        // 启用输入输出流
        connection.setDoInput(true);
        connection.setDoOutput(true);

        // 构造JSON数据
        JSONObject json = new JSONObject();
        json.put("name", "John Doe");
        json.put("age", 30);

        // 设置请求参数
        OutputStream outputStream = connection.getOutputStream();
        outputStream.write(json.toString().getBytes());
        outputStream.flush();
        outputStream.close();

        // 发送请求并获取响应
        // ...

        // 处理响应
        // ...

        // 输出响应结果
        // ...

        // 关闭连接
        // ...
    }
}

以上代码中，使用org.json包来构造一个包含”name”和”age”两个字段的JSON对象，并将其作为请求参数发送到服务器。

4. 发送文件

有时候需要发送文件到服务器，可以通过设置请求头Content-Type为multipart/form-data来发送文件。示例代码如下：

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;

public class PostFileRequestExample {
    public static void main(String[] args) throws IOException {
        // 创建URL对象
        URL url = new URL("http://example.com/upload");

        // 创建HttpURLConnection对象
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();

        // 设置请求方法为POST
        connection.setRequestMethod("POST");

        // 添加请求头
        connection.setRequestProperty("Content-Type", "multipart/form-data; boundary=----boundary");

        // 启用输入输出流
        connection.setDoInput(true);
        connection.setDoOutput(true);

        // 设置请求参数
        OutputStream outputStream = connection.getOutputStream();

        // 文件参数
        File file = new File("path/to/file.txt");
        outputStream.write(("------boundary\r\n" +
                "Content-Disposition: form-data; name=\"file\"; filename=\"" + file.getName() + "\"\r\n" +
                "Content-Type: text/plain\r\n\r\n").getBytes());
        FileInputStream fileInputStream = new FileInputStream(file);
        byte[] buffer = new byte[1024];
        int bytesRead;
        while ((bytesRead = fileInputStream.read(buffer)) != -1) {
            outputStream.write(buffer, 0, bytesRead);
        }
        fileInputStream.close();
        outputStream.write(("\r\n------boundary--\r\n").getBytes());

        outputStream.flush();
        outputStream.close();

        // 发送请求并获取响应
        // ...

        // 处理响应
        // ...

        // 输出响应结果
        // ...

        // 关闭连接
        // ...
    }
}

以上代码中，设置请求头中的Content-Type为multipart/form-data，并指定一个分隔符来区分不同的请求参数。通过FileInputStream读取文件内容，并将其写入到输出流中。