引入外部jar包

1.resources下创建libs文件夹
libs
2.在pom文件中导入外部jar包
groupId为任意值
artifactId 为jar包name
version 对应的版本

<dependency>
            <groupId>com.cars.xiaoyu</groupId>
            <artifactId>xylink-cloudsdk</artifactId>
            <version>3.7.4</version>
            <scope>system</scope>
            <systemPath>${project.basedir}/src/main/resources/libs/xylink-cloudsdk-3.7.4.jar</systemPath>
        </dependency>

3.打包
使用SpringBoot打包插件生成jar包的时候,你会发现这个jar包不会被打进去,进而出现错误。
这个就需要在maven插接中配置一个includeSystemScope属性:

 <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                 <!--设置为true,以便把本地的system的jar也包括进来-->
                    <includeSystemScope>true</includeSystemScope>
                </configuration>
            </plugin>

maven的scope一共包括:compile、runtime、test、system、provided、import

compile是默认值,当我们引入依赖时,如果标签没有指定,那么默认就是complie。
compile表示被依赖项目需要参与当前项目的编译,包括后续的测试,运行周期也参与其中,同时打包的时候也会包含进去。是最常用的,所以也是默认的。

runtime表示被依赖项目无需参与项目的编译,不过后期的测试和运行周期需要其参与。与compile相比,跳过编译而已。
数据库的驱动包一般都是runtime,因为在我们在编码时只会使用JDK提供的jdbc接口,而具体的实现是有对应的厂商提供的驱动(如mysql驱动),实在运行时生效的,所以这类jar包无需参与项目的编译。

test表示只会在测试阶段使用,在src/main/java里面的代码是无法使用这些api的,并且项目打包时,也不会将"test"标记的打入"jar"包或者"war"包。

system依赖不是由maven仓库,而是本地的jar包,因此必须配合systemPath标签来指定本地的jar包所在全路径。这类jar包默认会参与编译、测试、运行,但是不会被参与打包阶段。如果也想打包进去的话,需要在插件里做配置true。

provided表示的是在编译和测试的时候有效,在执行(mvn package)进行打包成war、jar包的时候不会加入,比如:servlet-api,因为servlet-api,tomcat等web服务器中已经存在,如果在打包进去,那么包之间就会冲突

import比较特殊,他的作用是将其他模块定义好的 dependencyManagement 导入当前 Maven 项目 pom 的 dependencyManagement 中,都是配合pom来进行的。所以import作用的是pom类型,不是jar包。

