properties

properties 把 Java 风格 .properties 文件作为键值集合读取,支持续行,并把带点的名称呈现为便于搜索和定点修改的路径。

数据版本 1.1.5稳定
lil-terminal

概览

properties 直接处理 Java Properties 文件:读取点路径键,搜索键或值,原子修改一项设置,验证文件,并查看完整的规范化源文本。

点路径仍然属于扁平文件

database.host 作为路径很方便,但磁盘上的文件仍然是扁平结构。结构化写入会把它规范化为 key=value 行;若必须保留注释和精确排版,请使用文本编辑器。

语法

lil-terminal
properties <file> [key|options] · properties dump <file>

参考

properties <file>

显示 properties 数据

properties <file> <key>

显示一个精确的点路径

properties dump <file>

显示规范化的 properties 源文本

-f <text|mask> [-k|-v]

在键或值中查找匹配项;* 和 ? 表示掩码

-w <key> : <value>

直接把值写入文件

-w <key> < <file>

写入从另一个文件读取的值

-d <key>

按点路径删除值

-c

验证 properties 文件

交互式 sandbox 预览

可直接在页面中运行预先准备的示例。结果已预先生成并在浏览器中显示;服务器不会执行任何终端命令。

打开文件并通过 $ 继续使用

安装与管理

安装当前兼容版本。完整功能请选择 Base,精简包请选择 Minimum;已安装模块的更新请使用 upgrade。

Base 与 Minimum 是同一当前模块版本的两个包。

Base 包

安装包含本地参考和全部已发布模式的完整包。

install properties
Minimum 包

安装精简包。该包不包含本地参考;help <cmd> -i 会打开当前服务器参考。

install properties -m
精确公开版本

安装这个确切的已发布版本。

install properties -v 1.1.5
检查或升级

让 upgrade 检查兼容性,仅在需要时替换已安装块。

upgrade properties
删除模块

删除扩展块,不影响核心和其他模块。

install properties -u

示例

示例可复制,但网站不会执行。请先检查路径、权限和破坏性选项。

打开文件并通过 $ 继续使用
cd \sandbox\config | properties app.properties
application.name   lil-shop
application.debug  true
database.host      localhost
database.port      3306
显示 properties 数据
app.properties
application.name   lil-shop
application.debug  true
database.host      localhost
database.port      3306
显示一个精确的点路径
properties $ database.host
localhost
Properties · find-key
properties $ -f "application*" -k
application.name  lil-shop
application.debug  true
Properties · find-value
properties $ -f "localhost" -v
database.host  localhost
Properties · write
properties $ -w database.password : "Ed1g!fs:13od"
database.password  Ed1g!fs:13od
Properties · delete
properties $ -d database.password
database.host  localhost
database.port  3306
Properties · validate
properties $ -c
Valid properties
显示规范化的 properties 源文本
properties dump $
application.name=lil-shop
application.debug=true
database.host=localhost
database.port=3306
处理不存在的文件
properties \sandbox\config\missing.properties
未找到文件

本示例使用的文件: sandbox/config/app.properties

该示例使用受保护的 /sandbox/ 文档工作区中的文件或目录。

application.name=lil-shop
application.debug=true
database.host=localhost
database.port=3306

相关文档

当前公开版本

v1.1.52026-08-14

统一的 properties 参考

properties 现在与其他结构化数据格式使用同一套紧凑参考布局。