Maven：如何使用包含外部库的可运行 jar（uber jar）

Question

到目前为止，我使用 Ant 制作了可运行的 jar，并且没有任何问题。
但是我现在尝试 mavenize 我的项目，我真的不知道如何使用这个工具来做可运行的 jar。
我已经阅读了大量的教程（也在这里，在 Stackoverflow 上）、帮助、建议和......什么都没有。就我而言，它们都不起作用，这可能意味着我不了解一些基础知识。
我有这么简单的项目：

这是一个应用程序，使用 mysql-connector-java-5.1.24-bin.jar（放置在“lib”目录中）连接到 MySQL 数据库。
我想将此 jar 包含到最终的 jar (DBPreformatter.jar) 中。 我在许多配置中使用了汇编和着色插件，但他们从未将此 jar 添加到 DBPreformatter.jar 中。

这是我的 pom.xml：

<modelVersion>4.0.0</modelVersion>
<groupId>com.icd4you</groupId>
<artifactId>DBPreformatter</artifactId>
<version>1.0.0</version>
<name>DBPreformatter</name>
<description>DB processing and cleaning tool</description>
<packaging>jar</packaging>
<dependencies>
    <dependency>
        <groupId>mysql-connector-java-5.1.24-bin</groupId>
        <artifactId>mysql-connector-java-5.1.24-bin</artifactId>
        <version>5.1.24</version>
        <scope>system</scope>
        <systemPath>${basedir}/lib/mysql-connector-java-5.1.24-bin.jar</systemPath>
    </dependency>
</dependencies>
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.1</version>
            <configuration>
                <source>1.7</source>
                <target>1.7</target>
            </configuration>
        </plugin>

        <!-- WHAT SHOULD I USE HERE? -->

    </plugins>
</build>

如何解决这个问题？

Answer 1

有一个 maven 插件 Apache Maven Shade Plugin 会为你构建一个 uber jar

Answer 2

添加Maven Assembly plugin 和描述符jar-with-dependencies：

<build>
    <plugins>
        <plugin>
            <artifactId>maven-assembly-plugin</artifactId>
            <configuration>
                <descriptorRefs>
                    <descriptorRef>jar-with-dependencies</descriptorRef>
                </descriptorRefs>
                <archive>
                    <manifest>
                        <mainClass>com.pany.your.MainClass</mainClass>
                    </manifest>
                </archive>
            </configuration>
            <executions>
                <execution>
                    <id>make-assembly</id>
                    <phase>package</phase>
                    <goals>
                        <goal>single</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>

请注意，这不会添加 JAR；相反，它会解压缩所有列为依赖项的 JAR，并将它们的 content 添加到生成的 JAR（因此您将在结果中看到 MySQL JAR 中的所有类文件，而不是 MySQL JAR 本身）。

编辑 但是有一点需要注意：Maven 会忽略带有scope=system 的 JAR 以进行许多操作。另见：How to include external jars in maven jar build process?

如果 Maven 没有将 JAR 添加到输出中，那么您必须使用 mvn install:file-install 命令将具有此范围的所有 JAR 安装到本地 maven 存储库 ($HOME/.m2/repository) 中。请参阅http://maven.apache.org/plugins/maven-install-plugin/usage.html 怎么做。

注意：在本地 repo 中安装库是首选方式；你真的应该考虑一下。一方面，scope=system 将不再让您感到困惑（因为许多插件以特殊方式处理它们）。另外，您只需执行一次。之后，您可以在许多 Maven 项目中使用该库。

在安装之前，您应该检查 http://search.maven.org/ 以查看 Maven 是否不知道依赖项。

MySQL 是：http://search.maven.org/#artifactdetails%7Cmysql%7Cmysql-connector-java%7C5.1.32%7Cjar