Java dom4j到底怎么配置和使用？

还在为Java处理XML文档发愁？每次看到那些层层嵌套的标签就头皮发麻？今天咱们就来聊聊这个让无数新手又爱又恨的dom4j，手把手带你从零开始搞定配置和基础操作！

一、配置dom4j环境

要玩转dom4j，首先得把它请进项目里。这里有两个经典姿势任君选择：

姿势A：传统手工配置 1. 官网（虽然是老古董网站了）下载dom4j-1.6.1.jar 2. 在IDE里右键项目 → Build Path → Add External JARs 3. 别忘了顺手把配套的jaxen.jar也加进来（XPath支持全靠它）

姿势B：Maven自动配置 在pom.xml里塞这段代码： xml <dependency> <groupId>org.dom4j</groupId> <artifactId>dom4j</artifactId> <version>1.6.1</version> </dependency> 注意看控制台有没有报红，有时候版本冲突会让人抓狂。要是遇到ClassNotFound错误，八成是依赖没装好。

二、入门三板斧操作

咱们用个学生信息的XML文件来练手，假设文件长这样： xml <students> <student id=”1001″> <name>张三</name> <age>18</age> </student> </students>

第一斧：创建文档对象 java SAXReader reader = new SAXReader(); Document document = reader.read(new File(“students.xml”)); 这步要是报错，十有八九是文件路径不对。建议先用绝对路径试，成功了再改相对路径。

第二斧：读取数据 java Element root = document.getRootElement(); List<Element> students = root.elements(“student”); for(Element stu : students){ String name = stu.elementText(“name”); System.out.println(“找到学生：” + name); } 这里有个坑：elementText()方法如果找不到子元素会返回null，记得做判空处理！

第三斧：修改保存 “`java Element firstStu = (Element) root.elements().get(0); firstStu.element(“age”).setText(“19”);

// 输出格式化后的XML OutputFormat format = OutputFormat.createPrettyPrint(); XMLWriter writer = new XMLWriter(new FileWriter(“updated.xml”), format); writer.write(document); writer.close(); 保存时如果出现乱码，试试在OutputFormat里指定编码：java format.setEncoding(“UTF-8”); “`

三、进阶技巧放送

Q：怎么处理带命名空间的XML？ 比如遇到这种： xml <ns:students xmlns:ns=”http://example.com”> <ns:student>…</ns:student> </ns:students> 读取时要加命名空间映射： java HashMap<String,String> nsMap = new HashMap<>(); nsMap.put(“ns”, “http://example.com”); Element student = root.element(new QName(“student”, nsMap.get(“ns”)));

Q：XPath怎么用才顺手？ 先确保导入了jaxen.jar，然后这样玩： java List<Node> nodes = document.selectNodes(“//student[age>18]”); 这个XPath表达式会找出所有年龄大于18的学生节点。注意表达式语法和普通XPath稍有不同，建议先在在线测试工具验证。

四、常见坑位预警

五、你可能想问

dom4j有什么缺点？ 虽然用着顺手，但官方早在2015年就停止维护了。现在更推荐用JDOM2或者XStream，不过现存的老项目还是很多在用dom4j，学学总没坏处。

什么时候该换其他库？ 当需要处理超大XML文件（比如几个G的）时，dom4j的内存占用会让你哭，这时候就该上StAX了。不过日常小文件处理，dom4j依然很香。

小编观点：作为过来人，dom4j就像自行车，虽然现在满大街都是电动车（指其他更现代的库），但学骑自行车的过程能让你真正理解XML解析的运作机制。刚开始可能会被各种Element、Attribute绕晕，多写几个实战案例就通透了。记住，编程没有捷径，唯手熟尔！