Java属性类详解（零基础掌握Properties类的使用与配置文件读写）

什么是Properties类？

Properties 是 Java 标准库中的一个工具类，位于 java.util 包中。它继承自 Hashtable，专门用于处理键值对形式的配置数据，通常以 .properties 文件格式存储。

它的主要特点包括：

• 键和值都是字符串类型
• 支持从文件或输入流中加载配置
• 可将配置保存到文件或输出流
• 天然支持中文（需注意编码问题）

创建一个简单的.properties文件

首先，我们在项目根目录下创建一个名为 config.properties 的文件，内容如下：

# 数据库配置db.url=jdbc:mysql://localhost:3306/mydbdb.username=rootdb.password=123456# 应用设置app.name=MyApplicationapp.version=1.0.0

注意：注释以 # 开头，键值对之间用等号 = 分隔。

使用Properties类读取配置文件

下面是一个完整的 Java 示例，展示如何使用 Properties 类读取上面的配置文件：

import java.io.FileInputStream;import java.io.IOException;import java.util.Properties;public class ReadPropertiesExample {    public static void main(String[] args) {        Properties prop = new Properties();                try (FileInputStream fis = new FileInputStream("config.properties")) {            // 加载配置文件            prop.load(fis);                        // 获取配置项            String dbUrl = prop.getProperty("db.url");            String username = prop.getProperty("db.username");            String appName = prop.getProperty("app.name");                        System.out.println("数据库地址: " + dbUrl);            System.out.println("用户名: " + username);            System.out.println("应用名称: " + appName);                    } catch (IOException e) {            e.printStackTrace();        }    }}

运行这段代码，你将看到控制台输出配置文件中的内容。这里使用了 try-with-resources 语法，确保文件流自动关闭，避免资源泄漏。

使用Properties类写入配置文件

你也可以动态修改配置并保存回文件：

import java.io.FileOutputStream;import java.io.IOException;import java.util.Properties;public class WritePropertiesExample {    public static void main(String[] args) {        Properties prop = new Properties();                // 设置新的属性        prop.setProperty("server.port", "8080");        prop.setProperty("logging.level", "INFO");                try (FileOutputStream fos = new FileOutputStream("new_config.properties")) {            // 保存到文件，并添加注释            prop.store(fos, "新增的服务器配置");            System.out.println("配置已成功保存！");        } catch (IOException e) {            e.printStackTrace();        }    }}

执行后，会在项目目录下生成一个 new_config.properties 文件，内容包含时间戳和你设置的键值对。

常见问题与注意事项

• 编码问题：默认情况下，.properties 文件使用 ISO-8859-1 编码。如果要使用中文，建议使用 Unicode 转义（如 \u4E2D\u6587），或在 Java 9+ 中使用 loadFromXML() 方法配合 XML 格式。
• 路径问题：确保文件路径正确。在 IDE 中运行时，相对路径通常相对于项目根目录。
• 线程安全：Properties 是线程安全的，因为其父类 Hashtable 是同步的。

总结

通过本教程，你已经掌握了 Java属性类（Properties）的基本用法，包括读取和写入 .properties 配置文件。这是 Java 开发中非常实用的技能，尤其在处理 Java配置文件读取 场景时不可或缺。

记住，良好的配置管理能让程序更灵活、更易维护。希望这篇 Java Properties教程 能帮助你在实际项目中高效使用 Properties类使用 技巧！

动手实践是掌握知识的最佳方式，快去创建你的第一个 .properties 文件吧！