最近這幾年，XML大臣的宅邸車水馬龍，像什么Spring, Hibernate, MyBatis 等大大小小的官員進京來都要拜訪一下，無數(shù)的冰敬碳敬悄悄地送入府中， 真可謂紅極一時， 正處于人生巔峰。 原因很簡單，Java帝國的配置文件幾乎都在使用XML, 自然都?xì)wXML大臣管理，想不紅都難！

其他大臣看在眼里，恨在心里，他們決定聯(lián)合起來，堅決打擊XML大臣的囂張氣焰， 堅決把白花花的銀子轉(zhuǎn)移到自己府中來。  幾位老家伙商量以后，決定還是推舉老成持國的IO大臣為首領(lǐng)，給XML大臣一點顏色瞧瞧。 

可是IO大臣想了半天，也沒什么好辦法。  

這一天有個姓安的翰林自報家門求見， 說是可以助IO大臣一臂之力。

“安大人有何見教？”  IO大臣懶洋洋地問道，他對這些讀死書的翰林們沒什么好感。

“大人，下官在負(fù)責(zé)Java注解，對付XML大臣，也許是個突破口”

“注解？ 這是什么東西？”  IO大臣確實是有點老了

“其實就是元數(shù)據(jù)了”

“元數(shù)據(jù)？”  IO大臣一頭霧水。

“嗯， Metadata”   安翰林把英文都整出來了。 

“賣它推它？”  IO大臣明顯英文不好。

旁邊的幕僚一個勁兒的使眼色， 諄諄告誡安翰林要通俗易懂。

安翰林說： “大人肯定知道@Override,@SuppressWarning等注解吧？ ”

IO大臣點頭。

安翰林接著說： “所謂元數(shù)據(jù)， 就是描述數(shù)據(jù)的數(shù)據(jù)了，換句話說可以給其他數(shù)據(jù)提供描述性信息， 例如Java類中的某個方法，可以認(rèn)為是一種數(shù)據(jù)， 如果我的@Override 一旦被用到這個方法上，那就意味著要覆蓋父類/接口的方法了，于是我的@Override 就給這個方法提供了額外的信息。”

 “但是在源代碼中寫個@Override 似乎也沒什么用處??？ ”  IO大臣問道

 “所以這只是元數(shù)據(jù),  它給其他數(shù)據(jù)（如Java方法）提供了信息， 但是怎么樣利用這些信息那就不歸我管了?！?nbsp;

 “那歸誰管？” 

“比如@Override ， 由編譯器來管，當(dāng)編譯這個Java 文件的時候，它就會檢查被@Override 修飾的方法是否和父類的方法和參數(shù)相同， 如果不同，就會報錯了?！?/p>

IO大臣說： “奧，明白了，所謂的注解有點像加強版的注釋， 這個“注釋”不但有一定的格式，還有特定的含義，這樣別的工具就可以讀取它來做事情了！”

安翰林松了一口氣， 心里暗自佩服IO大臣的總結(jié)能力。 

“我記得這個@Override注解很早就有了啊，好像是JDK1.4吧”

“沒錯，  之前JDK內(nèi)置了@Override、@Deprecated 、@SuppressWarnings等注解， 但是用處不大， 下官有個想法，干脆允許臣民們自定義注解得了”  安翰林開始切入正題。

“自定義？ 就是讓臣民們自己寫？ ”

“是的大人， 比如我可以自定義一個叫做 @Test的 注解：”  安翰林說著把寫好的代碼呈了上去。 

安翰林接著說： 大人請看我這里定義了一個叫做Test的注解，它有個ignore方法， 一會兒您老就看到它的用途了， 這個注解是應(yīng)用在方法上的 @Target(ElementType.METHOD)， 在運行時起作用@Retention(RetentionPolicy.RUNTIME)。

IO大臣問道：“稍等， 我怎么還看到了@Target，@Retention， 這是什么？ ”

 “這稱為元注解，可以認(rèn)為是注解的注解。” 安翰林嘿嘿一笑說  “@Target表示該注解的應(yīng)用目標(biāo)，可以是類、方法、 方法參數(shù)等等， @Retention表示這個注解要保留到什么時候， 可以只在源碼中， 或者class 文件中， 或者是運行時?！?/p>

“ 注解的注解， 真是夠拗口的啊， 這個自定義的注解@Test 該怎么使用呢？ ”

安翰林又展示了另外一段代碼：

