Link Search Menu Expand Document (external link)

Maven


Inhaltsverzeichnis

  1. CLI
    1. Einige Befehle, die man kennen sollte
    2. Beispiele
  2. Dependencies
  3. Glossar
  4. IntelliJ-Integration
    1. Quell- und Zielplattform angeben
    2. Archetype-Katalog erweitern
  5. Plugins
  6. pom.xml
    1. packaging
    2. dependencyManagement
  7. Profile
  8. Links

CLI

Einige Befehle, die man kennen sollte

  1. mvn clean - Aufräumen des Projekts, löscht den Ordner target
  2. mvn package - Erzeugt das JAR- oder WAR-Archiv des Projekts.
  3. mvn install - Die erzeugten Projektartefakte (z.B. JAR-/WAR-Archiv oder pom.xml) werden in das lokale Repository installiert.
  4. mvn dependency:tree - Listet den Abhängigkeitsbaum des Projekts auf.
  5. mvn dependency:analyze - Analyse des Projekts um nicht verwendete, aber deklarierte und verwendete, aber nicht deklarierte Abhängigkeiten zu ermitteln.
  6. mvn archetype:generate - Erzeugt ein Projekt auf Basis der Vorlage des Archetypes.
  7. mvn -f dir/pom.xml package - Erzwingt die Verwendung einer alternativen POM.
  8. mvn -o <command> - Führt <command> im Offline-Modus aus.
  9. mvn -q <command> - Führt <command> im stillen Modus aus. Es werden nur Fehler und Testergebnisse ausgegeben.
  10. mvn -X <command> - Führt <command> im Debug-Modus aus.
  11. mvn -v - Zeigt Versionsinformation an.
  12. mvn -V <command> - Ausgabe von Versionsinformationen und anschließendes Ausführen von <command>.
  13. mvn -DskipTests <command> - Überspringt die Ausführung von Tests. Es kann auch -Dmaven.skip.tests=true verwendet werden.
  14. mvn -T 4 clean install - Parallele Erstellung des Projekts mit 4 Threads, kann zur Verbesserung der Performance in einem Multi-Modul-Projekt beitragen.

Beispiele

  • (detaillierte) Hilfe zu einem Goal (z.B. compiler:compile aufrufen)

    mvn help:describe -Dcmd=compiler:compile [-Ddetail]
    
  • Ausführung in headless-Umgebungen (z.B. CI-Systeme)

    mvn -B|--batch-mode
    
  • Optimierung von Abhängigkeiten

    mvn dependency:analyze
    
    • besonderes Augenmerk auf used, undeclared dependencies, dann mit mvn dependency:tree im entsprechenden Modul genauer schauen und die Abhängigkeit ggf. direkt in der POM laden

Dependencies

  • Scopes
    • compiled: immer verfügbar, Standard
    • provided: wenn im JDK oder J2EE-Container bereitgestellt, Dependency wird nicht paketiert
    • runtime: nicht erforderlich beim Kompilieren
    • test
    • system: ähnlich provided, nur mit expliziter Pfadangabe zum JAR
  • Versionsbereiche

Glossar

Archetype

In short, Archetype is a Maven project templating toolkit. An archetype is defined as an original pattern or model from which all other things of the same kind are made. The name fits as we are trying to provide a system that provides a consistent means of generating Maven projects.

Maven Assemblies

Archiv oder Verzeichnis mit einem benutzerdefinierten Layout

pom.xml

descriptive, declarative Project Object Model3

  • erbt von “The Super POM”, definiert Standard-Projektstruktur (sources, target, tests, …)
    • daher kommen auch Plugins wie compiler, assembly usw.
    • Analyse mit mvn help:effective-pom

IntelliJ-Integration

Quell- und Zielplattform angeben

<properties>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>8</maven.compiler.target>
</properties>

pom.xml: Verwendung der Compiler-Argumente -source und -target.

Ab Java 9 existiert das -release Argument, welches mit der Property maven.compiler.release (ab maven-compiler-plugin:3.8.x) gesetzt werden kann:

<properties>
    <maven.compiler.release>17</maven.compiler.release>
</properties>

pom.xml: Verwendung des -release Compiler-Arguments.

Archetype-Katalog erweitern

IntelliJ wird mit einem relativ kleinen Archetype-Katalog ausgeliefert. Mit dieser Anleitung kann man ihn erweitern:

  1. Plugin Maven Archetype Catalogs installieren
  2. Einstellungen öffnen mit ⌘ + ,
  3. Wechsel zu Preferences | Build, Execution, Deployment | Build Tools | Maven Archetype Catalogs
  4. Auf das Hinzufügen-Symbol (+) klicken
  5. Im Eingabefeld die URL https://repo.maven.apache.org/maven2/archetype-catalog.xml hinzufügen

IntelliJ Maven Archetype-Katalog erweitern

Plugins

  • Testrunner4
    • Surefire: Unit tests
    • Failsafe: Integration tests

pom.xml

packaging

  • Wert der Eigenschaft (pom, jar, war) beeinflusst die Lifecycle-Schritte/Phasen5

dependencyManagement

  • erlaubt in Elterprojekten die einmalige und zentralisierte Definition von bestimmten Versionen von Abhängigkeiten (und auch den Umgang mit transitiven Abhängigkeiten)
  • Eigenschaften von Kindprojekten/-modulen erweitern Eigenschaften von übergeordneten Projekten/Modulen.

Profile

  • mittels -P oder --activate-profiles über das CLI steuerbar
  • wenn ein Profil mittels <activation> gesteuert wird, kann an der CLI mit mvn help:active -profiles analysiert werden, welche Profile gültig sind