百度360必应搜狗淘宝本站头条
当前位置:网站首页 > IT知识 > 正文

Maven 项目构建打包,如何引入本地 Jar 包?

liuian 2025-01-07 14:14 32 浏览

上一篇讲到 Maven 离线仓库的使用,反响不错很多人收藏。这一篇还是继续聊 Maven,今日话题:“项目在构建打包时,Maven 如何引入本地 Jar 包?”

未收录原因

我们在开发时,经常会遇到某 Jar 包没有被 Maven 公共仓库收录的情况。公共仓库搜索:

  • 阿里云代理仓库:https://developer.aliyun.com/mvn/search
  • mvnrepository 仓库:https://mvnrepository.com/

未收录有以下几个原因:

  1. 开发者偏好。开发者个人或公司偏好,分享作品只在自己博客和官网上,或者只上传到 github 上。
  2. 历史原因。依赖资源创始时间太久远,那时候可能还没有 Maven,开发者延续习惯上传到原发布平台上,也未迁移或同步到 Maven 公共仓库。例如发布托管在 sourceforge 上。
  3. 闭源和版权原因。例如原来 Oracle 数据库的驱动包"ojdbc.jar"就是是闭源的,他们的法务部门很厉害,Oracle 如果不主动上传,公共仓库方也不敢随意引用,开发者每次只能在甲骨文官网下载驱动包。对于一个广泛应用的依赖包,开发时引入就相当麻烦。(现在 Oracle 已经将其同步到 Maven 公共仓库了,方便不少)

适合场景

  • 引用的依赖不在 Maven 中央仓库或者企业内部私有仓库。
  • 私人编写的包,或第三方公司提供的 Jar 包。(企业内部私有协议包/加密算法包等)
  • Maven 在内网离线开发。
  • 引入被定制改动过的 Jar 包。


解决方法:

Maven 坐标三要素:groupId、artifactId、version。假如有项目在文件夹 C:/xxx/projectA,下面介绍两种方式引入本地 Jar 包。

mvn install 安装到本地仓库

mvn install 是 Maven 的一个命令,用于将项目的构建产物安装到本地仓库,以便其他项目可以作为依赖使用。将依赖的 Jar 包放入到项目 C:/xxx/projectA/lib 目录下 。这里以 ojdbc 做示例:

<dependency>
    <groupId>com.oracle.database.jdbc</groupId>
    <artifactId>ojdbc8</artifactId>
    <version>23.5.0.24.07</version>
</dependency>

手动导入,依赖包目录下打开 cmd 命令提示符窗口,执行命令把 Jar 安装到本地仓库里:

mvn install:install-file -Dfile=ojdbc8.jar -DgroupId=com.oracle.database.jdbc -DartifactId=ojdbc8 -Dversion=23.5.0.24.07 -Dpackaging=jar
  • -Dfile=制品文件文件名(可以是制品路径)
  • -DgroupId=Maven坐标组织名称
  • -DartifactId=Maven坐标制品名称
  • -Dversion=Maven坐标制品版本
  • -Dpackaging=打包类型

依赖包比较多时,使用 bat 命令批量执行,在 C:/xxx/projectA/lib 目录下创建 install.bat 脚本文件:

@echo off
call mvn install:install-file -Dfile=xxx.jar -DgroupId=com.xxx -DartifactId=xxx-xxx -Dversion=21.1 -Dpackaging=jar
call mvn install:install-file -Dfile=xxx.jar -DgroupId=com.xxx -DartifactId=xxx-xxx -Dversion=21.1 -Dpackaging=jar
call mvn install:install-file -Dfile=xxx.jar -DgroupId=com.xxx -DartifactId=xxx-xxx -Dversion=21.1 -Dpackaging=jar
pause

你可以依照依赖包路径,前往本地仓库确认是否成功安装。最后在 IDEA 里面刷新 Maven,重新加载 Jar 到项目就可以直接使用了。


修改项目 pom.xml 指定文件

拿到下载好的 Jar 包,在 IDEA 中,以下几步搞定 Maven 本地依赖:

  1. 将依赖的 Jar 包放入到项目 C:/xxx/projectA/lib 目录下 (这里以 hutool 做示例)
  2. 项目 pom.xml 配置依赖 Jar 坐标和本地路径(scope/path)
  3. 配置 spring-boot-maven-plugin 编译时将引用本地 Jar 包
<!-- pom.xml 片段 -->
<dependencies>
    <dependency>
        <groupId>cn.hutool</groupId>
        <artifactId>hutool-all</artifactId>
        <version>5.8.18</version>
        <scope>system</scope>
        <systemPath>${project.basedir}/lib/hutool-all-5.8.18.jar</systemPath>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <mainClass>com.youngdream.demo.DemoApplication</mainClass>
                <!--maven将引用的本地 jar 包一起打包-->
                <includeSystemScope>true</includeSystemScope>
            </configuration>
        </plugin>
    </plugins>
