Maven 打包将 system 的文件添加到 war 中

文章背景

   在个人的工作中使用了百度的编辑器的jar文件,但是在阿里云的maven镜像中是没有这个文件的,以前自己的私服里面有这个文件。
后面使用,system 添加后发现不能打包的war文件中。
对于国内的互联网的资料,我个人的意见是能用 English 的还是用这样的方式去查询吧。

基础姿势

个人在网络上寻找到的资料很多都是使用 spring-boot-maven-plugin 的 plugin ,首先我们来了解下作用域:

  • compile 默认的scope,表示 dependency 都可以在生命周期中使用。而且,这些dependencies 会传递到依赖的项目中。适用于所有阶段,会随着项目一起发布
  • provided 跟compile相似,但是表明了dependency 由JDK或者容器提供,例如Servlet AP和一些Java EE APIs。这个scope 只能作用在编译和测试时,同时没有传递性。
  • runtime 表示dependency不作用在编译时,但会作用在运行和测试时,如JDBC驱动,适用运行和测试阶段。
  • test 表示dependency作用在测试时,不作用在运行时。 只在测试时使用,用于编译和运行测试代码。不会随项目发布。
  • system 跟provided 相似,但是在系统中要以外部JAR包的形式提供,maven不会在repository查找它。

下面添加一个解决依赖冲突的办法,这个是题外话。

<!-- 这里是举个栗子,我们在添加别人写好的工具类的时候,会自动依赖很多jar,并且和项目本身的jar有冲突,用这个可以解决。其他是本地一定有引用这个jar文件 -->
<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.12</version>
    <scope>test</scope>
    <exclusions>
        <exclusion>
            <artifactId>hamcrest-core</artifactId>
            <groupId>org.hamcrest</groupId>
        </exclusion>
    </exclusions>
</dependency>

解决办法

这边先给出spring-boot-maven-plugin的配置,至于能不能将本地 jar 打入 war 中自己测试(实践出真知):

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <version>${spring-boot.version}</version>
    <configuration>
        <includeSystemScope>true</includeSystemScope>
    </configuration>
</plugin>

以下是我本地使用的百度的UE编辑器的jar

<!-- 百度的编辑器,这个在自己的私服上面,如果要使用的话需要配置 -->
<dependencies>
    <dependency>
        <groupId>com.baidu</groupId>
        <artifactId>ueditor</artifactId>
        <version>1.1.2</version>
        <scope>system</scope>
        <systemPath>${project.basedir}/libs/ueditor-1.1.2.jar</systemPath>
    </dependency>
</dependencies>

<!-- 记得这个地方要添加版本的,反正我很奇怪没有添加版本是正常运行了 -->
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <configuration>
                <webResources>
                    <resource>
                        <directory>${project.basedir}/libs</directory>
                        <targetPath>WEB-INF/lib</targetPath>
                        <filtering>true</filtering>
                        <includes>
                            <include>**/*.jar</include>
                        </includes>
                    </resource>
                </webResources>
            </configuration>
        </plugin>
    </plugins>
</build>