Maven 3

1 - Cover [Seite Cover]
- 1 [Seite 1]
2 - Titel [Seite Titel]
- 3 [Seite 3]
3 - Impressum [Seite Impressum]
- 4 [Seite 4]
4 - Inhaltsverzeichnis [Seite 7]
5 - Danksagungen [Seite 17]
6 - Vorwort [Seite 19]
7 - Einführung [Seite 21]
7.1 - 1.1 Über dieses Buch [Seite 22]
7.1.1 - 1.1.1 Für wen ist dieses Buch? [Seite 22]
7.1.2 - 1.1.2 Konventionen [Seite 24]
7.1.3 - 1.1.3 Sprache [Seite 25]
7.2 - 1.2 Das Mavenbuch im Internet [Seite 26]
7.3 - 1.3 Kontakt [Seite 26]
8 - Maven im Überblick [Seite 27]
8.1 - 2.1 Was ist Maven? [Seite 27]
8.1.1 - 2.1.1 POM [Seite 27]
8.1.2 - 2.1.2 Lebenszyklen [Seite 28]
8.1.3 - 2.1.3 Vereinfachtes Build-Management [Seite 28]
8.1.4 - 2.1.4 Trennung von Code und Unit-Tests [Seite 28]
8.1.5 - 2.1.5 Verwaltung von Abhängigkeiten [Seite 28]
8.1.6 - 2.1.6 Artefakte [Seite 29]
8.1.7 - 2.1.7 Informationen zu Codequalität und Projektzustand [Seite 29]
8.2 - 2.2 Voraussetzungen [Seite 29]
8.2.1 - 2.2.1 Betriebssystem [Seite 29]
8.2.2 - 2.2.2 JDK [Seite 29]
8.2.3 - 2.2.3 Speicherplatz [Seite 29]
8.3 - 2.3 Installation [Seite 30]
8.4 - 2.4 Projekt erstellen [Seite 31]
8.5 - 2.5 Bauen - Testen - Packen [Seite 33]
8.5.1 - 2.5.1 Basisfunktionen [Seite 33]
8.5.2 - 2.5.2 Dokumentation [Seite 36]
8.6 - 2.6 Projekte erweitern [Seite 40]
8.7 - 2.7 Ein Web-Projekt [Seite 41]
8.7.1 - 2.7.1 Generieren einer Web-Applikation [Seite 41]
8.7.2 - 2.7.2 Servlet-API [Seite 43]
8.7.3 - 2.7.3 Ausführen der Web-Anwendung [Seite 43]
8.8 - 2.8 Weitere Projekttypen [Seite 44]
8.9 - 2.9 Entwicklungsumgebungen [Seite 45]
8.9.1 - 2.9.1 Eclipse [Seite 45]
8.9.2 - 2.9.2 Netbeans [Seite 48]
8.9.3 - 2.9.3 IntelliJ IDEA [Seite 48]
9 - Maven als Konfigurationsmanagement-Tool [Seite 49]
9.1 - 3.1 Konfigurationsmanagement [Seite 49]
9.2 - 3.2 Elemente des Konfigurationsmanagements [Seite 51]
9.3 - 3.3 Von make zu Maven [Seite 53]
10 - Maven-Grundlagen [Seite 57]
10.1 - 4.1 Maven ausführen [Seite 57]
10.1.1 - 4.1.1 Lifecycles [Seite 57]
10.1.2 - 4.1.2 Plugins [Seite 57]
10.1.3 - 4.1.3 Kommandozeilenparameter [Seite 58]
10.1.4 - 4.1.4 MAVEN_OPTS [Seite 60]
10.2 - 4.2 Versionierung [Seite 61]
10.2.1 - 4.2.1 Releases [Seite 61]
10.2.2 - 4.2.2 Snapshots [Seite 61]
10.3 - 4.3 Maven-Konventionen [Seite 62]
10.3.1 - 4.3.1 Verzeichnisstruktur [Seite 62]
10.3.2 - 4.3.2 Namenskonventionen [Seite 64]
10.4 - 4.4 Zugangsdaten verschlüsseln [Seite 65]
10.4.1 - 4.4.1 Anlegen eines Masterpassworts [Seite 65]
10.4.2 - 4.4.2 Verschlüsseln von Passworten [Seite 66]
10.5 - 4.5 Wo erhalte ich Hilfe? [Seite 66]
10.5.1 - 4.5.1 Maven-Hilfe im Internet [Seite 66]
10.5.2 - 4.5.2 Das Maven-Help-Plugin [Seite 67]
11 - Lifecycles [Seite 71]
11.1 - 5.1 Die Standard-Lifecycles [Seite 71]
11.1.1 - 5.1.1 Der Default-Lifecycle [Seite 72]
11.1.2 - 5.1.2 Der clean-Lifecycle [Seite 75]
11.1.3 - 5.1.3 Der Site-Lifecycle [Seite 76]
12 - POM - Das Project Object Model [Seite 77]
12.1 - 6.1 Koordinaten [Seite 78]
12.1.1 - 6.1.1 Elemente [Seite 78]
12.2 - 6.2 Projektbeziehungen [Seite 79]
12.2.1 - 6.2.1 Abhängigkeiten [Seite 79]
12.2.2 - 6.2.2 Vererbung [Seite 80]
12.2.3 - 6.2.3 Aggregation [Seite 80]
12.3 - 6.3 Projektinformationen [Seite 81]
12.3.1 - 6.3.1 Lizenzen [Seite 81]
12.3.2 - 6.3.2 Team-Informationen [Seite 82]
12.3.3 - 6.3.3 Organisation [Seite 83]
12.4 - 6.4 Build-Einstellungen [Seite 84]
12.4.1 - 6.4.1 properties [Seite 84]
12.4.2 - 6.4.2 build [Seite 84]
12.4.3 - 6.4.3 reporting [Seite 88]
12.5 - 6.5 Projektumgebung [Seite 89]
12.5.1 - 6.5.1 Build-Umgebung [Seite 89]
12.5.2 - 6.5.2 Maven-Umgebung [Seite 92]
13 - Dependencies [Seite 97]
13.1 - 7.1 Abhängigkeiten im POM [Seite 97]
13.1.1 - 7.1.1 Das dependency-Tag [Seite 98]
13.1.2 - 7.1.2 dependencyManagement [Seite 101]
13.2 - 7.2 Versionsbereiche [Seite 103]
13.3 - 7.3 Transitive Abhängigkeiten [Seite 105]
13.3.1 - 7.3.1 Der Gültigkeitsbereich transitiver Abhängigkeiten [Seite 106]
13.4 - 7.4 Das Dependency-Plugin [Seite 107]
13.4.1 - 7.4.1 Goals [Seite 107]
13.5 - 7.5 Welche Koordinaten, Käpt'n? [Seite 109]
13.5.1 - 7.5.1 Drittmittel [Seite 110]
14 - Projektbeziehungen [Seite 111]
14.1 - 8.1 Vererbung [Seite 111]
14.2 - 8.2 Aggregation - Multimodul-Projekte [Seite 112]
14.2.1 - 8.2.1 Fischladen [Seite 112]
15 - Repositories [Seite 115]
15.1 - 9.1 Lokale und entfernte Repositories [Seite 115]
15.2 - 9.2 Repository-Struktur [Seite 115]
15.3 - 9.3 Repositories verwenden [Seite 116]
15.3.1 - 9.3.1 Das lokale Repository [Seite 116]
15.3.2 - 9.3.2 Entfernte Repositories [Seite 116]
15.3.3 - 9.3.3 Plugin-Repositories [Seite 120]
15.3.4 - 9.3.4 Distribution Management [Seite 121]
15.4 - 9.4 Eigene Repositories [Seite 122]
15.5 - 9.5 Bibliotheken installieren [Seite 123]
15.5.1 - 9.5.1 Installation im lokalen Repository [Seite 124]
15.5.2 - 9.5.2 deploy im entfernten Repository [Seite 125]
16 - Plugins [Seite 127]
16.1 - 10.1 Ausführen von Plugins [Seite 127]
16.1.1 - 10.1.1 Ausführen auf der Kommandozeile [Seite 127]
16.1.2 - 10.1.2 Automatisches Ausführen von Plugins [Seite 128]
16.2 - 10.2 Deklaration im POM [Seite 129]
16.2.1 - 10.2.1 Elemente [Seite 129]
16.2.2 - 10.2.2 Die Sektion pluginManagement [Seite 130]
16.2.3 - 10.2.3 Plugin-Repositories [Seite 131]
16.2.4 - 10.2.4 Versionen und Update von Plugins [Seite 131]
16.2.5 - 10.2.5 Externe Konfiguration - Konfigurationsmodule? [Seite 132]
16.3 - 10.3 Das Maven-AntRun-Plugin [Seite 133]
17 - Properties und Filtering [Seite 135]
17.1 - 11.1 Maven-Properties [Seite 135]
17.1.1 - 11.1.1 Projekt-Properties [Seite 135]
17.1.2 - 11.1.2 Settings-Properties [Seite 136]
17.1.3 - 11.1.3 Umgebungsvariablen [Seite 137]
17.1.4 - 11.1.4 System-Properties [Seite 137]
17.1.5 - 11.1.5 Properties definieren [Seite 138]
17.2 - 11.2 Resource Filtering [Seite 139]
17.2.1 - 11.2.1 Filterdateien [Seite 140]
17.2.2 - 11.2.2 Excludes [Seite 142]
17.2.3 - 11.2.3 Web-Applikationen [Seite 142]
18 - Profile [Seite 145]
18.1 - 12.1 Profilarten [Seite 145]
18.2 - 12.2 Profilaktivierung [Seite 146]
18.2.1 - 12.2.1 Aktivierung über die Kommandozeile [Seite 146]
18.2.2 - 12.2.2 Aktivierung in den Settings [Seite 147]
18.2.3 - 12.2.3 Aktivierung als Standard [Seite 147]
18.2.4 - 12.2.4 Umgebungsabhängige Aktivierung [Seite 148]
18.2.5 - 12.2.5 Und wer ist jetzt aktiv? [Seite 150]
18.3 - 12.3 Einsatzmöglichkeiten für Profile [Seite 150]
18.3.1 - 12.3.1 Standortabhängige Ressourcen [Seite 150]
18.3.2 - 12.3.2 Module [Seite 151]
18.3.3 - 12.3.3 Dependencies [Seite 151]
18.3.4 - 12.3.4 Properties für verschiedene (Test-)Umgebungen [Seite 151]
18.3.5 - 12.3.5 Artefakte durch Klassifizierer kennzeichnen [Seite 155]
18.4 - 12.4 Konflikte [Seite 156]
18.4.1 - 12.4.1 Profile mit gleichem Namen [Seite 156]
18.4.2 - 12.4.2 Gleichnamige Eigenschaften [Seite 156]
19 - Maven-SCM [Seite 159]
19.1 - 13.1 Versionskontrolle mit dem SCM-Plugin [Seite 159]
19.1.1 - 13.1.1 Wird mein Kontrollsystem unterstützt? [Seite 159]
19.2 - 13.2 Unterstützte Kommandos [Seite 160]
19.3 - 13.3 Anwendung des SCM-Plugins [Seite 161]
19.3.1 - 13.3.1 Alles ist wandelbar [Seite 161]
19.4 - 13.4 Konfiguration [Seite 161]
19.4.1 - 13.4.1 Aufbau der SCM-URL [Seite 162]
19.4.2 - 13.4.2 Subversion [Seite 162]
19.5 - 13.5 Beispiele [Seite 163]
19.5.1 - 13.5.1 Automatisches Kennzeichnen von Releases [Seite 165]
19.5.2 - 13.5.2 Sauberes Deployment mit scm:bootstrap [Seite 165]
20 - Software veröffentlichen [Seite 167]
20.1 - 14.1 Maven-Release-Plugin [Seite 167]
20.1.1 - 14.1.1 Die Vorbereitung des Release - release:prepare [Seite 168]
20.1.2 - 14.1.2 Die Ausführung des Release - release:perform [Seite 170]
20.1.3 - 14.1.3 Weitere Goals [Seite 171]
20.2 - 14.2 Assembly-Plugin [Seite 172]
20.2.1 - 14.2.1 Was sind Assemblies? [Seite 172]
20.2.2 - 14.2.2 Assembly-Deskriptoren [Seite 173]
20.2.3 - 14.2.3 Assembly-Inhalte festlegen [Seite 176]
20.2.4 - 14.2.4 Dateien [Seite 176]
20.2.5 - 14.2.5 Dependencies [Seite 179]
20.2.6 - 14.2.6 Module [Seite 181]
20.2.7 - 14.2.7 Repositories [Seite 184]
20.2.8 - 14.2.8 Assembly-Deskriptoren weiterverwenden [Seite 185]
20.3 - 14.3 Server Deployments mit dem Cargo-Plugin [Seite 186]
21 - Plugins schreiben [Seite 191]
21.1 - 15.1 Bestandteile eines Maven-Plugins [Seite 191]
21.1.1 - 15.1.1 Plugin Build-Lifecycle [Seite 191]
21.1.2 - 15.1.2 Der Plugin-Deskriptor [Seite 192]
21.1.3 - 15.1.3 Namenskonventionen [Seite 192]
21.2 - 15.2 Mojo [Seite 193]
21.2.1 - 15.2.1 Fehlerbehandlung [Seite 193]
21.2.2 - 15.2.2 Der Mojo-Logger [Seite 194]
21.3 - 15.3 Eigene Plugins schreiben [Seite 194]
21.3.1 - 15.3.1 Ein erstes Mojo [Seite 194]
21.3.2 - 15.3.2 Das POM [Seite 195]
21.4 - 15.4 Parameter [Seite 196]
21.4.1 - 15.4.1 Prioritäten [Seite 199]
21.5 - 15.5 Parametertypen [Seite 199]
21.5.1 - 15.5.1 Skalare Werte [Seite 199]
21.5.2 - 15.5.2 Mehrdimensionale Parameter [Seite 200]
21.5.3 - 15.5.3 Konfiguration von Parametern [Seite 202]
21.5.4 - 15.5.4 Testen von Plugins [Seite 204]
21.5.5 - 15.5.5 Dokumentation von Plugins [Seite 204]
21.5.6 - 15.5.6 Unterstützte Sprachen [Seite 206]
22 - Maven und Eclipse [Seite 207]
22.1 - 16.1 Das Maven-Eclipse-Plugin [Seite 207]
22.1.1 - 16.1.1 Goals [Seite 207]
22.1.2 - 16.1.2 Vorbereitungen [Seite 208]
22.1.3 - 16.1.3 Projektkonfiguration [Seite 209]
22.2 - 16.2 Maven ausführen [Seite 214]
22.2.1 - 16.2.1 External Tools [Seite 214]
22.2.2 - 16.2.2 Maven als Builder in Eclipse [Seite 217]
22.2.3 - 16.2.3 Ersetzen des Standard-Eclipse-Builders [Seite 218]
22.3 - 16.3 Eclipse-Maven-Plugins [Seite 219]
22.3.1 - 16.3.1 M2Eclipse [Seite 219]
22.3.2 - 16.3.2 Eclipse IAM [Seite 221]
23 - Reporting und Dokumentation [Seite 223]
23.1 - 17.1 Projektdokumentation mit Maven [Seite 223]
23.2 - 17.2 Bestandteile [Seite 224]
23.3 - 17.3 Projektinformationen [Seite 224]
23.3.1 - 17.3.1 Continuous Integration [Seite 225]
23.3.2 - 17.3.2 Dependencies [Seite 225]
23.3.3 - 17.3.3 Dependency Convergence [Seite 227]
23.3.4 - 17.3.4 Issue Tracking [Seite 228]
23.3.5 - 17.3.5 Mailing Lists [Seite 228]
23.3.6 - 17.3.6 Plugin Management [Seite 228]
23.3.7 - 17.3.7 Project License [Seite 229]
23.3.8 - 17.3.8 Project Plugins [Seite 229]
23.3.9 - 17.3.9 Project Summary [Seite 229]
23.3.10 - 17.3.10 Project Team [Seite 230]
23.3.11 - 17.3.11 Source Repository [Seite 230]
23.3.12 - 17.3.12 Konfiguration der Projektinformationen [Seite 230]
23.4 - 17.4 Projekt-Reports [Seite 232]
23.4.1 - 17.4.1 Das Javadoc-Plugin [Seite 233]
23.4.2 - 17.4.2 Das Surefire-Report-Plugin [Seite 233]
23.4.3 - 17.4.3 JXR [Seite 234]
23.4.4 - 17.4.4 Weitere Reporting-Plugins [Seite 234]
23.5 - 17.5 Eigene Projektdokumentation [Seite 241]
23.5.1 - 17.5.1 Doxia - ein Content-Generation-Framework [Seite 241]
23.5.2 - 17.5.2 APT - das Maven-Dokument-Format [Seite 241]
23.5.3 - 17.5.3 XDOC - das Jakarta-Dokument-Format [Seite 246]
23.5.4 - 17.5.4 FML - Frequently Asked Questions [Seite 247]
23.5.5 - 17.5.5 Verzeichnisstruktur [Seite 249]
23.5.6 - 17.5.6 Internationalisierung [Seite 249]
23.6 - 17.6 Der Site-Deskriptor [Seite 250]
23.6.1 - 17.6.1 Aufbau [Seite 250]
23.6.2 - 17.6.2 Vererbung [Seite 254]
23.6.3 - 17.6.3 Look&Feel anpassen [Seite 255]
23.7 - 17.7 Multimodul-Projekte [Seite 255]
23.7.1 - 17.7.1 Besonderheiten [Seite 255]
23.8 - 17.8 Das Maven-Site-Plugin [Seite 256]
23.8.1 - 17.8.1 site - goals [Seite 257]
23.8.2 - 17.8.2 Module ausschließen [Seite 258]
23.8.3 - 17.8.3 Der Site-Lebenszyklus [Seite 259]
24 - Qualitätsmanagement mit Maven [Seite 261]
24.1 - 18.1 Continuous Integration [Seite 261]
24.2 - 18.2 QS-Plugins [Seite 261]
24.2.1 - 18.2.1 Checkstyle [Seite 261]
24.2.2 - 18.2.2 PMD [Seite 267]
24.2.3 - 18.2.3 FindBugs [Seite 271]
24.2.4 - 18.2.4 Surefire [Seite 272]
24.2.5 - 18.2.5 Surefire-Reports [Seite 273]
24.2.6 - 18.2.6 Cobertura [Seite 274]
24.2.7 - 18.2.7 Integrationstests mit dem Failsafe-Plugin [Seite 276]
24.3 - 18.3 Tipps und Tricks [Seite 278]
24.3.1 - 18.3.1 Source-Encoding [Seite 278]
24.3.2 - 18.3.2 Build-Abbruch bei Regelverstößen [Seite 278]
24.3.3 - 18.3.3 Konfigurationsmodule [Seite 280]
24.4 - 18.4 Erzeugen von Projekt-Templates mit dem Archetype-Plugin [Seite 281]
24.4.1 - 18.4.1 Woher bekommt Maven neue Archetypen? [Seite 282]
24.5 - 18.5 Firmenweite Einstellungen [Seite 283]
24.6 - 18.6 POM-Tuning [Seite 284]
24.6.1 - 18.6.1 Konfigurationsmodule [Seite 285]
25 - Änderungen in Maven 3 [Seite 287]
25.1 - 19.1 Umstieg von Maven 2 auf Maven 3 [Seite 287]
25.2 - 19.2 Repositories und Dependencies [Seite 288]
25.3 - 19.3 Reporting [Seite 289]
25.4 - 19.4 Ausführung [Seite 289]
25.4.1 - 19.4.1 Neue Kommandozeilen-Parameter [Seite 289]
25.4.2 - 19.4.2 Profile [Seite 290]
25.5 - 19.5 Und was noch? [Seite 290]
25.5.1 - 19.5.1 Mvnsh [Seite 290]
25.5.2 - 19.5.2 Polyglot for Maven [Seite 291]
26 - Produkte aus dem Maven-Universum [Seite 293]
26.1 - A.1 Über diesen Anhang [Seite 293]
26.1.1 - A.1.1 Datenbanken [Seite 293]
26.2 - A.2 Apache Archiva [Seite 293]
26.2.1 - A.2.1 Was ist Archiva? [Seite 294]
26.2.2 - A.2.2 Installation [Seite 294]
26.2.3 - A.2.3 Konfiguration [Seite 296]
26.2.4 - A.2.4 Server-Konfiguration [Seite 297]
26.2.5 - A.2.5 Benutzerverwaltung [Seite 299]
26.2.6 - A.2.6 Tipps [Seite 301]
26.2.7 - A.2.7 Literatur [Seite 303]
26.3 - A.3 Continuum [Seite 303]
26.3.1 - A.3.1 Continuous Integration? [Seite 303]
26.3.2 - A.3.2 Installation [Seite 304]
26.3.3 - A.3.3 Konfiguration [Seite 306]
26.3.4 - A.3.4 Und was noch? [Seite 312]
27 - Konfigurationsdateien [Seite 315]
27.1 - B.1 POM - Project Object Model [Seite 315]
27.1.1 - B.1.1 Basiselemente [Seite 315]
27.1.2 - B.1.2 Koordinaten [Seite 315]
27.1.3 - B.1.3 Projektbeziehungen [Seite 315]
27.1.4 - B.1.4 Umgebungseinstellungen [Seite 318]
27.1.5 - B.1.5 Super-POM [Seite 323]
27.2 - B.2 settings.xml [Seite 326]
27.2.1 - B.2.1 Referenz [Seite 327]
28 - Referenzen [Seite 331]
28.1 - C.1 Mojo-Elemente und -Annotations [Seite 331]
28.1.1 - C.1.1 Hauptelemente [Seite 331]
28.1.2 - C.1.2 Mojo-Elemente [Seite 331]
28.1.3 - C.1.3 Parameterelemente und -Annotations [Seite 335]
28.2 - C.2 APT-Kurzreferenz [Seite 337]
28.3 - C.3 Plugin-Versionen in Maven 3.0.3 [Seite 340]
28.4 - C.4 Lifecycle-Verknüpfungen [Seite 341]
28.4.1 - 3.4.1 Build-Lifecycle [Seite 341]
28.5 - C.5 Namenskonventionen für SUN-JARs [Seite 342]
29 - Literatur [Seite 345]
30 - Stichwortverzeichnis [Seite 347]