0

0

如何正确配置 Maven 依赖并修复 XML 解析失败问题

霞舞

霞舞

发布时间:2026-03-01 14:04:03

|

997人浏览过

|

来源于php中文网

原创

如何正确配置 Maven 依赖并修复 XML 解析失败问题

本文详解 Java 中使用 DOM 解析 XML 时常见的 db.parse() 报错原因,重点指出错误用法(如误传 InputSource 对象字符串)、缺失核心 XML 解析依赖、JDK 17+ 的 Jakarta EE 迁移适配问题,并提供可直接运行的修复方案与完整 pom.xml 配置。

本文详解 java 中使用 dom 解析 xml 时常见的 `db.parse()` 报错原因,重点指出错误用法(如误传 `inputsource` 对象字符串)、缺失核心 xml 解析依赖、jdk 17+ 的 jakarta ee 迁移适配问题,并提供可直接运行的修复方案与完整 pom.xml 配置。

在 JDK 17+ 环境下解析 XML 字符串时,代码崩溃在 db.parse("is"+is) 这一行,根本原因并非 XML 内容本身不合法,而是调用方式严重错误:DocumentBuilder.parse(String uri) 方法期望传入的是一个可访问的 URI 路径(如文件路径或 URL),而非 InputSource 对象的字符串拼接结果(例如 "isorg.xml.sax.InputSource@7fc7ed31")。该字符串既非有效路径,也无法被解析器识别,必然抛出 IOException 或 SAXException。

正确的做法是使用 DocumentBuilder.parse(InputSource is) 重载方法——它专为内存中 XML 字符串、流或 Reader 设计。请将原第 166 行:

Document doc = db.parse("is"+is); // ❌ 错误:传入非法 URI 字符串

立即更正为:

Document doc = db.parse(is); // ✅ 正确:直接传入已配置好的 InputSource

此外,您的 pom.xml 存在两个关键缺陷,导致 XML 解析功能不可靠:

飞书知识问答
飞书知识问答

飞书平台推出的AI知识库管理和智能搜索工具

下载
  1. 缺失基础 XML 处理依赖:JDK 17 移除了 javax.xml.* 相关的内置实现(如 Xerces),且默认不包含完整的 JAXP(Java API for XML Processing)运行时。仅靠 jakarta.xml.ws-api 和 jaxws-rt 无法支撑 DOM 解析。
  2. 依赖版本未适配 Jakarta 命名空间迁移:自 Java EE 迁移至 Jakarta EE 后,所有 javax.* 包已升级为 jakarta.*。若项目混用旧包(如手动 import javax.xml.parsers.*),而依赖未同步更新,将引发 NoClassDefFoundError 或 ClassNotFoundException。

✅ 推荐的最小可行 pom.xml 依赖配置如下(兼容 JDK 17+,基于 Jakarta EE 9+ 标准):

<dependencies>
    <!-- 核心:Jakarta XML Binding + Parser 实现(替代已废弃的 Xerces) -->
    <dependency>
        <groupId>org.glassfish.jaxb</groupId>
        <artifactId>jaxb-runtime</artifactId>
        <version>4.0.4</version>
    </dependency>

    <!-- 必需:Jakarta JAXP API(提供 DocumentBuilderFactory 等抽象接口) -->
    <dependency>
        <groupId>jakarta.xml.parsers</groupId>
        <artifactId>jakarta.xml.parsers-api</artifactId>
        <version>2.0.0</version>
    </dependency>

    <!-- 可选但推荐:稳定可靠的 SAX/DOM 实现(替代可能冲突的旧版 Xerces) -->
    <dependency>
        <groupId>org.apache.xerces</groupId>
        <artifactId>xercesImpl</artifactId>
        <version>2.12.2</version>
    </dependency>

    <!-- 其他原有依赖(保持不变,但建议升级 junit) -->
    <dependency>
        <groupId>javax.mail</groupId>
        <artifactId>mail</artifactId>
        <version>1.5.0-b01</version>
    </dependency>

    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter</artifactId>
        <version>5.10.2</version>
        <scope>test</scope>
    </dependency>

    <dependency>
        <groupId>jakarta.xml.ws</groupId>
        <artifactId>jakarta.xml.ws-api</artifactId>
        <version>4.0.0</version>
    </dependency>
    <dependency>
        <groupId>com.sun.xml.ws</groupId>
        <artifactId>jaxws-rt</artifactId>
        <version>4.0.0</version>
        <scope>runtime</scope>
    </dependency>
</dependencies>

⚠️ 重要注意事项:

  • 禁止手动指定 DocumentBuilderFactory 实现类(如 System.setProperty("javax.xml.parsers.DocumentBuilderFactory", "...")),JDK 17+ 会忽略此类设置;应完全依赖标准服务发现机制(META-INF/services/jakarta.xml.parsers.DocumentBuilderFactory)。
  • 确保 XML 字符串严格合法:即使修复了调用和依赖,若 strXMLResponse 为空、含 BOM、编码不匹配(如 UTF-8 字符串被误按 ISO-8859-1 解析)或结构错误(未闭合标签、重复根节点等),仍会抛出 SAXParseException。建议在解析前添加校验:
    if (strXMLResponse == null || strXMLResponse.trim().isEmpty()) {
        throw new IllegalArgumentException("XML content is null or empty");
    }
  • 避免混合使用 javax 和 jakarta 包:检查所有 import 语句,确保全部为 jakarta.xml.*(如 jakarta.xml.parsers.DocumentBuilderFactory),而非遗留的 javax.xml.*。

完成上述修改后,您的 XML 解析逻辑将健壮运行。完整可运行示例片段如下:

import jakarta.xml.parsers.DocumentBuilder;
import jakarta.xml.parsers.DocumentBuilderFactory;
import org.w3c.dom.Document;
import org.w3c.dom.NodeList;
import org.xml.sax.InputSource;
import java.io.StringReader;

// ... 在方法内
String strXMLResponse = "<Root><Value>test</Value></Root>";
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
DocumentBuilder db = factory.newDocumentBuilder();
InputSource is = new InputSource(new StringReader(strXMLResponse));
Document doc = db.parse(is); // ✅ 正确调用
NodeList nodes = doc.getElementsByTagName("Value");
System.out.println("Found " + nodes.getLength() + " <Value> elements.");

总结:XML 解析失败往往源于“低级但致命”的 API 误用与依赖缺失。牢记三点——*用对 parse(InputSource) 方法、配齐 jakarta.xml.parsers-api + jaxb-runtime 依赖、统一使用 `jakarta.` 包命名空间**,即可彻底规避此类问题。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

0

2025.09.15

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

890

2023.08.02

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1936

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2114

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1142

2024.11.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

658

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

219

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1560

2023.10.24

Golang 测试体系与代码质量保障:工程级可靠性建设
Golang 测试体系与代码质量保障:工程级可靠性建设

Go语言测试体系与代码质量保障聚焦于构建工程级可靠性系统。本专题深入解析Go的测试工具链(如go test)、单元测试、集成测试及端到端测试实践,结合代码覆盖率分析、静态代码扫描(如go vet)和动态分析工具,建立全链路质量监控机制。通过自动化测试框架、持续集成(CI)流水线配置及代码审查规范,实现测试用例管理、缺陷追踪与质量门禁控制,确保代码健壮性与可维护性,为高可靠性工程系统提供质量保障。

6

2026.02.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号