0

0

Java Properties类怎么加载XML文件

幻夢星雲

幻夢星雲

发布时间:2026-01-14 11:25:21

|

691人浏览过

|

来源于php中文网

原创

properties.loadfromxml()是java中唯一支持xml格式配置加载的方法,要求xml以声明开头、根元素为、键值对用...表示,并严格遵循编码与实体转义规范。

java properties类怎么加载xml文件

Properties.loadFromXML() 是唯一支持 XML 的加载方法

Java 的 Properties 类本身不支持直接用 load() 读取 XML 文件——那个方法只认 ISO-8859-1 或 UTF-8 编码键值对文本。真正能加载 XML 格式的,只有 loadFromXML(InputStream) 这一个方法。

它要求输入流必须指向符合 Java XML 属性文件规范的文档,不是任意 XML。常见错误是拿 Spring 的 application.xml 或自定义格式 XML 去试,结果抛出 InvalidPropertiesFormatException

  • XML 必须以 <?xml version="1.0" encoding="UTF-8"?> 开头(编码可为 ISO-8859-1,但推荐 UTF-8)
  • 根元素必须是 <properties></properties>,且仅含一个 <comment></comment>(可选)和若干 <entry key="xxx">yyy</entry>
  • key 值不能含等号、空格或控制字符;value 中的特殊字符(如 &)需实体转义

正确的 XML 格式长什么样

下面是一个能被 loadFromXML() 成功解析的最小合法示例:

<?xml version="1.0" encoding="UTF-8"?>
<properties>
  <comment>Generated by Java</comment>
  <entry key="db.url">jdbc:h2:mem:test</entry>
  <entry key="db.user">sa</entry>
  <entry key="message.hello">Hello, & welcome!</entry>
</properties>

注意:& 是必须的——XML 解析器先解码成 &,再由 Properties 当作普通值处理。如果写成原始 &,会报 org.xml.sax.SAXParseException: The entity "amp" was referenced, but not declared

立即学习Java免费学习笔记(深入)”;

墨刀AIPPT
墨刀AIPPT

排版/配图/美化一键优化,3分钟产出专业级PPT

下载

加载时的编码与异常处理要点

loadFromXML() 内部强制使用 UTF-8 或 ISO-8859-1 解析 XML 声明中的 encoding 属性。如果你的文件声明为 encoding="GBK",它会直接失败,不会 fallback。

  • 务必确保 XML 文件保存编码与声明一致(推荐统一用 UTF-8)
  • 捕获 IOException(如文件不存在、无读权限)和 InvalidPropertiesFormatException(格式非法)
  • 不要用 FileInputStream 包裹 FileReader——XML 解析需要原始字节流,字符流会导致编码错乱

正确写法:

Properties props = new Properties();
try (InputStream is = getClass().getResourceAsStream("/config.xml")) {
  props.loadFromXML(is);
} catch (InvalidPropertiesFormatException e) {
  // XML 结构不对,比如少了 <properties> 标签
} catch (IOException e) {
  // 文件没找到或不可读
}

和 load() 的行为差异:注释、空行、Unicode 处理

loadFromXML()load() 在语义上并不等价:

  • load() 允许 # 或 ! 开头的注释行,loadFromXML() 只认 <comment></comment> 元素,且只保留第一个
  • load() 把连续空格/制表符压缩为单个空格,loadFromXML() 完全保留 value 中的空白(包括换行)
  • load() 对 Unicode 转义(uXXXX)自动解码,loadFromXML() 不做任何转义处理——value 就是 XML 文本内容原样

这意味着,如果你在 XML 里写 <entry key="name">u4f60u597d</entry>,取出来就是字符串 "\u4f60\u597d",不是“你好”。要支持 Unicode,得手动调用 StringEscapeUtils.unescapeJava()(Apache Commons Lang)或自己实现反斜杠解析。

实际用 XML 存配置的场景不多,一旦格式写错或编码不匹配,错误信息非常模糊——重点盯住 XML 声明、根标签、实体转义这三处,基本就能绕过八成问题。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

154

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

88

2026.01.26

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

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

1943

2024.04.01

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

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

2117

2024.08.01

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

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

1159

2024.11.28

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

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

718

2023.08.03

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

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

219

2023.09.04

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

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

1561

2023.10.24

JavaScript浏览器渲染机制与前端性能优化实践
JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开,系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理,以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例,帮助开发者理解浏览器底层工作原理,并掌握提升网页加载速度与交互体验的实用技巧。

1

2026.03.06

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 4.2万人学习

C# 教程
C# 教程

共94课时 | 10.8万人学习

Java 教程
Java 教程

共578课时 | 78万人学习

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

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