Java 注解

注解：

Java提供了一种源程序中的元素关联任何信息和任何元数据的途径和方法。

常见注解：
    JDK注解：
        1.@override ： 覆盖方法
        2.@Deprecated ： 表示一个方法已经过期
        3.@Suppresswarnings ： 表示忽略警告
    常见第三方注解：
        1.Spring
            1.1.@Autowired
            1.2.@Service
            1.3.@Repository
        2.Mybatis
            2.1.@InsertProvider
            2.2.@UpdateProvider
            2.3.@Options

注解的分类：
    按照运行机制分:
        1.源码注解 ： 注解只在源码里存在，编译成class文件就不存在了。
        2.编译时注解 ： 注解在源码和.class文件中都存在。(eg:@Override)
        3.运行时注解 ： 在运行阶段还起作用，甚至会影响运行逻辑的注解。（eg:@Autowired）
    按照来源分：
        1.来自JDK的注解
        2.来自第三方的注解
        3.我们自己定义的注解

自定义注解：

// 元注解 : 注解的注解
@Target({ElementType.METHOD,ElementType.TYPE}) // 注解的作用域,这里指定了在方法，类，接口作用域可以使用
@Retention(RetentionPolicy.RUNTIME) // 注解的声明周期,这里指定为运行时注解
@Inherited // 允许子注解继承
@Documented // 生成javadoc时会包含注解
public @interface MyAnnotation {
    /* 
    成员类型是受限的，合法的类型包括原始类型和String,Class,Annotation,Enumeration
    注解可以没有成员，就变成标识注解
    */
    String desc(); // 成员使用无参无异常方式声明
    String author(); 
    int age() default 18; // 使用default指定默认值
}

解析注解：（如何通过注解关联其他数据的）

通过反射机制获取类，函数或成员上的运行时注解信息，从而实现动态控制程序运行的逻辑。

---

示例代码：（通过反射获取注解信息来拼接sql语句）

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

/**
 * 
 * @author ZHOUMI2
 * 表注解
 */
@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface Table {
  String value();
}

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

/**
 * 
 * @author ZHOUMI2
 * 域注解
 */
@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface Column {
    String value();
}

/**
 * 
 * @author ZHOUMI2
 * 实体类
 */
@Table("student")
public class Filter {

    @Column("id")
    private int stuId;
    @Column("name")
    private String stuName;
    @Column("email")
    private String email;

    public int getStuId() {
        return stuId;
    }
    public void setStuId(int stuId) {
        this.stuId = stuId;
    }
    public String getStuName() {
        return stuName;
    }
    public void setStuName(String stuName) {
        this.stuName = stuName;
    }
    public String getEmail() {
        return email;
    }
    public void setEmail(String email) {
        this.email = email;
    }

}

import java.lang.reflect.Field;
import java.lang.reflect.Method;

/**
 * 
 * @author ZHOUMI2
 * 测试类
 */
public class Test {
    public static void main(String[] args) {
        Filter f1 = new Filter();
        f1.setStuId(10);

        Filter f2 = new Filter();
        f2.setStuId(10);
        f2.setStuName("baoyou");

        Filter f3 = new Filter();
        f3.setEmail("1223716098@qq.com,curiousby@163.com");

        String sql1 = query(f1);
        String sql2 = query(f2);
        String sql3 = query(f3);

        System.out.println(sql1);
        System.out.println(sql2);
        System.out.println(sql3);
    }

    // 通过反射机制来拼接sql语句
    @SuppressWarnings("unchecked")
    private static String query(Filter f) { 
        StringBuffer sb = new StringBuffer();
        Class c=  f.getClass();
        boolean isExist = c.isAnnotationPresent(Table.class);
        if (!isExist) {
            return null;
        }
        Table t = (Table) c.getAnnotation(Table.class);
        String  tableName = t.value();
        sb.append(" select * from ").append(tableName).append(" 1=1 ");
        Field[] fArray = c.getDeclaredFields();
        for (Field field : fArray) {
            boolean fExist = field.isAnnotationPresent( Column.class);
            if (!fExist) {
                continue;
            }
            Column column = field.getAnnotation(Column.class);
            String columnName = column.value();
            String fieldName = field.getName();
            String getMethodName = "get" +fieldName.substring(0, 1).toUpperCase()+fieldName.substring(1);
            Object fieldValue=null;
            try {
                Method getMethod =c.getMethod(getMethodName);
                fieldValue = getMethod.invoke(f);
            } catch (Exception e) {   
            }
            if (fieldValue == null || (fieldValue instanceof Integer && (Integer)fieldValue == 0) ) {
                continue;
            }
            sb.append(" and ").append( columnName );
            if (fieldValue instanceof String){
                if (((String) fieldValue ).contains(",")) {
                    String[] values = ((String) fieldValue ).split(",");
                    sb.append(" in ( ");
                    for (String v : values) {
                        sb.append("'").append(v).append("',");
                    }
                    sb.deleteCharAt(sb.length()-1);
                    sb.append(" )");
                } else{
                sb.append(" = '").append(fieldValue).append("' ");
                }
            }else if (fieldValue instanceof Integer){
                sb.append(" = ").append(fieldValue).append(" ");
            }


        }
        return sb.toString();
    }
}