JDepend

說明

呼叫 JDepend 分析器。

此分析器「會遍歷一組 Java 原始碼目錄，並為每個 Java 套件產生設計品質指標」。它允許「自動衡量設計品質，包括其可擴充性、可重複使用性，以及可維護性，以有效管理和控制套件相依性。」

原始碼目錄由巢狀的 <sourcespath> 定義。類別檔案目錄由巢狀的 <classespath> 定義。請參閱 巢狀元素。

您也可以選擇設定 outputfile 名稱，以儲存輸出。預設情況下，任務會將其報告寫入標準輸出。

此任務至少需要 JDepend 1.2 版。

參數

屬性 說明 必要
outputfile 輸出檔案名稱。如果未設定，輸出會印在標準輸出上。 否
format 輸出格式，可以是 text（預設）或 xml 否；預設為 text
fork 在個別的 JVM 中執行測試。 否；預設為 off
haltonerror 如果在 jdepend 分析期間發生錯誤，則停止建置程序。 否；預設為 off
timeout 如果操作未在指定時間內完成（以毫秒為單位），則取消操作。 否，如果 fork 為 false，則忽略
jvm 用於呼叫 JVM 的命令。此命令由 java.lang.Runtime.exec() 解析。 否；預設為 java，如果 fork 為 false，則忽略
dir 呼叫 JVM 的目錄。 否，如果 fork 為 false，則忽略
includeruntime 在分岔模式中隱含加入執行 jdepend 所需的類別。自 Apache Ant 1.6 起。 否；預設為 no，如果 fork 為 false，則忽略
classpathref 要使用的 classpath，指定為對其他地方定義的路徑的參考。 否

指定為巢狀元素的參數

jdepend 支援四個巢狀元素：<classpath>、<classespath> 和 <sourcespath>，它們代表 類別路徑結構，以及 <exclude>。

<sourcespath> 用於定義要分析的原始碼路徑，但已不建議使用。在 JDepend 2.5 版中，只會分析類別檔案。巢狀元素 <classespath> 取代了 <sourcespath>，用於定義要分析的已編譯類別程式碼路徑；如果您使用的是較早版本的 JDepend，則仍可以使用 <sourcespath> 變數。<exclude> 元素可用於設定要忽略的套件（需要 JDepend 2.5 或更新版本）。

範例

在 build 目錄上呼叫 JDepend，將輸出寫入標準輸出。使用參考定義類別路徑。

<jdepend classpathref="base.path">
    <classespath>
        <pathelement location="build"/>
    </classespath>
</jdepend>

在 src 和 testsrc 目錄上，在個別的 JVM 中呼叫 JDepend，將輸出以 XML 格式寫入 docs/jdepend.xml 檔案。使用巢狀元素定義類別路徑。

<jdepend outputfile="docs/jdepend.xml" fork="yes" format="xml">
    <sourcespath>
        <pathelement location="src"/>
    </sourcespath>
    <classpath>
        <pathelement location="classes"/>
        <pathelement location="lib/jdepend.jar"/>
    </classpath>
</jdepend>

呼叫 JDepend，以建置目錄作為要分析的類別檔案基礎，並忽略 java.* 和 javax.* 套件中的所有類別。

<jdepend classpathref="base.path">
    <exclude name="java.*>
    <exclude name="javax.*>
    <classespath>
        <pathelement location="build"/>
    </classespath>
</jdepend>