Maven中optional标签用法详解

 更新时间:2023年05月19日 10:24:09   作者:怪 咖@  
这篇文章主要介绍了Maven中optional标签,文章中有详细的代码示例供大家参考,对大家的学习或工作有一定的参考价值,感兴趣的小伙伴可以借鉴一下

一、前言

<dependency>
  <groupId>cn.hutool</groupId>
  <artifactId>hutool-all</artifactId>
  <version>5.8.18</version>
  <optional>true</optional>
</dependency>

optional表示是否会传递依赖,有两个可填值(假如不声明optional标签,默认就是false):

  • false: 传递依赖
  • true:不传递依赖

举例:A引用了B的依赖,而B又引用了C依赖。

  • 假如B引用C依赖的时候没有设置optional,那么A是可以使用C依赖的。
  • 假如B引用C依赖的时候将optional标签设置为了true,那么在A当中就无法使用C依赖相关的方法,并且A调用B依赖的方法,而B依赖方法使用到了C,这时候会报找不到C依赖下的类,因为C不参与A的打包。

二、依赖传递代码演示

(1)如下是一个父子聚合工程,不设置optional的情况:

打成jar包后,我们可以将jar解压,解压后在BOOT-INF的lib下存放着所能使用的依赖jar包,在这里可以看到hutool。

(2)设置optional为true的情况:

没有那也就意味着我再download工程不能访问hutool的类了,想要访问只能在当前项目再次引用了。

(3)我有点好奇,既然这里看不到那么他究竟会参与打包吗?假如不参与打包,我们download工程调用common中的方法,然后common中的方法又使用了hutool工具类,那能否访问成功?接下来我们来一点一点的印证!

设置为true的时候是否会参与download工程的打包?

答:他是不会参与download的打包的,打成jar包后,我们可以将jar解压,解压后在BOOT-INF的lib下存放着所能使用的依赖jar包。

假如不参与打包,我们download工程调用common中的方法,然后common中的方法又使用了hutool工具类,那能否访问成功?

答:不能访问成功,直接会报找不到hutool的类

我解压common包发现连BOOT-INF都没有,并不是只有common的jar包解压没有,而是所有的都没有。

我一直以为common包引用了hutool,那么解压common包就应该在BOOT-INF下的jar中看到hutool.jar,其实不是的,maven打包会将所有依赖关系全部放到当前项目的BOOT-INF/jar目录下

为此我专门在common当中写了一个方法,然后使用到了hutool当中的类。

然后我又在download工程下写了一个接口,让这个接口访问common包下test方法。

紧接着启动项目,启动download项目并没有异常,只要访问common包当中方法带有hutool相关的都报异常,说找不到hutool的包。因为我们刚刚也看过了,确实是没有这个jar包。

从而也证明了,不管是当前项目引用的,还是间接引用的,jar包都存放在BOOT-INF下/jar目录下,只要这下面没有jar,那当前项目就不能用。

三、为啥common的jar包下没有BOOT-INF呢?

在download下的BOOT-INF/lib下的common包解压后没有BOOT-INF我可以理解,因为所有的jar包都没有。但是为什么target当中的jar包解压后也没有,而download却有。他两个唯一的区别就是,一个是有main函数的web工程,一个是连main方法都没有的而且也没有打包插件。

我的父工程继承了spring-boot-starter-parent

而spring-boot-starter-parent当中对打包插件做了如下配置,也就意味着子工程一旦声明该插件就会遵循如下配置:

于是我在common包下添加了打包插件。注意使用打包插件意味着打出来的jar是一个可以直接执行的jar,因此必须要声明main函数,否则会打包异常的。

并且新增了一个主函数

于是再次打包,这时候会发现jar包大小已经发生了变化。解压后会发现他已经存在BOOT-INF了。

但是诡异的一幕发生了,download引入了common包,并且download调用了common包下的方法,直接就mvn install 不通过了。说在仓库找不到包。

但是在仓库当中实际上是存在这个包的。那也就是证明项目不能引用可执行jar。

于是我又把common的打包插件给去掉之后mvn install可以成功了。因此也证明了假如我们要封装自己的jar,一定不要使用打包插件。一旦使用插件就会变成了可执行jar,可执行jar是不可以被别的项目所引用的。

