Explains the steps involved in getting the Maven 2.x Plug-in up and running.

..
  repository
    [...]
    triemax
      jalopy
        1.9.1-108
          jalopy-1.9.1-108.jar
          jalopy-1.9.1-108.pom
      jalopy-maven
        1.9.1-108
          jalopy-maven-1.9.1-108.jar
          jalopy-maven-1.9.1-108.pom
          maven-metadata-local.xml
        maven-metadata-central.xml
    [...]

Although Jalopy ships with sensible default settings (mimicking the Sun Java coding convention), you most likely want to configure the formatter to match your needs (adding copyright headers, tune Javadoc handling and the like). For such, Jalopy comes with a graphical configuration tool that lets you interactively customize the settings. See Chapter 2, Configuration for an in-depth discussion of the available options.

To display the configuration tool, you should install the Console Plug-in and use the matching wrapper script for your platform. The wrapper scripts are called jalopy.xxx and can be found in the /bin folder of the Console installation directory.

Invoke the script with the --configure option.

% jalopy --configure

If you don't want to install the Console Plug-in, you can make use of the -jar option of the Java launcher, as Jalopy comes as an executable JAR file:

% java -jar <path_to>/jalopy-1.9.1.jar --configure

Or you give the class path directly to the launcher

% java -cp <path_to>/jalopy-1.9.1.jar Jalopy --configure

Of course, you can externally configure the class path yourself by adding all .jar files as usual and then type

% java Jalopy --configure

In order to integrate Jalopy into your build process, you need to edit your pom.xml under the plugins section:

<project>
  [...]
  <plugins>
    <plugin>
      <groupId>triemax</groupId>
      <artifactId>jalopy-maven</artifactId>
      <configuration>
        [...]
      </configuration>
      <executions>
        <execution>
          <phase>process-classes</phase>
          <goals>
            <goal>format</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
    [...]
  </plugins>
</project>

This would execute Jalopy during the process-classes phase. Please note that you should always apply formatting after the compile phase has finished in order to ensure that the project is clean, but you're otherwise free to choose the phase that best suits your needs. For more information about the Maven build lifecycle, please refer to the "Maven Build Lifecycle Guide". It contains a reference of the available build phases.

If you don't want to have the format goal execute during the build, you simply don't bind the goal to a specific phase:

<project>
  [...]
  <plugins>
    <plugin>
      <groupId>triemax</groupId>
      <artifactId>jalopy-maven</artifactId>
      <configuration>
        [...]
      </configuration>
    </plugin>
    [...]
  </plugins>
</project>

Formatting can be manually triggered from the command-line using either

% mvn triemax:jalopy-maven:format

or the shorthand

% mvn jalopy:format

Configuration

Naturally the Plug-in provides a few parameters to configure its behavior.

To configure the Plug-in, you specify elements named after the available parameters where the contents of an element is the value to be assigned to the parameter.

<plugin>
  <groupId>triemax</groupId>
  <artifactId>jalopy-maven</artifactId>
  <configuration>
    <threads>4</threads>
    <profile>test</profile>
  </configuration>
  [...]
</plugin>

For parameters of type List you would use multiple element tags to add the different values to the list.

<plugin>
  <groupId>triemax</groupId>
  <artifactId>jalopy-maven</artifactId>
  <configuration>
    <includes>
      <include>com/foo/siri/**</include>
      <include>com/foo/lana/**</include>
    </includes>
    <excludes>
      <exclude>**/*.sqlj</exclude>
      <exclude>**/*Test/**</exclude>
    </excludes>
    [...]
  </configuration>
</plugin>

Configuring Maps works similar: elements are named after the keys and the element contents is the value to be assigned to the key.

<plugin>
  <groupId>triemax</groupId>
  <artifactId>jalopy-maven</artifactId>
  <configuration>
    <environment>
      <lead>John Doo</lead>
      <office>Alta Nova</office>
    </environment>
    [...]
  </configuration>
</plugin>

For a complete example, please refer to Section 12.4, “Example” below.

Below you find a complete POM that performs formatting after each compile run finished successfully, disables logging of Javadoc related messages, only displays messages with warning severity or higher, activates the profile "test" during formatting and imports a code convention from a shared server. Formatting is applied to all Java source files of the project that are not located below the "testdata" folder.

<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>testing</groupId>
  <artifactId>test</artifactId>
  <packaging>jar</packaging>
  <version>1.0-SNAPSHOT</version>
  <name>Maven Quick Start Archetype</name>
  <url>http://maven.apache.org</url>
  <build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <configuration>
        <source>1.5</source>
        <target>1.5</target>
      </configuration>
    </plugin>
    <plugin>
      <groupId>triemax</groupId>
      <artifactId>jalopy-maven</artifactId>
      <configuration>
        <javadoc>false</javadoc>
        <logLevel>warn</logLevel>
        <convention>http://tools/jalopy/config/foo.xml</convention>
        <sources>
          <source>/work/foo/main/src/java</source>
          <source>/work/foo/test/src/java</source>
        </sources>
        <includes>
          <include>**/*.java</include>
        </includes>
        <excludes>
          <exclude>**/testdata/**</exclude>
        </excludes>
        <environment>
          <lead>John Doo</lead>
          <office>Alta Nova</office>
        </environment>
      </configuration>
      <executions>
        <execution>
          <phase>process-classes</phase>
          <goals>
            <goal>format</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
  </build>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
</project>