By default maven is generating a small JAR file, which just contains your compiled classes and other project files. If you want to have a single JAR file which also includes all dependent JAR files, you have to create a uber JAR. You can do that with the maven shade plugin. Just put this lines of xml into your pom.xml.

</pre>
<build>
<plugins>
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-shade-plugin</artifactId>
	<version>1.4</version>
	<executions>
		<execution>
			<phase>package</phase>
			<goals>
				<goal>shade</goal>
			</goals>
			<configuration>
				<shadedArtifactAttached>true</shadedArtifactAttached>
				<shadedClassifierName>all</shadedClassifierName>
			</configuration>
		</execution>
	</executions>
      </plugin>
   </plugins>
 </build>
<pre>

In Maven you can solve every problem. You just need enough XML code for that. If you still have problems, than probably your pom.xml is to short.

Maven2 sieht vor produktiven Code, SourceCode und JavaDoc in getrennten JAR-Archiven zu hinterlegen. Idealerweise liegen zu einem Software-Artefakt also drei JAR-Files vor. Hier ein Beispiel:

ploinFaces-1.4.5.jar
ploinFaces-1.4.5-javadoc.jar
ploinFaces-1.4.5-sources.jar

Bei einem Aufruf wie “mvn compile” wird standardmäßig immer nur der produktive Code herunter geladen. Wenn auch die JAR-Files mit den classifiern “javadoc” und “sources” von Maven herunter geladen werden sollen, dann muss das explizit mit angegeben werden. Der folgende Aufruf lädt von allen Abhängigkeiten eines Projektes die Sourcen und das JavaDoc herunter und bindet auch alles richtig in Eclipse ein

mvn -DdownloadJavadocs -DdownloadSources eclipse:eclipse

und entsprechend für IDEA:

mvn -DdownloadJavadocs -DdownloadSources idea:idea

Leider halten sich nicht alle OpenSource-Projekte an die Vorgaben von Maven und so gibt es bedauerlicherweise viele Projekte deren SourceCode und JavaDoc nicht in M2-Repositorys hinterlegt sind.

Maven2 kann von http://maven.apache.org/ als zip-Datei heruntergeladen werden. Nach dem enpacken muss die Umgebungsvariable PATH angepasst werden und drei weitere Umgebungsvariablen müssen erstellt werden damit Maven2 aus der Kommandozeile aufgerufen werden kann. Gehen wir davon aus das Maven2 in den folgenden Ordner entpackt wurde:

/Users/jan/apache-maven-2.0.9/

Um die benötigten Umgebungsvariablen nicht jedesmal aus der Kommandozeile exportieren zu müssen, macht es Sinn die /etc/profile zu erweitern. Ausgehend vom oberen Verzeichniss sollten folgende Einträge in der /etc/profile vorhanden sein.

export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Home
export M2_HOME=/Users/jan/apache-maven-2.0.9
export M2=$M2_HOME/bin
export MAVEN_OPTS="-Xms256m -Xmx1024m -XX:MaxPermSize=1024m"
export PATH=$PATH:$M2

Jetzt noch eine neue Shell/Bash starten oder einfach den Befehl “bash” absetzen um die neuen Einstellungen aus der /etc/profile zu laden. Und das war es auch schon. Maven2 ist fertig installiert auf dem Mac. Der folgende Befehl sollte die Java- und Maven2 Version ausgeben:

mvn --version

In Maven2 ist es möglich die Versionen von Softwareartefakten dynamisch an zu geben. Die folgende Versionsangabe bezieht sich immer auf die aktuellste Version einer Abhängigkeit, aber der Version 1.0.

<version>[1,0,)</version>

Um eine bestimmtet Version zu blocken, z.B. die 1.1, ist folgender Eintrage nötig.

<version>(,1.0],[1.2,)</version>

Wenn ein Softwareartefakt in einem bestimmten Versionsbereich akzeptiert werden soll ist folgendes Beispiel hilfreich.

<version>[1.0,2.0]</version>

Im obrigen Beispiel sind nur Versionen zwischen 1.0 und 2.0 zulässig.

maven2 kann von http://maven.apache.org/ als zip-Datei heruntergeladen werden. Nach dem enpacken muss die Umgebungsvariable PATH angepasst werden und drei weitere Umgebungsvariablen muessen erstellt werden damit maven2 aus der Kommandozeile aufgerufen werden kann. Die PATH sollte erweitert werden um den Pfad zum maven2 Verzeichnis(das ist das entpackte Verzeichnis) + “/bin”.

export PATH=$PATH:pathToMaven2/bin

Als naechstes sollte die M2_HOME gesetzt werden.

export M2_HOME=pathToMaven2

