JAVA8 官网笔记教程

# 属性（properties）

属性是作为键/值对管理的配置值。在每一对中，键和值都是两个 String 值。该键标识并用于检索该值， 就像变量名称用于检索变量的值一样。例如，能够下载文件的应用程序可能会使用名为 “download.lastDirectory” 的属性来跟踪最后一次下载所用的目录。

要管理属性，请创建实例 java.util.Properties。该类提供了以下方法：

  • 将键/值对从流中加载到 Properties 对象中，
  • 从其键中检索一个值，
  • 列出 key 及其 value，
  • 列举 key
  • 将属性保存到流。

有关流的介绍，请参阅基本 I / O 课程中的 I / O 流部分 。

  • Starting Up

    当应用程序启动时，前三个框中的操作会发生。

    1. 首先，应用程序将默认属性从众所周知的位置加载到 Properties 对象中。通常，默认属性将与应用程序的 .class 其他资源文件一起存储在磁盘上的文件中。
    2. 接下来，应用程序创建另一个 Properties 对象，并加载从上次运行应用程序时保存的属性。许多应用程序在每个用户的基础上存储属性，因此此步骤中加载的属性通常位于该应用程序在用户主目录中维护的特定目录中的特定文件中。
    3. 最后，应用程序使用默认和记住的属性来初始化自身。

    这里的关键是一致性。

  • Running

    在执行应用程序期间，用户可能会在“首选项”窗口中更改某些设置，并更新 Properties 对象以反映这些更改。如果用户更改在以后的会话中被记住，则必须保存它们。

  • Exiting

    退出后，应用程序将属性保存到其知名位置，以便在下次启动应用程序时再次加载该属性。

# 设置属性对象

以下 Java 代码执行前面部分描述的前两个步骤：加载默认属性并加载记住的属性：

. . .
// 创建并加载默认值
Properties defaultProps = new Properties();
FileInputStream in = new FileInputStream("defaultProperties");
defaultProps.load(in);
in.close();

// 创建应用程序属性
Properties applicationProps = new Properties(defaultProps);

// 现在加载属性
in = new FileInputStream("appProperties");
applicationProps.load(in);
in.close();
. . .
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

首先，应用程序设置一个默认 Properties 对象。此对象包含要在其他地方未显式设置值时要使用的一组属性。 然后，load 方法从名为 defaultProperties 的文件读取默认值。

接下来，应用程序使用不同的构造函数创建第二个 Properties 对象 applicationProps ， 其中包含默认值 defaultProps 。当检索到属性时，默认值将起作用。如果找不到该属性 applicationProps，则搜索其默认列表。

最后，代码从一个名为 appProperties 的文件中加载一组属性 。该文件中的属性是从上次调用应用程序中保存的属性，如下一节所述。

# 保存属性

以下示例使用上一个示例写出应用程序属性 Properties.store。默认属性不需要每次保存，因为它们不会更改。

FileOutputStream out = new FileOutputStream("appProperties");
applicationProps.store(out, "---No Comment---");
out.close();
1
2
3

该 store 方法需要一个流写入，以及一个字符串，它用作输出顶部的注释。

# 获取属性信息

一旦应用程序设置了其 Properties 对象，应用程序可以查询对象以获取有关其所包含的各种键和值的信息。 应用程序在启动后从 Properties 对象获取信息，以便可以根据用户的选择对其进行初始化。 本 Properties 类有获取属性信息的几种方法：

  • contains(Object value) 和 containsKey(Object key)

    返回 true，value 或 key 是否在 Properties 对象中。Properties 继承 Hashtable 这些方法。 因此，他们接受 Object 对象，但只能使用 String 值。

  • getProperty(String key) 和 getProperty(String key, String default)

    返回指定属性的值。第二个版本提供了默认值。如果找不到键，则返回默认值。

  • list(PrintStream s) 和 list(PrintWriter w)

    将属性列表输出到指定的输出流。此方法对调试很有用。

  • elements()，keys()，和 propertynames（）

    返回包含 Enumeration 对象中包含的键或值（如方法名称所示）Properties。该 keys 方法仅返回对象本身的键; 该 propertyNames 方法也返回默认属性的键。

  • stringPropertyNames()

    propertyNames，但返回一个 Set<String>，只返回属性的名称，其中 key 和 value 都是字符串。 请注意，Set 对象不受 Properties 对象的支持，因此一个对象的更改不会影响对方。

  • size() 返回当前的键/值对数。

# 设置属性

用户与应用程序在执行过程中的交互可能会影响属性设置。这些更改应反映在 Properties 对象中， 以便在应用程序退出时调用它们（并调用 store 方法）。以下方法更改 Properties 对象中的属性：

  • setProperty(String key, String value)

    将 key/value 放入对象

  • remove(Object key)

    移除指定的key

注意： 上面描述的一些方法是在 Hashtable 其中定义的，因此接受除了 String 以外的键和值参数类型。 始终使用 Strings 键和值，即使该方法允许其他类型。也不要调用 Hashtable.set 或 Hastable.setAll; 总是使用 Properties.setProperty。

← 命令行参数 →