當您選擇要執行程式碼複查的程式碼庫時,程式碼必須符合一些必備條件;最重要的是當您執行複查時,程式碼庫中的所有檔案必須是可編譯的。
執行程式碼複查時請注意下列的必備條件,如不符合將會發生問題:
- 程式碼必須是可編譯的。對不可編譯的程式碼執行程式碼複查可能會導致局部不一致,甚至是錯誤的結果。
- 不能有編碼問題。如果因為其中的編碼問題而無法讀取專案,而專案因此不能在無法編譯的區段執行,則無法進行程式碼複查。
- 編碼設定必須是正確的。錯誤的編碼設定可能會產生類似在不可編譯程式碼執行程式碼複查的結果。
下列必備條件僅適用於「J2EE 最佳作法」程式碼複查:
- J2EE 動態 Web 專案必須是已編譯過。這可允許啟動「J2EE 最佳作法」程式碼複查中的所有規則。
- 如果您從 WebSphere® Studio Application Developer (WSAD) 工作區移轉程式碼,必須手動設定伺服器。用滑鼠右鍵按一下專案,然後按一下內容 > 伺服器。
注意
當您符合必備條件且準備好可以開始執行程式碼複查之後,在某些情況下會有一些事項需要注意。
執行結構分析程式碼複查:當您執行「結構分析」程式碼複查時,必須在工作區執行複查。這可確保複查到每個專案中的程式碼,使結構分析完整。
避免具有相同 Java 路徑的多重檔案:當您在工作區執行程式碼複查時,複查並不涵蓋具有相同 Java 路徑的多重檔案,即使這些檔案分別在不同的專案中。這項行為適用於需要大量系統處理程序的程式碼複查或規則:
- 結構分析程式碼複查
- J2EE 最佳作法程式碼複查
- 完整程式碼複查
- 您建立的架構控制規則
因此最好避免具有相同 Java 路徑的多重檔案。
範例:假設工作區含有 RED_Examples 專案和 BLUE_Examples 專案。兩個專案都含有 Color 套件,內含 bright.java 檔案。當您在工作區執行程式碼複查時,複查僅涵蓋一個 bright.java 檔。您可以讓兩個檔案的路徑不具有相同的路徑,以複查其中的程式碼,例如將名稱更改為 brightr.java 和 brightb.java。
如果工作區具有相同 Java 路徑的多重檔案,利用下列方法來設定工作區即可執行涵蓋多重檔案的程式碼複查:
- 分割工作區,使同一工作區中不會有相同路徑的兩個檔案。
- 一次只載入一個工作區。
- 在每一個工作區執行個別程式碼複查。