196

I've heard people say that they create a fat JAR and deploy it. What do they actually mean ?

5

6 Answers 6

153

The different names are just ways of packaging Java applications.

Skinny – Contains only the bits you literally type into your code editor, and nothing else.

Thin – Contains all of the above plus the application’s direct dependencies of your application (db drivers, utility libraries, etc.).

Hollow – The inverse of thin. It contains only the bits needed to run your application but does not contain the application itself. Basically a pre-packaged “application server” to which you can later deploy your application, in the same style as traditional Java EE application servers, but with important differences.

Fat/Uber – Contains the bit you literally write yourself plus the direct dependencies of your application PLUS the bits needed to run your application “on its own”.

Source: Article from Dzone

Visual representation of JAR types

5
  • 19
    Best answer IMO since it also gives comparison to other jar types.
    – Grizz
    Sep 5, 2019 at 16:53
  • 1
    Wouldn't hollow be the inverse of skinny rather than thin? The inverse of thin would be none of your code and all the dependencies your code doesn't use. :-)
    – greymatter
    Oct 31, 2019 at 17:02
  • Is java runtime able to support running Fat jar?
    – Nick Wills
    Nov 16, 2022 at 14:15
  • @NickWills Yes it should
    – Mark Han
    Nov 16, 2022 at 20:46
  • What if I want all my app dependencies as a single jar? What is that called?
    – Sriman S
    Dec 14, 2023 at 9:05
117

The fat jar is the jar, which contains classes from all the libraries, on which your project depends and, of course, the classes of current project.

In different build systems fat jar is created differently, for example, in Gradle one would create it with (instruction):

task fatJar(type: Jar) {
    manifest {
        attributes 'Main-Class': 'com.example.Main'
    }
    baseName = project.name + '-all'
    from { configurations.compile.collect { it.isDirectory() ? it : zipTree(it) } }
    with jar
}

In Maven it's being done this way (after setting up regular jar):

<pluginRepositories>
   <pluginRepository>
        <id>onejar-maven-plugin.googlecode.com</id>
        <url>http://onejar-maven-plugin.googlecode.com/svn/mavenrepo</url>
   </pluginRepository>
  </pluginRepositories>
<!-- ... -->

<plugin>
    <groupid>org.dstovall</groupid>
    <artifactid>onejar-maven-plugin</artifactid>
    <version>1.4.4</version>
    <executions>
        <execution>
            <configuration>
                <onejarversion>0.97</onejarversion>
                <classifier>onejar</classifier>
            </configuration>
            <goals>
                <goal>one-jar</goal>
            </goals>
        </execution>
   </executions>
</plugin>
6
  • 35
    So is "fat jar" just another name for "uber jar"?
    – gturri
    Nov 18, 2015 at 18:49
  • 15
    @gturri Yes, exactly. Nov 25, 2015 at 17:46
  • 4
    Why use some third party plugin when there is maven assembly plugin with it's jar-with-dependencies assembly?
    – MeTTeO
    Apr 10, 2016 at 7:23
  • 3
    @MeTTeO you can add your own answer without using the plugin. Apr 10, 2016 at 7:32
  • 3
    I think Uber-jar is a particular implementation of the bundling concept, whereas a fat jar is just the concept itself. Jul 10, 2016 at 16:25
20

Fat jar or uber jar is a jar which contains all project class files and resources packed together with all it's dependencies. There are different methods for achieving such effect:

  • dependencies' jars are copied into main jar and then loaded using special class loader (onejar, spring-boot-plugin:repackage)
  • dependencies' jars are extracted at the top of main jar hierarchy (maven-assembly-plugin with it's jar-with-dependencies assembly)
  • dependencies' jars are unpacked at the top of main jar hierarchy and their packages are renamed (maven-shade-plugin with shade goal)

Below sample assembly plugin configuration jar-with-dependencies:

<project>
  <!-- ... -->
  <build>
    <!-- ... -->
    <plugins>
      <plugin>
        <!-- NOTE: We don't need a groupId specification because the group is
             org.apache.maven.plugins ...which is assumed by default.
         -->
        <artifactId>maven-assembly-plugin</artifactId>
        <version>2.6</version>
        <configuration>
          <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
          </descriptorRefs>
          <classifier>
        </configuration>
        <!-- ... -->
</project>

For more detailed explanation: Uber-JAR at imagej.net

2
  • 2
    One thing to be careful about with FAT jars: conflicting versions of the same classes, across the different dependency jars. You can get really DIFFERENT (and often very frustrating-go-boom) effects depending on which approach you take (i.e. totally exploding all the jars and then reassembling them into one jar, vs. a jar-of-jars). Neither approach is necessarily better. Most build systems have some sort of "reverse dependency explorer" that can alert you to such version conflicts. Feb 14, 2019 at 18:51
  • Yes, unpacking multiple jars has some important drawbacks. Another one is the issue with META-INF files like signature files or SPI (services/package.Class) files which are overwritten by assembly plugin by default. Shade plugin has some special transformers which can merge the files if needed
    – MeTTeO
    Feb 12, 2020 at 9:01
13

In the case of an executable jar, another way to think about a fat jar is one you can execute by invoking:

java -jar myFatLibrary.jar

without the need for -cp / --classpath, or even double clicking the jar icon.

4
  • 2
    Keep in mind that -jar requires Main-Class header in MANIFEST.MF: docs.oracle.com/javase/tutorial/deployment/jar/run.html
    – MeTTeO
    Aug 4, 2017 at 6:28
  • 1
    That's the case even for non-fat jars, so not relevant really. Aug 5, 2017 at 22:05
  • what mvn flag can we use to skip building the fat jar file? Jan 27, 2019 at 19:56
  • By default it won't be fat. You have to explicitly use jar-with-dependencies, uberjar or shadow for mvn install to put anything other than your generated class files in there Jan 27, 2019 at 20:10
1

From the Gradle documentation:

In the Java space, applications and their dependencies typically used to be packaged as separate JARs within a single distribution archive. That still happens, but there is another approach that is now common: placing the classes and resources of the dependencies directly into the application JAR, creating what is known as an uber or fat JAR.

Here is a demonstrated of uberJar task in build.gradle file:

task uberJar(type: Jar) {
    archiveClassifier = 'uber'

    from sourceSets.main.output

    dependsOn configurations.runtimeClasspath
    from {
        configurations.runtimeClasspath.findAll { it.name.endsWith('jar') }.collect { zipTree(it) }
    }
}

In this case, we’re taking the runtime dependencies of the project — configurations.runtimeClasspath.files — and wrapping each of the JAR files with the zipTree() method. The result is a collection of ZIP file trees, the contents of which are copied into the uber JAR alongside the application classes.

3
0

A fat jar simply contains same classes as a classical jar + classes from all of their runtime dependencies.

With Jeka ( https://jeka.dev) you can achieve it programmatically :

JkPathTreeSet.of(Paths.get("classes")).andZips(
    Paths.get("bouncycastle-pgp-152.jar"),
    Paths.get("classgraph-4.8.41.jar"),
    Paths.get("ivy-2.4.0.jar")
).zipTo(Paths.get("fat.jar"));

or just by parametring Java plugin :

javaPlugin.getProject().getMaker().defineMainArtifactAsFatJar(true);

Not the answer you're looking for? Browse other questions tagged or ask your own question.