StAX适合大XML文件、内存敏感或只需部分节点的场景；它支持按需拉取事件，控制权在开发者手中，典型用于日志解析、ETL配置处理及微服务XML传输。
StAX适合什么场景
当XML文件大（几十MB以上）、内存敏感、或只需要读取部分节点时，StAX比DOM更合适；它不像SAX那样纯事件驱动、无法回退，而是允许按需拉取事件——你调next()它才吐下一个START_ELEMENT或CHARACTERS，控制权在你手里。
- 典型用例：解析日志XML流、ETL中处理带命名空间的配置片段、微服务间传输的长XML payload
- 不适合：需要频繁随机访问父/兄弟节点、要反复重读同一段内容、XML结构极不规则且需大量状态推断
-
StAX本身是接口规范，JDK自带实现是com.sun.xml.internal.stream.XMLInputFactoryImpl，但别硬编码这个类名——用XMLInputFactory.newInstance()获取，否则换JDK版本可能失败
怎么写一个安全的XMLStreamReader循环
直接while (reader.hasNext())再reader.next()容易漏掉最后一个事件，正确做法是用nextEvent()或nextTag()配合类型判断——尤其CHARACTERS事件常被忽略，导致文本内容丢失。
- 必须检查
XMLStreamConstants.START_ELEMENT和XMLStreamConstants.END_ELEMENT，但别忘了XMLStreamConstants.CHARACTERS里可能有空格或换行，用isWhiteSpace()过滤 - 遇到
START_ELEMENT后，用getAttributeCount()和getAttributeValue()取属性，别用getElementText()——它会跳过中间的END_ELEMENT，破坏流位置 - 示例关键片段：
while (reader.hasNext()) { int event = reader.next(); if (event == XMLStreamConstants.START_ELEMENT) { String localName = reader.getLocalName(); if ("item".equals(localName)) { String id = reader.getAttributeValue(null, "id"); // 后续用 nextEvent() 跳到对应 END_ELEMENT } } }
XMLInputFactory几个关键配置项
默认工厂行为对生产环境不够健壮，比如外部实体、DTD、注释都会影响解析逻辑和性能，必须显式关闭。
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
-
factory.setProperty(XMLInputFactory.IS_SUPPORTING_EXTERNAL_ENTITIES, false)：防止XXE攻击，JDK 8u191+默认false，但旧版本默认true -
factory.setProperty(XMLInputFactory.SUPPORT_DTD, false)：禁用DTD，否则!DOCTYPE会触发网络请求或本地文件读取 -
factory.setProperty(XMLInputFactory.IS_NAMESPACE_AWARE, true)：如果XML含xmlns，不设这个会导致getLocalName()返回空 - 别设
IS_VALIDATING为true——StAX不支持完整验证，设了会抛UnsupportedOperationException
常见错误：为什么getElementText()总抛XMLStreamException
这个方法表面方便，实则暗藏陷阱：它内部自动跳过所有非CHARACTERS事件，直到遇到END_ELEMENT，但如果当前节点下有子元素，就会在子START_ELEMENT处直接报错“expected CHARACTERS”。
立即学习“Java免费学习笔记（深入）”；
- 错误现象：
XMLStreamException: ParseError at [row,col]:[3,12] Message: expected a character - 根本原因：XML像
<name><first>A</first><last>B</last></name>，getElementText()进<name></name>后立刻撞上<first></first>，不是文本 - 正确做法：手动循环，用
next()+if (isCharacters()) getText()，或改用nextTag()跳过空白后再判断 - 顺带一提：
getElementText()返回的字符串不会trim，前后可能有换行和缩进，得自己strip()
StAX时，最麻烦的往往不是语法，而是XML里那些没文档说明的隐式规则：比如某个字段值为空时是省略标签、还是留着空标签、还是用xsi:nil="true"——这些都得在START_ELEMENT里挨个判断，没法偷懒。 
