1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
|
<!DOCTYPE html>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<html lang="en">
<head>
<link rel="stylesheet" type="text/css" href="../stylesheets/style.css">
<title>JDepend Task</title>
</head>
<body>
<h2 id="jdepend">JDepend</h2>
<h3>Description</h3>
<p>Invokes the <a href="https://github.com/clarkware/jdepend" target="_top">JDepend</a>
parser.</p>
<p>This parser "traverses a set of Java source file directories and generates design quality
metrics for each Java package". It allows to "automatically measure the quality of a
design in terms of its extensibility, reusability, and maintainability to effectively manage and
control package dependencies."</p>
<p>Source file directories are defined by nested <code><sourcespath></code>. Class file
directories are defined by nested <code><classespath></code>. See <a href="#nested">nested
elements</a>.</p>
<p>Optionally, you can also set the <var>outputfile</var> name where the output is stored. By
default the task writes its report to the standard output.</p>
<p>The task requires at least the JDepend 1.2 version.</p>
<h3>Parameters</h3>
<table class="attr">
<tr>
<th scope="col">Attribute</th>
<th scope="col">Description</th>
<th scope="col">Required</th>
</tr>
<tr>
<td>outputfile</td>
<td>The output file name. If not set, the output is printed on the standard output.</td>
<td>No</td>
</tr>
<tr>
<td>format</td>
<td>The format to write the output in,
either <q>text</q> (default) or <q>xml</q></td>
<td>No; the default is <q>text</q></td>
</tr>
<tr>
<td>fork</td>
<td>Run the tests in a separate JVM.</td>
<td>No; default is <q>off</q></td>
</tr>
<tr>
<td>haltonerror</td>
<td>Stop the build process if an error occurs during the <code>jdepend</code> analysis.</td>
<td>No; default is <q>off</q></td>
</tr>
<tr>
<td>timeout</td>
<td>Cancel the operation if it doesn't finish in the given time (measured in milliseconds).</td>
<td>No, ignored if <var>fork</var> is <q>false</q></td>
</tr>
<tr>
<td>jvm</td>
<td>The command used to invoke JVM. The command is resolved
by <code>java.lang.Runtime.exec()</code>.</td>
<td>No; default <kbd>java</kbd>, ignored if <var>fork</var> is <q>false</q></td>
</tr>
<tr>
<td>dir</td>
<td>The directory to invoke JVM in.</td>
<td>No, ignored if <var>fork</var> is <q>false</q></td>
</tr>
<tr>
<td>includeruntime</td>
<td>Implicitly add the classes required to run <code>jdepend</code> in forked mode. <em>Since
Apache Ant 1.6</em>.</td>
<td>No; default is <q>no</q>, ignored if <var>fork</var> is <q>false</q></td>
</tr>
<tr>
<td>classpathref</td>
<td>the <var>classpath</var> to use, given as reference to a path defined elsewhere.</td>
<td>No</td>
</tr>
</table>
<h3 id="nested">Parameters specified as nested elements</h3>
<p><code>jdepend</code> supports four nested
elements: <code><classpath></code>, <code><classespath></code>
and <code><sourcespath></code>, that represent <a href="../using.html#path">path-like
structures</a>, and <code><exclude></code>.</p>
<p><code><sourcespath></code> is used to define the paths of the source code to analyze, but
it is deprecated. With version 2.5 of JDepend, only class files are analyzed. The nested
element <code><classespath></code> replaces <code><sourcespath></code> and is used to
define the paths of compiled class code to analyze; the <code><sourcespath></code> variable is
still available in case you are using an earlier version of JDepend.
The <code><exclude></code> element can be used to set packages to ignore (requires JDepend 2.5
or above).</p>
<h3>Examples</h3>
<p>Invoke JDepend on the <samp>build</samp> directory, writing the output on the standard
output. The classpath is defined using a reference.</p>
<pre>
<jdepend classpathref="base.path">
<classespath>
<pathelement location="build"/>
</classespath>
</jdepend></pre>
<p>This invoke JDepend in a separate JVM on the <samp>src</samp> and <samp>testsrc</samp>
directories, writing the output to the <samp>docs/jdepend.xml</samp> file in XML format. The
classpath is defined using nested elements.</p>
<pre>
<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></pre>
<p>Invoke JDepend with the build directory as the base for class files to analyze, and ignore all
classes in the <samp>java.*</samp> and <samp>javax.*</samp> packages.</p>
<pre>
<jdepend classpathref="base.path">
<exclude name="java.*>
<exclude name="javax.*>
<classespath>
<pathelement location="build"/>
</classespath>
</jdepend></pre>
</body>
</html>
|
