【賽迪網(wǎng)技術(shù)報道】Java Annotations主要用來標注deprecated的代碼。在這篇文章中，它們用來把方法調(diào)用的控制權(quán)移交給一個輕量級框架中負責處理一系列方法調(diào)用的組件。因此，正確的初始化和設(shè)置等操作被委派給客戶端應用而不是類，以做到設(shè)置和控制都可以調(diào)整。
對于開發(fā)者來說，復雜的應用通常有很多初始化問題需要處理。許多不同的步驟無非是建立面板，配置服務之類。而這些事情的難點在于，有一些步驟需要重復，另一些則不需要。把這種管理問題交給類自己處理是非常麻煩的，因為邏輯可能會變化。另外，現(xiàn)代軟件設(shè)計強調(diào)分離職責。簡單來說，我們的目的是把做什么和怎么做分離開來。
這篇文章展示給大家如何使用 Annotations來做初始化控制，這種做法超越了簡單的標注。它介紹了一個小的API，可以用它來開發(fā)你自己的“phaseable” Annotations，或者在這種新特性上給你提供一些靈感。
版權(quán)聲明：任何獲得Matrix授權(quán)的網(wǎng)站，轉(zhuǎn)載時請務必保留以下作者信息和鏈接
作者:Norbert Ehreke;deafwolf(作者的blog:http://blog.matrix.org.cn/page/deafwolf)
原文:http://www.matrix.org.cn/resource/article/44/44403_Java+Annotations.html
關(guān)鍵字:Java;Annotations
Annotations
Annotations是J2SE 5.0引入的新語言特性。通常， Annotations允許開發(fā)者用一種跟運行代碼無關(guān)的次要信息來標注類，方法以及成員。這樣就可以使用類似評價的 Annotations，比如“好方法”、“壞方法”，或者更詳細一些，“不推薦的方法”、“覆寫的方法”。這些用法的可能性是無窮的。不過請注意，方法或類跟標注實際可能不相關(guān)，比如“不推薦的”。如果想知道關(guān)于 Annotations的更多詳細討論，請閱讀Java 5.0 Tiger: A Developer's Notebook。
因為 Annotations可以用來描述用例或者實體比如方法和類的意思，所以這是一種語法棒棒糖。反過來，這些附加信息也可以被其他東西（比如框架）用于各種各樣的動作，比如生成文檔（Javadoc），或者像這里討論的，作為一種特殊內(nèi)容來控制行為，比如對象的生命周期。
生命周期管理
生命周期管理通常發(fā)生在中間件環(huán)境中，比如應用服務器。這種思想是把對象的創(chuàng)建、使用以及銷毀跟對象本身分開。例如在一個發(fā)布不同服務的應用服務器中，它通常不關(guān)心所請求的特殊服務(譯注：此處的意思應該是應用服務器對所有請求都一視同仁)，調(diào)用服務的機制或多或少的采用了同一種方案。這取決于應用的狀態(tài)，呼叫者以及其他參數(shù)，一些必要的變量，但是在一個易于管理的環(huán)境中，基本的算法通常是一系列操作的順序鏈。在Java客戶端應用中，必須處理mask的顯示，或者form允許用戶輸入或修改數(shù)據(jù)。
示例問題
在Java應用中，mask通常用于數(shù)據(jù)收集以及在CRUD（create, read, update, delete）周期中處理數(shù)據(jù)。用戶可以修改、刪除或者新增加一些數(shù)據(jù)。跟一個簡單的商務問題一樣，我們需要管理在客戶端應用中如何顯示mask。這樣，我們把顯示從操作鏈中分離了出來，像下面這樣：
1.創(chuàng)建：mask在這一狀態(tài)中只安排一次。
2.初始化：在這一狀態(tài)，數(shù)據(jù)從文件和數(shù)據(jù)庫等地方找回，并填充到mask的字段中。
3.激活：這里，用戶放棄對mask的控制。
在現(xiàn)實中，涉及到很多方面：訪問、驗證、控制依賴等等。
Phases
在這篇討論中，我提到了每一步操作的phase，基本思想非常簡單：我們把類方法標注成操作鏈中的phases，然后把這些方法的調(diào)用交給服務（框架）來做。實際上，這種方法并不僅限于生命周期管理。它可以用做商務流程中所有調(diào)用的控制機制。
我們使用的 Annotations簡單的命名為Phase，我們使用它來把一個方法標注成操作鏈的一部分。在下面的代碼里，你可以看到 Annotations的聲明與接口很接近。
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD})
public @interface Phase {
int index();
String displayName() default "";}
我們簡單看一下代碼。在頭兩行，你看到 Annotations跟另外兩個 Annotations一起使用。剛看上去時，這有點混亂，但是這兩行很簡單的就指定了 AnnotationsPhase只允許并且應該保留到編譯后。之所以增加這兩個 Annotations，是因為有些 Annotations可能只會在編譯期間被使用，并且可能指向類或者成員。
@interface是一個 Annotations的標準描述。在接下來的代碼中，index和displayName??不只聲明了一個成員，還聲明了一個方法??也是Java的新語法。如果沒提供初始值的話, displayName將被賦予了一個空字符串作為初始值，同時這個displayName能夠被用來作為監(jiān)測用途,叫做progress bar. index()是必須的，它告訴框架這些phase可以被缺省的執(zhí)行。
像我早先說的那樣，我們應該把這個邏輯從對象中分離出來，所以我們定義了一個必須實現(xiàn)的接口以用于調(diào)用管理。這個接口可以被一個客戶端對象實現(xiàn)。為了達到管理的目的，我們定義了一個通用的標記接口，所有的“phaseable”接口必須從這里繼承，這樣框架就可以通過一個的訪問點來管理類。
public interface Phased {}
這個接口的具體實現(xiàn)會看起來像下面的代碼那樣。這里，接口定義了一個mask，或者一個form，它們包含幾個操作，這些操作必須像上面的描述那樣被定義。
public interface PhasedMask extends Phased {
@Phase(index=0)
public void construct();
@Phase(index=1)
public void initialize();
@Phase(index=2,displayName="Activating...")
public void activate();}
你可以看到如何使用 Annotations。它寫在方法聲明之前，并使用一個介紹性的@sign，它的屬性index需要提供圓括號。請注意，因為 Annotations并不是一個Java聲明，所以結(jié)尾不能出現(xiàn)分號。現(xiàn)在，我們需要一個類來來把這些東西聯(lián)結(jié)起來，并且試試我們剛才定義的phase。
Phaser
主要處理類也許應該被稱為Phaser。（喂，我們不都挺喜歡星際旅行嗎？）它執(zhí)行全部的phase，并且為用戶提供簡單的監(jiān)視機制。這個類的實現(xiàn)并不包含在這篇文章里，當然，你可以從資源找到框架代碼的下載。
一個Phaser擁有一個實現(xiàn)了一些具體的PhasedXxxx接口并且管理phase調(diào)用的對象。
假設(shè)我們有一個像這樣的MyMask類：
public class MyMask implements PhasedMask {
@Phase(index = 0)
public void construct() {
// Do the layout }
@Phase(index = 1)
public void initialize() {
// Fill the mask with data }
@Phase(index = 2)
public void activate() {
// Activate the listeners and allow the user to interact with the mask }
// Business code}
現(xiàn)在，我們可以像下面那樣調(diào)用這些PhasedMask方法：
Phaser phaser = new Phaser( phasedMask );phaser.invokeAll();
這樣，方法construct()、initialize()和activate()就都被調(diào)用了。
那么我們?nèi)绾慰刂苝hase呢？我們跳過構(gòu)造階段，因為當我們第二次調(diào)用phasedMask()時，并不需要再布置一次。本意是我們不需要construct()被調(diào)用多次。因為我們把這個方法用0索引標注，所以我們可以簡單的跳過這個索引，并且告訴Phaser應該執(zhí)行哪些phase。
Phaser phaser = new Phaser( phasedMask );phaser.invoke( new int[] {1,2} );
這樣就好了，不過不夠清晰。誰會記得phase的索引實際代表什么？幸運的是，我們可以像下面這樣寫得詳細一點：
Phaser phaser = new Phaser( phasedMask );
phaser.invoke( new String[] {"initialize","activate"} );
這里，我們使用從接口繼承來的方法名。當然，如果需要的話，我們可以重新安排phase。所以，為了交換順序，我們可以這樣寫：
Phaser phaser = new Phaser( phasedMask );
phaser.invoke( new String[] {"activate","initialize"} );
這個好象沒什么意義，但是，當某個設(shè)置中一些phase是緊耦合的時，這種做法是有用的。
因為我們在這里通過反射來調(diào)用方法，所以存在很多拋出異常的情況。Phaser會捕捉這些異常，并包裝成所謂的PhaserException。所以，如果一個方法調(diào)用失敗（比如是私有的），Phaser的invoke()方法會拋出一個包含著初異常的PhaseException。如果對反射知之不多，請看邊欄的“Notes on Reflection”。
你也許會給Phaser增加一個PhaseListener來觀察里面發(fā)生了什么，并在漫長的phase調(diào)用過程中反饋給用戶一些信息。
PhaseListener listener = new PhaseListener() {
public void before( PhaseEvent e ) {
// This is called before the Phaser invokes a phase }
public void after( PhaseEvent e ) {
// This is called after the Phaser has successfully invoked a phase }
}; Phaser phaser = new Phaser( phasedMask );phaser.addPhaseListener( listener );
phaser.invoke( new String[] {"initialize","activate"} );
討論和總結(jié)
在這篇文章中，你看到了如何利用 Annotations來管理被分成幾個phase的類的生存周期。為了使這些類能夠被框架組件所管理，它們必須簡單的實現(xiàn)一個接口，這個接口從Phased派生而來，并且用Phase Annotations標注了方法。管理通過Phaser類來完成，這個類能夠調(diào)用被標注方法，并能控制調(diào)用的順序，還提供了一種事件處理機制來觀察Phaser的工作。
這種方法也顯示了一種比Javadoc的 Annotations使用更進一步的用法。它們不只用于生命周期管理，也可以用于常規(guī)的對象初始化。
實現(xiàn)類不關(guān)心它們的方法被調(diào)用的順序。如果你在設(shè)計中保持這種思想，你就可以更靈活的使用這些類。
如果phase必須重新排列或者忽略，這些行為會發(fā)生在實現(xiàn)類中。
像任何工具一樣，它有一些缺點。如果接口必須改變，或者新接口必須保持向后兼容性以保證源代碼完全可用,那么實現(xiàn)類必須改變。這種方案缺少參數(shù)和返回值的支持。參數(shù)必須在phase調(diào)用前被完全提供。同樣，因為大量使用了反射，所以會成為一個高性能要求的系統(tǒng)中的瓶頸。
，調(diào)用鏈對IDE來說是不明晰的。