The org.gmetrics.report.SingleSeriesHtmlReportWriter class produces an HTML report of metric results based on a single metric, single level and single function to provide a single series of data.
The metric, level and function properties are required (must be non-null and non-empty). These three properties uniquely identify a single series of metric values.
See a Sample Report.
The option element is a child of the report element and defines a report-specific option for a report.
org.gmetrics.report.SingleSeriesHtmlReportWriter supports the following options:
| Attribute | Description | Required |
| metric | The name (case-sensitive) of a single Metric included in the analysis results (e.g. "CyclomaticComplexity"). |
Yes |
| level | The single level at which results are included in the report. Valid level values are "package", "class" and "method". |
Yes |
| function | The function for which results are included in the report. Valid function values are metric-specific, but are typically "total", "average", "minimum" or "maximum". |
Yes |
| outputFile | The path and filename for the output report file. | No |
| title | The title for the output report. | No |
| writeToStandardOut | Set to "true" or true to write out the report to stdout (System.out) instead of writing to a file. |
No |
| sort | Controls whether the report results are sorted numerically. A value of null or empty means no sorting is performed; otherwise, the value must be either "ascending" or "descending". |
No |
| maxResults | Specifies the limit on the number of results included in the report. A value of null, zero or empty means no limit is applied; otherwise the value must be a positive integer. |
No |
| greaterThan | Specifies a lower-bound threshold -- only results with a larger value are included within the report. A value of null or empty means no lower-bound threshold is applied. |
No |
| lessThan | Specifies an upper-bound threshold -- only results with a smaller value are included within the report. A value of null or empty means no upper-bound threshold is applied. |
No |
Here is an example Ant XML build file illustrating configuration of org.gmetrics.report.SingleSeriesHtmlReportWriter.
<taskdef name="gmetrics" classname="org.gmetrics.ant.GMetricsTask">
<target name="runGMetrics">
<gmetrics>
<report type="org.gmetrics.report.SingleSeriesHtmlReportWriter">
<option name="outputFile" value="SampleGMetricsReport.html" />
<option name="title" value="Sample" />
<option name="metric" value="CyclomaticComplexity" />
<option name="level" value="class" />
<option name="function" value="average" />
<option name="maxResults" value="50" />
<option name="greaterThan" value="100.0" />
</report>
<fileset dir="src">
<include name="**/*.groovy"/>
</fileset>
</gmetrics>
</target>