Java API 之 Properties 类

1、简介

在项目中我们经常看到一种格式极其干净的配置文件,如:config.properties。在Java的体系结构中也提供了API对properties文件进行读取和写入等操作,即:Properties类。


2、入门DEMO

在cn.lay.properties包下建立类Properties.java和config.properties文件,如下:

Properties.java

package cn.lay.properties;

import java.io.IOException;
import java.io.InputStream;
import java.util.Properties; public class PropertiesDemo {
public static void main(String[] args) throws IOException {
InputStream inputStream = Thread.currentThread().getContextClassLoader().getResourceAsStream("cn/lay/properties/config.properties");
Properties config = new Properties();
config.load(inputStream);
String userName = config.getProperty("username");
System.out.println("username=" + userName);
}
}

config.properties

username=lay

运行main方法,输出:

username=lay

main方法中,通过输入流读取了config.properties。Properties实例对象从流中读取文件属性,并提供getProperty(key)方法读取属性。


3、类Properties

类Properties存在于java.util包下

继承结构如:

java.lang.Object

  |_ java.uil.Dictionary<K,V>

    |_ java.util.Hashtable<Object,Object>

      |_ java.util.Properties

已实现的主要接口:

Serializable, Cloneable, Map<Object, Object>

直接子类:

Provider

Properties直接继承自Hashtable那么它的数据结构也和Hashtable一样属于键值对形式如:username="lay",不过不同的是,Properties的键和值都是String类型。所以,虽然Properties继承了Hashtable后可以使用put和putAll方法,但是不被建议使用。因为这两个方法允许插入非String类型。

字段摘要:

protected Properties defaults; 默认属性列表

构造函数:

1) Properties();

2) Properties(Properties defaults); 可以初始化默认属性列表


4、加载properties资源文件

Properties类重载了两个方法用于读取属性列表,也就是加载资源为实例对象:

1) void load(InputStream inputStream);

InputStream inputStream = Thread.currentThread().getContextClassLoader().getResourceAsStream("cn/lay/properties/config.properties");
Properties config = new Properties();
config.load(inputStream);

2) void load(Reader reader);

InputStream inputStream = Thread.currentThread().getContextClassLoader().getResourceAsStream("cn/lay/properties/config.properties");
Reader reader = new InputStreamReader(inputStream, "utf-8");
Properties config = new Properties();
config.load(reader);

5、读取属性值

1)String getProperty(String key);

String userName = config.getProperty("username");

2) String getProperty(String key, String defaultValue);

String userName = config.getProperty("username", "nobody");

6、设置属性值

config.setProperty("username", "marry");

7、存储为properties资源文件

写数据的方法分为两种,list和store

1)list 此方法通常用于调试,System.out即可以获取PrintStream,从而输出到控制台

void list(PrintStream out);

PrintStream printStream = new PrintStream("/Users/lay-mac/Desktop/config.properties");
config.list(printStream);

void list(PrintWriter writer);

PrintWriter printWriter = new PrintWriter(outputStream);
config.list(printWriter);

2) store

void store(OutputStream out, String comments);

OutputStream outputStream = new FileOutputStream("/Users/lay-mac/Desktop/config.properties");
config.store(outputStream, "test store");

void store(Writer writer, String comments);

Writer writer = new FileWriter("/Users/lay-mac/Desktop/config.properties");
config.store(writer, "test store");

8、遍历属性列表

Set<String> stringPropertyNames(); 返回属性列表键的set集合,包括默认列表;

Set<String> keySet = config.stringPropertyNames();
for (String key : keySet) {
System.out.println("key=" + key);
System.out.println("value=" + config.getProperty(key));
}

Enumeration<?> propertyNames();返回属性列表中所有键的枚举,包括默认列表;

Enumeration<String> enumeration = (Enumeration<String>) config.propertyNames();
while (enumeration.hasMoreElements()) {
String key = (String) enumeration.nextElement();
System.out.println("key=" + key);
System.out.println("value=" + config.getProperty(key));
}

除了读取写入.properties文件外,Properties类还可以读取和写入xml文件形式,具体请参考:http://tool.oschina.net/apidocs/apidoc?api=jdk-zh

上一篇:day1 java基础回顾- Properties类与配置文件


下一篇:Java中的Properties类