Sign In Start Free Trial

Apache Maven Cookbook

By : Raghuram Bharathan

4.2 (5)

Apache Maven Cookbook

4.2 (5)

By: Raghuram Bharathan

Overview of this book

If you are a Java developer or a manager who has experience with Apache Maven and want to extend your knowledge, then this is the ideal book for you. Apache Maven Cookbook is for those who want to learn how Apache Maven can be used for build automation. It is also meant for those familiar with Apache Maven, but want to understand the finer nuances of Maven and solve specific problems.

Preface

Preface

What this book covers

What you need for this book

Who this book is for

Sections

Conventions

Reader feedback

Customer support

Free Chapter

1. Getting Started

1. Getting Started

Introduction

Installing Maven on Microsoft Windows

Installing Maven on Mac OS X

Installing Maven on Linux

Changing the JDK used by Maven

Creating a simple project with Maven

Building a simple project with Maven

Changing the location of the Maven repository

Running Maven behind an HTTP proxy server

Understanding the standard directory layout

2. IDE Integration with Maven

2. IDE Integration with Maven

Introduction

Creating a new Maven project in Eclipse

Importing an existing Maven project in Eclipse

Creating a new Maven project in NetBeans

Importing an existing Maven project in NetBeans

Creating a new Maven project in IntelliJ IDEA

Importing an existing Maven project in IntelliJ IDEA

3. Maven Lifecycle

3. Maven Lifecycle

Introduction

Understanding the Maven lifecycle, phases, and goals

Understanding the pom file

Understanding Maven settings

Understanding command-line options in Maven

Understanding Maven profiles

Adding a new Maven profile

Activating/deactivating a Maven profile

Using properties in Maven

Specifying source encoding for platform-independent builds

4. Essential Maven Plugins

4. Essential Maven Plugins

Introduction

Using the Maven Clean plugin

Using the Maven Compiler plugin

Changing the compiler used by the Maven Compiler plugin

Specifying the Java version for the Compiler plugin

Using the Maven Surefire plugin to run unit tests

Using the Maven Failsafe plugin to run integration tests

Using the Maven Resources plugin

Filtering using resources

Using Eclipse to run Maven goals

Using NetBeans to run Maven goals

Using IntelliJ IDEA to run Maven goals

5. Dependency Management

5. Dependency Management

Introduction

Choosing the scope of dependency

Getting a report of dependencies

Getting into dependency and avoiding dependency hell

Downloading dependencies into a folder

Understanding SNAPSHOT dependencies

Handling dependency download errors

Detecting unused/undeclared dependencies

Manually installing dependencies that are not available in a repository

Dependency management using Eclipse

Dependency management using NetBeans

Dependency management using IntelliJ IDEA

6. Code Quality Plugins

6. Code Quality Plugins

Introduction

Analyzing code coverage with the Maven JaCoCo plugin

Analyzing code coverage with the Maven Cobertura plugin

Analyzing code with the Maven PMD plugin

Analyzing code with the Maven Checkstyle plugin

Analyzing code with the Maven FindBugs plugin

Generating source references with the Maven JXR plugin

Analyzing code with the Maven SonarQube plugin

7. Reporting and Documentation

7. Reporting and Documentation

Introduction

Documenting with the Maven Site plugin

Generating Javadocs for a site

Generating source cross-reference for a site

Generating unit test reports for a site

Generating code coverage reports for a site

Generating code quality reports for a site

Generating selective reports

Deploying a site

8. Handling Typical Build Requirements

8. Handling Typical Build Requirements

Introduction

Including and excluding additional resources

Including and excluding source files and folders

Configuring Maven to search for plugins

Working in offline mode

Controlling the verbosity of the Maven output

Using the Maven Help plugin

Using the Maven SCM plugin

Generating changelogs for a site

9. Multi-module Projects

9. Multi-module Projects

Introduction

Understanding project inheritance

Understanding project aggregation

Combining inheritance and aggregation

Performing multi-module dependency management

Performing multi-module plugin management

Selectively building modules

Reporting for multi-module projects

10. Java Development with Maven

10. Java Development with Maven

Introduction

Building a JAR project

Generating an executable JAR

Generating a JAR of the source code

Generating a JAR of the test classes

Building a WAR project

Building an EAR project

Building a pom project

Running a web project with Jetty

Running a web project with Tomcat

11. Advanced Maven Usage

11. Advanced Maven Usage

Introduction

Creating an assembly

Running a custom executable

Running an ANT task

Determining updates to Maven plugin AntRun

Determining updates to Maven dependencies

Controlling the constraints

Generating unique builds

Releasing a Maven project

Index

Index

Customer Reviews

4.2 (5)

5 star

60%

4 star

0

3 star

40%

2 star

0

1 star

0

Building a simple project with Maven

Let us now build the project that was created in the preceding section.

How to do it...

To build the previously created simple project with Maven, perform the following steps:

Open the command prompt and run the following command, changing the directory to the folder the project was created:
```
mvn package
```

Observe the following things in the output:

Notice the following warning (we will see how to resolve this later in this book):

[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ simple-project ---
[WARNING] Using platform encoding (Cp1252 actually) to copy filtered resources,
i.e. build is platform dependent!

Check if the sources are compiled:

[INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ simple-project

Check if the tests are run:

[INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ simple-project ---
[INFO] Surefire report directory: C:\projects\apache-maven-cookbook\simple-project\target\surefire-reports
-------------------------------------------------------
 T E S T S
-------------------------------------------------------
Running com.packt.cookbook.AppTest
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.005 sec

A JAR file is now created.

How it works...

In the mvn package command, the package parameter is a phase in the build lifecycle. Maven has a default build lifecycle that has a number of phases. Each phase will execute every phase prior to it in order along with the specified phase. In this case, the package phase executes in the following order:

Validate
Compile
Test
Package

The validate phase makes sure that the project (specifically the pom.xml file that describes the project) is in order and all the necessary information to run the project is available.

The compile phase compiles the sources.

The test phase compiles the test sources and then runs the test using a suitable test framework. In the earlier example, the JUnit framework is used to run the tests.

The package phase packages the artifacts to the format specified in the pom.xml file.

Search

Your notes and bookmarks