HSC Maven Plugin

Maven Plugin Portal Version Maven Central Version

The Maven plugin of HTML Sanity Check (HSC) enables to check generated or native HTML documentation from the Maven build.

Installation (Maven Plugin)

Default Installation

Use the following snippet inside a Maven build file:

build.maven
<plugin>
    <groupId>org.aim42.htmlSanityCheck</groupId>
    <artifactId>htmlSanityCheck-maven-plugin</artifactId>
    <version>2.0.0-rc3</version> (1)
    <executions>
        <execution>
            <phase>compile</phase>
            <goals>
                <goal>sanity-check</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <sourceDocuments>
            <file>src/file-to-test.html</file> (2)
        </sourceDocuments>
        <sourceDir>src</sourceDir> (3)
    </configuration>
</plugin>
1 Checkout current version
2 List the files you want tio check here.
3 Directory where the HTML files are located.
Latest (development) versions

Usage

This task exposes a few properties as part of its configuration:

sourceDir (mandatory)

Directory where the HTML files are located.

Type: Directory.
sourceDocuments (optional)

An override to process several source files, which may be a subset of all files available in {sourceDir}.

Type: org.maven.api.file.FileCollection.

Default: All files in {sourceDir} whose names end with .html.
checkingResultsDir (optional)

Directory where the checking results written to.

Type: Directory.

Default: +{buildDir}+/reports/htmlSanityCheck/
junitResultsDir (optional)

Directory where the results are written to in JUnit XML format. JUnit XML can be read by many tools, including CI environments.

Type: Directory.

Default: +{buildDir}+/test-results/htmlchecks/
failOnErrors (optional)

Fail the build if any error was found in the checked pages.

Type: Boolean.

Default: false.
httpConnectionTimeout (optional)

Timeout for http requests in ms.

Type: Integer.

Default: 5000.
ignoreLocalHost (optional)

Ignore localhost as hostname.

Type: Boolean.

Default: false.
ignoreIPAddresses (optional)

Ignore IP addresses as hostname.

Type: Boolean.

Default: false.
checkerClasses (optional)

The set of checker classes to be executed.

Type: List.

Default: All available checker classes.

Checker Classes
// Keep the list ordering to ensure
// report ordering comparability
// with HSC 1.x versions
MissingAltInImageTagsChecker.class,
MissingImageFilesChecker.class,
DuplicateIdChecker.class,
BrokenHttpLinksChecker.class,
ImageMapChecker.class,
BrokenCrossReferencesChecker.class,
MissingLocalResourcesChecker.class
httpWarningCodes (optional)

Additional HTTP response codes treated as warning.

Type: List.

Default:

100, 101, 102
// Redirects included
301, 302, 303, 307, 308
HTTP Redirects

Note that HTTP redirects are treated as a warning to make the user aware of the correct or new location (cf. Issue 244). Some HSC reports often contain the respective location.
httpErrorCodes (optional)

Additional HTTP response codes treated as error.

Type: List.

Default:

400, 401, 402, 403, 404,
405, 406, 407, 408, 409,
410, 411, 412, 413, 414,
415, 416, 417, 418, 421,
422, 423, 424, 425, 426,
428, 429, 431, 451,
500, 501, 502, 503, 504,
505, 506, 507, 508, 510,
511
httpSuccessCodes (optional)

Additional HTTP response codes treated as success.

Type: List.

Default:

200, 201, 202, 203, 204,
205, 206, 207, 208, 226
HTTP response code handling

The lists shown above are the default HTTP response codes handled by HSC. The mentioned configurations effectively move the configured codes around, i.e., if you add 308 to httpErrorCodes it is automatically removed from its default list (httpWarningCodes).

Examples

Small Example

build.maven

tbd

Extended example

build.maven
tbd

Compatibility

The Plugin is only tested with Maven 3.9.x, but should also work with previous versions later than Maven 3.6.x.