java中注解

一、什么是注解

　　注解是jdk5.0引入的新技术！

　　注解(Annotation):java中对某一程序片段注释说明、这个注释说明能被其它程序读到并执行相应操作！

二、注解的作用

　　1、能对于程序做出解释，并且能被其它相应程序读取并且执行相应操作！

三、注解格式

　　@注释名  可以添加一些参数值、例如：@SuppressWarnings(value="unchecked")

四、注解的应用范围

　　package、class、method、field等上面。通过反射机制来访问。

五、常用的内置注解

　　1、@Override：标记的方法是重写了父类的方法

　　2、@Deprecated：标记的方法是表示遗弃、废弃，不建议人们以后去使用，但是能使用

　　3、@SuppressWarnings：用来抑制编译时的警告信息

　　　　3.1@SuppressWarnings(value={"unchecked","deprecation"})

六、自定义注解

　　使用@interface自定义注解时，自动继承了java.lang.annotation.Annotation接口

　　@interface用来声明一哥注解 格式： public @interface 注解名{定义体}

　　自定义注解时，我们一般在在自定义注解前面加元注解(作用：负责注解其它注解)java定义了4个标准的meta_annotation类型，他们被用来提供对其它annotation类型说明，详见java.lang.annotation包（@Target、@Retention、@Document、@Inherited）

　　　　@Target:用于描述注解的使用范围(即：被描述的注解可以用在什么地方)

　　　　

　　　　@Retention

　　　　

 七、综合所学写一个小测试

　　该测试可以帮助大家理解ORM框架映射，因为这个是用注解写的一个关于实体类到数据库表的简单映射

　　7.1 我们写两个注解、一个注解用来指定实体类映射到数据库中的表的名称，另一个用来指定该实体类中所有字段映射到数据库表的详细信息(包括字段名、字段类型、字段长度)

　　

package edu.aeon.annotation;

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)
/**
 * @author lzj
 * @create 2017年11月23日 下午1:13:53
 * @describe 用来指定注解所对应类映射到数据库中的表名称
 */
public @interface CreateTable {
    String tableName();
}

package edu.aeon.annotation;

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)
/**
 * @author lzj
 * @create 2017年11月23日 下午1:17:58
 * @describe 用于注解实体类中属性到数据库的映射关系
 */
public @interface AeonField {
    //指定列名
    String ColumnName();
    //指定列类型
    String ColumnType();
    //指定该列大小长度
    int ColumnLength();
}

　　7.2接下来我们简单定义一个实体类、该实体类采用我们刚才定义的两个注解

　　

package edu.aeon.entity;

import edu.aeon.annotation.CreateTable;
import edu.aeon.annotation.AeonField;

/**
 * @author lzj
 * @create 2017年11月23日 下午1:14:51
 * @describe 简单定义一个实体类
 */
@CreateTable(tableName="t_user")
public class T_User {
    @AeonField(ColumnName="UserId",ColumnType="int", ColumnLength = 10)
    private int uId;
    @AeonField(ColumnName="UserName",ColumnType="varchar", ColumnLength = 16)
    private String uName;
    @AeonField(ColumnName="UserAge",ColumnType="int", ColumnLength = 3)
    private int uAge;
    public int getuId() {
        return uId;
    }
    public void setuId(int uId) {
        this.uId = uId;
    }
    public String getuName() {
        return uName;
    }
    public void setuName(String uName) {
        this.uName = uName;
    }
    public int getuAge() {
        return uAge;
    }
    public void setuAge(int uAge) {
        this.uAge = uAge;
    }
}

　　7.3写一个注解的解析小程序

　　

package edu.aeon.annotation.test;

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

import edu.aeon.annotation.AeonField;
import edu.aeon.annotation.CreateTable;
import edu.aeon.entity.T_User;

/**
 * @author lzj
 * @create 2017年11月23日 下午1:21:38
 * @describe 解析注解类信息
 */
public class AnnotationTest {

    /**
     * at 2017年11月23日 下午1:21:38 by lzj
     * @throws SecurityException 
     * @throws NoSuchFieldException 
     * @Parameters1
     * @Returns void
     */
    public static void main(String[] args) throws NoSuchFieldException, SecurityException{
        Class clazz = null;
        try {
            clazz = Class.forName("edu.aeon.entity.T_User");
        } catch (ClassNotFoundException e) {
            e.printStackTrace();
        }
        /**
         * 获得edu.aeon.entity.T_User类的所有注解信息
         */
        Annotation an1[]=clazz.getAnnotations();
        for(Annotation a:an1) {
            System.out.println(a);
        }
        /**
         * 获得指定(注解)类的指定注解信息
         */
        CreateTable an2=(CreateTable) clazz.getAnnotation(CreateTable.class);
        System.out.println("表名:"+an2.tableName());
        /**
         * 获得指定属性的注解信息
         */
        StringBuffer sb=new StringBuffer("create table ");
        sb.append(an2.tableName()).append(" ( ");
        /*//获得uName这个属性
        Field field=clazz.getDeclaredField("uName");*/
        Field [] field1=clazz.getDeclaredFields();
        for (Field f : field1) {
            AeonField af=f.getAnnotation(AeonField.class);
            sb.append(af.ColumnName()).append(" ").append(af.ColumnType()).append("(").append(af.ColumnLength()).append("),");
            //System.out.println(af.ColumnName()+"	"+af.ColumnType()+"	"+af.ColumnLength());
        }
        //这里拼接sql方式很多，可以采取截取、也可以采取将最后一个逗号替换成右括号
        String sql=sb.substring(0, sb.lastIndexOf(","))+")";
        System.out.println(sql);
        /*//获得uName这个属性所对应的注解(所有信息数据)
        AeonField aField=field.getAnnotation(AeonField.class);
        //打印uName属性所对应的注解的详细信息
        System.out.println("uName属性信息："+aField.ColumnName()+"---"+aField.ColumnType()+"---"+aField.ColumnLength());
        */
        /**
         * 那么这样我们可以通过获得的表名、表字段及属性来拼接出sql、然后用JDBC执行该sql,去创建表
         * JDBC执行sql比较简单，格式也比较固定，所以此处省略！
         */
        
    }

}

　　7.4控制台输出截图附上：

　　

将生成的sql拿到数据库执行：

　　

到这里我们简单解析出了这个实体类映射到数据库中的对应信息，那么接下来用JDBC去执行这条解析出来的sql语句即可，因为JDBC执行sql的格式比较固定，且比较简单且由于时间原因此处不一一写出来了！