Bookmark This PageThe first Maven book was Maven: A Developer’s Notebook (O’Reilly). That book introduced Maven in a series of steps via a conversation between you and a colleague who already knew how to use Maven. The idea behind the (now-retired) Developer’s Notebook series was that developers learn best when they are sitting next to other developers and going through the same thought processes, learning to code by doing and experimenting. Although the series was successful, the Notebook format had limitations. Notebooks are, by design, “goal-focused” books that take you through a series of steps to achieve very specific goals. By contrast, larger reference books (such as O’Reilly’s animal books) provide comprehensive reference material that cover the entirety of the topic.
If you read Maven: A Developer’s Notebook, you’ll learn how to create a simple project or a project that creates a WAR from a set of source files. But if you want to find out the specifics for something like the Assembly plugin, you’ll hit an impasse. Because there is no well-written reference material for Maven, you have to hunt through plugin documentation on the Maven web site or cull from a series of mailing lists. Once you really dig into Maven, you end up reading through thousands of HTML pages on the Maven site written by hundreds of different developers, each with a different idea of what it means to document a plugin. Despite the best efforts of well-meaning volunteers, reading through plugin documentation on the Maven site is, at best, frustrating, and at worst, a reason to abandon Maven. Quite often, Maven users get stuck because they just can’t find an answer.
This lack of an authoritative (or definitive) reference manual has held Maven back for a few years, and it has been something of a dampening force on Maven adoption. With Maven: The Definitive Guide, we intend to change that situation by providing a comprehensive reference in Part II, “Maven Reference”. In Part II, we’re preserving the narrative progression of a Developer’s Notebook; it is valuable material that helps people learn Maven by example. Thus, in this part, we “introduce by doing,” and in Part II, “Maven Reference”, we fill in the blanks and dig into the details. Where Part II, “Maven Reference” might use a reference table and a program listing detached from an example project, Part II is motivated by real examples.
After reading this part, you should have everything you need to start using Maven. You might need to refer to Part II, “Maven Reference” only when you start customizing Maven by writing custom plugins or when you want more detail about specific plugins.
Table of Contents
- 3. A Simple Maven Project
- 4. Customizing a Maven Project
-
- 4.1. Introduction
- 4.2. Defining the Simple Weather Project
- 4.3. Creating the Simple Weather Project
- 4.4. Customize Project Information
- 4.5. Add New Dependencies
- 4.6. Simple Weather Source Code
- 4.7. Add Resources
- 4.8. Running the Simple Weather Program
- 4.9. Writing Unit Tests
- 4.10. Adding Test-scoped Dependencies
- 4.11. Adding Unit Test Resources
- 4.12. Executing Unit Tests
- 4.13. Building a Packaged Command Line Application
- 5. A Simple Web Application
- 6. A Multi-module Project
- 7. Multi-module Enterprise Project
- 8. Optimizing and Refactoring POMs
Maven: The Definitive Guide by Sonatype, Inc. is licensed under a Creative Commons Attribution-Noncommercial-No Derivative Works 3.0 United States License.
Based on a work at www.sonatype.com.
Report Typos, Errors, Ask Questions, Discuss, Share Your Ideas with us at Get Satisfaction