[JAVA] Kombinieren Sie JAR-Dateien mit Systembereich zu einer mit dem Maven Shade Plugin

Überblick

--Maven Shade Plugin ist ein Maven-Plugin, das abhängige JAR-Dateien in einer einzigen JAR-Datei kombiniert. --Maven Shade Plugin ruft JAR-Dateien im Repository ab, enthält jedoch keine JAR-Dateien, die im Systembereich (im lokalen Dateisystem) angegeben sind.

Dateiorganisation

├── lib
│   └── my-lib-999.999.jar ← jar-Datei, die nur lokal existiert
├── pom.xml
└── src
    └── main
        ├── java
        │   └── com
        │       └── example
        │           └── App.java
        └── resources
            └── my-app.Eigenschaften ← Allgemeine Ressourcendatei

pom.xml

<?xml version="1.0" encoding="UTF-8"?>

<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</version>

  <name>my-app</name>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>

  <dependencies>

    <!--Lokale JAR-Datei-->
    <dependency>
      <groupId>com.example</groupId>
      <artifactId>my-lib</artifactId>
      <version>999.999</version>
      <scope>system</scope>
      <systemPath>${basedir}/lib/my-lib-999.999.jar</systemPath>
    </dependency>

    <!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-core -->
    <dependency>
      <groupId>com.fasterxml.jackson.core</groupId>
      <artifactId>jackson-core</artifactId>
      <version>2.9.9</version>
      <scope>compile</scope><!-- default scope -->
    </dependency>
  </dependencies>

  <build>
    <resources>
      <!--Standardressourceneinstellungen-->
      <resource>
        <directory>${project.basedir}/src/main/resources</directory>
      </resource>
      <!--Einstellung, JAR-Datei mit Systemumfang als Ressource einzuschließen-->
      <resource>
        <directory>${project.basedir}</directory>
        <includes>
          <include>lib/*.jar</include>
        </includes>
      </resource>
    </resources>
    <plugins>
      <!--Einführung eines Plugins, das abhängige JAR-Dateien in einer einzigen JAR-Datei kombiniert-->
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-shade-plugin</artifactId>
        <version>3.2.1</version>
        <configuration>
          <!-- dependency-reduced-pom.Einstellungen, die keine XML generieren-->
          <createDependencyReducedPom>false</createDependencyReducedPom>
        </configuration>
        <executions>
          <execution>
            <phase>package</phase>
            <goals>
              <goal>shade</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>

</project>

Generieren Sie eine JAR-Datei

Generieren Sie eine JAR-Datei mit dem Befehl mvn package. Eine Warnmeldung wird angezeigt, da im Systembereich eine JAR-Datei angegeben ist, die diesmal jedoch ignoriert wird.

$ mvn package
[INFO] Scanning for projects...
[WARNING] 
[WARNING] Some problems were encountered while building the effective model for com.example:my-app:jar:1.0
[WARNING] 'dependencies.dependency.systemPath' for com.example:my-lib:jar should not point at files within the project directory, ${basedir}/lib/my-lib-999.999.jar will be unresolvable by dependent projects @ line 27, column 19
[WARNING] 
[WARNING] It is highly recommended to fix these problems because they threaten the stability of your build.
[WARNING] 
[WARNING] For this reason, future Maven versions might no longer support building such malformed projects.

Wenn Sie den Inhalt der generierten JAR-Datei überprüfen, enthält sie die im Systembereich angegebene lib / my-lib-999.999.jar. Die im Standardkompilierungsbereich angegebene Bibliothek wird nach dem Erweitern in die Klassendatei aufgenommen, während die im Systembereich angegebene Bibliothek als JAR-Datei enthalten ist. Selbst wenn Sie es als Glas eingeben, wird es ordnungsgemäß geladen, wenn es funktioniert, sodass es kein Problem gibt.

$ jar -t -f target/my-app-1.0.jar 
META-INF/
META-INF/MANIFEST.MF
lib/
lib/my-lib-999.999.jar
my-app.properties
com/
com/example/
com/example/App.class
META-INF/maven/
META-INF/maven/com.example/
META-INF/maven/com.example/my-app/
META-INF/maven/com.example/my-app/pom.xml
META-INF/maven/com.example/my-app/pom.properties
META-INF/LICENSE
META-INF/NOTICE
META-INF/maven/com.fasterxml.jackson.core/
META-INF/maven/com.fasterxml.jackson.core/jackson-core/
META-INF/maven/com.fasterxml.jackson.core/jackson-core/pom.properties
META-INF/maven/com.fasterxml.jackson.core/jackson-core/pom.xml
META-INF/services/
META-INF/services/com.fasterxml.jackson.core.JsonFactory
com/fasterxml/
com/fasterxml/jackson/
com/fasterxml/jackson/core/
com/fasterxml/jackson/core/Base64Variant.class
com/fasterxml/jackson/core/Base64Variants.class
com/fasterxml/jackson/core/FormatFeature.class
com/fasterxml/jackson/core/FormatSchema.class
(Folgendes wird weggelassen)

Als Nebeneffekt enthält das Original-my-app-1.0.jar, das normalerweise keine abhängigen JAR-Dateien enthält, auch JAR-Dateien mit Systembereich. Daher müssen Sie vorsichtig sein, wenn Sie original- *. Jar verwenden.

$ jar -t -f target/original-my-app-1.0.jar
META-INF/
META-INF/MANIFEST.MF
lib/
com/
com/example/
lib/my-lib-999.999.jar
my-app.properties
com/example/App.class
META-INF/maven/
META-INF/maven/com.example/
META-INF/maven/com.example/my-app/
META-INF/maven/com.example/my-app/pom.xml
META-INF/maven/com.example/my-app/pom.properties

Der Systemumfang wird überhaupt nicht empfohlen

Maven – Introduction to the Dependency Mechanism

System Dependencies Important note: This is deprecated.

Referenzmaterial

Recommended Posts

Kombinieren Sie JAR-Dateien mit Systembereich zu einer mit dem Maven Shade Plugin
Kombinieren Sie JAR-Dateien mit Systembereich zu einer mit dem Maven Dependency Plugin
Erstellen Sie Jar-Dateien mit einem Klick mit IntelliJ im Plugin-Ordner
Erste Schritte mit Gradle (bis Sie ein Java-Projekt erstellen und externe Bibliotheken in einer ausführbaren JAR kombinieren)
Erste Schritte mit Maven (bis Sie ein Java-Projekt erstellen und externe Bibliotheken in einer einzigen ausführbaren JAR kombinieren)
Automatisieren Sie Integrationstests mit dem Maven Failsafe-Plug-In