StAX通过XMLStreamReader和XMLStreamWriter在START_ELEMENT事件中读写XML属性；读取用getAttributeValue(namespaceURI, localName)，写入需在writeStartElement()后、writeEndElement()前调用writeAttribute()。
StAX（Streaming API for XML）在Java中读取和写入XML属性非常直接，核心是通过XMLStreamReader和XMLStreamWriter操作属性（attribute），而不是把属性当元素处理。
读取XML元素的属性
使用XMLStreamReader时，属性只存在于START_ELEMENT事件中。调用getAttributeCount()获取数量，再用getAttributeValue(namespaceURI, localName)或getAttributeValue(index)读取值。
常见做法：
- 先判断事件类型是否为
XMLStreamConstants.START_ELEMENT - 用
getAttributeCount()确认是否有属性（避免越界） - 推荐用命名空间+本地名方式读取，更安全；若无命名空间，
namespaceURI传空字符串""
例如，对<book id="101" category="fiction"></book>，可这样取值：
立即学习“Java免费学习笔记（深入）”；
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
if (event == XMLStreamConstants.START_ELEMENT) {
String id = reader.getAttributeValue("", "id"); // "101"
String cat = reader.getAttributeValue("", "category"); // "fiction"
}
写入XML元素时添加属性
用XMLStreamWriter写元素前，调用writeStartElement()开启标签，然后连续调用writeAttribute()添加属性，最后writeEndElement()闭合。
注意点：
-
writeAttribute(localName, value)最常用，适用于无命名空间场景 - 如需带命名空间，用
writeAttribute(prefix, namespaceURI, localName, value) - 属性必须在
writeStartElement()之后、内容或子元素之前写入
示例生成<book id="101" category="fiction"></book>：
writer.writeStartElement("book");
writer.writeAttribute("id", "101");
writer.writeAttribute("category", "fiction");
writer.writeEndElement();
读写属性的典型误区
容易混淆属性（attribute）和文本内容（character data）或子元素（child element）。StAX中：
- 属性只能出现在
START_ELEMENT里，END_ELEMENT没有属性 - 不能用
getElementText()读属性——它只读起始与结束标签之间的文本 - 写属性时若在
writeStartElement()前或writeEndElement()后调用writeAttribute()，会抛XMLStreamException
完整小例子：读一个带属性的XML并原样写回
输入：<person name="Alice" age="30"></person>
输出相同结构——验证读写一致性：
// 读
XMLInputFactory factory = XMLInputFactory.newInstance();
XMLStreamReader reader = factory.createXMLStreamReader(new StringReader(xml));
while (reader.hasNext()) {
int event = reader.next();
if (event == XMLStreamConstants.START_ELEMENT && "person".equals(reader.getLocalName())) {
String name = reader.getAttributeValue("", "name");
String age = reader.getAttributeValue("", "age");
// 写
XMLOutputFactory outFactory = XMLOutputFactory.newInstance();
XMLStreamWriter writer = outFactory.createXMLStreamWriter(System.out);
writer.writeStartElement("person");
writer.writeAttribute("name", name);
writer.writeAttribute("age", age);
writer.writeEndElement();
writer.flush();
break;
}
}
基本上就这些。属性操作不复杂但容易忽略事件时机和命名空间语境，盯住START_ELEMENT和写入顺序就没问题。
