# Project Management - maven

* [Project Management - maven](#project-management-maven)
  * [Objectives of maven](#objectives-of-maven)
  * [Tutorials](#tutorials)
  * [Using IDE to create maven Project](#using-ide-to-create-maven-project)
    * [Other way - download maven](#other-way-download-maven)
  * [pom.xml](#pomxml)
    * [Maven coordinate](#maven-coordinate)
  * [Archetype](#archetype)
  * [Snapshot](#snapshot)
  * [Maven lifecycles](#maven-lifecycles)
  * [Dependencies](#dependencies)
  * [Plugins](#plugins)
  * [Profiles](#profiles)
  * [Resources](#resources)
  * [Repositories](#repositories)
  * [Plugin repository](#plugin-repository)
  * [Builds](#builds)
  * [Excutions](#excutions)
  * [Modules](#modules)
  * [Properties](#properties)
  * [Parent POMs](#parent-poms)
  * [Best practises](#best-practises)
  * [Links](#links)
  * [Used plugins](#used-plugins)

Using maven to manage our dependencies, excute commands (ie docker image creation and starting), compile and zip up, etc.

<https://maven.apache.org/>

Alternatives are Gradle(new) and Ant(old)

## Objectives of maven

* Sets dependencies used in project
  * Can easily upgrade to new versions
* Describes how project will be built
* Provides unified build cycles
  * Maven have predefined lifecycles
* Run plugins to acheive goals like unit tests, acceptance tests, jar -ing project with dependencies, create and run docker images etc etc

Maven is just a collection of plugins that are configured in the pom.xml.

## Tutorials

* <https://youtu.be/Xatr8AZLOsE> Maven Tutorial - Nice & Easy

## Using IDE to create maven Project

* Prerequisites
  * need jdk
  * need IDE
* Use of IntelliJ
* create new project -> maven project
* ????
* check maven is on computer: `mvn --version`

### Other way - download maven

* link ???

## pom.xml

* Describes the project in this configuration file
* Project Object Model
* In XML
* Can get large but can use aggregation and modules to reduce this

### Maven coordinate

This is the combination of GroupID + ArtifactID + Version

## Archetype

* Is a template
* define the type of project to be created
* use `maven-archetype-quickstart` for general projects
* <https://maven.apache.org/guides/introduction/introduction-to-archetypes.html>

## Snapshot

* When maven builds a jar/war file it will contain "snapshot" in name.
* snapshot is the latest code in project.
* <https://maven.apache.org/guides/getting-started/index.html#What\\_is\\_a\\_SNAPSHOT\\_version>
* <https://stackoverflow.com/questions/5901378/what-exactly-is-a-maven-snapshot-and-why-do-we-need-it>

## Maven lifecycles

* Lifecycles are made of phases
* <https://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html>
*

## Dependencies

* dependency management
* test dependencies
  * Only used for tests, thus do not need to packaged with prod jar
* transistive dependencies
* exclusions
* Maven central to get dependencies

## Plugins

* <http://javarevisited.blogspot.co.uk/2016/08/top-10-maven-plugins-every-java-developer-know.html>
* <https://www.fromdev.com/2012/07/25-best-free-maven-plug-ins-to-make.html>

## Profiles

## Resources

## Repositories

## Plugin repository

## Builds

## Excutions

## Modules

* Grab modules with dedicated poms, so these can be excuted in this pom
* <https://maven.apache.org/guides/mini/guide-multiple-modules.html>
* <http://www.codetab.org/apache-maven-tutorial/maven-multi-module-project/>

## Properties

* extracting common things like version numbers or boolean references or paths, to be used else where

## Parent POMs

* inheriting

## Best practises

* <http://www.kyleblaney.com/maven-best-practices/>
* <http://books.sonatype.com/mvnref-book/reference/index.html>

## Links

* <https://www.tutorialspoint.com/maven/index.htm>
* <https://codurance.com/2016/08/19/maven-demystified/>
*

## Used plugins

* Fabric8
  * <https://maven.fabric8.io/>
* findbugs
  * <https://gleclaire.github.io/findbugs-maven-plugin/>
* pmd
  * <https://maven.apache.org/plugins/maven-pmd-plugin/>
* pitest
  * <http://pitest.org/quickstart/maven/>
* surefire
  * <http://maven.apache.org/surefire/maven-surefire-plugin/>
  * run all unit tests
* maven-surefire-report-plugin
  * generate reports
  * <http://maven.apache.org/surefire/maven-surefire-report-plugin/>
* Failsafe Plugin
  * run acceptance tests
  * <http://maven.apache.org/surefire/maven-failsafe-plugin/>
* maven-compiler-plugin
  * allows you to set your java language level
* Flywaydb
  * <https://flywaydb.org/documentation/maven/>
* Artifactory
  * Store jars and in cloud based space jfrog
  * <https://www.jfrog.com/confluence/display/RTF/Maven+Repository>
* Jar plugin
  * build jars of app
  * <https://maven.apache.org/plugins/maven-jar-plugin/>
* deploy plugin
  * <http://maven.apache.org/plugins/maven-deploy-plugin/>
  * deploy jars to repository
* Resources Plugin
* <https://maven.apache.org/plugins/maven-resources-plugin/>