IO大臣看了下，心想這自定義的注解和JDK內(nèi)置的注解都差不多嘛，@Test修飾了方法， 表示這個方法可以作為測試用例來運行， @Test(ignore=true)則表示雖然這是個測試方法， 但是暫時忽略，不用運行， 果然簡潔而清爽，老夫真是小看了這個安翰林。

“@Test注解的定義和使用，只是定義了行為語義，怎么樣實現(xiàn)這個行為呢？  ” IO大臣問道

安翰林早有準(zhǔn)備：“大人請看，我可以在運行時通過反射的方式取出把方法的注解，如果這個注解是@Test， 并且沒有被ignore ， 那就可以通過反射去執(zhí)行這個方法了， 是不是很簡單？”

IO大臣微微點了點頭，表示贊同，接著便閉目陷入了沉思： 這個東西有點意思，在一個方法上添加了簡單的修飾性注解@Test以后，這個方法突然間就有了額外的語義，變成了可以執(zhí)行的測試用例了 !

如果是XML老頭兒， 該怎么描述類似的行為呢？  也許得這樣：

相比于簡潔的@Test注解，這個方式實在是太復(fù)雜了， 更重要的是每次增加新的方法，除了修改Java文件之外，還得記著修改這個XML文件， 實在是繁瑣。

嗯， 看來這個注解確實是個殺手锏， 要謹(jǐn)慎使用，一擊必中。

想到這里，IO大臣睜開眼睛，喜笑顏開，讓安翰林寫一個關(guān)于注解的詳細(xì)奏章，自己在合適的時候呈給皇上。 

初六陽光燦爛，IO大臣看到早朝的皇上心情不錯，就把奏章呈了上去。 

“注解？ 這是什么東西？”  皇上根本沒心思了解細(xì)節(jié)。

“啟奏陛下，這個注解能夠部分的代替一些XML的配置工作”  IO大臣一邊小心翼翼地回復(fù)，一邊用余光向XML大臣掃去。 

看到IO大臣向自己發(fā)難， XML大臣立刻警覺起來， 他馬上說： “陛下，可否讓老臣一觀？”

皇帝示意讓呂公公把奏章遞給XML大臣。 

XML大臣看了一會兒就明白大事不好， 這簡直是釜底抽薪， 如果這個帝國批準(zhǔn)了這個玩意兒，允許臣民們自定義注解，自己的勢力要大大地被削弱了。

XML大臣腦海中出現(xiàn)一副可怕的場景， Spring, Struts, Hibernate 等紛紛倒戈，都采用注解來進行系統(tǒng)配置，白花花的銀子開始流向IO大臣的府邸......

不， 堅決要把這點星星之火迅速撲滅。 

“陛下，依老臣之見， 此法斷不可行！”  XML大臣斬釘截鐵。

“為何不可行？  使用注解，配置靠近代碼，容易閱讀、容易修改！”  IO大臣立刻反擊， 為了展示易讀易改，IO大臣還現(xiàn)場寫了一段代碼，描述了一個普通的Java 類是如何向數(shù)據(jù)庫表和列映射的。 朝中多位大臣齊聲喝彩，  為IO大臣搖旗吶喊。

“單獨看一個當(dāng)然很清晰， 但是如果多了， 配置分散在各個Java文件中， 極難查找，到時候你哭都來不及， 如果你用了XML, 所有的配置集中在一處， 一目了然。 還有，如果你想修改配置就得改Java源文件，重新編譯部署，這也太扯了吧？！” XML大臣不甘示弱。

眼看著兩位重臣開始劍拔弩張， 皇帝決定出面和稀泥， 他也不希望一家獨大，也想平衡一下朝中關(guān)系。

“兩位愛卿，依朕之意，還是先在JDK中加入自定義注解的支持，至于是用注解還是用XML， 還是讓朕的子民們?nèi)ミx擇吧！  ”

看到皇上主意已定， 兩位大臣只好退下。 

自定義注解發(fā)布了， 令大家沒有想到的是，無論是注解還是XML配置都沒有占據(jù)壟斷地位，很多人把二者混合起來使用了！  對于一些需要集中配置的場合，例如數(shù)據(jù)源的配置， 自然是用XML。 另外一方面對于@Controller, @RequestMapping, @Transactional 這樣的注解 ， 大家更喜歡和Java方法寫在一起，顯得簡單而直觀。

這正如朝中的局勢，沒人能夠一家獨大，XML大臣雖然丟失了一些領(lǐng)地，但依然是不可忽視的力量。 一場爭斗，唯一的大贏家可能就是安翰林了，他被任命為Annotation大臣，專門管理自定義的注解。 

（完）