練習 1.2︰執行結構分析程式碼複查
本練習假設您已完成練習 1.1︰匯入必要的資源。在練習 1.2 中,首先您要閱讀一個使用者實務。然後,假設您扮演使用者實務中所描述的軟體架構設計師角色,並使用您在練習 1.1 中所匯入的專案來完成練習。
使用者實務
為了複查新撰寫的程式碼以評估其品質,架構設計師想要尋找一般的違反型樣。違反型樣是發生在程式碼中的已知問題而且未遵循最佳作法。設計型樣是要遵循的良好模型,違反型樣則是應該避免的不良模型。一些特定的違反型樣包括下列類型:
- 會中斷的︰程式碼中的物件有許多相依關係,當其他物件變更時,很可能會使這些相依關係中斷。
- 循環相依關係︰一群物件交互連接(通常是循環式)的程度會使得變更任何一個物件就會影響所有的物件。亦稱為 tangle。
- 集中︰物件同時具有許多相依關係和許多相依項。當其他物件變更時就會受影響。相同地,當自己變更時,也會影響其他物件。
在第一個練習中,架構設計師執行程式碼複查來尋找上述的違反型樣。
練習
在這個練習中,您會執行下列作業︰
- 選取要執行的程式碼複查。
- 檢視程式碼複查中所套用的規則。
- 選擇哪些程式碼要執行複查。
- 執行程式碼複查。
- 檢視程式碼複查的發現項目。
- 選取某個發現項目來查看關於該項目的下列資訊︰
選取程式碼複查
如果要選取結構分析程式碼複查︰
- 在「程式碼複查」視圖中的工具列上按一下管理規則圖示
。

- 在選取程式碼複查清單中,按一下結構分析程式碼複查。
- 展開結構分析資料夾和子資料夾來查看程式碼複查中所套用的規則,如下所示。按一下確定。

選取要複查的程式碼庫
如果要選取工作區做為要複查的程式碼庫︰
- 在「程式碼複查」視圖中的工具列上按一下複查圖示(
) > 複查工作區)。
執行程式碼複查
一旦您選取要複查的程式碼庫,就會執行程式碼複查。您可以檢查視圖右下角的進度列來追蹤其狀態。
檢視程式碼複查發現項目
當程式碼複查完成時,「程式碼複查」視圖中會顯示發現項目,如下列畫面所示︰

「程式碼複查」視圖中提供下列資訊。
- 程式碼複查統計資料︰發現項目上方的字行顯示最近程式碼複查的相關資訊︰名稱、範圍、內含的規則和檔案數,以及發現項目的數目和嚴重性。
- 程式碼複查發現項目︰程式碼複查中的發現項目列在「程式碼複查」視圖中的資料夾內。每一個資料夾名稱會告訴您程式碼複查名稱和種類,以及發現項目的數目。
取得程式碼複查發現項目的詳細資訊
如果要取得程式碼複查中發現項目的詳細資訊︰
- 展開結構分析︰循環相依關係資料夾。其中包含四個發現項目,如下列畫面所示︰

每一個發現項目的前面會有指出其嚴重性層次的圖示。

如果圖示旁邊出現燈泡 (
),表示發現項目存在快速修正。快速修正是針對特定的發現項目的自動化補充解決方案。下列圖例顯示快速修正圖示︰

- 按兩下以 Event.java 為開頭的發現項目。相關的詳細資料會顯示在兩個地方,如下列的概要和畫面所示︰
- 程式碼︰顯示發現項目出現位置的程式碼並強調顯示正確的位置。
- 程式碼複查「詳細資料」視圖︰詳細說明發現項目並提供範例和解決方案來更正項目。如果發現項目是循環相依關係,還會有迴圈詳細資料的部分。

您已完成練習 1.2︰執行結構分析程式碼複查。
運用程式碼複查的能力
藉由積極地執行程式碼複查,您可以早期發現問題,讓您可以早期更正問題,以避免導致下列問題︰
- 影響應用程式的效能、維護性或可調整性。
- 浪費公司的金錢、時間和資源。
在練習 1.4 中,您會修正程式碼複查發現項目來建置在練習 1.2 中做的工作。
練習 1.2 整理
您已完成練習 1.2︰執行結構分析程式碼複查。其中您執行了下列作業︰
- 選取要執行的程式碼複查。
- 檢視程式碼複查中所套用的規則。
- 選擇要執行複查的程式碼主體。
- 執行程式碼複查。
- 檢視程式碼複查的發現項目。
- 選取某個發現項目來查看關於該項目的下列資訊︰
現在您已準備好開始進行練習 1.3︰定義架構控制規則。