注解（annotation）是JDK5之后引进的新特性，是一种特殊的注释，之所以说它特殊是因为不同于普通注释（comment）能存在于源码，而且还能存在编译期跟运行期，会最终编译成一个.class文件，所以注解能有比普通注释更多的功能。
JDK自带的注解
@Deprecated 表明当前的元素已经不推荐使用
@Override 表明当前方法是覆盖了父类方法
@SuppressWarnings 关闭不当的编译器警告信息
元注解
- @Documented 被修饰的注解会生成到javadoc中。
- @Retention设置注解的级别。默认是RetentionPolicy.CLASS。
注解@Retention(RetentionPolicy.CLASS) 的值有三种，即如下枚举类
public enum RetentionPolicy {
SOURCE,
CLASS,
RUNTIME
}
SOURCE 代表源码级别，注解只存在源码中，其功能是与编译器交互，用于代码检测，如@Override, @SuppressWarings，这个级别的框架额外效率损耗发生在编译时。
CLASS代表字节码级别，注解存在源码与字节码文件中。
RUNTIME 代表运行时级别，注解存在源码，字节码与Java虚拟机中，主要用于运行时反射获取相关信息，许多框架就是使用这个级别的注解，这个级别的框架额外的效率损耗发生在程序运行时。
- @Target限制注解修饰的元素种类
public enum ElementType {
TYPE, /**接口、类、枚举、注解**/
FIELD, /**字段、枚举的常量**/
METHOD, /**方法**/
PARAMETER, /**方法参数**/
CONSTRUCTOR, /**构造方法**/
LOCAL_VARIABLE, /**局部变量**/
ANNOTATION_TYPE, /**注解**/
PACKAGE, /**包**/
TYPE_PARAMETER, /**表示该注解能写在类型变量的声明语句中。 java8新增**/
TYPE_USE /**表示该注解能写在使用类型的任何语句中。 java8新增**/
}
注意：不加元注解@Target的情况下，注解可以修饰各种元素，比如可以修饰类，可以修饰变量，可以修饰方法等。
- @Inherited让注解可以被继承
@Inherited可以让注解类似被继承一样，但是这并不是真的继承。通过使用@Inherited，只可以让子类类对象使用getAnnotations（）反射获取父类被@Inherited修饰的注解。
package com.zheting.it.test01;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.util.Arrays;
public class Test {
@UnInheritable
@Inheritable
public static class Super{
}
public static class Sub extends Super {
}
public static void main(String[] args) {
Super instance=new Sub();
System.out.println(Arrays.toString(instance.getClass().getAnnotations())); //[@com.zheting.it.test01.Inheritable()]
}
}
//自定义的注解
@Inherited
@Retention(RetentionPolicy.RUNTIME)
@interface Inheritable{
}
//自定义的注解
@interface UnInheritable{
}
用运行时注解生成sql语句的Demo
package com.zheting.it.test02;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
@Retention(RetentionPolicy.RUNTIME)
public @interface Table {
String name();
}
package com.zheting.it.test02;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
@Retention(RetentionPolicy.RUNTIME)
public @interface Column {
String name();
}
package com.zheting.it.test02;
public class NameAndType {
private String type;
private String name;
public NameAndType(String type, String name) {
this.name = name;
this.type = type;
}
public String getType() {
return type;
}
public void setType(String type) {
this.type = type;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
package com.zheting.it.test02;
@Table(name = "user_t")
public class User {
@Column(name = "user_name")
String userName;
@Column(name = "gender")
boolean gender;
}
package com.zheting.it.test02;
import java.lang.reflect.Field;
import java.util.ArrayList;
import java.util.List;
public class Utils {
//获取表名
private static String getTableName(Class<?> bean) {
String name = null;
//判断是否有Table注解
if (bean.isAnnotationPresent(Table.class)) {
//获取注解对象
Table table = bean.getAnnotation(Table.class);
name =table.name();
}
return name;
}
//获取字段名与类型
private static List<NameAndType> getColumns(Class<?> bean) {
List<NameAndType> columns = new ArrayList<NameAndType>();
Field[] fields = bean.getDeclaredFields();
if (fields != null) {
//分析Bean中的变量是否需要生成sql字段
for (int i = 0; i < fields.length; i++) {
Field field = fields[i];
if (field.isAnnotationPresent(Column.class)) {
//生成sql字段的名
Column column = field.getAnnotation(Column.class);
String name=column.name();
//生成sql字段的类型
String type = null;
if (int.class.isAssignableFrom(field.getType())) {
type = "integer";
} else if (boolean.class.isAssignableFrom(field.getType())) {
type = " tinyint(1)";
} else if (String.class.isAssignableFrom(field.getType())) {
type = "text";
} else {
throw new RuntimeException("unspported type=" + field.getType().getSimpleName());
}
columns.add(new NameAndType(type, name));
}
}
}
return columns;
}
//生成建表sql语句
public static String createTable(Class<?> bean) {
String tableName = getTableName(bean);
List<NameAndType> columns = getColumns(bean);
if (tableName != null && !tableName.equals("") && !columns.isEmpty()) {
StringBuilder createTableSql = new StringBuilder("create table ");
//加表名
createTableSql.append(tableName);
createTableSql.append("(");
//加表中字段
for (int i = 0; i < columns.size(); i++) {
NameAndType column = columns.get(i);
createTableSql.append(column.getName());
createTableSql.append(" ");
createTableSql.append(column.getType());
// 追加下一个字段定义前需要添加逗号
if (i != columns.size() - 1) {
createTableSql.append(",");
}
}
createTableSql.append(")");
return createTableSql.toString();
}
return null;
}
}
package com.zheting.it.test02;
public class Test {
public static void main(String... args){
//create table user_t(user_name text,gender tinyint(1))
System.out.println(Utils.createTable(User.class));
}
}
源码级注解自定义Demo，没有搞出来。有时间再搞
