Stvaranje izvršnog JAR-a s ovisnostima pomoću Mavena

Pakiranje Mavenovih projekata u jedan izvršni JAR

Kada radite s Java projektima, često je potrebno zapakirati vašu aplikaciju u jednu izvršnu JAR datoteku radi lakše distribucije. Maven, moćan alat za automatizaciju izrade, omogućuje razvojnim programerima da uključe sve potrebne ovisnosti unutar ovog jednog izlaznog JAR-a.

Ovaj će vas članak voditi kroz korake potrebne za konfiguriranje vašeg Maven projekta za uključivanje svih JAR-ova ovisnosti u vaš konačni izvršni JAR. Slijedeći ove upute, pojednostavit ćete proces postavljanja i osigurati nesmetan rad vaše aplikacije u različitim okruženjima.

Stvaranje i pokretanje izvršnog JAR-a s Mavenom

Gore navedene skripte pokazuju kako konfigurirati Maven projekt za pakiranje svih njegovih ovisnosti u jednu izvršnu JAR datoteku. Prva skripta je Maven pom.xml datoteku koja sadrži konfiguraciju projekta. Unutar ove datoteke, <plugin> oznaka se koristi za definiranje dodatka Maven Assembly. Ovaj je dodatak ključan za stvaranje izvršnog JAR-a koji uključuje sve ovisnosti. The <descriptorRefs> unutar konfiguracije dodatka navodi upotrebu jar-with-dependencies deskriptor, koji osigurava da su sve ovisnosti projekta pakirane u konačnu JAR datoteku. The <mainClass> oznaka unutar <manifest> odjeljak je bitan jer govori Mavenu koja klasa sadrži glavnu metodu koju treba pokrenuti kada se JAR izvrši.

The <execution> blok unutar konfiguracije dodatka mjesto je gdje se radnja događa. Određuje cilj dodatka single treba izvršiti tijekom package faza životnog ciklusa izgradnje. To je ono što pokreće stvaranje JAR datoteke sa ovisnostima. Druga skripta je jednostavna instrukcija iz naredbenog retka: mvn clean package. Ova naredba čisti projekt (uklanjajući prethodne artefakte izgradnje), kompilira izvorni kod, pokreće testove i pakira projekt u JAR datoteku. Konačna JAR datoteka bit će smještena u target imenik projekta i nazvan prema artifactId i version navedeno u pom.xml.

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>my-app</artifactId>
    <version>1.0-SNAPSHOT</version>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-assembly-plugin</artifactId>
                <version>3.3.0</version>
                <configuration>
                    <descriptorRefs>
                        <descriptorRef>jar-with-dependencies</descriptorRef>
                    </descriptorRefs>
                    <archive>
                        <manifest>
                            <mainClass>com.example.MainClass</mainClass>
                        </manifest>
                    </archive>
                </configuration>
                <executions>
                    <execution>
                        <id>make-assembly</id>
                        <phase>package</phase>
                        <goals>
                            <goal>single</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

mvn clean package
# This command will compile the code, run the tests, and create the JAR file
# The JAR file will include all dependencies specified in the pom.xml
# It will be located in the target directory of the project
# The final JAR file will be named my-app-1.0-SNAPSHOT-jar-with-dependencies.jar

# To run the JAR file, use the following command:
java -jar target/my-app-1.0-SNAPSHOT-jar-with-dependencies.jar
# Ensure that the mainClass specified in the pom.xml is correct
# This will start your application with all dependencies included

Napredne Maven tehnike za ovisnosti o pakiranju

Osim osnovne konfiguracije za stvaranje izvršnog JAR-a s Mavenom, postoje dodatne tehnike koje mogu poboljšati vaš proces izgradnje. Jedna takva tehnika uključuje korištenje shade dodatak umjesto assembly uključiti. Maven Shade Plugin nudi naprednije značajke za stvaranje uber-JAR-ova (JAR-ova s ​​uključenim ovisnostima). Omogućuje vam preimenovanje paketa kako biste izbjegli sukobe staza klasa i pruža bolje rukovanje dupliciranim klasama i resursima. Osim toga, nudi preciznu kontrolu nad tim koje su ovisnosti uključene u konačni JAR.

Drugi važan aspekt je upravljanje veličinom vaše JAR datoteke. Velike JAR datoteke mogu biti glomazne i spore za prijenos ili učitavanje. The maven-shade-plugin može pomoći u tome dopuštajući vam da isključite nepotrebne datoteke i klase, čime se smanjuje veličina konačnog JAR-a. Također možete konfigurirati dodatak za minimiziranje JAR-a uklanjanjem nebitnih informacija kao što su neiskorištene klase ili suvišni resursi. Ove napredne konfiguracije mogu biti osobito korisne pri radu na velikim projektima s brojnim ovisnostima.

Zaključne misli o Mavenovim izvršnim JAR-ovima

Stvaranje izvršnog JAR-a s ovisnostima pomoću Mavena pojednostavljuje proces postavljanja Java aplikacija. Ispravnim konfiguriranjem pom.xml datoteku i koristeći dodatke poput Maven Assembly Plugin ili Maven Shade Plugin, programeri mogu upakirati sve potrebne ovisnosti u jednu JAR datoteku. Ovaj pristup osigurava da aplikacija može raditi besprijekorno u različitim okruženjima, čineći distribuciju i izvođenje jednostavnim. Slijeđenje ovih koraka pomoći će vam da učinkovito upravljate ovisnostima vašeg projekta i stvorite pouzdane, izvršne JAR datoteke.