当前位置：首页 > 后端开发 > 正文

java怎么写xml

admin
后端开发
2025-08-06
8

Java可通过DOM/SAX库操作 XML：创建Document对象，构建节点树，设置元素/属性，调用Transformer将内存中的文档序列化为 XML文件

在Java中操作XML的核心在于利用标准API或第三方库实现结构化数据的序列化/反序列化,以下从基础概念到完整实践方案展开详细说明：

核心认知体系

维度	说明
本质定位	XML是树形结构化数据格式，Java通过DOM/SAX/StAX等模型将其映射为内存对象
核心矛盾	程序化表达（线性代码）↔层级化数据（嵌套标签）之间的转换逻辑设计
关键动作	创建/读取XML文档增删改查节点属性操作命名空间管理
典型场景	配置文件存储、WebService数据交换、跨平台数据持久化

主流实现方案详解

DOM（Document Object Model）全量加载法

特征：将整个XML文档载入内存构建节点树，适合中小型文件操作

// 完整示例：创建含图书列表的XML import javax.xml.parsers.; import org.w3c.dom.; import javax.xml.transform.; import javax.xml.transform.dom.DOMSource; import javax.xml.transform.stream.StreamResult; public class DomExample { public static void main(String[] args) throws Exception { // 1. 创建空文档 DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance(); DocumentBuilder builder = factory.newDocumentBuilder(); Document doc = builder.newDocument(); // 2. 构建根节点 Element root = doc.createElement("library"); doc.appendChild(root); // 3. 添加子节点及属性 for(int i=1; i<=3; i++){ Element book = doc.createElement("book"); book.setAttribute("id", "B00"+i); Element title = doc.createElement("title"); title.appendChild(doc.createTextNode("Java编程思想")); book.appendChild(title); Element author = doc.createElement("author"); author.appendChild(doc.createTextNode("Bruce Eckel")); book.appendChild(author); root.appendChild(book); } // 4. 输出格式化XML TransformerFactory tff = TransformerFactory.newInstance(); Transformer tf = tff.newTransformer(); tf.setOutputProperty(OutputKeys.INDENT, "yes"); tf.transform(new DOMSource(doc), new StreamResult(System.out)); } }

执行结果：

<?xml version="1.0" encoding="UTF-8" standalone="no"?> <library> <book id="B001"> <title>Java编程思想</title> <author>Bruce Eckel</author> </book> <book id="B002">...</book> <book id="B003">...</book> </library>

SAX（Simple API for XML）事件驱动法

优势：基于推送模式的事件回调，内存占用极低，适合GB级大文件处理

java怎么写xml 第1张

java怎么写xml 第2张

// SAX解析器实现 import org.xml.sax.; import org.xml.sax.helpers.DefaultHandler; import java.util.ArrayList; import java.util.List; public class SaxParser extends DefaultHandler { private List<String> titles = new ArrayList<>(); @Override public void startElement(String uri, String localName, String qName, Attributes attrs) { if("title".equals(qName)) { System.out.println("发现标题元素: " + qName); } } @Override public void characters(char[] ch, int start, int length) { String content = new String(ch, start, length).trim(); if(!content.isEmpty()) { titles.add(content); } } public List<String> getTitles() { return titles; } }

调用方式：

SAXParserFactory factory = SAXParserFactory.newInstance(); SAXParser saxParser = factory.newSAXParser(); saxParser.parse(new File("books.xml"), new SaxParser());

StAX（Streaming API for XML）拉取式迭代法

特点：结合推/拉模型优势，通过Cursor逐条读取事件，比SAX更易控制流程

java怎么写xml 第3张

// StAX读写示例 import javax.xml.stream.; import java.io.; public class StAXDemo { public static void writeXml() throws Exception { XMLOutputFactory xof = XMLOutputFactory.newInstance(); try (XMLStreamWriter writer = xof.createXMLStreamWriter(new FileOutputStream("stax.xml"))) { writer.writeStartDocument("UTF-8", "1.0"); writer.writeStartElement("students"); writer.writeStartElement("student"); writer.writeAttribute("rollNo", "S101"); writer.writeStartElement("name"); writer.writeCharacters("张三"); writer.writeEndElement(); // name闭合 writer.writeEndElement(); // student闭合 writer.writeEndDocument(); } } }

JAXB（Java Architecture for XMLBinding）注解映射法

革命性方案：通过POJO与XML的自动映射，彻底消除手工编码

// 1. 定义JavaBean（需无参构造+getter/setter） @XmlRootElement(name="order") @XmlAccessorType(XmlAccessType.FIELD) // 根据字段而非getter生成XML public class Order { @XmlAttribute private String orderId; @XmlElementWrapper(name="items") // 包装集合的父元素 @XmlElement(name="item") // 集合项元素名 private List<Item> items; // 省略其他字段及getter/setter } // 2. 执行绑定操作 JAXBContext context = JAXBContext.newInstance(Order.class); Marshaller marshaller = context.createMarshaller(); marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true); // 美化输出 marshaller.marshal(orderObject, new File("order.xml")); // 对象→XML Unmarshaller unmarshaller = context.createUnmarshaller(); Order loadedOrder = (Order)unmarshaller.unmarshal(new File("order.xml")); // XML→对象

关键操作对照表

操作类型	DOM实现方式	SAX实现方式	JAXB实现方式
创建新文档	DocumentBuilder创建空文档	需手动生成完整XML字符串	直接实例化Java对象
读取节点值	getTextContent()	在characters()回调中捕获	通过getter方法获取
修改节点内容	直接操作节点对象	需重建整个XML片段	修改对象属性后重新序列化
处理命名空间	createElementNS()	在startElement中识别前缀	使用@XmlSchema注解配置
性能表现	O(n²) 随文档增大显著下降	O(n) 线性时间	O(n) 依赖底层实现
最佳适用场景	<5MB的配置文件/小型数据集	>10MB的大型日志文件	复杂业务对象的长期维护

高级技巧与陷阱规避

编码处理：始终显式指定字符集（如UTF-8），防止中文乱码 // DOM写入时设置编码 tf.setOutputProperty(OutputKeys.ENCODING, "UTF-8");
CDATA区块：用于包裹特殊字符（如SQL语句） Element script = doc.createElement("script"); doc.createCDATASection("SELECT FROM users"); script.appendChild(cdataSection);
注释处理：通过createComment()创建注释节点
线程安全：DOM解析器非线程安全，多线程环境需加锁或改用ThreadLocal
命名空间冲突：使用createElementNS()并正确声明默认命名空间 String NS_URI = "http://example.com/schema"; Element specialElem = doc.createElementNS(NS_URI, "ns:special");

常见错误调试指南

现象	可能原因	解决方案
文件找不到异常	路径未转义或工作目录错误	使用绝对路径或getClass().getResource()
标签闭合不全	忘记调用writeEndElement()	严格配对每个writeStartElement()
属性重复定义	同一元素多次设置相同属性	合并属性值或使用复合属性
数字精度丢失	BigDecimal转为Double时的截断	改用BigDecimal类型字段
日期格式错误	默认ISO格式不符合需求	自定义@XmlJavaTypeAdapter适配器