Hallo Spa\u00df-Coder.<\/p>\n
Im Artikel Mit Maven raus aus der Abh\u00e4ngigkeit<\/a> haben wir einen Einstieg in die Verwaltung von Abh\u00e4ngigkeiten zwischen Java-Projekten gezeigt. Aber wie genau funktioniert das nun in der Praxis? Wie gehe ich vor, wenn ich Unit Tests in meinem Projekt hinzuf\u00fcgen m\u00f6chte und daf\u00fcr JUnit einbinden will? Wo finde ich diese Abh\u00e4ngigkeit f\u00fcr meine POM? Wie macht Maven das mit der Bereitstellung der Abh\u00e4ngigkeiten denn so genau?<\/p>\n Damit Maven genutzt werden kann, muss entweder die IDE-Integration aktiviert oder – so wie wir es im Laufe des Artikels beschreiben – Maven lokal installiert sein. Maven ist f\u00fcr verschiedene Plattformen z.B. unter apache.maven.org<\/a> zu finden. Unter http:\/\/www.it-adviser.net\/apache-maven-installieren\/<\/a> findet ihr eine leicht verst\u00e4ndliche Beschreibung der Installation zu Maven auf deutsch. Auf der Kommando-Zeile kann eine erfolgreiche Installation mit dem Befehl mvn -version<\/strong> \u00fcberpr\u00fcft werden.<\/p>\n Dabei muss die Version von Maven ausgegeben werden (hier: 3.1.1). Damit Maven erfolgreich betrieben werden kann, muss auch das JDK von Java installiert sein. Das habt ihr aber wahrscheinlich sowieso schon, ihr wollt ja schlie\u00dflich Java programmieren \ud83d\ude09<\/p>\n Im Folgenden gehen wir davon aus, dass ihr das Grundverst\u00e4ndnis aus dem vorangegangenen Artikel mitbringt. Falls euch was unklar ist, lest dort noch einmal nach<\/a>.<\/p>\n <\/p>\n Beginnen wir damit, ein neues Java-Projekt anzulegen. Diesmal allerdings nicht in unserer Lieblings-IDE, sondern als P<\/strong>roject O<\/strong>bject M<\/strong>odel – also POM. Wir beschreiben damit, was am Ende als Ergebnis herauskommen soll. Dies sieht im ersten Schritt wie folgt aus:<\/p>\n Wie erinnern uns an die Beschreibung unseres Moduls als GAV, also mit der g<\/strong>roupId, a<\/strong>rtifactId und v<\/strong>ersion. Unser Projekt soll den Namen HelloWorld<\/em> – was auch sonst \ud83d\ude09 – haben und zun\u00e4chst in der Version 1.0.0 als Schnappschuss – also als Version die sich noch in der Entwicklung befindet – ver\u00f6ffentlicht werden.<\/p>\n Was passiert nun, wenn wir Maven unser Modul bauen lassen? Probieren wir es aus und rufen dazu auf der Kommando-Zeile mvn package<\/strong> im unserem Projektverzeichnis in dem die pom.xml liegt auf. Maven ist so freundlich und kompiliert unseren Code – in diesem Fall haben wir noch keine Programmquellen -, f\u00fchrt alle Unit Tests aus und erstellt die Datei HelloWorld-1.0.0-SNAPSHOT.jar<\/strong> im Unterordner target<\/strong>.<\/p>\n <\/p>\n Legen wir eine typische Java-Klasse mit dem Namen HelloWorld.java<\/em> und diesem Inhalt an:<\/p>\n Die Ausgabe auf dem Standardausgabestrom soll also „Hello Maven-World“ sein. Aber wo legen wir die Datei zu unserer Klasse ab?<\/p>\n Maven arbeitet an vielen Stellen nach dem Prinzip „Convention over Configuration“. So auch bei den Verzeichnissen, in denen unsere Quelldateien abgelegt werden. Hier sieht Maven einen Standard f\u00fcr die Verzeichnisstruktur vor, an den sich alle Maven 3 Projekte halten sollten. Dieser sieht folgenderma\u00dfen aus:<\/p>\n Unsere obige Quelldatei legen wir demnach also im Verzeichnis \/src\/main\/java\/de\/invidit\/<\/strong> unter dem Namen HelloWorld.java<\/strong> an.<\/p>\n Was passiert nun, wenn wir mit Maven erneut unser Projekt bauen? Rufen wir mvn package<\/strong> also nochmal auf. Hmmm…die Ausgabe sieht genauso aus wir vorher, aber nun ist unser Code in der JAR-Datei enthalten, was wir \u00fcberpr\u00fcfen k\u00f6nnen, in dem wir unsere main()-Methode einfach mal aufrufen (dazu m\u00fcssen wir zuvor in das target-Verzeichnis wechseln):<\/p>\n Gro\u00dfartig! Aber das ist nur der Anfang. Bis hierhin bietet uns Maven noch keine Vorteile gegen\u00fcber unserer IDE.<\/p>\n <\/p>\n Die Ausgabe auf dem Standardausgabestrom ist nicht sonderlich elegant. Wir ersetzen diese lieber durch eine Ausgabe\u00a0 in eine Log-Datei. Aber – bevor wir die \u00c4nderung an unserem Code vornehmen, sichern wir diese durch Unit Tests ab. Dazu nutzen wir selbstverst\u00e4ndlich die bereits vorgestellten Bibliotheken JUnit und AsssertJ<\/a>.<\/p>\n Nach der Verzeichnisstruktur von oben liegt unsere Klasse HelloWorldTest.java<\/em> im Verzeichnis \/src\/test<\/span>\/java\/de\/invidit\/<\/strong>. Maven unterscheidet in der Struktur bereits zwischen Produktivem Quellcode und Testcode.<\/p>\n Um unser Projekt zu bauen, rufen wir erneut was auf? Genau: mvn package<\/strong>. Auf Grund der Standardverzeichnisstruktur von Maven wird unser Unit Test nach dem Kompilieren ausgef\u00fchrt.<\/p>\n WTF!? Maven kommt gar nicht erst zu unserem Test, da bereits das Kompilieren abbricht. Den Fehlermeldungen k\u00f6nnen wir entnehmen, dass sowohl JUnit als auch AssertJ nicht gefunden werden. Wo bekommen wir diese jetzt her?<\/p>\n>mvn -version\r\n\r\nApache Maven 3.1.1 (893ca28a1da9d5f51ac03827af98bb730128f9f2; 2013-06-28 04:15:32+0200)\r\nMaven home: D:\\Development\\maven\r\nJava version: 1.7.0, vendor: Oracle Corporation\r\nJava home: D:\\Programme\\Java\\jdk1.7.0\\jre\r\nDefault locale: de_DE, platform encoding: Cp1252\r\nOS name: \"windows 7\", version: \"6.1\", arch: \"amd64\", family: \"windows\"<\/pre>\n
Unser kleines Projekt<\/h1>\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n<project xmlns=\"http:\/\/maven.apache.org\/POM\/4.0.0\" \r\n\txmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\"\r\n\txsi:schemaLocation=\"http:\/\/maven.apache.org\/POM\/4.0.0 \r\n\thttp:\/\/maven.apache.org\/xsd\/maven-4.0.0.xsd\">\r\n <modelVersion>4.0.0<\/modelVersion>\r\n\r\n <groupId>de.invidit<\/groupId>\r\n <artifactId>HelloWorld<\/artifactId>\r\n <version>1.0.0-SNAPSHOT<\/version>\r\n<\/project><\/pre>\n
>mvn package\r\n\r\n[INFO] Scanning for projects...\r\n[INFO]\r\n[INFO] ------------------------------------------------------------------------\r\n[INFO] Building HelloWorld 1.0.0-SNAPSHOT\r\n[INFO] ------------------------------------------------------------------------\r\n[INFO]\r\n[...]\r\n[INFO] ------------------------------------------------------------------------\r\n[INFO] BUILD SUCCESS\r\n[INFO] ------------------------------------------------------------------------\r\n[INFO] Total time: 5.803s\r\n[INFO] Finished at: Tue Sep 15 19:39:00 CEST 2015\r\n[INFO] Final Memory: 8M\/122M\r\n[INFO] ------------------------------------------------------------------------<\/pre>\n
Unser Projekt macht auch was<\/h1>\n
package de.invidit.hello;\r\n\r\npublic class HelloWorld {\r\n\r\n\tpublic static void main(String[] args) {\r\n\t\tSystem.out.println(getHelloPhrase(\"Maven\"));\r\n\t}\r\n\r\n\tpublic static String getHelloPhrase(String name) {\r\n\t\treturn \"Hello \" + name + \"-World\";\r\n\t}\r\n}<\/pre>\n\n
\n
\n
\n
\n
\n
\n
\n
>java -cp HelloWorld-1.0.0-SNAPSHOT.jar de.invidit.hello.HelloWorld\r\n\r\nHello Maven-World<\/pre>\n
Vor dem Refaktorisieren schreiben wir nat\u00fcrlich Tests<\/h1>\n
public class HelloWorldTest extends TestCase {\r\n\r\n\tpublic void testGetHelloPhraseForGivenValueReturnsCorrectPhrase() throws Exception {\r\n\t\tString expected = \"Hello Maven-World\";\r\n\r\n\t\tString actual = HelloWorld.getHelloPhrase(\"Maven\");\r\n\r\n\t\tAssertions.assertThat(actual).isEqualTo(expected);\r\n\t}\r\n}<\/pre>\n> mvn package\r\n\r\n[...]\r\n[INFO] -------------------------------------------------------------\r\n[ERROR] COMPILATION ERROR :\r\n[INFO] -------------------------------------------------------------\r\n[ERROR] \\src\\test\\java\\de\\invidit\\hello\\HelloWorldTest.java:[10,22] error: package junit.framework does not exist\r\n[ERROR] \\src\\test\\java\\de\\invidit\\hello\\HelloWorldTest.java:[11,27] error: package org.assertj.core.api does not exist\r\n[ERROR] \\src\\test\\java\\de\\invidit\\hello\\HelloWorldTest.java:[13,36] error: cannot find symbol\r\n[ERROR] \\src\\test\\java\\de\\invidit\\hello\\HelloWorldTest.java:[20,2] error: cannot find symbol\r\n[INFO] 4 errors\r\n[INFO] -------------------------------------------------------------\r\n[INFO] ------------------------------------------------------------------------\r\n[INFO] BUILD FAILURE\r\n[INFO] ------------------------------------------------------------------------\r\n[INFO] Total time: 0.998s\r\n[INFO] Finished at: Tue Sep 15 20:33:25 CEST 2015\r\n[INFO] Final Memory: 14M\/154M\r\n[INFO] ------------------------------------------------------------------------\r\n[...]<\/pre>\n