本文详解如何在 java http post 请求中动态注入变量到 json 字符串（如 teams 消息卡片），避免手动拼接引号与转义错误，推荐使用 jackson 等序列化库实现类型安全、可维护的 json 构造。
本文详解如何在 java http post 请求中动态注入变量到 json 字符串（如 teams 消息卡片），避免手动拼接引号与转义错误，推荐使用 jackson 等序列化库实现类型安全、可维护的 json 构造。
在 Java 中向 HTTP POST 请求的 JSON Body 动态注入变量（如 total、success、failed、skipped），绝非简单字符串拼接——直接用 + 连接变量极易引发 JSON 格式破坏（如未转义双引号、特殊字符乱码、空值/null 导致解析失败），且难以维护和调试。最佳实践是借助成熟 JSON 库进行对象建模与序列化，既保证语法正确性，又提升代码可读性与健壮性。
✅ 推荐方案：使用 Jackson Databind 构建类型安全的 JSON
Jackson 是 Java 生态最主流、高性能、高兼容性的 JSON 处理库。以下为完整、可运行的实现步骤：
1. 添加 Maven 依赖（推荐 Jackson 2.17+，兼容 Java 11+）
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.17.2</version>
</dependency>2. 定义结构化数据模型（POJO）
为 Microsoft Teams MessageCard 设计清晰的 Java 类（支持嵌套、数组、布尔字段）：
import com.fasterxml.jackson.annotation.JsonProperty;
import java.util.List;
public class TeamsMessageCard {
@JsonProperty("@type")
private String type = "MessageCard";
@JsonProperty("@context")
private String context = "http://schema.org/extensions";
private String themeColor = "#00FF00";
private String summary = "Weekend UI Validation Success";
private List<Section> sections;
// 构造函数（传入动态变量）
public TeamsMessageCard(int total, int success, int failed, int skipped) {
this.sections = List.of(new Section(total, success, failed, skipped));
}
// getter/setter 略（Lombok 可自动省略）
public static class Section {
private String activityTitle = "Weekend UI Validation Successful!!";
private String activitySubtitle = "Build Results";
private String activityImage = "https://ac-buckets-dev-acpublicmedia-2cxkd4j0deg1.s3.amazonaws.com/icons/GreenThumbUP.png";
private boolean markdown = true;
private List<Fact> facts;
public Section(int total, int success, int failed, int skipped) {
this.facts = List.of(
new Fact("Message", "Weekend UI Validation email will be shared shortly"),
new Fact("Status", "Success"),
new Fact("Total Tests:", String.valueOf(total)),
new Fact("Passed:", String.valueOf(success)),
new Fact("Failed:", String.valueOf(failed)),
new Fact("Skipped:", String.valueOf(skipped))
);
}
}
public static class Fact {
private String name;
private String value;
public Fact(String name, String value) {
this.name = name;
this.value = value;
}
// getter/setter
public String getName() { return name; }
public String getValue() { return value; }
}
}3. 发送请求：序列化 + HttpClient 调用
import com.fasterxml.jackson.databind.ObjectMapper;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
public class TeamsNotifier {
private static final ObjectMapper mapper = new ObjectMapper(); // 复用实例，线程安全
public HttpResponse<String> sendTeamsPostSummary(String url, int total, int success, int failed, int skipped)
throws java.io.IOException, InterruptedException {
// ✅ 步骤1：构造强类型对象（变量自然注入）
TeamsMessageCard card = new TeamsMessageCard(total, success, failed, skipped);
// ✅ 步骤2：序列化为标准 JSON 字符串（自动处理转义、null、编码）
String jsonBody = mapper.writeValueAsString(card);
// ✅ 步骤3：构建 HTTP 请求（注意：Content-Type 必须显式设置）
HttpClient client = HttpClient.newBuilder()
.connectTimeout(Duration.ofSeconds(10))
.followRedirects(HttpClient.Redirect.NORMAL)
.build();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.header("Content-Type", "application/json; charset=utf-8") // ⚠️ 关键：声明 UTF-8 编码
.POST(HttpRequest.BodyPublishers.ofString(jsonBody))
.build();
// ✅ 步骤4：发送并处理响应
HttpResponse<String> response = client.send(request,
HttpResponse.BodyHandlers.ofString(java.nio.charset.StandardCharsets.UTF_8));
System.out.printf("Teams POST status: %d, body: %s%n",
response.statusCode(), response.body().substring(0, Math.min(200, response.body().length())));
return response;
}
}⚠️ 重要注意事项
-
禁止手拼 JSON：
"\"value\": \"" + totalString + "\""类写法极易出错（如totalString含换行、双引号、null），Jackson 自动处理所有边缘情况。 -
必须设置
Content-Type：application/json; charset=utf-8是服务端（尤其是 Teams Webhook）正确解析的前提；仅application/json在某些场景下可能因默认编码不一致导致中文乱码。 -
复用
ObjectMapper：它是线程安全的，应作为静态常量复用，避免频繁创建开销。 -
异常处理增强建议：
try { HttpResponse<String> res = client.send(...); if (res.statusCode() >= 400) { throw new RuntimeException("Teams webhook failed: " + res.statusCode() + ", " + res.body()); } return res; } catch (java.net.http.HttpTimeoutException e) { throw new RuntimeException("Teams request timeout", e); }
? 替代方案对比（不推荐用于生产）
| 方案 | 是否推荐 | 原因 |
|---|---|---|
String.format() 或 + 拼接 |
❌ 高风险 | 无 JSON 转义、无法处理 null/特殊字符、不可读、难调试 |
JSONObject（org.json） |
△ 可用但次选 | API 较原始，无泛型支持，需手动 put()，易漏字段 |
Java 11 JsonBuilder（不存在） |
❌ 不存在 | Java 原生无 JSON 构建器，勿混淆 HttpRequest.BodyPublishers（仅流包装器，非序列化器） |
✅ 总结：动态注入变量到 JSON 请求体的唯一专业方式，是将业务数据映射为 Java 对象，再通过 Jackson/Gson 等库序列化。这不仅解决变量插入问题，更带来类型检查、空值策略、日期格式、性能优化等一揽子能力。对于 Teams、Slack、Webhook 等通知类接口，此模式已成行业标准实践。
立即学习“Java免费学习笔记（深入）”；
