@Generated源码翻译

package javax.annotation;

import static java.lang.annotation.ElementType.ANNOTATION_TYPE;
import static java.lang.annotation.ElementType.CONSTRUCTOR;
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.ElementType.LOCAL_VARIABLE;
import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.ElementType.PACKAGE;
import static java.lang.annotation.ElementType.PARAMETER;
import static java.lang.annotation.ElementType.TYPE;
import static java.lang.annotation.RetentionPolicy.SOURCE;

import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;

/**
 * 目的：@Generated标记已生成的源代码，也区分单个文件中用户编写的代码和生成的代码
 * 1. 使用时，必须有代码生成器的名称（完整名）
 * 2. 生成日期必须遵循 ISO 8601标准。例如：2001-07-04T12:08:56.235-0700
 * @author TCM
 * @create 2017年10月16日下午2:06:28
 * @since Common Annotations 1.0
 */
@Documented
@Retention(SOURCE)
@Target({PACKAGE, TYPE, ANNOTATION_TYPE, METHOD, CONSTRUCTOR, FIELD, 
        LOCAL_VARIABLE, PARAMETER})
public @interface Generated {
	
	/**
	 * 代码生成器的名称
	 * 使用完整名，如：com.acme.generator.CodeGen
	 * @return
	 */
	String[] value();
	
	/**
	 * 生成源代码的日期
	 * @return
	 */
	String date() default "";
	
	/**
	 * 代码生成器生成代码包含的注释
	 * @return
	 */
	String comments() default "";
}