旧问题（2009 年 1 月）的另一个答案（2018 年 1 月）。
Java 属性文件的规范在@987654321@ 的JavaDoc 中有描述。一个问题是规范比我们可能的第一印象有点复杂。另一个问题是这里的一些答案随意添加了额外的规范——例如，; 和' 被视为注释行的开头，但它们不应该是。属性值周围的双引号/单引号被删除，但它们不应该被删除。
以下是需要考虑的点。
- 线有两种，自然线和逻辑线。
- 自然行以
\n、\r、\r\n 或流的结尾结束。
- 通过使用反斜杠字符
\ 转义行终止符序列，可以将逻辑行分散到多个相邻的自然行中。
- 逻辑行中第二行和后续自然行开头的任何空白都将被丢弃。
- 空白是空格（
\u0020）、制表符（\t、\u0009）和换页（\f、\u000C）。
- 正如规范中明确指出的那样，“仅检查行终止符序列之前的字符来确定行终止符是否被转义是不够的；行终止符必须有奇数个连续的反斜杠被转义。由于输入是从左到右处理的，因此在行终止符（或其他地方）之前的非零偶数个 2n 个连续反斜杠在转义处理后对 n 个反斜杠进行编码。"
-
= 用作键和值之间的分隔符。
-
: 也用作键和值之间的分隔符。
- 键和值之间的分隔符可以省略。
- 注释行的第一个非空白字符是
# 或!，这意味着# 或! 之前的前导空白是允许的。
- 注释行不能扩展到下一个自然行，即使它的行终止符前面是
\。
- 如规范中明确说明的那样，
=、: 和空格如果被反斜杠转义，则可以嵌入到密钥中。
- 使用
\r 和\n 转义序列甚至可以包含行终止符。
- 如果省略值，则使用空字符串作为值。
-
\uxxxx 用于表示 Unicode 字符。
- 无效转义字符之前的反斜杠字符不会被视为错误；它被默默地丢弃。
因此，例如，如果test.properties 具有以下内容：
# A comment line that starts with '#'.
# This is a comment line having leading white spaces.
! A comment line that starts with '!'.
key1=value1
key2 : value2
key3 value3
key\
4=value\
4
\u006B\u0065\u00795=\u0076\u0061\u006c\u0075\u00655
\k\e\y\6=\v\a\lu\e\6
\:\ \= = \\colon\\space\\equal
它应该被解释为以下键值对。
+------+--------------------+
| KEY | VALUE |
+------+--------------------+
| key1 | value1 |
| key2 | value2 |
| key3 | value3 |
| key4 | value4 |
| key5 | value5 |
| key6 | value6 |
| : = | \colon\space\equal |
+------+--------------------+
Authlete.Authlete NuGet 包中的PropertiesLoader 类可以解释规范的格式。下面的示例代码：
using System;
using System.IO;
using System.Collections.Generic;
using Authlete.Util;
namespace MyApp
{
class Program
{
public static void Main(string[] args)
{
string file = "test.properties";
IDictionary<string, string> properties;
using (TextReader reader = new StreamReader(file))
{
properties = PropertiesLoader.Load(reader);
}
foreach (var entry in properties)
{
Console.WriteLine($"{entry.Key} = {entry.Value}");
}
}
}
}
将生成此输出：
key1 = value1
key2 = value2
key3 = value3
key4 = value4
key5 = value5
key6 = value6
: = = \colon\space\equal
Java 中的一个等价示例如下：
import java.util.*;
import java.io.*;
public class Program
{
public static void main(String[] args) throws IOException
{
String file = "test.properties";
Properties properties = new Properties();
try (Reader reader = new FileReader(file))
{
properties.load(reader);
}
for (Map.Entry<Object, Object> entry : properties.entrySet())
{
System.out.format("%s = %s\n", entry.getKey(), entry.getValue());
}
}
}
源代码@987654323@ 可以在authlete-csharp 中找到。 xUnit 对 PropertiesLoader 的测试写在 @987654326@ 中。