0

0

Java中的Properties.loadFromXML用法_使用XML格式存储配置信息

P粉602998670

P粉602998670

发布时间:2026-02-27 09:59:44

|

532人浏览过

|

来源于php中文网

原创

invalidformatexception 根本原因是 xml 不符合 java properties 的严格 schema:根节点必须为 ,且至少含一个 或 ,禁止命名空间、doctype 等;loadfromxml() 支持 utf-8 中文但结构刚性,性能较差且不支持嵌套。

java中的properties.loadfromxml用法_使用xml格式存储配置信息

Properties.loadFromXML 读取 XML 配置时抛出 InvalidFormatException

根本原因是 XML 格式不满足 Java 内置的 Properties XML 规范——它不是任意 XML,而是有严格 schema 的固定结构。

常见错误现象:java.util.InvalidFormatException: Invalid XML document. Root element must be <properties>, and root element must contain one <comment> or <entry> subelement</entry></comment></properties>

  • 根节点必须是 <properties></properties>(大小写敏感),不能是 <config></config><root></root>
  • 必须包含至少一个 <entry key="xxx">yyy</entry> 或一个
    <comment>xxx</comment></li>
    <li>不允许出现命名空间、DOCTYPE、处理指令(如 <code><?xml version="1.0"?>
    可以有,但不能带 standalone="no" 等额外属性)
  • 注释节点 <comment></comment> 必须在所有 <entry></entry> 之前,且最多只能有一个

正确示例(可直接用 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>
</properties>

为什么不用 load() 而选 loadFromXML()

核心区别不在“是否支持中文”,而在于编码与结构容错性:XML 默认按 UTF-8 解析,天然规避 load() 的 ISO-8859-1 乱码陷阱;但代价是牺牲灵活性。

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

启科网络PHP商城系统
启科网络PHP商城系统

启科网络商城系统由启科网络技术开发团队完全自主开发,使用国内最流行高效的PHP程序语言,并用小巧的MySql作为数据库服务器,并且使用Smarty引擎来分离网站程序与前端设计代码,让建立的网站可以自由制作个性化的页面。 系统使用标签作为数据调用格式,网站前台开发人员只要简单学习系统标签功能和使用方法,将标签设置在制作的HTML模板中进行对网站数据、内容、信息等的调用,即可建设出美观、个性的网站。

下载
  • load() 读取 .properties 文件:简单、兼容老配置,但值中含中文需 Unicode 转义(如 name=\u4f60\u597d),否则乱码
  • loadFromXML() 读取 .xml 文件:值可直接写明文中文,无需转义,但要求 XML 结构合规,且不支持带空格的 key(<entry key="cache size">1024</entry> 会解析失败)
  • 性能上,loadFromXML()load() 慢约 2–3 倍(DOM 解析开销),小配置无感,高频加载场景需留意

loadFromXML() 不支持嵌套或列表,别硬塞复杂结构

Java 的 Properties 是纯键值对容器,XML 只是换种格式存扁平数据——它不解析子元素、不递归、不识别数组语法。

错误尝试:

<entry key="redis.nodes">
  <host>127.0.0.1</host>
  <port>6379</port>
</entry>

结果:loadFromXML() 把整个 XML 片段当字符串值读入,getProperty("redis.nodes") 返回的是带标签的原始文本,不是对象。

  • 若需结构化配置,应换用 JAXBJackson(XML module)或 SnakeYAML 等专用库
  • 若坚持用 Properties,可用点号分隔模拟层级,如 redis.host=127.0.0.1redis.port=6379,再手动组装
  • 列表类需求只能靠约定,例如 task.keys=key1,key2,key3,再用 String.split(",") 拆分

保存 XML 时别漏掉 storeToXML() 的必需参数

storeToXML() 第二个参数是注释(String comment),传 null 会导致生成的 XML 缺少 <comment></comment> 节点,下次用 loadFromXML() 就会报错。

  • 正确调用:props.storeToXML(outputStream, "Auto-generated config", "UTF-8")
  • 错误写法:props.storeToXML(outputStream, null) → 输出无 <comment></comment>,加载失败
  • 第三个参数(encoding)建议显式指定 "UTF-8",避免平台默认编码差异(如 Windows 上可能用 GBK)
  • 生成的 XML 中 <entry></entry> 值里的特殊字符(、<code>&)会被自动转义,无需手动处理

XML 格式校验比 properties 文件严格得多,一个空格、多一行注释、少一个闭合标签,都可能让 loadFromXML() 直接崩溃。真要图省事,不如老实用 .properties + native2ascii;非要 XML,就老老实实按它的规矩来。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
string转int
string转int

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

850

2023.08.02

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

248

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

906

2024.03.01

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的相关内容,可以阅读本专题下面的文章。

2111

2024.08.01

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

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

1139

2024.11.28

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

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

638

2023.08.03

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

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

218

2023.09.04

html5播放器怎么用
html5播放器怎么用

本合集全面介绍HTML5播放器的使用方法,涵盖基础语法、自定义控制、兼容性处理及实战示例。阅读专题下面的文章了解更多详细内容。

0

2026.02.27

热门下载

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

精品课程

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

共23课时 | 3.9万人学习

C# 教程
C# 教程

共94课时 | 10.2万人学习

Java 教程
Java 教程

共578课时 | 72.7万人学习

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

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