<think> 我们正在讨论Spring Boot如何引入外部JAR的问题。根据引用内容,有两种主要方式:通过Maven依赖(括将外部JAR安装到本地Maven仓库后引用)以及使用system scope直接引用本地路径的JAR。下面我将详细解释这两种方法,并给出步骤。 ### 方法1:将外部JAR安装到本地Maven仓库后引用 这是推荐的方式,因为它能更好地融入Maven的依赖管理体系。 **步骤:** 1. **安装JAR到本地Maven仓库** 使用Maven命令将外部JAR安装到本地仓库: ```bash mvn install:install-file -Dfile=path/to/your.jar -DgroupId=com.example -DartifactId=your-artifact -Dversion=1.0.0 -Dpackaging=jar ``` - `-Dfile`: 外部JAR的路径(如`D:\lib\aliyun-sdk.jar`) - `-DgroupId`: 自定义的组织ID(类似于名) - `-DartifactId`: 自定义的项目ID - `-Dversion`: 版本号 2. **在pom.xml中添加依赖** 在项目的`pom.xml`中添加刚安装的依赖: ```xml <dependency> <groupId>com.example</groupId> <artifactId>your-artifact</artifactId> <version>1.0.0</version> </dependency> ``` ### 方法2:使用system scope直接引用本地JAR(不推荐) 这种方式直接将本地文件系统中的JAR作为依赖,但会导致项目可移植性变差。 **步骤:** 1. **将JAR放入项目目录** 例如,将`aliyun-sdk.jar`放到项目根目录下的`lib`文件夹中。 2. **在pom.xml中配置依赖** ```xml <dependency> <groupId>com.aliyun</groupId> <!-- 自定义或实际groupId --> <artifactId>aliyun-sdk</artifactId> <version>1.0.0</version> <scope>system</scope> <systemPath>${project.basedir}/lib/aliyun-sdk.jar</systemPath> </dependency> ``` ### 注意事项 1. **打问题** 使用`system`作用域的依赖默认不会被含在最终的Spring Boot可执行JAR中。需要额外配置Maven插件将外部JAR进去: ```xml <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <configuration> <includeSystemScope>true</includeSystemScope> </configuration> </plugin> </plugins> </build> ``` 2. **版本冲突** 确保外部JAR与项目其他依赖无冲突。 3. **可移植性** `system`作用域的依赖在团队协作或持续集成环境中可能因路径问题导致构建失败。 ### 总结 - **优先选择方法1**:将外部JAR安装到本地Maven仓库,以标准依赖方式引入,避免打问题。 - **谨慎使用方法2**:仅在临时测试或无法使用Maven仓库时使用,并注意处理打配置[^2][^3]。 ### 相关问题 1. 如何解决Spring Boot打时遗漏外部JAR的问题? 2. 如何将外部JAR部署到私有Maven仓库? 3. Spring Boot多模块项目如何共享外部JAR依赖? 4. 使用`system`作用域依赖时如何避免路径问题? </think>### Spring Boot引入外部JAR的两种常用方法 #### 方法一:通过本地Maven仓库引入(推荐) 1. **将JAR安装到本地仓库** ```bash mvn install:install-file \ -Dfile=path/to/your.jar \ -DgroupId=com.example \ -DartifactId=custom-lib \ -Dversion=1.0.0 \ -Dpackaging=jar ``` 2. **在pom.xml中添加依赖** ```xml <dependency> <groupId>com.example</groupId> <artifactId>custom-lib</artifactId> <version>1.0.0</version> </dependency> ``` #### 方法二:使用system scope直接引用 ```xml <dependency> <groupId>com.aliyun</groupId> <artifactId>dayu-sdk</artifactId> <version>1.0</version> <scope>system</scope> <systemPath>${project.basedir}/lib/dayu-sdk.jar</systemPath> </dependency> ``` ### 关键配置步骤 1. **打外部JAR** 在`pom.xml`中配置Spring Boot插件: ```xml <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <configuration> <!-- 含system作用域的JAR --> <includeSystemScope>true</includeSystemScope> </configuration> </plugin> </plugins> </build> ``` 2. **验证打结果** 解压生成的JAR文件检查是否含: ``` BOOT-INF/lib/dayu-sdk.jar ``` ### 常见问题解决 1. **ClassNotFoundException** - 检查`<includeSystemScope>`配置是否启用 - 确认JAR路径是否正确(使用`${project.basedir}`避免绝对路径) 2. **打JAR缺失** ```xml <!-- 额外添加资源复制插件 --> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-resources-plugin</artifactId> <executions> <execution> <id>copy-libs</id> <phase>prepare-package</phase> <goals><goal>copy-resources</goal></goals> <configuration> <outputDirectory>${project.build.directory}/lib</outputDirectory> <resources> <resource> <directory>${project.basedir}/lib</directory> <includes><include>*.jar</include></includes> </resource> </resources> </configuration> </execution> </executions> </plugin> ``` > **最佳实践**:优先使用方法一(本地Maven仓库),可避免打路径问题。对于无法修改的第三方JAR,使用方法二但务必配置`<includeSystemScope>`[^1][^2][^3]。 ### 相关问题 1. 如何解决Spring Boot打外部JAR未被含的问题? 2. 多模块项目中如何共享外部JAR依赖? 3. 如何将外部JAR部署到私有Maven仓库供团队使用? 4. Spring Boot如何加载非标准目录下的JAR文件
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值