如何用Apache HttpClient实现带树形结构参数的POST请求？

Hey there! I get where you're coming from—flat key-value pairs work great for simple data, but tree/nested structures require a different approach. Let's clear this up step by step.

What Are Those Tree-Structured Parameters? #

The tree view you see in Firefox Dev Tools is almost certainly a JSON payload sent in the request body, instead of the application/x-www-form-urlencoded format you're used to. JSON is perfect for representing nested, hierarchical data (the "tree" structure) because it supports objects inside objects, arrays, etc.—something flat key-value pairs can't handle cleanly.

How to Implement This with Apache HttpClient #

Instead of using UrlEncodedFormEntity, you'll need to send a JSON string as the request body, and set the correct Content-Type header to application/json. Here are two common approaches:

1. Using Java's Built-in JSONObject (For Simple Cases)

If your tree structure isn't too complex, you can build the JSON directly with Java's org.json library (you'll need to add this dependency to your project first):

import org.apache.http.HttpResponse;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.HttpClientBuilder;
import org.json.JSONObject;

public class TreeParamPostExample {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClientBuilder.create().build();
        HttpPost post = new HttpPost("your-api-url-here");

        // Build the tree-structured JSON
        JSONObject root = new JSONObject();
        root.put("sn", "C02G8416DRJM");
        
        // Add nested objects to create the tree structure
        JSONObject user = new JSONObject();
        user.put("name", "Lin");
        user.put("role", "admin");
        root.put("invitedUser", user);
        
        JSONObject permissions = new JSONObject();
        permissions.put("canEdit", true);
        permissions.put("canDelete", false);
        user.put("permissions", permissions);

        // Set the JSON as the request entity
        StringEntity entity = new StringEntity(root.toString());
        post.setEntity(entity);
        post.setHeader("Content-Type", "application/json");

        // Execute the request
        HttpResponse response = client.execute(post);
        
        // Handle the response as needed (e.g., read status code, parse response body)
        // ...
    }
}

2. Using Jackson (For Complex Objects/POJOs)

If your tree structure maps to a Java class (POJO), using Jackson's ObjectMapper is cleaner—it automatically converts your Java objects to JSON, avoiding manual JSON string building.

First, add Jackson dependencies to your project (e.g., for Maven):

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version>
</dependency>

Then, define your POJOs that mirror the tree structure:

public class InviteRequest {
    private String sn;
    private InvitedUser invitedUser;

    // Getters and setters
    public String getSn() { return sn; }
    public void setSn(String sn) { this.sn = sn; }
    public InvitedUser getInvitedUser() { return invitedUser; }
    public void setInvitedUser(InvitedUser invitedUser) { this.invitedUser = invitedUser; }
}

public class InvitedUser {
    private String name;
    private String role;
    private Permissions permissions;

    // Getters and setters
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public String getRole() { return role; }
    public void setRole(String role) { this.role = role; }
    public Permissions getPermissions() { return permissions; }
    public void setPermissions(Permissions permissions) { this.permissions = permissions; }
}

public class Permissions {
    private boolean canEdit;
    private boolean canDelete;

    // Getters and setters
    public boolean isCanEdit() { return canEdit; }
    public void setCanEdit(boolean canEdit) { this.canEdit = canEdit; }
    public boolean isCanDelete() { return canDelete; }
    public void setCanDelete(boolean canDelete) { this.canDelete = canDelete; }
}

Now, convert the POJO to JSON and send the request:

import com.fasterxml.jackson.databind.ObjectMapper;
import org.apache.http.HttpResponse;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.HttpClientBuilder;

public class PojoPostExample {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClientBuilder.create().build();
        HttpPost post = new HttpPost("your-api-url-here");

        // Populate your POJO with tree-structured data
        InviteRequest request = new InviteRequest();
        request.setSn("C02G8416DRJM");

        InvitedUser user = new InvitedUser();
        user.setName("Lin");
        user.setRole("admin");

        Permissions permissions = new Permissions();
        permissions.setCanEdit(true);
        permissions.setCanDelete(false);
        user.setPermissions(permissions);

        request.setInvitedUser(user);

        // Convert POJO to JSON string
        ObjectMapper mapper = new ObjectMapper();
        String json = mapper.writeValueAsString(request);

        // Set the JSON entity and headers
        StringEntity entity = new StringEntity(json);
        post.setEntity(entity);
        post.setHeader("Content-Type", "application/json");

        // Execute the request
        HttpResponse response = client.execute(post);
        
        // Handle the response
        // ...
    }
}

Key Notes #

• Double-check the exact JSON structure Lin is sending (you can copy it directly from Firefox Dev Tools' "Request Body" tab) and match it in your code—this ensures the API accepts your request.
• Confirm the API you're targeting supports application/json requests; most modern APIs do, but it's good to verify.

内容的提问来源于stack exchange，提问作者tom bobby