Anschliesend die M2.

export M2=pathToMaven2/bin

und die JAVA_HOME muss natuerlich gesetzt sein.

export JAVA_HOME=pathToYourJavaHome

Wenn mit eclipse gearbeitet wird, muss in eclipse die Classpath Variable M2_REPO eingerichtet werden. Siehe hierzu folgendes Bild.

Gestern habe ich, nach dem Befehl “mvn site”, folgende Fehlermeldung erhalten.

The skin does not exist: Unable to determine the release version

Der Fehler tauchte auf, weil maven2 kein skin gefunden hat. Die ganze Zeit davor hats geklappt. Nun den, als ich das ganze explizit angegeben habe, hat es wieder funktioniert.

<skin>
<groupId>org.apache.maven.skins</groupId>
<artifactId>maven-default-skin</artifactId>
<version>1.0</version>
</skin>

With this command you can create an Archetype from your existing project:

mvn archetype:create-from-project

Here are some useful Maven2 Repositorys listed.

EclipseLink:

<repository>
  <id>EclipseLink Repo</id>
  <url>http://www.eclipse.org/downloads/download.php?r=1&nf=1&file=/rt/eclipselink/maven.repo</url>
</repository>

PLOIN Repository, containing ploinFaces and ploinMailFacotry:

<repository>
  <id>ploinPublic</id>
  <name>ploinPublic</name>
  <url>http://ploin-m2.de/nexus/content/groups/public/</url>
</repository>

JSF 2.0, java.net:

<repository>
  <id>maven2-repository.dev.java.net</id>
  <name>Java.net Repository for Maven 2</name>
  <url>http://download.java.net/maven/2/</url>
  <layout>default</layout>
</repository>

Ibiblio, mirror of M2:

<repository>
 <id>ibiblio.org</id>
 <name>ibiblio Repository for Maven 2</name>
 <url>http://mirrors.ibiblio.org/pub/mirrors/maven2/</url>
 <layout>default</layout>
 </repository>

Codehaus

<repository>
 <id>repository.codehaus.org</id>
 <name>Codehaus Repository</name>
 <url>http://repository.codehaus.org/</url>
 </repository>

Selenium:

<repository>
 <id>openqa-releases</id>
 <name>OpenQA Releases</name>
 <url>http://archiva.openqa.org/repository/releases/</url>
 <releases>
 <enabled>true</enabled>
 </releases>
 <snapshots>
 <enabled>false</enabled>
 </snapshots>
 </repository>
 <repository>
 <id>openqa-snapshots</id>
 <name>OpenQA Snapshots</name>
 <url>http://archiva.openqa.org/repository/snapshots/</url>
 <releases>
 <enabled>false</enabled>
 </releases>
 <snapshots>
 <enabled>true</enabled>
 </snapshots>
 </repository>
 <repository>
 <id>openqa-thirdparty</id>
 <name>OpenQA Third Party</name>
 <url>http://archiva.openqa.org/repository/thirdparty/</url>
 <releases>
 <enabled>true</enabled>
 </releases>
 <snapshots>
 <enabled>false</enabled>
 </snapshots>
 </repository>

Spring-Framework:

<repository>
 <id>springsource maven repo</id>
 <name>springsource maven repo</name>
 <url>http://maven.springframework.org/milestone</url>
 </repository>

JBoss:

<repository>
 <id>repository.jboss.org</id>
 <name>Jboss Repository for Maven</name>
 <url>http://repository.jboss.org/maven2/</url>
 </repository>
 <repository>
 <id>snapshots.jboss.org</id>
 <name>Jboss Snapshots Repository for Maven</name>
 <url>http://snapshots.jboss.org/maven2/</url>
 <snapshots>
 </snapshots>
 </repository>

maven2 kann von http://maven.apache.org/ als zip-Datei heruntergeladen werden. Nach dem enpacken muss die Umgebungsvariable PATH angepasst werden und drei weitere Umgebungsvariablen muessen erstellt werden damit maven2 aus der Kommandozeile aufgerufen werden kann. Die PATH sollte erweitert werden um den Pfad zum maven2 Verzeichnis(das ist das entpackte Verzeichnis) + “/bin”.

export PATH=$PATH:pathToMaven2/bin

Als naechstes sollte die M2_HOME gesetzt werden.

export M2_HOME=pathToMaven2

Anschliesend die M2.

export M2=pathToMaven2/bin

und die JAVA_HOME muss natuerlich gesetzt sein.

export JAVA_HOME=pathToYourJavaHome

Wenn mit eclipse gearbeitet wird, muss in eclipse die Classpath Variable M2_REPO eingerichtet werden. Siehe hierzu folgendes Bild.