java自定義註解
Java註解是附加在代碼中的一些元信息,用於一些工具在編譯、運行時進行解析和使用,起到說明、配置的功能。
註解不會也不能影響代碼的實際邏輯,僅僅起到輔助性的作用。包含在 java.lang.annotation 包中。
1、元註解
元註解是指註解的註解。包括 @Retention @Target @Document @Inherited四種。
1.1、@Retention: 定義註解的保留策略
@Retention(RetentionPolicy.SOURCE) //註解僅存在於源碼中,在class字節碼文件中不包含
@Retention(RetentionPolicy.CLASS) // 默認的保留策略,註解會在class字節碼文件中存在,但運行時無法獲得,
@Retention(RetentionPolicy.RUNTIME) // 註解會在class字節碼文件中存在,在運行時可以通過反射獲取到
註解類:
[java] view plain copy
@Retention(RetentionPolicy.RUNTIME) // 註解會在class字節碼文件中存在,在運行時可以通過反射獲取到br/>@Target({ElementType.FIELD,ElementType.METHOD})//定義註解的作用目標**作用範圍字段、枚舉的常量/方法
@Documented//說明該註解將被包含在javadoc中
public @interface FieldMeta {
/**
- 是否爲序列號
- @return
*/
boolean id() default false;
/** - 字段名稱
- @return
*/
String name() default "";
/** - 是否可編輯
- @return
*/
boolean editable() default true;
/** - 是否在列表中顯示
- @return
*/
boolean summary() default true;
/** - 字段描述
- @return
*/
String description() default "";
/** - 排序字段
- @return
*/
int order() default 0;
}
實體類:
[java] view plain copy
public class Anno {br/>@FieldMeta(id=true,name="序列號",order=1)
private int id;br/>@FieldMeta(name="姓名",order=3)
private String name;br/>@FieldMeta(name="年齡",order=2)
private int age;br/>@FieldMeta(description="描述",order=4)
public String desc(){
return "java反射獲取annotation的測試";
}
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
}
獲取到註解的幫助類:
[java] view plain copy
public class SortableField {
public SortableField(){}
public SortableField(FieldMeta meta, Field field) {
super();
this.meta = meta;
this.field = field;
this.name=field.getName();
this.type=field.getType();
}
public SortableField(FieldMeta meta, String name, Class<?> type) {
super();
this.meta = meta;
this.name = name;
this.type = type;
}
private FieldMeta meta;
private Field field;
private String name;
private Class<?> type;
public FieldMeta getMeta() {
return meta;
}
public void setMeta(FieldMeta meta) {
this.meta = meta;
}
public Field getField() {
return field;
}
public void setField(Field field) {
this.field = field;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public Class<?> getType() {
return type;
}
public void setType(Class<?> type) {
this.type = type;
}
}
運行時獲取註解,首先創建一個基類:
[java] view plain copy
public class Parent<T> {
private Class<T> entity;
public Parent() {br/>init();
}
@SuppressWarnings("unchecked")
public List<SortableField> init(){
List<SortableField> list = new ArrayList<SortableField>();
/**getClass().getGenericSuperclass()返回表示此 Class 所表示的實體(類、接口、基本類型或 void)
- 的直接超類的 Type(Class<T>泛型中的類型),然後將其轉換ParameterizedType。。
- getActualTypeArguments()返回表示此類型實際類型參數的 Type 對象的數組。
- [0]就是這個數組中第一個了。。
- 簡而言之就是獲得超類的泛型參數的實際類型。。*/
entity = (Class<T>)((ParameterizedType)this.getClass().getGenericSuperclass())
.getActualTypeArguments()[0];
// FieldMeta filed = entity.getAnnotation(FieldMeta.class);
if(this.entity!=null){
/**返回類中所有字段,包括公共、保護、默認(包)訪問和私有字段,但不包括繼承的字段- entity.getFields();只返回對象所表示的類或接口的所有可訪問公共字段
- 在class中getDeclared**()方法返回的都是所有訪問權限的字段、方法等;
- 可看API
- */
Field[] fields = entity.getDeclaredFields();
//
for(Field f : fields){
//獲取字段中包含fieldMeta的註解
FieldMeta meta = f.getAnnotation(FieldMeta.class);
if(meta!=null){
SortableField sf = new SortableField(meta, f);
list.add(sf);
}
}
//返回對象所表示的類或接口的所有可訪問公共方法
Method[] methods = entity.getMethods();
for(Method m:methods){
FieldMeta meta = m.getAnnotation(FieldMeta.class);
if(meta!=null){
SortableField sf = new SortableField(meta,m.getName(),m.getReturnType());
list.add(sf);
}
}
//這種方法是新建FieldSortCom類實現Comparator接口,來重寫compare方法實現排序
// Collections.sort(list, new FieldSortCom());
Collections.sort(list, new Comparator<SortableField>() {br/>@Override
public int compare(SortableField s1,SortableField s2) {
return s1.getMeta().order()-s2.getMeta().order();
// return s1.getName().compareTo(s2.getName());//也可以用compare來比較
}
});
}
return list;
}
}
創建子類繼承基類:
[java] view plain copy
public class Child extends Parent<Anno>{
}
測試類:
[java] view plain copy
public class TestAnnotation {
@SuppressWarnings({ "unchecked", "rawtypes" })
public static void main(String[] args) {
Parent c = new Child();
List<SortableField> list = c.init();//獲取泛型中類裏面的註解
//輸出結果
for(SortableField l : list){
System.out.println("字段名稱:"+l.getName()+"\t字段類型:"+l.getType()+
"\t註解名稱:"+l.getMeta().name()+"\t註解描述:"+l.getMeta().description());
}
}
}
轉:
1、Annotation的工作原理:
JDK5.0中提供了註解的功能,允許開發者定義和使用自己的註解類型。該功能由一個定義註解類型的語法和描述一個註解聲明的語法,讀取註解的API,一個使用註解修飾的class文件和一個註解處理工具組成。
Annotation並不直接影響代碼的語義,但是他可以被看做是程序的工具或者類庫。它會反過來對正在運行的程序語義有所影響。
Annotation可以衝源文件、class文件或者在運行時通過反射機制多種方式被讀取。
2、@Override註解:
java.lang
註釋類型 Overridebr/>@Target(value=METHOD)
@Retention(value=SOURCE)
public @interface Override
表示一個方法聲明打算重寫超類中的另一個方法聲明。如果方法利用此註釋類型進行註解但沒有重寫超類方法,則編譯器會生成一條錯誤消息。
@Override註解表示子類要重寫父類的對應方法。
Override是一個Marker annotation,用於標識的Annotation,Annotation名稱本身表示了要給工具程序的信息。
下面是一個使用@Override註解的例子:
class A {
private String id;
A(String id){
this.id = id;br/>}
@Override
public String toString() {
return id;br/>}
}
3、@Deprecated註解:
java.lang
註釋類型 Deprecatedbr/>@Documented
@Retention(value=RUNTIME)
public @interface Deprecated
用 @Deprecated 註釋的程序元素,不鼓勵程序員使用這樣的元素,通常是因爲它很危險或存在更好的選擇。在使用不被贊成的程序元素或在不被贊成的代碼中執行重寫時,編譯器會發出警告。
@Deprecated註解表示方法是不被建議使用的。
Deprecated是一個Marker annotation。
下面是一個使用@Deprecated註解的例子:
class A {
private String id;
A(String id){
this.id = id;br/>}
@Deprecated
public void execute(){
System.out.println(id);
}
public static void main(String[] args) {
A a = new A("a123");br/>a.execute();
}
}
4、@SuppressWarnings註解:
java.lang
註釋類型 SuppressWarningsbr/>@Target(value={TYPE,FIELD,METHOD,PARAMETER,CONSTRUCTOR,LOCAL_VARIABLE})
@Retention(value=SOURCE)
public @interface SuppressWarnings
指示應該在註釋元素(以及包含在該註釋元素中的所有程序元素)中取消顯示指定的編譯器警告。注意,在給定元素中取消顯示的警告集是所有包含元素中取消顯示的警告的超集。例如,如果註釋一個類來取消顯示某個警告,同時註釋一個方法來取消顯示另一個警告,那麼將在此方法中同時取消顯示這兩個警告。
根據風格不同,程序員應該始終在最裏層的嵌套元素上使用此註釋,在那裏使用纔有效。如果要在特定的方法中取消顯示某個警告,則應該註釋該方法而不是註釋它的類。
@SuppressWarnings註解表示抑制警告。
下面是一個使用@SuppressWarnings註解的例子:
@SuppressWarnings("unchecked")
public static void main(String[] args) {
List list = new ArrayList();
list.add("abc");
}
5、自定義註解:
使用@interface自定義註解時,自動繼承了java.lang.annotation.Annotation接口,由編譯程序自動完成其他細節。在定義註解時,不能繼承其他的註解或接口。
自定義最簡單的註解:
public @interface MyAnnotation {
}
使用自定義註解:
public class AnnotationTest2 {
@MyAnnotation
public void execute(){
System.out.println("method");
}
}
5.1、添加變量:
public @interface MyAnnotation {
String value1();
}
使用自定義註解:
public class AnnotationTest2 {
@MyAnnotation(value1="abc")
public void execute(){
System.out.println("method");
}
}
當註解中使用的屬性名爲value時,對其賦值時可以不指定屬性的名稱而直接寫上屬性值接口;除了value意外的變量名都需要使用name=value的方式賦值。
5.2、添加默認值:
public @interface MyAnnotation {
String value1() default "abc";
}
5.3、多變量使用枚舉:
public @interface MyAnnotation {
String value1() default "abc";
MyEnum value2() default MyEnum.Sunny;
}
enum MyEnum{
Sunny,Rainy
}
使用自定義註解:
public class AnnotationTest2 {
@MyAnnotation(value1="a", value2=MyEnum.Sunny)
public void execute(){
System.out.println("method");
}
}
5.4、數組變量:
public @interface MyAnnotation {
String[] value1() default "abc";
}
使用自定義註解:
public class AnnotationTest2 {
@MyAnnotation(value1={"a","b"})
public void execute(){
System.out.println("method");
}
}br/>6、設置註解的作用範圍:
@Documented
@Retention(value=RUNTIME)br/>@Target(value=ANNOTATION_TYPE)
public @interface Retention
指示註釋類型的註釋要保留多久。如果註釋類型聲明中不存在 Retention 註釋,則保留策略默認爲 RetentionPolicy.CLASS。
只有元註釋類型直接用於註釋時,Target 元註釋纔有效。如果元註釋類型用作另一種註釋類型的成員,則無效。
public enum RetentionPolicy
extends Enum<RetentionPolicy>
註釋保留策略。此枚舉類型的常量描述保留註釋的不同策略。它們與 Retention 元註釋類型一起使用,以指定保留多長的註釋。
CLASS
編譯器將把註釋記錄在類文件中,但在運行時 VM 不需要保留註釋。
RUNTIME
編譯器將把註釋記錄在類文件中,在運行時 VM 將保留註釋,因此可以反射性地讀取。
SOURCE
編譯器要丟棄的註釋。
@Retention註解可以在定義註解時爲編譯程序提供註解的保留策略。
屬於CLASS保留策略的註解有@SuppressWarnings,該註解信息不會存儲於.class文件。
6.1、在自定義註解中的使用例子:br/>@Retention(RetentionPolicy.CLASS)
public @interface MyAnnotation {
String[] value1() default "abc";
}
7、使用反射讀取RUNTIME保留策略的Annotation信息的例子:
java.lang.reflect
接口 AnnotatedElement
所有已知實現類:
AccessibleObject, Class, Constructor, Field, Method, Package
表示目前正在此 VM 中運行的程序的一個已註釋元素。該接口允許反射性地讀取註釋。由此接口中的方法返回的所有註釋都是不可變並且可序列化的。調用者可以修改已賦值數組枚舉成員的訪問器返回的數組;這不會對其他調用者返回的數組產生任何影響。
如果此接口中的方法返回的註釋(直接或間接地)包含一個已賦值的 Class 成員,該成員引用了一個在此 VM 中不可訪問的類,則試圖通過在返回的註釋上調用相關的類返回的方法來讀取該類,將導致一個 TypeNotPresentException。
isAnnotationPresent
boolean isAnnotationPresent(Class<? extends Annotation> annotationClass)
如果指定類型的註釋存在於此元素上,則返回 true,否則返回 false。此方法主要是爲了便於訪問標記註釋而設計的。
參數:
annotationClass - 對應於註釋類型的 Class 對象
返回:
如果指定註釋類型的註釋存在於此對象上,則返回 true,否則返回 false
拋出:
NullPointerException - 如果給定的註釋類爲 null
從以下版本開始:
1.5
getAnnotation
<T extends Annotation> T getAnnotation(Class<T> annotationClass)
如果存在該元素的指定類型的註釋,則返回這些註釋,否則返回 null。
參數:
annotationClass - 對應於註釋類型的 Class 對象
返回:
如果該元素的指定註釋類型的註釋存在於此對象上,則返回這些註釋,否則返回 null
拋出:
NullPointerException - 如果給定的註釋類爲 null
從以下版本開始:
1.5
getAnnotations
Annotation[] getAnnotations()
返回此元素上存在的所有註釋。(如果此元素沒有註釋,則返回長度爲零的數組。)該方法的調用者可以隨意修改返回的數組;這不會對其他調用者返回的數組產生任何影響。
返回:
此元素上存在的所有註釋
從以下版本開始:
1.5
getDeclaredAnnotations
Annotation[] getDeclaredAnnotations()
返回直接存在於此元素上的所有註釋。與此接口中的其他方法不同,該方法將忽略繼承的註釋。(如果沒有註釋直接存在於此元素上,則返回長度爲零的一個數組。)該方法的調用者可以隨意修改返回的數組;這不會對其他調用者返回的數組產生任何影響。
返回:
直接存在於此元素上的所有註釋
從以下版本開始:
1.5
下面是使用反射讀取RUNTIME保留策略的Annotation信息的例子:
自定義註解:
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
String[] value1() default "abc";
}
使用自定義註解:
public class AnnotationTest2 {
@MyAnnotation(value1={"a","b"})
@Deprecated
public void execute(){
System.out.println("method");
}
}
讀取註解中的信息:
public static void main(String[] args) throws SecurityException, NoSuchMethodException, IllegalArgumentException, IllegalAccessException, InvocationTargetException {
AnnotationTest2 annotationTest2 = new AnnotationTest2();
//獲取AnnotationTest2的Class實例
Class<AnnotationTest2> c = AnnotationTest2.class;
//獲取需要處理的方法Method實例
Method method = c.getMethod("execute", new Class[]{});
//判斷該方法是否包含MyAnnotation註解
if(method.isAnnotationPresent(MyAnnotation.class)){
//獲取該方法的MyAnnotation註解實例
MyAnnotation myAnnotation = method.getAnnotation(MyAnnotation.class);
//執行該方法
method.invoke(annotationTest2, new Object[]{});
//獲取myAnnotation
String[] value1 = myAnnotation.value1();
System.out.println(value1[0]);
}
//獲取方法上的所有註解
Annotation[] annotations = method.getAnnotations();
for(Annotation annotation : annotations){
System.out.println(annotation);
}
}
8、限定註解的使用:
限定註解使用@Target。
@Target(ElementType.ANNOTATION_TYPE)
public @interface MetaAnnotationType {
...
}
此元註釋指示該聲明類型只可作爲複雜註釋類型聲明中的成員類型使用。它不能直接用於註釋:
@Target({})
public @interface MemberType {
...
}
這是一個編譯時錯誤,它表明一個 ElementType 常量在 Target 註釋中出現了不只一次。例如,以下元註釋是非法的:
@Target({ElementType.FIELD, ElementType.METHOD, ElementType.FIELD})
public @interface Bogus {
...
}
public enum ElementType
extends Enum<ElementType>
程序元素類型。此枚舉類型的常量提供了 Java 程序中聲明的元素的簡單分類。
這些常量與 Target 元註釋類型一起使用,以指定在什麼情況下使用註釋類型是合法的。
ANNOTATION_TYPE
註釋類型聲明
CONSTRUCTOR
構造方法聲明
FIELD
字段聲明(包括枚舉常量)
LOCAL_VARIABLE
局部變量聲明
METHOD
方法聲明
PACKAGE
包聲明
PARAMETER
參數聲明
TYPE
類、接口(包括註釋類型)或枚舉聲明
註解的使用限定的例子:
@Target(ElementType.METHOD)
public @interface MyAnnotation {
String[] value1() default "abc";
}
9、在幫助文檔中加入註解:
要想在製作JavaDoc文件的同時將註解信息加入到API文件中,可以使用java.lang.annotation.Documented。
在自定義註解中聲明構建註解文檔:
@Documented
public @interface MyAnnotation {
String[] value1() default "abc";
}
使用自定義註解:
public class AnnotationTest2 {
@MyAnnotation(value1={"a","b"})
public void execute(){
System.out.println("method");
}
}
10、在註解中使用繼承:
默認情況下註解並不會被繼承到子類中,可以在自定義註解時加上java.lang.annotation.Inherited註解聲明使用繼承。
注意,如果使用註釋類型註釋類以外的任何事物,此元註釋類型都是無效的。還要注意,此元註釋僅促成從超類繼承註釋;對已實現接口的註釋無效。
閱讀全文請點擊:Java自定義註解和運行時靠反射獲取註解