JAXB不原生支持Map，需通过XmlAdapter（如MapAdapter）实现序列化与反序列化；其核心是定义MapEntry内部类并重写marshal/unmarshal方法，将Map转为数组再映射为XML节点。
Java中用JAXB将Map转为XML，不能直接映射，因为JAXB不原生支持Map类型。必须借助自定义XmlAdapter（即MapAdapter）实现序列化与反序列化。
为什么需要MapAdapter
JAXB规范要求所有被@XmlRootElement或@XmlElement标注的字段/属性必须是JAXB可处理的类型（如基本类型、String、List、自定义Bean等）。Map没有默认绑定规则，JAXB无法自动推断键值对如何生成XML结构，所以必须通过适配器告诉JAXB：“这个Map应该转成怎样的XML节点”。
编写MapAdapter的具体步骤
创建一个继承XmlAdapter的类，泛型参数为MapEntry[]（适配后类型）和Map<K,V>（原始类型）：
- 重写
marshal()：把Map转成数组形式（每个元素代表一个键值对），便于JAXB按顺序生成XML节点 - 重写
unmarshal()：把XML解析后的数组还原为Map - 定义内部静态类
MapEntry，用@XmlRootElement或@XmlType标注，并用@XmlAttribute映射key，@XmlValue映射value（或两个@XmlElement也可）
完整可用示例
假设要将Map<String, String>转为如下XML格式：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
<config><entry key="timeout">30</entry>
<entry key="retry">3</entry>
</config>
对应代码：
public class MapAdapter extends XmlAdapter<MapAdapter.MapEntry[], Map<String, String>> {
@Override
public MapEntry[] marshal(Map<String, String> map) throws Exception {
if (map == null) return new MapEntry[0];
return map.entrySet().stream()
.map(e -> new MapEntry(e.getKey(), e.getValue()))
.toArray(MapEntry[]::new);
}
@Override
public Map<String, String> unmarshal(MapEntry[] entries) throws Exception {
Map<String, String> map = new LinkedHashMap<>();
if (entries != null) {
for (MapEntry entry : entries) {
map.put(entry.key, entry.value);
}
}
return map;
}
public static class MapEntry {
@XmlAttribute
public String key;
@XmlValue
public String value;
public MapEntry() {}
public MapEntry(String key, String value) {
this.key = key;
this.value = value;
}
}
}
在目标Bean中使用：
@XmlRootElement
public class Config {
@XmlJavaTypeAdapter(MapAdapter.class)
private Map<String, String> properties;
// getter/setter
}
注意事项与常见问题
-
泛型擦除：JAXB运行时无法获取
Map<K,V>的实际类型，所以MapAdapter通常只能处理固定键值类型的组合（如String,String），若需通用，可用反射+泛型工具类辅助，但会增加复杂度 -
key必须是字符串或可转为字符串的类型：因为
@XmlAttribute只接受String、QName等JAXB内置支持类型；若key是对象，需改用@XmlElement嵌套方式表达 -
顺序保留：用
LinkedHashMap确保XML中<entry>顺序与原始Map一致 -
空Map处理：marshal返回空数组时，JAXB默认不生成任何
<entry>节点，符合预期；若想强制生成空容器标签，需额外在Bean中加@XmlElementWrapper
