arhimondr / airbase

Base POM for Airlift

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool


Maven Central Build Status


Add Airbase as the parent to a project:

  <version> ... current pom release version ...</version>

Project pom structure

The following elements should be present in a pom using Airbase as parent:

  • groupId, artifactId, version, packaging, name, description and inceptionYear

    Define the new project. These elements should always be present. If any of those fields are missing from the project, the values from Airbase are picked up instead.

  • scm

    Defines the SCM location and URL for the project. This is required to use the release:prepare and release:perform targets to deploy artifacts to Maven Central.

  • organization, developers, distributionManagement

    Empty elements override the values inherited from Airbase.

This is a sample skeleton pom using Airbase:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns=""


    <version> ... current version ...</version>

  <groupId> ... group id of the new project ... </groupId>
  <artifactId> ... artifact id of the new project ... </artifactId>
  <version> ... version of the new project ... </version>
  <packaging> ... jar|pom ... </packaging>
  <description> ... description of the new project ...  </description>

    <connection> ... scm read only connection ... </connection>
    <developerConnection>... scm read write connection ... </developerConnection>
    <url> ... project url ... </url>


Project POM conventions

In large maven projects, especially with multi-module builds, the pom files can become quite large. In many places, properties defined in the <properties> section of the pom are used.

To avoid confusion with properties, the following conventions are used in Airbase:

  • Properties defined in the POM that influence the build configuration are prefixed with air.
  • Properties that factor out plugin versions (because the plugin is used in multiple places in the POM and the versions should be uniform) start with dep.plugin and end with version.
  • Properties that factor out dependency versions (to enforce uniform dependency versions across multiple, related dependencies) start with dep and end with version.


  <!-- Sets the minimum maven version to build (influences build) -->

  <!-- The surefire plugin version -->

  <!-- The version for all guice related dependencies -->

Deploy to Maven Central (

Airbase is intended for open source projects that should be deployed to Maven Central.

As described in the OSSRH Guide, the ossrh repository must be configured:


Project Build and Checkers

Airbase hooks various checkers into the build lifecycle and executes them on each build.

Generally speaking, running a set of checks at each build is a good way to catch problems early and any problem reported by a checker should be treated as something that needs to be fixed before releasing.

Checkers are organized in two groups, basic and extended.

Basic checkers

Extended checkers

All checkers are enabled by default and will fail the build if a problem is encountered.

Each checker has a switch to turn it on or off and also whether a problem will be a warning or fatal to the build.

  <!-- Do not run the duplicate finder --->

The following switches exist:

Group Check Skip check (Setting to true skips the check) Fail build (Setting to false only reports a warning)
Basic Maven Enforcer air.check.skip-enforcer
Basic Maven Dependencies air.check.skip-dependency
Basic Maven Dependency version check air.check.skip-dependency-version-check
Basic Maven Duplicate finder air.check.skip-duplicate-finder
Basic Maven Dependency scope air.check.skip-dependency-scope
Extended SpotBugs air.check.skip-spotbugs
Extended PMD air.check.skip-pmd
Extended License check air.check.skip-license
Extended Code coverage air.check.skip-jacoco
Extended Modernizer air.check.skip-modernizer
Extended Checkstyle air.check.skip-checkstyle

Checks can be turned on and off in groups:

Group Skip checks Fail build
All Checks air.check.skip-all
All Basic checks air.check.skip-basic
All Extended Checks air.check.skip-extended

A more specific setting (checker specific, then group, then all) overrides a more general setting:


will skip all checks except the duplicate finder.

Checker notes

License checker

To ensure that a project has an uniform license header in all source files, the Maven license plugin can be used to check and format license headers.

The plugin expects the license header file as src/license/LICENSE-HEADER.txt in the root folder of a project.

For a multi-module project, this file should exist only once, in the root pom of the project. In all other sub-modules, add


to each pom. This is a limitation of the Maven multi-module build process (see for details).

Enforcer checker

The Enforcer plugin outlaws a number of dependencies that project might use for various reasons:

Outlawed dependency Rationale What to use
commons-logging:commons-logging-api Ill-fated attempt to split commons-logging implementation and commons-logging API. commons-logging:commons-logging
cglib:cglib Has all its dependencies packed inside, therefore leads to duplicate classes. cglib:cglib-nodep
junit:junit Has all its dependencies packed inside, therefore leads to duplicate classes. junit:junit-dep Superseded by Guava, duplicate classes with Guava. Contains FindBugs annotations, JSR-305 and JCIP annotations. com.github.spotbugs:spotbugs-annotations

org.eclipse.jetty.orbit:javax.servlet Jetty variant of the 3.x servlet API jar. javax.servlet:javax.servlet-api

Well known dependencies

Airbase provides a number of dependencies to projects. These dependencies are considered "well known and stable". When a project wants to use any of these dependencies, it can declare them in the project <dependencies> section without a version and automatically pick it up from Airbase.

Airbase provides versions for the following well-known dependencies:

Dependency nameGroup/Artifact Ids
Google Guice

Google Guava
Joda Time joda-time:joda-time
Java Inject API javax.inject:javax.inject
Java Servlet API javax.servlet:javax.servlet-api
Java Validation API javax.validation:validation-api
slf4j (Simple Logging Facade for Java) org.slf4j:slf4j-api








Logback ch.qos.logback:logback-core


Jackson com.fasterxml.jackson.core:jackson-annotations






Bean Validation Framework org.apache.bval:bval-jsr
JmxUtils org.weakref:jmxutils
Joda Time joda-time:joda-time
CGLib cglib:cglib-nodep
FindBugs / SpotBugs Annotations com.github.spotbugs:spotbugs-annotations
JSR-305 Annotations
TestNG testing org.testng:testng
AssertJ org.assertj:assertj-core




Mockito org.mockito:mockito-core
Hamcrest matchers org.hamcrest:hamcrest-core



Airlift Slice io.airlift:slice

Other properties

These are default properties that affect some aspects of the build. All of them can be overriden in the <properties> section of the project pom.

By default, Airbase enforces JDK 1.8. To use another version, add


Sets the default heap size for the compiler, javadoc generation and other plugins. Default is 1024M.


When a project creates a release using the maven-release-plugin and mvn release:prepare, this switch controls whether the generated tags, modified POM files etc. are pushed automatically to the upstream repository or not. Default is false (do not push the changes).


The minimum version of Maven to build a project. Default is "3.0".


The 'root' directory of a project. For a simple project, this is identical to project.basedir. In a multi-module build, it should point at the root project.

For a multi-module project, all other sub-modules must have this explicitly set to the root directory and therefore the following code


must be added to each pom. This is a limitation of the Maven multi-module build process (see for details).

Deploy profiles

airlift packaging build

A module or sub-module can produce a tarball using the airlift packaging. This profile is activated by creating a file .build-airlift in the root of the module or submodule. This file can be empty. The tarball is attached as an additional artifact.

The necessary launchers from the airlift launcher package are included. The version of the launcher included is controlled by the dep.packaging.version property.


Base POM for Airlift

License:Apache License 2.0