JavaEE 配置文件 应用首选项存储

Posted 2020-08-06 IXENOS

JavaEE 配置文件 应用首选项存储

@author ixenos

 

 

 

什么是首选项？

---

首选项Preferences 指配置信息

首选项存储就是指对配置信息的存储

 

有什么方式存储？

---

有两种，一种存于属性文件中（无结构），一种存于XML文档中（有树型结构）

第一种

直接将配置信息存储在孤立的属性文件中，使用属性映射（property map）的数据结构来存储属性的键值对信息，属性之间没有层次结构。Properties类实现了属性映射数据结构，继承于HashTable类。

在该属性文件中，配置信息都是文本信息，都是String

/*专门使用一个类来组织配置信息*/

写一个属性映射列表：

Properties settings = new Properties(); //创建一个无默认值的空属性列表

settings.setProperty(“width”, “200”); //内部调用put，这里只是为了形参限制为String类型

settings.setProperty(“title”, “ixenos”);

 

将属性映射列表保存到文件中：

FileOutputStream out = new FileOutputStream(“program.properties”); //相对路径

Settings.store(out, “Program Properties”); //第二个参数是对这个文件的注释

在文件中将显示：

#Program Properties

#Sun Sept 4 07:31:52 2016

width=200

title=ixenos

 

从文件中加载属性：

FileInputStream in = new FileInputStream(“program.properties”);

Settings.load(in);

 

习惯上，Properties需要将程序配置存储在用户主目录的某个子目录下，子目录名通常由一个圆点开始：如 .corejava

String userDir = System.getProperty(“user.home”); //获得用户主目录字符串表示

 

Properties类为应用程序指定默认值的两种方式：

getProperty时指定：

String title = settings.getProperty(“title”, “Default Title”); //当键值不存在时返回默认值

在构造器指定，传入一个二级属性映射：

Properties defaultSettings = new Properties();

defaultSettings.setProperty(“width”, );

defaultSettings.setProperty();

defaultSettings.setProperty();

…

Properties settings = new Properties(defaultSettings); //为查询表提供默认值

 

Properties类缺点：

1.没有层次结构，没有标准的为配置文件命名的规则

2.配置文件不能放置在主目录中

3.要求键是唯一的

       树形结构可以解决（如Preferences导出的XML格式）

 

 

第二种存储配置信息的方式：

Preferences首选项API

Preferences类提供了一个与平台无关的中心知识库，其底层实现是native的

Preferences的中心知识库具有树状结构，这样每个节点的路径就与包名形式一致，因此建议配置节点路径与程序中的包名匹配，如/com/ixenos/myapp

中心知识库中的每一个节点都有一个独立的map，可以用来存放数字、String、byte[]，但不适宜存放JDK序列化的对象（二进制流），因为API设计者认为序列化格式不适于长期存放数据，不过可以将序列化对象存放在字节数组中。

 

为了增加灵活性，系统中有多棵并行的树。

每个程序使用者拥有一棵树，同时，系统中还存一棵树，称为系统树，用于存放全体用户的公共信息

 

获取特定节点的两种方式：

第一种基于节点所在位置：

Preferences root = Preferences.userRoot(); //先获取用户或系统的根

//Preferences root = Preferences.systemRoot();

Preferences node = root.node(“/com/ixenos/myapp”); //节点由节点路径获得

第二种基于类所在位置：

Preferences node = Preferences.userNodeForPackage(some.getClass()); //也可以直接填入Class对象；通常obj就是this引用

// Preferences node = Preferences.userSystemForPackage(some.getClass());

 

一旦获得节点，就可以使用一系列 xxx getXXX(String key, xxx default) 方法访问键值表，右边的形参是对应类型的默认值；对应的用put(String key, xxx value)方法填入数据

 

 

Preferences类使配置数据易于迁移

可以调用下列方法将子树或者一个节点的全部值显示输出

void exportSubtree(OutputStream out)

void exportNode(OutputStream out)

数据将以XML格式存储，很关键

可以调用下列方法将他们导入到另一个中心知识库中

void importPreferences(InoutStream in)

 

例如：

 1 <?xml version=”1.0” encoding=”UTF-8”?>
 2 <!DOCTYPE perferences SYSTEM “http://java.sun.com/dtd/preferences.dtd”>
 3 <preferences EXTERNAL_XML_VERSION=”1.0”>
 4     <root type=”user”>
 5         <map/>
 6         <node name=”com”>
 7             <map/>
 8             <node name=”ixenos”>
 9                 <map/>
10                 <node name=”corejava”>
11                     <map>
12                         <entry key=”left” value=”11”>
13                         <entry key=”top” value=”9”>
14                         <entry key=”width” value=”22”>
15                         <entry key=”height” value=”52”>
16                         <entry key=”title” value=”Halo”>
17                     </map>
18                 </node>
19             </node>
20        </node>
21    </root>
22 </preferences>