将自定义或第三方库的jar包引入项目中

1.背景

 个人项目中引入了某个免费版框架有字数限制，我们业务需要生成字数很多，超过了限制，现在要引入自定义的jar解决问题。

2.实现

 在resource文件夹下建lib文件夹 (属于是约定)，将自己的jar包放入

然后在pom里引入

<dependency>
            <groupId>xxxx</groupId>
            <artifactId>xxxxxx</artifactId>
            <version>${spire.version}</version>
            <scope>system</scope>
            <systemPath>
                ${project.basedir}/src/main/resources/lib/xxxx-3.4.2.jar
            </systemPath>
</dependency>

groupId、artifactId和version可以在搜索 https://central.sonatype.com/search，如果搜不到那肯你的jar包是不在官方库里的，你下载的地方应该会给出这三个的值。

<scope>system</scope>表示不去官方maven仓库下载jar包而是用本地指定的文件。scope有compile、runtime、test、system、provided、import 几种类型，感兴趣的可以去了解一下。

<systemPath>${project.basedir}/src/main/resources/lib/xxxx-3.4.2.jar</systemPath> 指定本地jar的路径。${project.basedir}总是指向该模块的最上层目录。
比如你的目录是这样
your-project/
|-- src/
| |-- main/
| | |-- java/
| | |-- resources/
|-- target/
|-- pom.xml

那么 ${project.basedir}就是your-project/。如果your-project只是你项目中的一个微服务，外层还有pom，那也不会跑外层去。

有些小朋友到这里在本地测试完没问题就傻乎乎去跑流水线，到时又会发现找不到这个jar包。
这个时候只要在最外层的pom(建议)的插件部分配置一下<includeSystemScope>就可以了

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

groupId和artifactId是固定的，version看个人