內(nèi)容: 使用J2SE 5.0的注解來(lái)去除getter和setter摘要getter/setter這種習(xí)慣用法一直是有問(wèn)題的，它允許你的類(lèi)更容易被訪(fǎng)問(wèn)，卻使這些類(lèi)失去了可維護(hù)性。J2SE 5.0的注解（或者說(shuō)元數(shù)據(jù)）提供了另一種可能性。比起用自省尋找get/set方法，你可以用注解“標(biāo)注類(lèi)，然后在編譯或者運(yùn)行時(shí)訪(fǎng)問(wèn)那個(gè)注解。這篇文章不僅描述了注解機(jī)制，還介紹了一個(gè)基于XML的持久化機(jī)制的輸出端，這個(gè)機(jī)制使用注解來(lái)標(biāo)注類(lèi)和字段。我曾經(jīng)在JavaWorld對(duì)getter/setter這種習(xí)慣用法的缺點(diǎn)做了很詳細(xì)的討論（請(qǐng)看資源）。這種習(xí)慣用法一開(kāi)始是在JavaBean規(guī)范中被介紹的，以作為一種“標(biāo)注對(duì)象屬性的方法，這樣，一個(gè)擴(kuò)展的用戶(hù)界面層工具（叫做BeanBox）可以為那個(gè)對(duì)象創(chuàng)建一系列的屬性列表。你可以像下面那樣提供方法來(lái)“標(biāo)注屬性。String getFoo();void setFoo( String newValue );BeanBox使用Class類(lèi)中的自省API獲取方法列表，然后使用模式匹配來(lái)尋找getter/setter對(duì)。根據(jù)這些推斷出屬性是否存在，并確定屬性的類(lèi)型（在這個(gè)例子中，有一個(gè)String類(lèi)型的Foo屬性）。你是不會(huì)調(diào)用這些方法的，它們只會(huì)被BeanBox調(diào)用。有趣的是，JavaBean規(guī)范的作者完全清楚getter/setter標(biāo)注機(jī)制的問(wèn)題所在（主要缺點(diǎn)已經(jīng)在以前的文章中討論過(guò)了，getter/setter方法暴露了過(guò)多的對(duì)象實(shí)現(xiàn)信息，所以底層類(lèi)很難維護(hù)）。因此，設(shè)計(jì)者提供了大量的面向?qū)ο蠼鉀Q方法，比如BeanInfo和Customizer接口。用戶(hù)實(shí)現(xiàn)了這些接口以后，就可以在沒(méi)有setter/getter的條件下建立圖形用戶(hù)界面。不幸的是，這些過(guò)度復(fù)雜的面向?qū)ο蠓椒ㄔ谝?guī)范里很少提到。Getter/setter方法是簡(jiǎn)單的，可是如果你不能理解面向?qū)ο箨P(guān)系的維護(hù)問(wèn)題，getter/setter方法好象是很合理的。因此，BeanInfo/Customizer方法就沒(méi)落了，而getter/setter策略則像兔子一樣快速繁殖。然而，你所經(jīng)常看到的習(xí)慣用法并不是最好的做法。JavaBean剛被提出時(shí)，許多人（包括我自己）贊成在Java中使用新的關(guān)鍵字來(lái)消除getter和setter。利用新引入的關(guān)鍵字的能力，我在早些時(shí)候像下面那樣描述Foo屬性：private @property String foo;因?yàn)閒oo是私有的，所以用新的關(guān)鍵字把它暴露給BeanBox并沒(méi)有違反封裝的原則。可是這時(shí)，引入新關(guān)鍵字有些離經(jīng)叛道，盡管這個(gè)關(guān)鍵字不可能跟已經(jīng)存在的標(biāo)識(shí)符混淆，畢竟它們包含一個(gè)非法字符@。當(dāng)J2SE 5.0出現(xiàn)時(shí)，Sun已經(jīng)領(lǐng)會(huì)到了它的微妙，并且對(duì)語(yǔ)言的主要語(yǔ)法做了一點(diǎn)調(diào)整。現(xiàn)在，你可以引入一個(gè)新的關(guān)鍵字（叫做注解）來(lái)表明一個(gè)屬性會(huì)在編譯時(shí)或者運(yùn)行時(shí)被檢查。你可以引入你選擇的任何關(guān)鍵字。只需要做到這點(diǎn)，注解（關(guān)鍵字）必須有一個(gè)前導(dǎo)@符號(hào)，并且你必須像使用形容詞一樣使用注解（注解可以放在任何你可以聲明static，final，或者public的地方）。最后，你可以?huà)侀_(kāi)getter和setter了，一種更干凈的語(yǔ)法能夠做到相同的事情。Java內(nèi)置了兩個(gè)很棒的關(guān)于注解的例子。想想這樣一種情況，你的類(lèi)繼承自AWT/Swing的Adapter，可是卻不小心拼錯(cuò)了基類(lèi)方法的名字。你認(rèn)為你覆寫(xiě)了基類(lèi)的方法，實(shí)際上卻沒(méi)有。這種意料之外的繼承是非常難以發(fā)現(xiàn)，但是如下的代碼中的錯(cuò)誤卻很容易被編譯器檢測(cè)出來(lái)。public class myListener implements MouseListener{ @Overrides void MousePressed(MouseEvent e) { System.out.println('Mouse button clicked!'); }}編譯器在這里會(huì)抱怨，因?yàn)榛?lèi)的方法叫做mousePressed()（m是小寫(xiě)的），而不是MousePressed()，就像類(lèi)定義的那樣。另外，程序里的注解@Deprecated在語(yǔ)法上也比Javadoc中的要簡(jiǎn)潔（因?yàn)樽⑨寖?nèi)容不會(huì)影響類(lèi)的兼容性）。有兩種途徑可以處理注解。首先，Class類(lèi)的自省API可以獲取關(guān)聯(lián)到類(lèi)的注解，以及關(guān)聯(lián)到類(lèi)的字段和方法的注解。BeanBox可以使用這種機(jī)制來(lái)尋找被標(biāo)注的屬性，并建立起屬性列表。如果你沒(méi)有自己的BeanBox，那么還有另一種選擇。JDK提供了apt (Annotation Processing Tool)處理器，它是javac的前端，能夠理解注解，并允許你構(gòu)建Java源代碼。你需要給apt提供不同的注解處理器插件。在這個(gè)例子中，插件會(huì)建立一個(gè)包裝類(lèi)，像老式的BeanBox做的那樣，使用getter/setter這種習(xí)慣用法來(lái)把被注解的屬性暴露給外界。不過(guò)，（就算是按Sun的標(biāo)準(zhǔn)）apt的文檔也是非常糟糕的。我會(huì)在以后的文章中在介紹如何使用。在這篇文章中，我會(huì)展示一個(gè)小的持久化框架的“輸出端來(lái)告訴你如何使用運(yùn)行時(shí)注解。這個(gè)框架并沒(méi)有解決全部持久關(guān)系問(wèn)題的打算，但是它很容易的把一個(gè)對(duì)象的狀態(tài)表示為一個(gè)XML字符串。你可以用這種原理來(lái)取代其他應(yīng)用中的getter和setter，比如GUI或者幫助系統(tǒng)（通過(guò)注解一個(gè)類(lèi)來(lái)說(shuō)明詳細(xì)的信息）。版權(quán)聲明：任何獲得Matrix授權(quán)的網(wǎng)站，轉(zhuǎn)載時(shí)請(qǐng)務(wù)必保留以下作者信息和鏈接作者:Allen Holub ;deafwolf(作者的blog:http://blog.matrix.org.cn/page/deafwolf)原文:http://www.javaworld.com/javaworld/jw-03-2005/jw-0321-toolbox.htmlMatrix:http://www.matrix.org.cn/resource/article/44/44458_annotation+persistence.html關(guān)鍵字:annotation;persistence使用XMLExporter類(lèi)清單1示范了我的持久化框架是如何使用注解的，清單2則展示了相應(yīng)的輸出。清單1. Test.java：使用XMLExporter 1 package com.holub.persist.test; 2 3 import java.io.*; 4 import java.util.*; 5 import com.holub.persist.*; 6 import com.holub.persist.Exportable; 7 //---------------------------------------------------------------------- 8 @Exportable 9 class Address 10 { private @Persistent String street; 11 private @Persistent String city; 12 private @Persistent String state; 13 private @Persistent('zipcode') int zip; 14 15 public Address( String street, String city, String state, int zip ) 16 { this.street = street; 17 this.city = city; 18 this.state = state; 19 this.zip = zip; 20 } 21 } 22 //---------------------------------------------------------------------- 23 public class Test 24 { 25 @Exportable( name='customer', description='A Customer' ) 26 public static class Customer 27 { 28 @com.holub.persist.Persistent 29 private String name = 'Allen Holub'; 30 31 @Persistent 32 private Address streetAddress = 33 new Address( '1234 MyStreet', 34'Berkeley', 'CA', 99999 ); 35 @Persistent 36 private StringBuffer notes = new StringBuffer( 'Notes go here '); 37 38 private int garbage; // Is not persistant 39 40 @Persistent Collection invoices = new LinkedList(); 41 { invoices.add( new Invoice(0) ); 42 invoices.add( new Invoice(1) ); 43 } 44 } 45 46 @Exportable 47 public static class Invoice 48 { private @Persistent int number; 49 public Invoice( int number ){ this.number = number; } 50 } 51 52 public static void main(String[] args ) throws IOException 53 { Customer x = new Customer(); 54 XmlExporter out = 55 new XmlExporter( 56 new PrintWriter(System.out, true) ); 57 out.flush( x ); 58 } 59 }Listing 2. Test output 1