{"id":1993,"date":"2017-03-24T11:56:17","date_gmt":"2017-03-24T06:26:17","guid":{"rendered":"https:\/\/www.wikitechy.com\/technology\/?p=1993"},"modified":"2017-03-28T16:40:47","modified_gmt":"2017-03-28T11:10:47","slug":"create-executable-jar-dependencies-using-maven","status":"publish","type":"post","link":"https:\/\/www.wikitechy.com\/technology\/create-executable-jar-dependencies-using-maven\/","title":{"rendered":"JAVA – How to create an executable JAR with dependencies using Maven"},"content":{"rendered":"

Maven<\/b><\/span><\/h4>\n
    \n
  • Mavenis a powerful project management tool that is based on POM (project object model). It is used for projects build, dependency and documentation.<\/li>\n
  • It simplifies the build process like ANT. But it is too much advanced than ANT.<\/li>\n
  • Current version of Maven is 3.<\/li>\n<\/ul>\n

    A JAR (Java <\/b>ARchive<\/b>)<\/b><\/span><\/h4>\n
      \n
    • JAR is a package file format typically used to aggregate many Java class files and associated metadata and resources (text, images, etc.) into one file for distribution.<\/li>\n<\/ul>\n

      TO CREATE A JAR FILE WITH MAVEN<\/b><\/span><\/h4>\n

      Create a simple Java project<\/b><\/u><\/span><\/p>\n

        \n
      • Create a Java project from the Maven quick start template.<\/li>\n<\/ul>\n
        javascript code<\/span> <\/div> 
        $ mvn archetype:generate -DgroupId=com.wikitechy.core.utils -DartifactId=dateUtils -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false<\/code><\/pre> <\/div>\n[ad type=”banner”]\n
          \n
        • The following files and folder structure will be created.<\/li>\n<\/ul>\n
           
           css code<\/span> <\/div> 
          .|____dateUtils| |____pom.xml| |____src| | |____main| | | |____java| | | | |____com| | | | | |____wikitechy| | | | | | |____core| | | | | | | |____utils| | | | | | | | |____App.java| | |____test| | | |____java| | | | |____com| | | | | |____wikitechy| | | | | | |____core| | | | | | | |____utils| | | | | | | | |____AppTest.java<\/code><\/pre> <\/div>\n
          Above folder structure is not enough, create a log4j.properties file <\/b>and put it in src<\/b>\/main\/resources\/log4j.properties<\/b>, just create the resources folder manually.<\/p>\n
          log4j.properties<\/b><\/span><\/h4>\n
           
           java code<\/span> <\/div> 
          # Root logger optionlog4j.rootLogger=DEBUG, stdout# Direct log messages to stdoutlog4j.appender.stdout=org.apache.log4j.ConsoleAppenderlog4j.appender.stdout.layout=org.apache.log4j.PatternLayoutlog4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n<\/code><\/pre> <\/div>\n
          Make it support Eclipse.<\/b><\/span><\/h4>\n
           
           java code<\/span> <\/div> 
          $ mvn eclipse:eclipse<\/code><\/pre> <\/div>\n[ad type=”banner”]\n
          Update Pom.xml<\/b><\/span><\/h4>\n
          Update pom.xml to declare both log4j<\/b> and the jodatime<\/b> dependencies<\/b>, for output to a jar format, make sure the packaging is set to \u201cjar\u201d.<\/p>\n
          pom.xml<\/b><\/span><\/h4>\n
           
           html code<\/span> <\/div> 
          <project xmlns="http:\/\/maven.apache.org\/POM\/4.0.0"\txmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance"\txsi:schemaLocation="http:\/\/maven.apache.org\/POM\/4.0.0\thttp:\/\/maven.apache.org\/maven-v4_0_0.xsd">\t<modelVersion>4.0.0<\/modelVersion>\t<groupId>com.wikitechy.core.utils<\/groupId>\t<artifactId>dateUtils<\/artifactId><!-- Output to jar format -->\t<packaging>jar<\/packaging>\t<version>1.0-SNAPSHOT<\/version>\t<name>dateUtils<\/name>\t<url>http:\/\/maven.apache.org<\/url><properties>\t\t<jdk.version>1.7<\/jdk.version>\t\t<jodatime.version>2.5<\/jodatime.version>\t\t<junit.version>4.11<\/junit.version>\t\t<log4j.version>1.2.17<\/log4j.version>\t<\/properties>\t<dependencies>\t\t<dependency>\t\t\t<groupId>junit<\/groupId>\t\t\t<artifactId>junit<\/artifactId>\t\t\t<version>${junit.version}<\/version>\t\t\t<scope>test<\/scope>\t\t<\/dependency>\t\t<dependency>\t\t\t<groupId>joda-time<\/groupId>\t\t\t<artifactId>joda-time<\/artifactId>\t\t\t<version>${jodatime.version}<\/version>\t\t<\/dependency><dependency>\t\t\t<groupId>log4j<\/groupId>\t\t\t<artifactId>log4j<\/artifactId>\t\t\t<version>${log4j.version}<\/version>\t\t<\/dependency>\t<\/dependencies>\t<build>\t\t<finalName>dateutils<\/finalName>\t\t<plugins>\t\t\t<!-- download source code in Eclipse, best practice -->\t\t\t<plugin>\t\t\t\t<groupId>org.apache.maven.plugins<\/groupId>\t\t\t\t<artifactId>maven-eclipse-plugin<\/artifactId>\t\t\t\t<version>2.9<\/version>\t\t\t\t<configuration>\t\t\t\t\t<downloadSources>true<\/downloadSources>\t\t\t\t\t<downloadJavadocs>false<\/downloadJavadocs>\t\t\t\t<\/configuration>\t\t\t<\/plugin><!-- Set a JDK compiler level -->\t\t\t<plugin>\t\t\t\t<groupId>org.apache.maven.plugins<\/groupId>\t\t\t\t<artifactId>maven-compiler-plugin<\/artifactId>\t\t\t\t<version>2.3.2<\/version>\t\t\t\t<configuration>\t\t\t\t\t<source>${jdk.version}<\/source>\t\t\t\t\t<target>${jdk.version}<\/target>\t\t\t\t<\/configuration>\t\t\t<\/plugin>\t\t\t<!-- Make this jar executable -->\t\t\t<plugin>\t\t\t\t<groupId>org.apache.maven.plugins<\/groupId>\t\t\t\t<artifactId>maven-jar-plugin<\/artifactId>\t\t\t\t<configuration><!-- DO NOT include log4j.properties file in our Jar -->\t\t\t\t  <excludes>\t\t\t\t\t<exclude>**\/log4j.properties<\/exclude>\t\t\t\t  <\/excludes>\t\t\t\t  <archive>\t\t\t\t\t<manifest><!-- Jar file entry point -->\t\t\t\t\t\t<mainClass>com.wikitechy.core.utils.App<\/mainClass>\t\t\t\t\t<\/manifest>\t\t\t\t  <\/archive>\t\t\t\t<\/configuration>\t\t\t<\/plugin>\t\t<\/plugins>\t<\/build><\/project><\/code><\/pre> <\/div>\n
          Update App.java<\/b><\/span><\/h4>\n
          App.java<\/b><\/span><\/h4>\n
           
           java code<\/span> <\/div> 
          package com.wikitechy.core.utils;import org.apache.log4j.Logger;import org.joda.time.LocalDate;public class App {\tprivate static final Logger logger = Logger.getLogger(App.class);\tpublic static void main(String[] args) {\t\tSystem.out.println(getLocalCurrentDate());}private static String getLocalCurrentDate() {\t\tif (logger.isDebugEnabled()) {\t\t\tlogger.debug("getLocalCurrentDate() is executed!");\t\t}\t\tLocalDate date = new LocalDate();\t\treturn date.toString();\t}}<\/code><\/pre> <\/div>\n
            \n
          • Thus this project has two dependencies : log4j <\/b>and jodatime<\/b>.<\/li>\n<\/ul>\n
            Working with Dependencies<\/b><\/span><\/h4>\n
            How to add dependencies in a jar<\/b><\/span><\/h4>\n
              \n
            • we can put both log4j.jar and jodatime.jar inside the final.jar, but our classes are unable to call other classes which is inside the unpack log4j.jar, Java jar is designed like this, unless we can create a special class loader like one-jar plugin.<\/li>\n
            • Alternatively, use maven-assembly-plugin to extract all dependency jars into raw classes, and group it together.<\/li>\n
            • Try one-jar plugin, it will create a fat-jar, which includes the entire project\u2019s dependencies into a single jar file.
              \n<\/b><\/li>\n<\/ul>\n
              Solution<\/b><\/span><\/h4>\n
                \n
              • Copy the entire project\u2019s dependencies to a pre-defined folder, and define the dependency class path in the jar\u2019s manifest file.<\/li>\n
              • The updated and final pom.xml, to use maven-dependency-plugin to copy all dependencies to target\/dependency-jars\/ folder, and use maven-jar-plugin to add the dependency class path.<\/li>\n<\/ul>\n
                pom.xml<\/b><\/span><\/h4>\n
                 
                 html code<\/span> <\/div> 
                <project xmlns="http:\/\/maven.apache.org\/POM\/4.0.0"\txmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance"\txsi:schemaLocation="http:\/\/maven.apache.org\/POM\/4.0.0\thttp:\/\/maven.apache.org\/maven-v4_0_0.xsd">\t<modelVersion>4.0.0<\/modelVersion>\t<groupId>com.wikitechy.core.utils<\/groupId>\t<artifactId>dateUtils<\/artifactId>\t<packaging>jar<\/packaging>\t<version>1.0-SNAPSHOT<\/version>\t<name>dateUtils<\/name>\t<url>http:\/\/maven.apache.org<\/url><properties>\t\t<jdk.version>1.7<\/jdk.version>\t\t<jodatime.version>2.5<\/jodatime.version>\t\t<junit.version>4.11<\/junit.version>\t\t<log4j.version>1.2.17<\/log4j.version>\t\t<\/properties><dependencies>\t\t<dependency>\t\t\t<groupId>junit<\/groupId>\t\t\t<artifactId>junit<\/artifactId>\t\t\t<version>${junit.version}<\/version>\t\t\t<scope>test<\/scope>\t\t<\/dependency>\t\t<dependency>\t\t\t<groupId>joda-time<\/groupId>\t\t\t<artifactId>joda-time<\/artifactId>\t\t\t<version>${jodatime.version}<\/version>\t\t<\/dependency><dependency>\t\t\t<groupId>log4j<\/groupId>\t\t\t<artifactId>log4j<\/artifactId>\t\t\t<version>${log4j.version}<\/version>\t\t<\/dependency>\t<\/dependencies>\t<build>\t\t<finalName>dateutils<\/finalName>\t\t<plugins>\t\t\t<!-- download source code in Eclipse, best practice -->\t\t\t<plugin>\t\t\t\t<groupId>org.apache.maven.plugins<\/groupId>\t\t\t\t<artifactId>maven-eclipse-plugin<\/artifactId>\t\t\t\t<version>2.9<\/version>\t\t\t\t<configuration>\t\t\t\t\t<downloadSources>true<\/downloadSources>\t\t\t\t\t<downloadJavadocs>false<\/downloadJavadocs>\t\t\t\t<\/configuration>\t\t\t<\/plugin><dependency>\t\t\t<groupId>log4j<\/groupId>\t\t\t<artifactId>log4j<\/artifactId>\t\t\t<version>${log4j.version}<\/version>\t\t<\/dependency>\t<\/dependencies>\t<build>\t\t<finalName>dateutils<\/finalName>\t\t<plugins>\t\t\t<!-- download source code in Eclipse, best practice -->\t\t\t<plugin>\t\t\t\t<groupId>org.apache.maven.plugins<\/groupId>\t\t\t\t<artifactId>maven-eclipse-plugin<\/artifactId>\t\t\t\t<version>2.9<\/version>\t\t\t\t<configuration>\t\t\t\t\t<downloadSources>true<\/downloadSources>\t\t\t\t\t<downloadJavadocs>false<\/downloadJavadocs>\t\t\t\t<\/configuration>\t\t\t<\/plugin><!-- Set a compiler level -->\t\t\t<plugin>\t\t\t\t<groupId>org.apache.maven.plugins<\/groupId>\t\t\t\t<artifactId>maven-compiler-plugin<\/artifactId>\t\t\t\t<version>2.3.2<\/version>\t\t\t\t<configuration>\t\t\t\t\t<source>${jdk.version}<\/source>\t\t\t\t\t<target>${jdk.version}<\/target>\t\t\t\t<\/configuration>\t\t\t<\/plugin><!-- Make this jar executable -->\t\t\t<plugin>\t\t\t\t<groupId>org.apache.maven.plugins<\/groupId>\t\t\t\t<artifactId>maven-jar-plugin<\/artifactId>\t\t\t\t<configuration>\t\t\t\t  <excludes>\t\t\t\t\t<exclude>**\/log4j.properties<\/exclude>\t\t\t\t  <\/excludes><archive><manifest><addClasspath>true<\/addClasspath><mainClass>com.wikitechy.core.utils.App<\/mainClass><classpathPrefix>dependency-jars\/<\/classpathPrefix><\/manifest><\/archive><\/configuration><\/plugin><!-- Copy project dependency -->\t\t\t<plugin>\t\t\t\t<groupId>org.apache.maven.plugins<\/groupId>\t\t\t\t<artifactId>maven-dependency-plugin<\/artifactId>\t\t\t\t<version>2.5.1<\/version>\t\t\t\t<executions>\t\t\t\t <execution><id>copy-dependencies<\/id>\t\t\t\t\t<phase>package<\/phase>\t\t\t\t\t<goals>\t\t\t\t\t\t<goal>copy-dependencies<\/goal>\t\t\t\t\t<\/goals>\t\t\t\t\t<configuration> <!-- exclude junit, we need runtime dependency only -->\t\t\t<includeScope>runtime<\/includeScope>\t\t\t<outputDirectory>${project.build.directory}\/dependency-jars\/<\/outputDirectory>\t\t\t\t\t<\/configuration>\t\t\t\t  <\/execution>\t\t\t\t<\/executions>\t\t\t<\/plugin>\t\t<\/plugins>\t<\/build><\/project><\/code><\/pre> <\/div>\n[ad type=”banner”]\n
                final Jar file<\/b><\/span><\/h4>\n
                Package<\/b><\/span><\/h4>\n
                 
                 javascript code<\/span> <\/div> 
                $ mvn package<\/code><\/pre> <\/div>\n
                  \n
                • Review the folder structure in the target folder<\/li>\n<\/ul>\n
                  \"\"<\/p>\n
                  A dateutils.jar is created, and the entire project runtime dependencies (excluded junit) are copied to target\/dependency-jars\/ folder.<\/p>\n
                  List out the dateutils.jar content :<\/b><\/span><\/h4>\n
                   
                   javascript code<\/span> <\/div> 
                  $ jar tf target\/dateutils.jarMETA-INF\/META-INF\/MANIFEST.MFcom\/com\/wikitechy\/com\/wikitechy\/core\/com\/wikitechy\/core\/utils\/com\/wikitechy\/core\/utils\/App.classMETA-INF\/maven\/META-INF\/maven\/com.wikitechy.core.utils\/META-INF\/maven\/com.wikitechy.core.utils\/dateUtils\/META-INF\/maven\/com.wikitechy.core.utils\/dateUtils\/pom.xmlMETA-INF\/maven\/com.wikitechy.core.utils\/dateUtils\/pom.properties<\/code><\/pre> <\/div>\n
                  Extracts and review the content of MANIFEST.MF, the dependencies are added in the Class-Path.<\/b><\/p>\n
                   
                   javascript code<\/span> <\/div> 
                  META_INF\/MANIFEST.MFManifest-Version: 1.0Built-By: wikitechyBuild-Jdk: 1.7.0_05Class-Path: dependency-jars\/joda-time-2.5.jar dependency-jars\/log4j-1.2.17.jarCreated-By: Apache Maven 3.1.1Main-Class: com.wikitechy.core.utils.AppArchiver-Version: Plexus Archiver<\/code><\/pre> <\/div>\n[ad type=”banner”]\n
                  Run it<\/b><\/span><\/h4>\n
                   
                   javascript code<\/span> <\/div> 
                  $ java -jar target\/dateutils.jarlog4j:WARN No appenders could be found for logger (com.wikitechy.core.utils.App).log4j:WARN Please initialize the log4j system properly.log4j:WARN See http:\/\/logging.apache.org\/log4j\/1.2\/faq.html#noconfig for more info.2014-10-19<\/code><\/pre> <\/div>\n
                  Where is log4j.properties?<\/b><\/span><\/h4>\n
                  To exclude the log4j.properties in the jar file, to avoid issues like multiple log4j.properties files in classpath.<\/p>\n
                  We can still pass in the log4j properties via the log4j.configuration system property like this :<\/p>\n
                   
                   javascript code<\/span> <\/div> 
                  $ java -jar -Dlog4j.configuration=file:\/full_path\/log4j.properties target\/dateutils.jar17:09:15,385 DEBUG App:18 - getLocalCurrentDate() is executed!<\/code><\/pre> <\/div>\n","protected":false},"excerpt":{"rendered":"
                  Maven Mavenis a powerful project management tool that is based on POM (project object model). It is used for projects build, dependency and documentation. It simplifies the build process like ANT. But it is too much advanced than ANT. Current version of Maven is 3. A JAR (Java ARchive) JAR is a package file format […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[26,24,275],"tags":[4251,4246,4253,4254,4249,4248,4242,4238,4240,4241,4244,4243,4239,4252,4245,4250,4247,2177],"class_list":["post-1993","post","type-post","status-publish","format-standard","hentry","category-css","category-html","category-javascript","tag-building-a-runnable-jar-with-maven-2","tag-can-i-add-jars-to-maven-2-build-classpath-without-installing-them","tag-how-can-i-create-an-executable-jar-without-dependencies-using-maven","tag-how-can-i-create-an-executable-jar-without-including-3pp-dependencies-using-maven","tag-including-dependencies-in-a-jar-with-maven","tag-java-how-do-i-build-standalone-distributions-of-maven-based-projects","tag-maven-assembly-plugin-include-dependency-jars","tag-maven-build-jar-with-dependencies-command-line","tag-maven-create-executable-jar-with-external-dependencies","tag-maven-jar-with-dependencies-example","tag-maven-maven-assembly-plugin","tag-maven-shade-plugin-executable-jar-with-dependencies","tag-maven-jar-plugin-include-dependencies","tag-maven-add-a-dependency-to-a-jar-by-relative-path","tag-onejar-maven-plugin","tag-problem-building-executable-jar-with-maven","tag-why-does-maven-have-such-a-bad-rep","tag-why-is-it-faster-to-process-a-sorted-array-than-an-unsorted-array"],"_links":{"self":[{"href":"https:\/\/www.wikitechy.com\/technology\/wp-json\/wp\/v2\/posts\/1993","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.wikitechy.com\/technology\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.wikitechy.com\/technology\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.wikitechy.com\/technology\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.wikitechy.com\/technology\/wp-json\/wp\/v2\/comments?post=1993"}],"version-history":[{"count":0,"href":"https:\/\/www.wikitechy.com\/technology\/wp-json\/wp\/v2\/posts\/1993\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.wikitechy.com\/technology\/wp-json\/wp\/v2\/media?parent=1993"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.wikitechy.com\/technology\/wp-json\/wp\/v2\/categories?post=1993"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.wikitechy.com\/technology\/wp-json\/wp\/v2\/tags?post=1993"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}