java-初识注解Annotation

直接通过代码简单了解一下:

package com.etc;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import java.util.ArrayList;
import java.util.List;

/*
 * 注解不是程序本身，而是对程序作出解释，可以被其他程序读取
 * 注解信息可以用来处理流程
 * 格式为:@注释名,可以添加参数值
 * 如@SuppressWarningss(value="unchecked").
 * 可以附加在package,class,method,field等等上面，相当于给他们提供了额外的辅助信息，
 * 可以通过反射机制编程实现对这些元数据的访问
 */
public class AnnotationDemo1 extends Object{

    public static void main(String[] args) {

        AnnotationDemo1 a=new AnnotationDemo1();
        System.out.println(a.toString());
        a.test();
        a.test2();
        a.test3();

    }
    
    @Override   /*表示该方法为重写父类Object下的toString方法，为内置注解*/
    public String  toString() {
        return "简单测试";
    }

    @Deprecated /*表示不建议程序员使用的方法,为内置注解*/
    public void test() {
        System.out.println("注解入门！");
    }


    /*
     * deprecation :使用了过时的类或过时的方法的警告
     * unchecked  :执行了未检查的转换时的警告，如使用泛型时未指定类型
     * fallthrough:使用switch语句时发生了case穿透
     * path:在类路径，原文件路径等中有不存在路径的警告
     * serial:挡在序列化的类上缺少serialVersionUID的警告
     * finally:任何finally子句不能完成的警告
     * all:关于以上所有情况的警告
     * 为内置注解
     */
    @SuppressWarnings("all")
    /*等同于@SuppressWarnings(value="all"),存在多个则改为@SuppressWarnings(value={"unchecked","deprecation"})*/
    public void test2() {
        List list=new ArrayList();
        List list2=new ArrayList();
        list.add(1);
        list2.add(1);
        System.out.println("内置注解测试:"+list.size());
    }

    /*
     * 自定义注解:    使用@interface自定义注解时-> 自动继承了java.lang.annotation.Annotation接口
     * 格式:public @interface 注解名{定义体}
     * 其中的每一个方法实际上就是声明了一个配置参数。
     * （1）方法的名称就是参数的名称
     * （2）返回值就是参数的类型 ：返回类型只能是基本类型:Class,String,enum
     * （3）可以通过default来声明参数的默认值
     * （4）如果只有一个参数成员，一般参数名为value
     *  ps:注解元素必须要有值，经常使用空字符串，0作为默认值，也经常使用负数->-1表示不存在的意义
     */

    /*元注解：
     * 作用：负责注解其他注解，java定义了4个标准的meta-annotation类型，它们被用来提供对其他annotation类型作说明
     * 
     * @Target：描述注解的使用范围   ->取值方式: @Target(value=ElementType.参数值)
     * (1)package包->PACKAGE
     * (2)类，接口，枚举，Annotation类型->TYPE
     * (3)类型成员（方法，构造方法，成员变量，枚举值）->{构造方法:"CONSTRUCTOR",方法:"METHOD",描述域:"FIELD"}
     * (4)方法参数和本地变量->{局部变量:"LOCAL_VARIABLE",描述参数:"PARAMETER"}
     * 
     * @Retention：表示需要在什么级别保存该注释信息，用于描述注释的生命周期  ->取值方式:@Retention(value=RetentionPolicy.参数值)
     * (1)在源文件中有效，源文件保留->SOURCE
     * (2)在class文件中有效，class保留->CLASS
     * (3)在运行时有效，运行时保留，可以被反射机制读取->RUNTIME
     * @Document
     * @Inherited
     */

    //表示该注解只能用于方法前面
    @Target(value=ElementType.METHOD)
    //或者直接@Target(ElementType.METHOD)
    public @interface start{    
    }

    //表示该注释的生命周期只存在于源文件中
    @Retention(value=RetentionPolicy.SOURCE)
    public @interface over{

    }

    //表示该注解只能用于方法,类，接口，枚举，Annotation类型前面,生命周期只存在于源文件中
    @Target(value={ElementType.METHOD,ElementType.TYPE})
    @Retention(value=RetentionPolicy.SOURCE)
    public @interface up{
        //如果不加默认值，需要在加该注释的地方加上默认值
        String name() ;
        int id();
        int age() default 18;
    }

    @up(name = "", id = 0)
    public void test3() {
        System.out.println("自定义注解简单使用！");
    }
}

效果截图:

实例：利用自定义注解实现数据库与实体类的信息转换

1.实体类

package com.test;

//利用注解将类与表结构对应，即Person类与数据库表person对应
@Table(value = "person")
public class Person {
    //将类属性与表结构中的字段对应
    @Field(columName = "pname", len = 20, type = "varchar")
    private String name;
    
    @Field(columName = "pid", len = 10, type = "int")
    private int id;
    
    @Field(columName = "birth", len = 20, type = "varchar")
    private String birth;
    
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public String getBirth() {
        return birth;
    }
    public void setBirth(String birth) {
        this.birth = birth;
    }
}

2.自定义注解

package com.test;

import static java.lang.annotation.ElementType.TYPE;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;

@Retention(RUNTIME)
@Target(TYPE)
public @interface Table {
    //对应数据库表名
    String value();
}

package com.test;

import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.RetentionPolicy.RUNTIME;

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

@Retention(RUNTIME)
@Target(FIELD)
public @interface Field {
    //对应表结构中属性的属性名，属性类型，属性长度
    String columName();
    String type();
    int len();
}

3.信息处理类

package com.test;

import java.lang.annotation.Annotation;
import java.lang.reflect.AnnotatedElement;

/*
 * 之后会使用反射读取注解的信息，模拟处理注解信息的流程
 */
public class Reflex {

    public static void main(String[] args) throws ClassNotFoundException, NoSuchFieldException, SecurityException {
        
        Class c=Class.forName("com.test.Person");
        //获取类的所有有效注解
        Annotation[] ano=c.getAnnotations();
        for(Annotation a:ano) {
            System.out.println(a);
        }
        //获得类的指定属性的注解
        AnnotatedElement f=c.getDeclaredField("name");
        Field x=f.getAnnotation(Field.class);
        System.out.println(x.columName()+" "+x.len()+" "+x.type());
        
    }

}

效果截图:

ps:文章待完善中，如存在问题欢迎大佬指点。