xmlattribute.java

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

/**
 * @author 沈东良 Edward Shen<a href="mailto:[e-mail]">[e-mail]</a>
 * 2007-8-15 下午01:48:21
 */
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;

import net.sf.oxmled.mapping.service.ConvertCastMethod;

/**
 * @author 沈东良 Edward Shen<a href="mailto:[e-mail]">[e-mail]</a>
 * 2007-8-15 下午01:48:21
 *   用于标注字段为属性
 *   如果标注于基类的字段上，则无法反射！
 *   
 *   如果字段是iterator或者数组，则生成多个xml属性
 */
@Documented
@Retention(value=RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD})
@Inherited
public @interface XMLAttribute {
	/**
	 *   属性的名字，默认就取是变量的名字
	 * @return
	 */
	String name() default "";
	/**
	 * 默认就取 变量的值的toString()方法的值。
	 * @return
	 */
	String value() default "";
	/**
	 * 转换 xml文件中的属性的字符串为需要的类型的方法。
	 * 转换方法的签名如下：
	 * IConvertCastUtil
	 *  Type castAAA(String value); 
	 * @return
	 */
	String castMethod() default "";
	/**
	 * 目前未启用
	 *     这个属性用于指出该字段如何转为xml文件中的String。
	 *     默认就是该字段的toString方法生成的数据。
	 *     某些情况下，可能你需要提供这样的方法。
	 * @return    根据Java对象生成的属性的值
	 */
	String toStringMethod() default "";
	
	//ConvertCastMethod defaultCast() default ConvertCastMethod.none;

}