Martin Spiller. Maven 2. Konfigurationsmanagement mit Java

Transkript

1 Martin Spiller Maven 2 Konfigurationsmanagement mit Java

2 Danksagungen 17 Der Autor 17 i Einfuhrung 19 i.i Über dieses Buch 20 i.i.i Für wen ist dieses Buch? Aufbau des Buches Konventionen Sprache Das Maven-Buch im Internet Kontakt 24 2 Maven im Überblick Was ist Maven? POM Lebenszyklen Vereinfachtes Build-Management Trennung von Code und Unit-Tests Verwaltung von Abhängigkeiten Artefakte Informationen zu Codequalität und Projektzustand Voraussetzungen T Betriebssystem Л JDK Speicherplatz Installation Projekt erstellen Bauen - Testen - Packen Basisfunktionen Dokumentation Projekte erweitern 38

3 chnis Ein Web-Projekt Generieren einer Web-Applikation Servlet-API Ausführen der Web-Anwendung 40 Weitere Projekttypen 41 Entwicklungsumgebungen Eclipse Netbeans \ IntelliJ IDEA \ 46 Maven als Konfigurationsmanagement-Tool von Manfred Wolff Konfigurationsmanagement 47 Elemente des Konfigurationsmanagements 50 Von make zu Maven 51 Maven-Grundlagen 55 Maven ausführen Lifecycles Plugins Kommandozeilenparameter MAVEN_OPTS 58 Versionierung Releases Snapshots 58 Maven-Konventionen Verzeichnisstruktur Namenskonventionen 61 Wo erhalte ich Hilfe? Maven-Hilfe im Internet Das Maven-Help-Plugin 63 Lifecycles von Patrick Zeising 67 Die Standard-Lifecycles Der Default-Lifecycle Der clean-lifecycle Der Site-Lifecycle 72 POM - Das Project Object Model 73 Koordinaten Elemente 74

4 6.2 Projektbeziehungen Abhängigkeiten Vererbung Aggregation Projektinformationen Lizenzen Team-Informationen Organisation Build-Einstellungen properties build reporting Projektumgebung Build-Umgebung Maven-Umgebung 88 7 Dependencies Abhängigkeiten im POM Das dependency-tag Das dependencymanagement-tag Versionsbereiche Transitive Abhängigkeiten Der Gültigkeitsbereich transitiver Abhängigkeiten Das Dependency-Plugin Goals Welche Koordinaten, Käpt'n? Drittmittel Projektbeziehungen Vererbung Aggregation - Multimodul-Projekte Fischladen Repositories Ill 9.1 Lokale und entfernte Repositories Ill 9.2 Repository-Struktur Ill 9.3 Repositories verwenden Das lokale Repository Entfernte Repositories 112 9

5 9.3.3 Plugin-Repositories Distribution Management Eigene Repositories Bibliotheken installieren Installation im lokalen Repository deploy im entfernten Repository Plugins Ausführen von Plugins Ausführen auf der Kommandozeile Automatisches Ausführen von Plugins Deklaration im POM Elemente Die Sektion pluginmanagement Plugin-Repositories Versionen und Update von Plugins Externe Konfiguration - Konfigurationsmodule? Das Maven-AntRun-Plugin Properties und Filtering Maven-Properties Projekt-Properties Settings-Properties Umgebungsvariablen System-Properties Properties definieren Resource Filtering Filterdateien Excludes Web-Applikationen Profile Profilarten Profilaktivierung Aktivierung über die Kommandozeile Aktivierung in den Settings Aktivierung als Standard Umgebungsabhängige Aktivierung Und wer ist jetzt aktiv? 146 ю

6 12.3 Einsatzmöglichkeiten für Profile Standortabhängige Ressourcen Module Dependencies Properties für verschiedene (Test-)Umgebungen Artefakte durch Klassifizierer kennzeichnen Konflikte Profile mit gleichem Namen Gleichnamige Eigenschaften Maven-SCM Versionskontrolle mit dem SCM-Plugin Wird mein Kontrollsystem unterstützt? Unterstützte Kommandos Anwendung des SCM-Plugins Alles ist wandelbar Konfiguration Aufbau der SCM-URL Subversion Beispiele Automatisches Kennzeichnen von Releases Sauberes Deployment mit scm:bootstrap Software veröffentlichen Maven-Release-Plugin Die Vorbereitung des Release - release:prepare Die Ausführung des Release - release:perform Weitere Goals Assembly-Plugin Was sind Assemblies? Assembly-Deskriptoren Assembly-Inhalte festlegen Dateien Dependencies Module Repositories Assembly-Deskriptoren weiterverwenden

