Java XMLStreamWriter writeAttribute StAX写入属性

writeattribute 默认转义特殊字符但不自动声明命名空间，需配合 writenamespace；须在 startelement 后、endelement 前调用；三个重载版本行为不同，空值会抛 npe，务必校验。

writeAttribute 会自动转义特殊字符，但不处理命名空间前缀

writeAttribute 是 xmlstreamWriter 写入元素属性的标准方式，它默认对引号、小于号等做 XML 实体转义（比如把 & 变成 &），这点不用额外担心。但如果你传入带冒号的 prefix:localName 形式，比如 "xsi:type"，它不会自动绑定命名空间——必须提前用 setPrefix 和 writeNamespace 配合声明，否则生成的 XML 会报错或被解析器忽略。

• 只写 writeAttribute("xsi:type", "xs:String") → 输出 xsi:type="xs:string"，但没有 xmlns:xsi="..." 声明，XML 无效
• 正确做法：先 writeNamespace("xsi", "http://www.w3.org/2001/XMLSchema-instance")，再 writeAttribute("xsi:type", "xs:string")
• 如果命名空间 URI 拼错、漏调 writeNamespace，解析时常见错误是 org.xml.sax.SAXParseException: Prefix "xsi" not declared

writeAttribute 三个重载版本的区别很关键

别只记最短的那个。三个签名行为不同：writeAttribute(String localName, String value) 写无前缀属性；writeAttribute(String prefix, String localName, String value) 写带前缀属性（但不自动声明命名空间）；writeAttribute(String namespaceURI, String localName, String value) 写带命名空间 URI 的属性（推荐用于严格合规场景）。

• 用 writeAttribute("id", "123") → id="123"，安全，适合简单属性
• 用 writeAttribute("xsi", "type", "xs:string") → xsi:type="xs:string"，但需确保 xsi 已通过 writeNamespace 绑定
• 用 writeAttribute("http://www.w3.org/2001/XMLSchema-instance", "type", "xs:string") → xmlns:ns1="http://..." ns1:type="xs:string"，由 StAX 实现自动分配前缀，避免手动管理冲突
• 混用不同重载容易导致前缀重复或未声明，尤其在循环写多个命名空间属性时

writeAttribute 必须在 startElement 之后、endElement 之前调用

StAX 是事件驱动流式写入，writeAttribute 只能作用于当前正在打开的元素。如果在 startElement 前调用，会抛 java.lang.IllegalStateException: Invalid state. Expecting START_ELEMENT；如果在 endElement 后调用，则直接抛异常或静默失败（取决于实现）。

• 正确顺序： writeStartElement("book") → writeAttribute("id", "101") → writeCharacters("Java Guide") → writeEndElement()
• 错误示例：先 writeEndElement()，再补 writeAttribute(...) → 运行时报 IllegalStateException
• 嵌套元素中，每个 writeAttribute 只属于最近一次未闭合的 writeStartElement

空字符串和 NULL 值传给 writeAttribute 的行为不一致

传 null 给 writeAttribute 多数实现会直接抛 NullPointerException；传空字符串 "" 则合法，生成 attr=""。但要注意某些老版本 Woodstox 或 Aalto 在特定配置下对空值容忍度不同。

立即学习“Java免费学习笔记（深入）”；

• 永远校验变量是否为 null，再决定写入： if (id != null) writer.writeAttribute("id", id);
• 如果业务上空值应省略该属性，就不要写；如果语义上需要显式 attr=""，才传 ""
• 避免依赖默认行为，比如认为 writeAttribute("flag", null) 会跳过——它不会，而是崩溃
• 测试时用真实 XMLStreamWriter 实例（别用 mock），因为不同底层实现对边界输入的反应可能不同

命名空间绑定时机、重载选择、调用位置、空值防御——这四点漏掉任何一个，都可能让生成的 XML 在下游系统里悄无声息地失效。