注解是什么
我們在平時(shí)的工作中,可能會(huì)看到形如一下的代碼:
@Entity(tableName = "user")
public class User{
@Id
@Column(name="id")
private long id;
@Column(name="uid")
private String uid;
...
}
這種標(biāo)記在類上,方法上,@開頭的就叫做注解.
注解的用處
上圖是我們公司ORM框架的一個(gè)entity類,總所周知,ORM框架與數(shù)據(jù)庫打交道,最后也要轉(zhuǎn)為SQL語句.比如保存一條記錄,數(shù)據(jù)庫只接受INSERT INTO USER('id','uid') VALUES('1', 'huangzp')這樣的保存方式,如果當(dāng)我們操作 orm.save(user),這樣的代碼的時(shí)候,實(shí)際上也是將它轉(zhuǎn)成SQL,那么對象要怎么轉(zhuǎn)成SQL呢?可以看到,要轉(zhuǎn)成SQL,至少要知道表名,字段,那么我們在類中標(biāo)明類名和表名及成員變量和字段的對應(yīng)關(guān)系不就OK了嗎?當(dāng)我們要保存保存數(shù)據(jù)的時(shí)候,通過反射取得這些注解,然后拼成SQL.完美! 所以注解相當(dāng)于一個(gè)標(biāo)記,我們最后還是得通過反射等手段獲取這些注解,然后寫成我們需要的功能.
定義一個(gè)注解
我們使用一個(gè)類的時(shí)候,我們要先去定義一個(gè)類,比如
public class Cat{}
同樣的,我們要使用一個(gè)注解,同樣也要去定義
@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface Entity {
//注解元素
String tableName() default "";
//快捷方式,我們設(shè)置了value的元素的時(shí)候,設(shè)置value的值的時(shí)候,只需要@Entity("haha")而不需要@Entity(value="haha")
String value() default "";
}
- @interface 是聲明一個(gè)注解,就像我們class,enum一樣.
- @Target 是注解修飾范圍的范圍,我們可以看一下ElementType這個(gè)枚舉類
public enum ElementType {
/**注解在類名,接口名,枚舉名上 */
TYPE,
/** 注解在成員變量上 */
FIELD,
/** 注解在方法名上 */
METHOD,
/** 注解在方法參數(shù)上 */
PARAMETER,
/** 注解在構(gòu)造方法上 */
CONSTRUCTOR,
/** 注解在局部變量 */
LOCAL_VARIABLE,
/** 注解在注解上 */
ANNOTATION_TYPE,
/** 注解在包名上 */
PACKAGE,
/**
* Type parameter declaration
*
* @since 1.8
*/
TYPE_PARAMETER,
/**
* Use of a type
*
* @since 1.8
*/
TYPE_USE
}
- @Retention 注解的運(yùn)行時(shí)期
A. SOURCE : 注解將被編譯器丟棄（該類型的注解信息只會(huì)保留在源碼里，源碼經(jīng)過編譯后，注解信息會(huì)被丟棄，不會(huì)保留在編譯好的class文件里）
B. CLASS : 注解在class文件中可用，但會(huì)被VM丟棄（該類型的注解信息會(huì)保留在源碼里和class文件里，在執(zhí)行的時(shí)候，不會(huì)加載到虛擬機(jī)中），請注意，當(dāng)注解未定義Retention值時(shí)，默認(rèn)值是CLASS，如Java內(nèi)置注解，@Override、@Deprecated、@SuppressWarnning等
C. RUNTIME : 注解信息將在運(yùn)行期(JVM)也保留，因此可以通過反射信機(jī)制讀取注解的息（源碼、class文件和執(zhí)行的時(shí)候都有注解的信息），如SpringMvc中的@Controller、@Autowired、@RequestMapping等。 - 注解的元素及其類型
String name() default "";
在注解名花括號里的便是注解的元素,它對應(yīng)的是我們寫在@Entity(name="user"),的大括號里面的東西,除了常見的string和int類型,它還可以是以下的幾種類型:
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@interface Reference{
boolean next() default false;
}
public @interface AnnotationElementDemo {
//枚舉類型
enum Status {FIXED,NORMAL};
//聲明枚舉
Status status() default Status.FIXED;
//布爾類型
boolean showSupport() default false;
//String類型
String name()default "";
//class類型
Class<?> testCase() default Void.class;
//注解嵌套
Reference reference() default @Reference(next=true);
//數(shù)組類型
long[] value();
}
元注解(@Target(ElementType.ANNOTATION_TYPE))
剛剛介紹的@Target,@Retention便是元注解,元注解負(fù)責(zé)注解其他注解,Java還有@Documented 和 @Inherited 兩個(gè)元注解.
- @Documented 被修飾的注解會(huì)生成到j(luò)avadoc中
- @Inherited 被注解的注解 注解的類,可以被其他類繼承,然后注解的特性會(huì)轉(zhuǎn)移到子類上,子類Class對象使用getAnnotations()獲取父類被@Inherited修飾的注解
Java內(nèi)置注解(@Retention(RetentionPolicy.RUNTIME))
- @Override：用于標(biāo)明此方法覆蓋了父類的方法
- @Deprecated：用于標(biāo)明已經(jīng)過時(shí)的方法或類
- @SuppressWarnnings:用于有選擇的關(guān)閉編譯器對類、方法、成員變量、變量初始化的警告 比如 :
@SuppressWarnings({"uncheck","deprecation"})
注解與反射
- public boolean isAnnotationPresent(Class<? extends Annotation> annotationClass) {}
注解通過反射獲取。首先可以通過 對象的getClass()的 isAnnotationPresent() 方法判斷它是否應(yīng)用了某個(gè)注解
User user = new User(); //開文那個(gè)類
System.out.println(user.getClass().isAnnotationPresent(Entity.class));//運(yùn)行結(jié)果: true
- public <A extends Annotation> A getAnnotation(Class<A> annotationClass) {}
然后通過 getAnnotation() 方法來獲取 Annotation 對象。
User user = new User();
System.out.println(user.getClass().getAnnotation(Entity.class).tableName());//運(yùn)行結(jié)果為user
public Annotation[] getAnnotations() {}
或者是 getAnnotations() 方法獲取所有的Annotation對象,包括繼承的public Annotation[] getDeclaredAnnotations()
獲取所有注解對象,不包括繼承的
