前言:無(說一堆也沒用)
注解得圖解:
部分1.png
部分2.png
注解的原理
使用說明
下面我們舉例現(xiàn)實生活中的水果的收購案例(擼代碼)
其中FruitName (用于注解水果的名稱)就可注解描述域.
/**
水果名稱
*/
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface FruitName {
String value() default "";
}
其中FruitColor (用于注解水果的顏色)
default 是指默認(rèn)使用的值(下面的也是如此)
/**
* 注解水果顏色
*/
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface FruitColor {
/**
* 顏色枚舉
*/
public enum Color {
BULE, RED, GREEN
}
/**
* 顏色屬性
*/
Color fruitColor() default Color.GREEN;
}
其中FruitProvider(用于注解供應(yīng)商)
/**
* 水果供應(yīng)者注解
*/
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface FruitProvider {
/**
* 供應(yīng)商編號
*/
public int id() default -1;
/**
* 供應(yīng)商名稱
*/
public String name() default "";
/**
* 供應(yīng)商地址
*/
public String address() default "";
}
這時,沒有接觸過注解的有觀眾開始說了:"說了使用說明,這都是什么鬼啊,你寫了這么多這個干嗎啊?".
大兄弟你先別急,把手中的磚頭放下,有話好好說嘛,馬上就開始說他的使用了.
自定義注解的使用
/**
* 蘋果
*
* @author Administrator 開始使用注解
*/
public class Apple {
//使用了咱們剛才自定義的注解"FruitName"
@FruitName(value = "富士")
private String appleName;
//使用了咱們剛才自定義的注解"FruitColor"
@FruitColor(fruitColor = Color.RED)
private String appleColor;
//使用了咱們剛才自定義的注解"FruitProvider"
@FruitProvider(id = 1, name = "劉氏紅富士集團",
address = "河北省石家莊市槐北路路01號紅富士大廈")
private String appleProvider;
public void setAppleColor(String appleColor) {
this.appleColor = appleColor;
}
public String getAppleColor() {
return appleColor;
}
public void setAppleName(String appleName) {
this.appleName = appleName;
}
public String getAppleName() {
return appleName;
}
public void setAppleProvider(String appleProvider) {
this.appleProvider = appleProvider;
}
public String getAppleProvider() {
return appleProvider;
}
}
這時聰明的大兄弟們開始發(fā)問了:"那你怎么使用你注解里面的值啊,
比如'富士' ,' RED',?,你運行的時候,就顯示了嗎?"
回答當(dāng)然不是了,下面我們要引入一個概念注解處理器,才能解決這個問題.
注解處理器
注解處理器說明:
如果沒有用來讀取注解的方法和工作,那么注解也就不會比注釋更有用處了湃缎。使用注解的過程中袍嬉,很重要的一部分就是創(chuàng)建于使用注解處理器。
Java SE5擴展了反射機制的API,以幫助程序員快速的構(gòu)造自定義注解處理器。
注解處理器類庫說明:
Java使用Annotation接口來代表程序元素前面的注解,該接口是所Annotatio類型的父接口 除此之外彪笼,Java在java.lang.reflect 包下新增了AnnotatedElement接口,
該接口代表程序中可以接受注解的程序元素蚂且,該接口主要有如下幾個實現(xiàn)類:
Class:類定義
Constructor:構(gòu)造器定義
Field:累的成員變量定義
Method:類的方法定義
Package:類的包定義
去實踐吧
/**
* 水果工具
*
* @author Administrator 使用注解器
*/
public class FruitInfoUtil {
public static void getFruitInfo(Class<?> clazz) {
String strFruitName = " 水果名稱:";
String strFruitColor = " 水果顏色:";
String strFruitProvicer = "供應(yīng)商信息:";
// 找到所有Annotation所修飾的對象范圍
Field[] fields = clazz.getDeclaredFields();
for (Field field : fields) {
if (field.isAnnotationPresent(FruitName.class)) {
//使用FruitName注解
FruitName fruitName = (FruitName) field
.getAnnotation(FruitName.class);
strFruitName = strFruitName + fruitName.value();
System.out.println(strFruitName);
} else if (field.isAnnotationPresent(FruitColor.class)) {
//使用FruitColor注解
FruitColor fruitColor = (FruitColor) field
.getAnnotation(FruitColor.class);
strFruitColor = strFruitColor
+ fruitColor.fruitColor().toString();
System.out.println(strFruitColor);
} else if (field.isAnnotationPresent(FruitProvider.class)) {
//使用FruitProvider注解
FruitProvider fruitProvider = (FruitProvider) field
.getAnnotation(FruitProvider.class);
strFruitProvicer = " 供應(yīng)商編號:" + fruitProvider.id() + " 供應(yīng)商名稱:"
+ fruitProvider.name() + " 供應(yīng)商地址:"
+ fruitProvider.address();
System.out.println(strFruitProvicer);
}
}
}
}
說了這么多是時候檢驗成果了
public class Test {
public static void main(String[] args) {
FruitInfoUtil.getFruitInfo(Apple.class);
}
}
輸出結(jié)果
水果名稱:富士
水果顏色:RED
供應(yīng)商編號:1 供應(yīng)商名稱:劉氏紅富士集團 供應(yīng)商地址:河北省石家莊市槐北路路01號紅富士大廈
大功告成(另外小弟對扯蛋我有獨到見解,歡迎大家前來扯蛋)
參考文章
Java Annotation及注解原理簡析
Java注解(Annotation)原理詳解
annotation 原理學(xué)習(xí)總結(jié)
深入理解Java:注解(Annotation)基本概念
Java學(xué)習(xí)之注解Annotation實現(xiàn)原理