ioxmlmapping.java

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

package net.sf.oxmled.mapping.service;

import java.io.IOException;
import java.net.MalformedURLException;
import java.net.URI;
import java.net.URISyntaxException;
/**
 * 
 * @author 沈东良 Edward Shen<a href="mailto:[e-mail]">[e-mail]</a>
 * 2007-8-15 上午10:23:20
 *使用annotation的信息，实现BO对象和INode对象之间的转换。  这是在JavaBean和XML之间执行转换的服务类。
 *    节点的属性：  节点的名称（类名）    fullClassName="类的全名"
 */
public interface IOXmlMapping {

	public static final String CLASSNAME="fullClassName";

	/**
	 * 把对象中的数据保存为xml文件的形式，默认放在classpath下面
	 * 文件名是类名
	 * @param object
	 * @throws URISyntaxException 
	 * @throws IOException 
	 * @throws IllegalAccessException 
	 * @throws MalformedURLException 
	 * @throws IllegalArgumentException 
	 */
	public abstract void save(Object object) throws URISyntaxException, IllegalArgumentException, MalformedURLException, IllegalAccessException, IOException;

	/**
	 * 保存对象为某个文件名的xml文件
	 * @param object
	 * @param uri
	 * @throws IllegalAccessException 
	 * @throws IllegalArgumentException 
	 * @throws URISyntaxException 
	 * @throws IOException 
	 * @throws MalformedURLException 
	 */
	public abstract void save(Object object, URI uri) throws IllegalArgumentException, IllegalAccessException, MalformedURLException, IOException, URISyntaxException;

	/**
	 * 保存对象为某个文件名的xml文件，相对路径是classpath下
	 * @param object
	 * @param fileName
	 * @throws URISyntaxException 
	 * @throws IOException 
	 * @throws IllegalAccessException 
	 * @throws MalformedURLException 
	 * @throws IllegalArgumentException 
	 */
	public abstract void save(Object object, String fileName) throws URISyntaxException, IllegalArgumentException, MalformedURLException, IllegalAccessException, IOException;

	/**
	 * 根据xml文件生成对象
	 * @param uri  xml文件的地址
	 * @return
	 * @throws Exception 
	 * @throws MalformedURLException 
	 */
	public abstract Object load(URI uri) throws MalformedURLException, Exception;

	/**
	 * 根据xml文件生成对象,文件名相对于classpath
	 * @param fileName
	 * @return
	 * @throws Exception 
	 * @throws URISyntaxException 
	 * @throws MalformedURLException 
	 */
	public abstract Object load(String fileName) throws MalformedURLException, URISyntaxException, Exception;

}