注解(annotation)是JDK5之后引進(jìn)的新特性,是一種特殊的注釋,之所以說它特殊是因?yàn)椴煌谄胀ㄗ⑨專╟omment)能存在于源碼,而且還能存在編譯期跟運(yùn)行期,會(huì)最終編譯成一個(gè).class文件沽一,所以注解能有比普通注釋更多的功能。
JDK自帶的注解
@Deprecated 表明當(dāng)前的元素已經(jīng)不推薦使用
@Override 表明當(dāng)前方法是覆蓋了父類方法
@SuppressWarnings 關(guān)閉不當(dāng)?shù)木幾g器警告信息
元注解
- @Documented 被修飾的注解會(huì)生成到j(luò)avadoc中漓糙。
- @Retention設(shè)置注解的級(jí)別铣缠。默認(rèn)是RetentionPolicy.CLASS。
注解@Retention(RetentionPolicy.CLASS) 的值有三種昆禽,即如下枚舉類
public enum RetentionPolicy {
SOURCE,
CLASS,
RUNTIME
}
SOURCE 代表源碼級(jí)別蝗蛙,注解只存在源碼中,其功能是與編譯器交互醉鳖,用于代碼檢測(cè)捡硅,如@Override, @SuppressWarings,這個(gè)級(jí)別的框架額外效率損耗發(fā)生在編譯時(shí)盗棵。
CLASS代表字節(jié)碼級(jí)別壮韭,注解存在源碼與字節(jié)碼文件中。
RUNTIME 代表運(yùn)行時(shí)級(jí)別纹因,注解存在源碼喷屋,字節(jié)碼與Java虛擬機(jī)中,主要用于運(yùn)行時(shí)反射獲取相關(guān)信息辐怕,許多框架就是使用這個(gè)級(jí)別的注解逼蒙,這個(gè)級(jí)別的框架額外的效率損耗發(fā)生在程序運(yùn)行時(shí)从绘。
- @Target限制注解修飾的元素種類
public enum ElementType {
TYPE, /**接口寄疏、類、枚舉僵井、注解**/
FIELD, /**字段陕截、枚舉的常量**/
METHOD, /**方法**/
PARAMETER, /**方法參數(shù)**/
CONSTRUCTOR, /**構(gòu)造方法**/
LOCAL_VARIABLE, /**局部變量**/
ANNOTATION_TYPE, /**注解**/
PACKAGE, /**包**/
TYPE_PARAMETER, /**表示該注解能寫在類型變量的聲明語句中。 java8新增**/
TYPE_USE /**表示該注解能寫在使用類型的任何語句中批什。 java8新增**/
}
注意:不加元注解@Target的情況下农曲,注解可以修飾各種元素,比如可以修飾類,可以修飾變量乳规,可以修飾方法等形葬。
- @Inherited讓注解可以被繼承
@Inherited可以讓注解類似被繼承一樣,但是這并不是真的繼承暮的。通過使用@Inherited笙以,只可以讓子類類對(duì)象使用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{
}
用運(yùn)行時(shí)注解生成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)) {
//獲取注解對(duì)象
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());
// 追加下一個(gè)字段定義前需要添加逗號(hào)
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));
}
}
源碼級(jí)注解自定義Demo冻辩,沒有搞出來猖腕。有時(shí)間再搞