/**
 * 用于判斷是否是空字符串
 * 方法名：isEmpty
 * 創(chuàng)建人：剽悍一小兔
 * 時(shí)間：2016年9月21日-下午6:56:33
 * @param str
 * @return boolean
 */
public static boolean isEmpty(String str) {
    return null == str  || str.equals("")
            || str.matches("\\s*");
}

這是一個(gè)字符串判空的函數(shù)，函數(shù)名為isEmpty，雖然看名字大概也能猜到它的作用，可是，一旦加上了注釋，瞬間就變得更加清晰了，不是嗎？

這種注釋，當(dāng)代碼被執(zhí)行的時(shí)候，執(zhí)行機(jī)制會(huì)自動(dòng)忽略掉他們，因?yàn)檫@些文字其實(shí)是給程序員看的，而不是給執(zhí)行機(jī)制看的。

寫注釋是一種美德。

那么，注解又是什么呢？

我個(gè)人對(duì)它的看法是：所謂的注解，就是寫給電腦看的高級(jí)注釋。

你可能經(jīng)常會(huì)看到代碼里面出現(xiàn)@XXX的標(biāo)志，乍一看感覺挺高深的。反正我當(dāng)年就是這種感覺，頭腦里第一個(gè)反應(yīng)就是這肯定很難！

我還是那句話，如果你總想著復(fù)雜，那么就永遠(yuǎn)看不到簡單。

我們寫注釋，是給人看的，而注解就是寫給電腦看的。就這么簡單。

這么說可能有點(diǎn)抽象，沒關(guān)系，我們來一個(gè)快速入門吧。

2.提出問題

新建一個(gè)Java項(xiàng)目

項(xiàng)目名稱就叫做Annotation吧

在src旁邊右鍵，新建一個(gè)util包，也就是工具包。

弄一個(gè)專門處理日期的工具類

隨便寫一個(gè)日期格式化的方法。

package util;
import java.util.Date;
import java.text.SimpleDateFormat;
public class DateUtil {	
	public static String formatDate( Date date , String formatPattern ){
		return new SimpleDateFormat(formatPattern).format(date);
	}
	
}

注意，導(dǎo)包的時(shí)候要是java.util.Date;，而不是java.sql.Date;

測試：

Date now = new Date();//獲取當(dāng)前日期
System.out.println(now);
System.out.println(formatDate(now,"yyyy-MM-dd hh:mm:ss"));

控制臺(tái)打?。?/p>

Wed Sep 21 19:24:57 CST 2016
2016-09-21 07:24:57

這說明，我們寫的方法應(yīng)該是正確的。

很好，那么接下來要解決一個(gè)什么問題呢？就是說，如果我想通過代碼來獲取關(guān)于這個(gè)方法的信息，那么該如何做呢？

寫注釋肯定是不行的，因?yàn)樽⑨屖菍憘€(gè)程序員看的，電腦看不懂，更別提獲取注釋的內(nèi)容了，是吧？

于是，注解，這一種高級(jí)的注釋就出現(xiàn)了。

3.編寫注解

關(guān)于注解，要明確三個(gè)問題：

要給誰加注解??？什么時(shí)候注解起作用?。恳⒔饽切〇|西呢？

因?yàn)槭强焖偃腴T，所以大概知道這些就足夠了。

現(xiàn)在，我們來新建一個(gè)注解，毫無疑問，所謂的注解，它還是一個(gè)Java類，你不要被它嚇到。

新建一個(gè)注解包。

new一個(gè)Annotation，就叫MethodNote，意思就是說，這個(gè)是加在方法上的，為了給方法加一些電腦能看得懂的說明。

第一個(gè)問題是要給誰加注解啊？那么，這個(gè)注解類是需要加在方法上的，于是就這樣寫：

這就表示，該注解要加在方法上。

接下來，讓我們來明確第二個(gè)問題：什么時(shí)候注解起作用??？

我們希望在程序運(yùn)行的時(shí)候，注解發(fā)揮作用，就是說，當(dāng)你的程序跑起來了，電腦才開始閱讀這些注解。

這句話的意思就是說，我這個(gè)注解啊，是在程序跑起來的時(shí)候，RUNTIME嘛，就是跑起來的時(shí)候，才發(fā)揮作用的。

非常好，那么最后一個(gè)問題：要注解那些東西呢？

一個(gè)方法，最重要的信息包括：作用，創(chuàng)建時(shí)間，作者，版本，返回值等等。我們隨便抽取幾個(gè)，就作用和創(chuàng)建時(shí)間吧！

這種寫法有點(diǎn)類似于寫接口的方法。

好了，我們的第一個(gè)注解就編寫完成了！寫好了就馬上用唄，現(xiàn)在我們給日期格式化的方法加上咱自己編寫的注解。

@MethodNote(createTime = "2016-9-21")
public static String formatDate(Date date , String formatPattern){
	return new SimpleDateFormat(formatPattern).format(date);
}

這就是所謂的注解，其實(shí)也很簡單的吧。就是這么來的，它歸根到底還是一個(gè)Java類。

4.通過Java反射獲取方法的注解信息

好了，回到正題，我們已經(jīng)對(duì)formatDate方法進(jìn)行了注解，那么，既然這個(gè)注解是寫給電腦看的，那么電腦就肯定有辦法在其他Java類中獲得這些信息，對(duì)吧？

如何獲得呢，對(duì)了，用反射機(jī)制。

上代碼：

public static void main(String[] args) throws NoSuchMethodException, SecurityException {
	Class classOfDateUtil = DateUtil.class;
	Method formatDate = classOfDateUtil.getMethod("formatDate", Date.class,String.class);
	MethodNote methodNote = formatDate.getAnnotation(MethodNote.class);
	System.out.println("方法描述：" + methodNote.description());
	System.out.println("創(chuàng)建日期：" + methodNote.createTime());
}

結(jié)果：