Properties 类

在编写应用程序的时候，经常需要读写配置文件。

例如记录用户上次打开的文件，自动保存文件的时间间隔，使用什么主题等：

# 上次最后打开的文件:
last_open_file=/data/hello.txt
# 自动保存文件的时间间隔:
auto_save_interval=60
# 使用什么主题:
colorTheme=Monokai

我们使用的配置文件，其内容通常是 key-value 型的，我们完全可以用 Map<String, String> 来存储和处理；但我们不用自己造轮子，Java 集合库提供了一个 Properties 来表示一组“配置”。

读取配置文件

Java 默认配置文件以 .properties 为扩展名，每行以 key=value 表示，以 # 课开头的是注释

我们自己手动创建一个配置文件 setting.properties，然后再读取。

# setting.properties
last_open_file=/data/hello.txt
auto_save_interval=60

import java.io.FileInputStream;
import java.util.Properties;

public class IODemo8Properties {
  public static void main(String[] args) throws Exception{
    String filename = "setting.properties";
    Properties props = new Properties();
    props.load(new FileInputStream(filename));

    String last_open_file = props.getProperty("last_open_file");
    String auto_save_interval = props.getProperty("auto_save_interval");

    System.out.println("last_open_file: " + last_open_file);
    System.out.println("auto_save_interval: " + auto_save_interval);
  }
}

调用 getProperty() 获取配置时，如果 key 不存在，将返回 null。我们还可以提供一个默认值，这样，当 key 不存在的时候，就返回默认值，语法格式为：public String getProperty(String key,String defaultValue)，实践：

    String testDefault = props.getProperty("testDefault", "aaa");
    System.out.println("testDefault: " + testDefault);    //aaa

用 Properties 读取配置文件，一共有三步：

1. 创建 Properties 实例；
2. 调用 load() 读取文件；
3. 调用 getProperty() 获取配置。

注意点：

• 如果有多个 .properties 文件，可以反复调用 load() 读取，后读取的 key-value 会覆盖已读取的 key-value。通过这种机制，我们可以先读取有默认的配置文件，然后读取用户自己的配置，这样就达到了用户的配置优先于默认配置的效果。
• load(InputStream) 方法接收一个 InputStream 实例，表示一个字节流，它不一定是文件流，还可以是 ByteArrayInputStream 等。

写入配置文件

如果通过 setProperty() 修改了 Properties 实例，可以把配置写入文件，以便下次启动时获得最新配置。写入配置文件使用 store() 方法：

public void store(OutputStream out, String comments)throws IOException

第一个参数是 OutputStream，第二个参数是本次存储配置时的注释（也会存储到配置文件里）

import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.util.Properties;

public class IODemo8PropertiesWrite {
  public static void main(String[] args) throws Exception{
    String filename = "setting.properties";
    Properties props = new Properties();
    props.load(new FileInputStream(filename));

    props.setProperty("myWebsite", "www.peterjxl.com");
    props.store(new FileOutputStream(filename), "comment");
  }
}

运行后，配置文件内容如下：

#comment
#Mon Jan 30 22:42:33 CST 2023
myWebsite=www.peterjxl.com
auto_save_interval=60
last_open_file=/data/hello.txt

编码问题

早期版本的 Java 规定 .properties 文件编码是 ASCII 编码（ISO8859-1），如果涉及到中文就必须用 name=\u4e2d\u6587 来表示，非常别扭。从 JDK9 开始，Java 的 .properties 文件可以使用 UTF-8 编码了。

不过，需要注意的是，由于 load(InputStream) 默认总是以 ASCII 编码读取字节流，所以会导致读到乱码。我们需要用另一个重载方法 load(Reader) 读取：

Properties props = new Properties();
props.load(new FileReader("settings.properties", StandardCharsets.UTF_8));

就可以正常读取中文。InputStream 和 Reader 的区别是一个是字节流，一个是字符流。字符流在内存中已经以 char 类型表示了，不涉及编码问题。