</build>

依赖包的 scope 配置 system 范围时,必须通过 systemPath 指定依赖包的路径。表示此类依赖不经过 Maven 仓库解析,而是与本机系统绑定的,提交代码时就要注意了,该依赖包也得提交保存,以免后期管理丢失 Jar 包。

(题外话:这样做法是简便开发起见,代码仓库拉下来就能直接用。实际上建议 Jar 包和代码分别单独管理,不建议把二进制文件放在 Git 上 托管,会造成项目体积臃肿,而且二进制文件在上传时也会因为文件过大被拒绝,你可以尝试调整 Git http/ssh 的 buffer 大小,或者使用 Git LFS 解决这个问题。)

如图: mvn package 打好 Jar 包后,再用 JD-GUI 打开验证下本地包是否打入(或将后缀名 jar 改为 rar,解压也可以看到)。

以上,就是项目在构建打包时 Maven 引入本地 Jar 包的两个方法。


END


文章对您有用的话,

记得 点赞 关注 收藏 哦~,

您的支持,就是我更新的最大动力~

相关推荐

10种常见的MySQL错误,你可中招?

【51CTO.com快译】如果未能对MySQL8进行恰当的配置,您非但可能遇到无法顺利访问、或调用MySQL的窘境,而且还可能给真实的应用生产环境带来巨大的影响。本文列举了十种MySQL...

MySQL主从如何保证数据一致性

MySQL主从(主备)搭建请点击基于Spring的数据库读写分离。MySQL主备基本原理假设主备切换前,我们的主库是节点A,节点B是节点A的备库,客户端的读写都是直接访问节点A,节点B只是将A的更新同...

MySQL低版本升级操作流程

(关注“数据库架构师”公众号,提升数据库技能,助力职业发展)0-升级背景MySQL5.5发布于2010年,至今已有十年历史,官方已经停止更新。2008年发布的MySQL5.1版本,在2018年...

MySQL数据库知识

MySQL是一种关系型数据库管理系统;那废话不多说,直接上自己以前学习整理文档:查看数据库命令:(1).查看存储过程状态:showprocedurestatus;(2).显示系统变量:show...

Mysql 8.4数据库安装、新建用户和数据库、表单

1、下载MySQL数据库yuminstall-ywgetperlnet-toolslibtirpc#安装wget和perl、net-tools、libtirpcwgethtt...

mysql8.0新功能介绍

MySQL8.0新特性集锦一、默认字符集由latin1变为utf8mb4在8.0版本之前,默认字符集为latin1,utf8指向的是utf8mb3,8.0版本默认字符集为utf8mb4,utf8默...

全网最详细解决Windows下Mysql数据库安装后忘记初始root 密码方法

一、准备重置root的初始化密码Win+R键启动命令输入窗口;输入cmd打开命令执行窗口;##界面如下##输入命令:netstopmysqld#此操作会停止当前运行的...

互联网大厂面试:MySQL使用grant授权后必须flush privilege吗

从我上大学时,数据库概论老师就告诉我,MySQL使用grant对用户授权之后,一定记得要用flushprivilege命令刷新缓存,这样才能使赋权命令生效。毕业工作以后,在很多的技术文档上,仍然可以...

# mysql 8.0 版本无法使用 sqlyog 等图形界面 登录 的解决方法

30万以下的理想L6来了##mysql8.0版本无法使用sqlyog等图形界面登录的解决方法当我们在cmd下登录mysql时正常时,用sqlyog等图形界面连接数据库时却...

MySQL触发器介绍

前言:在学习MySQL的过程中,可能你了解过触发器的概念,不清楚各位是否有详细的去学习过触发器,最近看了几篇关于触发器的文档,分享下MySQL触发器相关知识。1.触发器简介触发器即trigg...

管理员常用的MySQL命令汇总(一)

以下是管理员常用的MySQL命令:以管理员身份连接到MySQL:mysql-uroot-p创建新的MySQL用户:CREATEUSER'username'@'...

Linux(CentOS) 在线安装MySQL8.0和其他版本,修改root密码

一:安装MySQL数据库1),下载并安装MySQL官方的YumRepositorymysql官方仓库地址:https://dev.mysql.com/downloads/repo/yum/选择自...

解决 MySQL 8.0 一直拒绝 root 登录问题

Accessdeniedforuser'root'@'localhost'(usingpassword:YES)这个错误在网上搜一下,能看到非常多的此类...

大模型MCP之MYSQL安装

前言学习大模型的时候需要一个mysql,原因还是在公司使用电脑的时候不允许按照Docker-Desktop,我的宿主机其实是MAC,我习惯上还是在centsos上面安装,就发现这件过去很简单的事情居然...

MySQL ERROR 1396

ERROR1396(HY000):OperationCREATEUSERfailedfor'usera'@'%'问题描述mysql>create...