异常教程

XML DOM – NamedNodeMap 对象（长文讲解）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

在 XML 文档的解析与操作中，DOM（Document Object Model）提供了一套强大的接口，帮助开发者以对象化的方式访问和修改文档内容。其中，XML DOM – NamedNodeMap 对象是一个容易被低估但至关重要的工具。它如同一座桥梁，连接着 XML 元素与其属性，为开发者提供了高效管理节点属性的途径。无论是处理配置文件、解析 API 响应，还是构建动态内容，理解这一对象的特性与用法，都能显著提升代码的灵活性和可维护性。本文将从基础概念到实际案例，逐步解析这一对象的核心原理与应用场景。

一、什么是 NamedNodeMap？

NamedNodeMap 是 XML DOM 中用于存储节点属性的特殊集合对象。它类似于字典或哈希表，通过属性名称（Name）快速定位对应的节点（Node），而非通过索引（Index）。

1.1 概念比喻

想象一个图书馆的目录系统：每本书都有唯一的书名（属性名），读者可通过书名直接找到该书的位置（属性值）。NamedNodeMap 就是这样的“目录”，它将 XML 元素的属性名作为“关键词”，映射到对应的属性节点上。例如，对于以下 XML 节点：

<book id="001" title="Effective JavaScript" author="David Herman" />

其 attributes 属性（即 NamedNodeMap）会将 id、title、author 等属性名映射到各自的节点上。

1.2 核心特性

  • 无索引访问：不能通过数字索引（如 map[0]）直接获取元素，必须通过属性名（getNamedItem()）或遍历（item()）。
  • 不可直接修改：虽然可以读取或删除节点，但新增或修改属性通常需要通过父节点的方法（如 setAttribute()）。
  • 动态性：当属性被添加或删除时，NamedNodeMap 会实时反映变化。

二、NamedNodeMap 的核心方法与用法

以下是 NamedNodeMap 对象最常用的方法，结合代码示例说明其工作原理：

2.1 getNamedItem(name)

通过属性名获取对应的节点：

// 创建 XML 文档并访问元素  
const xmlDoc = new DOMParser().parseFromString(`
  <bookstore>
    <book id="001" title="JavaScript: The Definitive Guide" />
  </bookstore>`, "application/xml");
const bookNode = xmlDoc.querySelector("book");  
const attributes = bookNode.attributes;  

// 获取 title 属性节点  
const titleAttr = attributes.getNamedItem("title");  
console.log(titleAttr.value); // 输出："JavaScript: The Definitive Guide"

2.2 item(index)

通过索引遍历所有属性（索引从 0 开始）：

for (let i = 0; i < attributes.length; i++) {  
  const attr = attributes.item(i);  
  console.log(`属性名：${attr.name}, 值：${attr.value}`);  
}  
// 输出：  
// 属性名：id, 值：001  
// 属性名：title, 值：JavaScript: The Definitive Guide

2.3 setNamedItem(node) 和 removeNamedItem(name)

修改或删除属性时，需通过节点的方法间接操作：

// 新增属性（需先创建 Attr 节点）  
const newAttr = xmlDoc.createAttribute("genre");  
newAttr.value = "Programming";  
attributes.setNamedItem(newAttr);  

// 删除属性  
attributes.removeNamedItem("id");

三、实际案例：解析 XML 配置文件

假设有一个 XML 配置文件，描述书籍信息：

<config>  
  <book id="001" title="Clean Code" pages="464" />  
  <book id="002" title="You Don't Know JS" pages="250" />  
</config>

目标是遍历所有书籍，提取其 id 和 pages 属性，并计算总页数。

3.1 步骤分解

  1. 解析 XML 文档：使用 DOMParser 将字符串转为 DOM 对象。
  2. 获取所有书籍节点：通过 querySelectorAll 选择所有 <book> 元素。
  3. 遍历属性：对每个书籍节点的 attributes 进行处理。

3.2 完整代码示例

const xmlString = `...`; // 上述 XML 内容  
const xmlDoc = new DOMParser().parseFromString(xmlString, "application/xml");  
const books = xmlDoc.querySelectorAll("book");  
let totalPages = 0;  

books.forEach(book => {  
  const attrs = book.attributes;  
  const id = attrs.getNamedItem("id").value;  
  const pages = Number(attrs.getNamedItem("pages").value);  
  totalPages += pages;  
  console.log(`书籍 ${id} 的页数为 ${pages}`);  
});  

console.log(`总页数：${totalPages}`);

四、NamedNodeMap 与其他数据结构的对比

4.1 与 Array 的区别

  • Array：通过索引访问元素，支持增删改查的直接操作。
  • NamedNodeMap：通过名称访问，仅支持有限的增删操作（需依赖父节点方法）。

4.2 与 Map 的区别

  • Map：键值对的集合，支持任意类型键，且可直接修改值。
  • NamedNodeMap：键必须是字符串（属性名），且节点本身是不可变的（修改需通过父节点）。

五、进阶技巧与常见问题

5.1 如何避免 NamedNodeMap 的陷阱？

  • 属性名大小写敏感：XML 默认区分大小写，因此 getNamedItem("ID") 和 getNamedItem("id") 可能返回不同结果。
  • 空值处理：若属性不存在，getNamedItem() 返回 null，需避免空指针错误。

5.2 结合其他 DOM 方法的高效用法

通过 NamedNodeMap 与 Element 的 setAttribute() 结合，可以实现属性的动态更新：

// 修改属性值  
const bookNode = xmlDoc.querySelector("book");  
bookNode.setAttribute("title", "Clean Code: A Handbook of Agile Software Craftsmanship");

结论

XML DOM – NamedNodeMap 对象 是开发者在处理 XML 节点属性时不可或缺的工具。通过掌握其核心方法（如 getNamedItem() 和 item()）以及与父节点的协作方式，开发者能够高效解析、遍历和修改 XML 数据。无论是配置文件管理、数据迁移，还是动态内容生成，这一对象都能帮助开发者以清晰、结构化的方式应对复杂场景。建议读者通过实际项目尝试，例如构建 XML 配置解析器或数据转换工具，进一步巩固对 NamedNodeMap 的理解。

掌握这一工具后，开发者在面对 XML 文档时，将如同拥有了一把精准的钥匙，能够轻松打开属性管理的“门”，为后续的高级操作（如 DOM 遍历或事件处理）奠定坚实基础。

最新发布

查看更多文章