2009年5月14日 星期四

V11 自動補齊註解(6)──依階層收集Method註解

Method是底層的行為單位,再往上的組織階層有Class、Package。既然Package擁有多個Class,而Class又擁有多個Method,那麼在集合的層級上匯總集合元素的資訊也是應該具備的功能。

回顧前面的章節所做的事,在彙總註解內容時首先要作到的是格式檢查與基本資訊的產生,第二是宣告時繼承與實作對象的註解(Class),第三是全部的使用關聯與判斷條件(註明在哪裡用到),最後則是修改的目的與記錄。處理的流程就定義迴圈,然後依序收集全部應該要收集的註解。

收集所有的Method註解後的內容很多,Class的註解可能會變為上百行之多而難以閱讀,Package層級則會面臨到沒有可放置單一註解的地方。因此建議Class的基本資訊、宣告內容與修改歷程放在Class的註解裡,使用關聯與判斷條件則另外產生外部檔存放(這部分也可在需要用到時再產生);Package則收集修改歷程、使用關聯與判斷條件另外存到外部檔案。

Package的資訊只需要收集屬於自己內部的資訊,不需要遞迴向上彙總。每個Package都整理好本身的資訊後,在Component、Module等級的Package就可以遞迴向下收集使用關聯,知道到底使用哪些Package後就清楚重用這個Package時還需要連帶哪些Package。修改記錄的收集用途亦是讓我們可以立即知道該Package下全部的變動。

收集全部Package使用關聯的過程中,還能夠建立使用Package間的垂直與水平追溯表。

沒有留言:

張貼留言