Plugin Documentation

This report describes goals, parameters details, requirements and sample usage of this plugin.

Goals

Goals available for this plugin:

Goal	Description
formatter:format	A Maven plugin mojo to format Java source code using the Eclipse code formatter. Mojo parameters allow customizing formatting by specifying the config XML file, line endings, compiler version, and source code locations. Reformatting source files is avoided using an sha512 hash of the content, comparing to the original hash to the hash after formatting and a cached hash.
formatter:help	Display help information on formatter-maven-plugin. Call `mvn formatter:help -Ddetail=true -Dgoal=<goal-name>` to display parameter details.
formatter:validate	This mojo is very similar to Formatter mojo, but it is focused on CI servers. If the code ain't formatted as expected this mojo will fail the build

System Requirements

The following specifies the minimum requirements to run this Maven plugin:

Maven	3.6.3
JDK	17

System Requirements History

The following specifies the minimum requirements to run this Maven plugin for historical versions:

Plugin Version	Maven	JDK
from 2.24.0 to 2.27.0	3.6.3	17
2.23.0	3.5.0	11
from 2.17.1 to 2.22.0	3.3.9	11
from 2.9.0 to 2.17.0	3.3.9	8
from 2.5.0 to 2.8.1	3.0.5	8
2.1.0.RC1	3.5.0	8
from 2.0.0 to 2.0.1	-	7

Usage

You should specify the version in your project's plugin configuration:

<project>
  ...
  <build>
    <!-- To define the plugin version in your parent POM -->
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>net.revelc.code.formatter</groupId>
          <artifactId>formatter-maven-plugin</artifactId>
          <version>2.27.0</version>
        </plugin>
        ...
      </plugins>
    </pluginManagement>
    <!-- To use the plugin goals in your POM or parent POM -->
    <plugins>
      <plugin>
        <groupId>net.revelc.code.formatter</groupId>
        <artifactId>formatter-maven-plugin</artifactId>
      </plugin>
      ...
    </plugins>
  </build>
  ...
</project>

For more information, see "Guide to Configuring Plug-ins"