7 15 Plugins schreiben Bestandteile eines Maven-Plugins Plugin Build-Lifecycle Der Plugin-Deskriptor Namenskonventionen Mojo Fehlerbehandlung Der Mojo-Logger Eigene Plugins schreiben Ein erstes Mojo Das POM Parameter Prioritäten Parametertypen Skalare Werte Mehrdimensionale Parameter Konfiguration von Parametern Testen von Plugins Dokumentation von Plugins Unterstützte Sprachen Maven und Eclipse r Das Maven-Eclipse-Plugin Goals Vorbereitungen Projektkonfiguration Maven ausführen External Tools Maven als Builder in Eclipse Ersetzen des Standard-Edipse-Builders Eclipse-Maven-Plugins M2Eclipse Q4E Reporting und Dokumentation Projektdokumentation mit Maven Bestandteile Projektinformationen Continuous Integration 211

8 Dependencies Dependency Convergence Issue Tracking Mailing Lists Plugin Management Project License Project Plugins Project Summary Project Team и Source Repository Konfiguration der Projektinformationen Projekt-Reports Das Javadoc-Plugin Das Surefire-Report-Plugin JXR Weitere Reporting-Plugins Eigene Projektdokumentation i Doxia - ein Content-Generation-Framework APT - Das Maven-Dokument-Format XDOC - Das Jakarta-Dokument-Format FML - Frequently Asked Questions Verzeichnisstruktur Internationalisierung Der Site-Deskriptor Aufbau Vererbung Look&Feel anpassen Multimodul-Projekte Besonderheiten Das Maven-Site-Plugin site - goals Module ausschließen Der Site-Lebenszyklus Qualitätsmanagement mit Maven Continuous Integration QS-Plugins Checkstyle

9 PMD FindBugs Surefire Surefire-Reports Cobertura Tipps und Tricks Source-Encoding Build-Abbruch bei Regelverstößen Konfigurationsmodule Erzeugen von Projekt-Templates mit dem Archetype-Plugin Woher bekommt Maven neue Archetypen? Firmenweite Einstellungen POM-Tuning Konfigurationsmodule Ausblick Was bringt Maven 2.1? Erscheinungsdatum Geplante Neuerungen in Maven A Produkte aus dem Maven-Universum 269 Ал Über diesen Anhang 269 A.1.1 Datenbanken 269 A.2 Apache Archiva 269 A.2.1 Was ist Archiva? 270 A.2.2 Installation 270 A.2.3 Konfiguration 272 A.2.4 Server-Konfiguration 273 A.2.5 Benutzerverwaltung 275 A.2.6 Tipps 277 A.2.7 Literatur 279 A.3 Apache Continuum 279 A.3.1 Continuous Integration? 279 A.3.2 Installation 280 A.3.3 Konfiguration 282 A.3.4 Und was noch? 288

10 В Konfigurationsdateien 289 B.i POM - Project Object Model 289 B.i.i Basiselemente 289 В.i.2 Koordinaten Projektbeziehungen Umgebungseinstellungen 293 B.1.5 Super-POM 297 B.2 settings.xml 303 В.2.i Referenz 303 С Referenzen 307 C.i Mojo-Elemente und -Annotations 307 C.1.1 Hauptelemente 307 C.i.2 Mojo-Elemente 307 C.1.3 Parameterelemente und -Annotations 311 C.2 APT-Kurzreferenz 313 C.3 Plugin-Versionen in Maven C.4 Lifecycle-Verknüpfungen 317 C.4.1 Build-Lifecycle 317 C.5 Namenskonventionen für SUN-JARs 319 D Literatur 321 Stichwortverzeichnis