Browse Library
Sign In Start Free Trial
Close icon Search icon
Account
Browse Library Advanced Search Sign In Start Free Trial

Add to playlist

Create a Playlist

Modal Close icon
You need to login to use this feature.
  • Apache Maven Cookbook
  • Toc
  • feedback
Apache Maven Cookbook

Apache Maven Cookbook

By : Raghuram Bharathan
4.2 (5)
close
Apache Maven Cookbook

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.
Table of Contents (13 chapters)
close
close
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
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
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
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
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
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
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
7. Reporting and Documentation
chevron up
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
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
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
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
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
12
Index
Index

Generating Javadocs for a site

Documentation for Java projects is created using Javadocs. Maven provides support not only to generate Javadocs, but also to publish them as part of the site. Plugins configured within the reporting element will generate content for the site. When they are configured within the build element, they can generate reports independent of site.

How to do it...

Use the following steps to generate Javadocs for a site:

  1. Open the Maven project project-with-documentation.

  2. Add the following section in the pom.xml file:

    <reporting>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-javadoc-plugin</artifactId>
      <version>2.10.1</version>
    </plugin>
  </plugins>
</reporting>

  3. Run the following command:

    mvn site

  4. See the report generated:

  5. Click on the JavaDocs link:

How it works...

We added the Javadoc plugin to the reporting section of pom. When the Site plugin...

End of Section 5
Next Section
bookmark search playlist download
font-size

Change the font size

margin-width

Change margin width

day-mode

Change background colour

Close icon Search
Country selected
Close icon Your notes and bookmarks

Delete Bookmark

Modal Close icon
Are you sure you want to delete it?
Cancel
Yes, Delete