Imagine you are working on a project based upon a traditional 3 layers architecture, in which the layers are named presentation, business and integration. Of course, you want each layer to be independant of all the other layers and so you want to produce one artifact for each one. Following the Maven norm, you will need to have one project for each layer. Hence, your setup should look like this :
So to compile your presentation project, you would first need to compile the business logic project. But wait, the business project depends upon the integration project so it should be compiled first. Ok, let's recapitulate, so to compile your presentation project you would need to type the following commands (we assume the projects have been put in a common root directory):
Few! 8 lines just to compile! I thought Maven was simple. Of course, Maven offers a solution to this problem in the form of multi-modules project.
A multi-modules project is a very particular type of project - it doesn't produce any artifact and is composed of several other projects known as modules. When you run a command on the project, it will executes it on all its children projects. Even better, Maven is able, throught its reactor component(don't worry about it for now), to discover the correct execution order and to detect circular dependencies. So let's apply this solution to the last example. Your project should have the following structure at the end of this lesson :
Let's create your multi-modules project. First, create a new directory named after your project, something like multimoduleproject. Now let's write your multi-modules project's pom file :
Next, create the following directory layout :
As you can see on the picture, all of the different module projects must be located under a subdirectory so the parent project can retrieve them easily.