四、是否会影响父子工程之间的依赖继承呢?

假如我在聚合工程的父pom依赖当中使用optional为true,那子工程会继承吗?接下来进行演示。

注:在父工程设置optional为true,并不会影响子工程继承该依赖。

五、总结

  • 将依赖设置为true不仅代表着依赖不会传递,就连打包的时候都不会将该jar打包进去,一旦使用到调用该jar包的方法就会异常。
  • 在父工程设置optional为true,并不会影响子工程继承该依赖。
  • 不管是当前项目引用的,还是间接引用的,所有依赖jar包都存放在jar解压后的BOOT-INF下/jar目录下,只要这下面没有jar,那当前项目就不能用。

什么时候将optional设置为true?

就拿hutool工具类来说,如下图:你想用他的某些工具类,他还让你引用一些第三方的依赖,为什么他不直接引用到自己的项目?

实际上hutool他肯定是引用了的,如果不引用他的项目可能连编译都编译不过,更别提打包给我们用了,他是将这个依赖设置为了true,假如谁用到了这块的功能,谁自己引入这个依赖。这样可以规避掉一些没有用到这块功能但是却引入了没有用的jar包。

以上就是Maven中optional标签详解的详细内容,更多关于Maven optional标签的资料请关注脚本之家其它相关文章!

相关文章

  • 详解Springboot之整合JDBCTemplate配置多数据源

    详解Springboot之整合JDBCTemplate配置多数据源

    这篇文章主要介绍了详解Springboot之整合JDBCTemplate配置多数据源,文中有非常详细的代码示例,对正在学习java的小伙伴们有很好的帮助,需要的朋友可以参考下
    2021-04-04
  • WebUploader+SpringMVC实现文件上传功能

    WebUploader+SpringMVC实现文件上传功能

    WebUploader是由Baidu团队开发的一个简单的以HTML5为主,FLASH为辅的现代文件上传组件。这篇文章主要介绍了WebUploader+SpringMVC实现文件上传功能,需要的朋友可以参考下
    2017-06-06
  • Mybatis中使用in()查询的方式详解

    Mybatis中使用in()查询的方式详解

    当参数有值,添加条件查询,附带一个字符串的in查询,下面这篇文章主要给大家介绍了关于Mybatis中使用in()查询的方式,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2022-08-08
  • Springboot3整合Elasticsearch8(elasticsearch-java)最佳实践

    Springboot3整合Elasticsearch8(elasticsearch-java)最佳实践

    文章推荐使用Elasticsearch官方新客户端(ElasticsearchJavaAPIClient)替代已废弃的RestHighLevelClient,对比SpringDataElasticsearch和easy-es的优缺点,详解SpringBoot3整合步骤及高阶用法,强调新客户端功能全且适配最新版本,感兴趣的朋友一起看看吧
    2025-07-07
  • java 如何实现日志追踪MDC

    java 如何实现日志追踪MDC

    这篇文章主要介绍了java 实现日志追踪MDC方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-09-09
  • JavaWeb建立简单三层项目步骤图解

    JavaWeb建立简单三层项目步骤图解

    这篇文章主要介绍了JavaWeb建立简单三层项目步骤图解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-07-07
  • Idea配置热部署的详细教程

    Idea配置热部署的详细教程

    这篇文章主要介绍了Idea配置热部署的详细教程,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-07-07
  • Java使用JSONObject操作json实例解析

    Java使用JSONObject操作json实例解析

    这篇文章主要介绍了Java使用JSONObject操作json,结合实例形式较为详细的分析了Java使用JSONObject解析json数据相关原理、使用技巧与操作注意事项,需要的朋友可以参考下
    2020-04-04
  • @JsonSerialize(using = LongToStringUtil.class)注解的使用方式

    @JsonSerialize(using = LongToStringUtil.class)注解的使

    这篇文章主要介绍了@JsonSerialize(using = LongToStringUtil.class)注解的使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-08-08
  • Java多线程案例之阻塞队列详解

    Java多线程案例之阻塞队列详解

    阻塞队列是一种特殊的队列. 也遵守 “先进先出” 的原则.阻塞队列能是一种线程安全的数据结构。本文将通过一些示例为大家详细讲讲阻塞队列的原理与使用,感兴趣的小伙伴可以学习一下
    2022-10-10

最新评论