Difference between maven plugins ( assembly-plugins , jar-plugins , shaded-plugins)

Question

I am a beginner in maven and now I\'m confused with the difference between these maven plugins. Is these all create jar files? now my questions are

1. what\'s

Answer 1

1. maven-jar-plugin: This plugin provides the capability to build and sign JARs. But it just compiles the java files under src/main/java and src/main/resources/. It doesn't include the dependencies JAR files.
2. maven-assembly-plugin: This plugin extracts all dependency JARs into raw classes and groups them together. It can also be used to build an executable JAR by specifying the main class. It works in project with less dependencies only; for large project with many dependencies, it will cause Java class names to conflict.
3. maven-shade-plugin: It packages all dependencies into one uber-JAR. It can also be used to build an executable JAR by specifying the main class. This plugin is particularly useful as it merges content of specific files instead of overwriting them by relocating classes. This is needed when there are resource files that have the same name across the JARs and the plugin tries to package all the resource files together.

Refer: comparison:maven plugin jar,assembly,shade

Answer 2

Jar plugin

Let's see what the following command can tell.

mvn help:describe -Dplugin=org.apache.maven.plugins:maven-jar-plugin

It has 3 goals, help, jar and test-jar. I believe you are mostly interested in the jar goal, which according to the description does the following:

Build a JAR from the current project.

As a side note, executing mvn help:effective-pom on a project with packaging set to jar, shows that this plugin is automatically configured and gets executed during the package phase.

  <plugin>
    <artifactId>maven-jar-plugin</artifactId>
    <version>2.4</version>
    <executions>
      <execution>
        <id>default-jar</id>
        <phase>package</phase>
        <goals>
          <goal>jar</goal>
        </goals>
      </execution>
    </executions>
  </plugin>

Assembly plugin

This one serves a different purpose. It has 8 goals, but 6 of them are deprecated. So apart from the help goal, this leaves us with the single goal.

mvn help:describe -Dplugin=org.apache.maven.plugins:maven-assembly-plugin

Assemble an application bundle or distribution from an assembly descriptor. This goal is suitable either for binding to the lifecycle or calling directly from the command line (provided all required files are available before the build starts, or are produced by another goal specified before this one on the command line).

You may use the assembly plugin when you want to deliver more than your project's artifact (JAR, WAR, etc.), but the configuration goes in another file.

Shade plugin

The description of the main goal is a bit disappointing.

mvn help:describe -Dplugin=org.apache.maven.plugins:maven-shade-plugin

Mojo that performs shading delegating to the Shader component.

You mostly want to use this plugin if you want to produce an uber-jar, which is your artifact in a JAR with all its transitive dependencies in it.

Basicly, if you're building a library, you'll stick with the default JAR plugin. If you're building an application, you could consider using the shade plugin, though to me, it's kind of quick and dirty. If uber-jar is not your taste or the distribution cannot fit inside a single JAR (external configuration, native dependencies, etc.) then you should go for the assembly plugin.

Answer 3

Maven jar plugin simply creates a jar files with all SOURCE files [.class files compiled from .java files] packed in it but a jar itself cannot be deployed as there are many more dependencies like 3rd party jar files or other library jar files which are needed to executed SOURCE jar file. This where Maven assembly plugin comes into picture, it creates a package of an extension of your choice like .zip, .tar, .gz which is a fully deploy-able package with all dependencies packed in it. You can also specify directory structure in assembly plugin which should be created when package is deployed on serve