使用JAXB解析嵌套XML元素遇问题，寻求解决方法

嘿，刚接触JAXB遇到嵌套元素映射问题太正常了，我来帮你一步步捋清楚解决方案～

一、先解决嵌套集合元素的正确映射 #

首先得明确你的XML结构，假设是类似这样的嵌套结构：

<root>
  <absolute>
    <absolute-item>内容1</absolute-item>
    <absolute-item>内容2</absolute-item>
  </absolute>
</root>

这里的核心是外层包装节点<absolute> + 内层集合节点<absolute-item>，JAXB有两种常用映射方式：

方式1：用@XmlElementWrapper简化（推荐）

不需要单独写包装类，直接在集合字段上配合两个注解：

import javax.xml.bind.annotation.*;
import java.util.List;

@XmlRootElement(name = "root")
@XmlAccessorType(XmlAccessType.FIELD) // 指定用字段映射，避免注解冲突
public class Root {
    // @XmlElementWrapper 指定外层的<absolute>包装节点
    // @XmlElement 指定集合中每个元素对应的<absolute-item>节点
    @XmlElementWrapper(name = "absolute")
    @XmlElement(name = "absolute-item")
    private List<String> absoluteItems;

    // 记得加getter/setter
    public List<String> getAbsoluteItems() { return absoluteItems; }
    public void setAbsoluteItems(List<String> absoluteItems) { this.absoluteItems = absoluteItems; }
}

方式2：单独写包装类

如果需要给<absolute>节点本身加额外属性，这种方式更灵活：

// 根节点类
@XmlRootElement(name = "root")
@XmlAccessorType(XmlAccessType.FIELD)
public class Root {
    @XmlElement(name = "absolute")
    private AbsoluteWrapper absoluteWrapper;

    // getter/setter
}

// <absolute>节点对应的包装类
public class AbsoluteWrapper {
    @XmlElement(name = "absolute-item")
    private List<String> absoluteItems;

    // getter/setter
}

二、解决IllegalAnnotationExceptions（Element$Location.right不可编译） #

这个异常几乎都是注解使用错误导致的，常见原因和解决方法：

1. 非静态内部类不能用JAXB注解
   如果Element$Location是非静态内部类，JAXB无法独立实例化它（依赖外部类对象），必须改成静态内部类，或者把Location抽成独立的类：

   public class Element {
       // 改成静态内部类
       public static class Location {
           @XmlElement(name = "right")
           private String right;
   
           // getter/setter
       }
   
       @XmlElement(name = "location")
       private Location location;
   }
   

2. 字段和方法重复标注注解
   JAXB默认只能选一种映射方式：要么用字段，要么用方法（getter/setter）。如果同时在字段和对应的getter上标了@XmlElement，就会冲突。建议统一用@XmlAccessorType(XmlAccessType.FIELD)指定字段映射，避免混乱。

3. 泛型类型或注解目标错误
   检查集合的泛型类型是否能被JAXB识别（比如不要用自定义的未加注解的类），也不要给非集合类型加@XmlElementWrapper。

三、完整可运行示例 #

给你一个能直接跑通的测试代码，对照着改自己的类就好：

XML示例（config.xml）

<config>
  <absolute>
    <absolute-item>file:///C:/test1.txt</absolute-item>
    <absolute-item>file:///D:/test2.txt</absolute-item>
  </absolute>
  <location>
    <right>100</right>
  </location>
</config>

Java映射类

import javax.xml.bind.annotation.*;
import java.util.List;

@XmlRootElement(name = "config")
@XmlAccessorType(XmlAccessType.FIELD)
public class Config {

    @XmlElementWrapper(name = "absolute")
    @XmlElement(name = "absolute-item")
    private List<String> absoluteItems;

    @XmlElement(name = "location")
    private Location location;

    // getter/setter
    public List<String> getAbsoluteItems() { return absoluteItems; }
    public void setAbsoluteItems(List<String> absoluteItems) { this.absoluteItems = absoluteItems; }
    public Location getLocation() { return location; }
    public void setLocation(Location location) { this.location = location; }

    // 静态内部类
    public static class Location {
        @XmlElement(name = "right")
        private String right;

        public String getRight() { return right; }
        public void setRight(String right) { this.right = right; }
    }
}

解析代码

import javax.xml.bind.JAXBContext;
import javax.xml.bind.Unmarshaller;
import java.io.File;

public class JaxbTest {
    public static void main(String[] args) throws Exception {
        JAXBContext context = JAXBContext.newInstance(Config.class);
        Unmarshaller unmarshaller = context.createUnmarshaller();
        Config config = (Config) unmarshaller.unmarshal(new File("config.xml"));

        // 测试输出
        System.out.println("Absolute items:");
        config.getAbsoluteItems().forEach(item -> System.out.println("- " + item));
        System.out.println("Location right: " + config.getLocation().getRight());
    }
}

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