iconfig.java

一个“对象--XML 映射”（Object-Xml Mapping） 的类库。 它的目的是帮助开发者方便、快速的从XML 文件构建出Java 对象

package net.sf.oxmled.common.config;

import java.util.List;
import java.util.Map;

import net.sf.oxmled.model.INode;
import net.sf.oxmled.service.INodeService;
/**
 * 方便的读取xml格式的配置文件。
 * xml文件的类型应该是类似于这样的：
 * <?xml version="1.0" encoding="gbk"?>
<!-- 配置资料 -->
<configs>
   <maps>
    <!--
    单个值
   <map>
       <key>RMIServerIp</key>
       <value>127.0.0.1</value>
   </map>
   多个值
   <map>
       <key>RMIServerIp</key>
       <values>127.0.0.1</values>
       <values>127.0.0.2</values>
   </map>
   <map>
       <key>RMIServerIp</key>
       <value>127.0.0.1</value> 
       <values>127.0.0.1</values>
       <values>127.0.0.2</values>
   </map>
   -->
   </maps>
</configs>
 * @author 沈东良 Edward Shen<a href="mailto:[e-mail]">[e-mail]</a>
 * Aug 20, 2007 3:43:28 PM
 *
 */
public interface IConfig {
    /**
     * 默认的配置文件。
     */
	public final static String defaultPath = "config/config.xml";
	/**
	 * OXmlEd库自己使用的配置文件
	 */
	public final static String OXmlEdConfigFile = "config/OXmlEdConfig.xml";

	/**
	 * 
	 * @param key
	 * @param value
	 * @throws Exception 
	 */
	public abstract void put(String key, String value) throws Exception;

	/**
	 * 
	 * @param key
	 * @param values
	 * @throws Exception 
	 */
	public abstract void put(String key, List<String> values) throws Exception;

	/**
	 * 根据提供的key，返回
	 * <map>
	 *   <key>
	 *   aaa
	 *   </key>
	 *   <value>
	 *   bbb
	 *   </value>
	 * </map>
	 * 的value值
	 * @param key
	 * @return
	 */
	public abstract String get(String key);

	/**
	 * 根据提供的key，返回
	 * <map>
	 *   <key>
	 *   aaa
	 *   </key>
	 *   <values>
	 *   bbb
	 *   </values>
	 * </map>
	 * 的value值
	 * @param key
	 * @return
	 */
	public abstract List<String> gets(String key);

	/**
	 * @return the map
	 */
	public abstract Map<String, String> getMap();

	/**
	 * @param map the map to set
	 */
	public abstract void setMap(Map<String, String> map);

	/**
	 * @return the multiMap
	 */
	public abstract Map<String, List<String>> getMultiMap();

	/**
	 * @param multiMap the multiMap to set
	 */
	public abstract void setMultiMap(Map<String, List<String>> multiMap);
	/**
	 * 
	 * @throws Exception
	 */
	public abstract void parseConfigXml() throws Exception;
	/**
	 * @return the configFile
	 */
	public String getConfigFile();
	/**
	 * @param configFile the configFile to set
	 */
	public void setConfigFile(String configFile);

}