xmlnode.java

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

/**
 * @author 沈东良 Edward Shen<a href="mailto:[e-mail]">[e-mail]</a>
 * 2007-8-15 上午11:16:57
 */
package net.sf.oxmled.mapping.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * @author 沈东良 Edward Shen<a href="mailto:[e-mail]">[e-mail]</a>
 * 2007-8-15 上午11:16:57
 *   XML类型标注，标注在业务对象上，表示：
 *1，name---节点的名字
 *2，root---是否根节点
 *3，encoding---编码
 *     可继承，运行时，目标是类型，文档可见
 *      
 *       用于2处：
 * 1，根节点，标注在类上。
 * 2，子节点，标注在字段上。
 * 
 *    如果标注于基类的字段上，则无法反射！
 *       
 */
@Documented
@Retention(value=RetentionPolicy.RUNTIME)
@Inherited
@Target({ElementType.TYPE,ElementType.FIELD})
public @interface XMLNode {
	
	 /**
	  * 编码
	  * @return
	  */
	 String encoding() default "utf-8";
	 /**
	  * 是否根节点 默认不是根节点
	  * @return
	  */
	 boolean root() default false;
	 /**
		 * 节点的名字
		 *    如果为""，使用类名作为节点的名字
		 *    或者使用字段名作为节点名字---如果是子节点
		 * @return
		 */
		 String name() default "";
		 /**
		  * 节点的内容
		  *     默认是""字符串。  表示没有
		  *     "toString"   表示使用 该对象的toString()方法的返回值作为 内容。
		  *     
		  * @return
		    但是，我们无法正确的从 节点的 text中生成正确的数据！  因为toString()产生的数据，如何逆向构建对象？没有办法！
		 String text() default "";
		  */
		
		 
		 /**
		  * 具体的实现类，一般只有 类型 是 数组或者集合的子节点 才需要设置它。
		  *     因为，从xml文件生成Java对象时，需要我们自己创建一个空的数组或者集合。
		  *     而类中可能使用了基类或者接口来引述它们！
		 * @return
		 */
		String concreteClass() default "";
}