PropertySet简介和配置

PropertySet是由opensymphony组织开发的的一个开源项目，但是那个项目文档少，长时间没有更新，官方文档错误奇多，所以现在在项目中使用并不广泛。但这并不妨碍PropertySet成为一个优秀的key-value持久化模块，当前，PropertySet可以说已经够用。这里我整理书写了PropertySet的文档。

---

Property文档

Property简介

　　简而言之，PropertySet就是一个存储key-value对的模块，他能将key-value通过XML、EJB、Ofbiz、JDBC、JDO等进行存储，也可以自己实现AbstractPropertySet从而自定义更多的存储形式。PropertySet最典型的适用存储数据是配置信息、用户首选项等。在项目中，如果一些可以转化为key-value的信息在一开始无法确定存储位置，或者想可以灵活改变存储位置，那就可以考虑使用PropertySet。

　　PropertySet的优点是：1.轻量级；2.灵活；3.易用；4.适用于J2SE和J2EE平台。

PropertySet的配置

　　Property默认提供的存取方式有：aggregate、cached、jdbc、ejb、javabeans、map、memory、serializable、serializable、ofbiz、hibernate、ojb、xml。

配置文件的放置位置为：
　　1.propertyset.xml
　　2./propertyset.xml
　　3.META-INF/propertyset.xml
　　4./META-INF/propertyset.xml
　　5.META-INF/propertyset-default.xml
　　6./META-INF/propertyset-default.xml

　　PropertySet会按以上顺序挨个寻找，第一个被找到的即作为配置文件。由于propertyset的jar中自带propertyset-default.xml，因此多数情况下无需配置即可使用（JDBC或Hibernate情况下，需要指定JNDI等信息，不可缺省）。

　　关于配置文件的书写，可以参考默认配置文件，默认配置文件内容是：

import java.io.FileInputStream; import java.io.FileOutputStream; import java.io.InputStream; import java.util.HashMap; import org.apache.commons.io.IOUtils; import org.apache.commons.lang.StringUtils; import com.opensymphony.module.propertyset.PropertySet; import com.opensymphony.module.propertyset.PropertySetManager; import com.opensymphony.module.propertyset.xml.XMLPropertySet; public class PropertySetDemo { public static void main(String[] args) throws Exception { PropertySetDemo demo = new PropertySetDemo(); demo.mapPsDemo(); demo.memoryPsDemo(); demo.xmlPsDemo(); } public void memoryPsDemo() { System.out.println(StringUtils.center("Memory PropertySet Demo", 80, '*')); //memory是配置文件中定义的：<propertyset name="memory" class="com.opensymphony.module.propertyset.memory.MemoryPropertySet"/> PropertySet ps = PropertySetManager.getInstance("memory", null); ps.setBoolean("BooleanPS", true); ps.setString("name", "Tom"); System.out.println(ps.getBoolean("BooleanPS")); System.out.println(ps.getString("name")); System.out.println(StringUtils.repeat("*", 80)); } public void mapPsDemo() { System.out.println(StringUtils.center("Map PropertySet Demo", 80, '*')); @SuppressWarnings("unchecked") HashMap map = new HashMap(); //memory是配置文件中定义的：<propertyset name="memory" class="com.opensymphony.module.propertyset.memory.MemoryPropertySet"/> PropertySet ps = PropertySetManager.getInstance("map", map); ps.setBoolean("BooleanPS", true); ps.setString("name", "Tom"); System.out.println(ps.getBoolean("BooleanPS")); System.out.println(ps.getString("name")); System.out.println(StringUtils.repeat("*", 80)); } public void xmlPsDemo() throws Exception { System.out.println(StringUtils.center("XML PropertySet Demo", 80, '*')); PropertySet ps = PropertySetManager.getInstance("xml", null); InputStream is = new FileInputStream("config.xml"); ((XMLPropertySet) ps).load(is); IOUtils.closeQuietly(is); System.out.println(ps.getBoolean("aa")); System.out.println(ps.getInt("ab")); System.out.println(ps.getLong("ac")); System.out.println(ps.getDouble("ad")); System.out.println(ps.getString("ae")); System.out.println(ps.getText("af").trim()); System.out.println(ps.getDate("ag")); System.out.println(ps.getProperties("ai")); ps.setBoolean("aa", false); ((XMLPropertySet) ps).save(new FileOutputStream("config.xml")); System.out.println(StringUtils.repeat("*", 80)); } }