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