Maven依赖Scope选项详解

转载自https://www.jianshu.com/p/fb09a49d4d1b
转载这篇文章主要是这篇是简书中的无法被收藏,且在初学Maven时有所疑问,故记录一下。

在一个maven项目中,如果存在编译需要而发布不需要的jar包,可以用scope标签,值设为provided。

如下:

<dependency>
  <groupId>javax.servlet.jsp</groupId>
  <artifactId>jsp-api</artifactId>
  <version>2.3</version>
  <scope>provided</scope>      
</dependency>

Scope的其他参数如下:

scope说明实例
compile编译时需要用到该jar包(默认)commons-logging
test编译Test时需要用到该jar包junit
runtime编译时不需要,但运行时需要用到mysql
provided编译时需要用到,但运行时由JDK或某个服务器提供servlet-api

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

### Maven 配置文件 `pom.xml` 详解 #### pom.xml 的作用 `pom.xml` 是 Maven 项目的核心配置文件,用于描述项目的元数据、依赖关系、构建逻辑以及插件配置等内容。通过合理的配置,能够实现项目的自动化构建、测试和部署流程[^1]。 #### 基本结构概述 该文件遵循 XML 格式,根元素为 `<project>`,并需声明命名空间及其模式位置。以下是其主要组成部分: - **模型版本 (`modelVersion`)** 定义 POM 文件的版本号,默认应设为 `4.0.0`,表示当前使用的POM格式版本。 - **groupId, artifactId 和 version** 这三个字段共同唯一标识一个Maven项目,在仓库中起到定位资源的作用。其中: - `groupId`: 组织或公司域名倒序加上模块名前缀; - `artifactId`: 实际项目名称; - `version`: 版本号; ```xml <groupId>com.example</groupId> <artifactId>my-app</artifactId> <version>1.0-SNAPSHOT</version> ``` - **packaging (打包方式)** 指定最终产出物的形式,默认为 jar 形式的 Java 库包。其他常见选项还包括 war(Web Application Archive)、pom(父级聚合工程)等。 ```xml <packaging>jar</packaging> ``` #### 项目基本信息 ##### modules 子模块管理 当存在多模块项目时,可以通过此标签列举子模块路径,便于统一管理和编译操作。 ```xml <modules> <module>sub-module-a</module> <module>sub-module-b</module> </modules> ``` ##### parent 父级继承 允许下层模块从上级继承公共配置项,减少重复劳动的同时保持一致性。 ```xml <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.7.5</version> <relativePath/> <!-- 查找本地相对路径 --> </parent> ``` ##### scm 源码控制系统集成 提供对源代码管理系统(SCM)的支持,方便开发者获取最新源码或提交更改记录。 ```xml <scm> <connection>scm:git:http://github.com/user/repo.git</connection> <developerConnection>scm:git:https://${env.GITHUB_TOKEN}@github.com/user/repo.git</developerConnection> <url>http://github.com/user/repo/tree/master</url> </scm> ``` ##### properties 属性定义 自定义变量集合区,可用于简化复杂表达式书写,提高可读性和维护便利度。 ```xml <properties> <java.version>8</java.version> <maven.compiler.source>${java.version}</maven.compiler.source> <maven.compiler.target>${java.version}</maven.compiler.target> </properties> ``` #### 依赖管理 ##### dependencies 依赖列表 罗列项目所需外部库文件,支持范围限定(`scope`)及排除特定传递性依赖(exclusions),确保环境纯净稳定运行。 ```xml <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.13.2</version> <scope>test</scope> </dependency> </dependencies> ``` ##### repositories 私有仓库地址 指定额外远程存储库URL,以便下载官方中央仓库之外的第三方组件。 ```xml <repositories> <repository> <id>central</id> <name>Maven Central Repository</name> <url>https://repo.maven.apache.org/maven2</url> </repository> </repositories> ``` #### 构建配置 ##### build 插件与资源处理 设定编译参数、资源过滤规则及相关工具链调用细节,保障不同阶段任务顺利完成。 ###### plugins 插件集锦 内置多种实用型辅助程序,如编译器优化、单元测试执行、JAR/WAR 打包等功能扩展。 ```xml <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <configuration> <source>${java.version}</source> <target>${java.version}</target> </configuration> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-surefire-plugin</artifactId> <executions> <execution> <goals> <goal>test</goal> </goals> </execution> </executions> </plugin> ... </plugins> </build> ``` #### 发布信息 ##### issueManagement 缺陷追踪系统对接 关联至缺陷跟踪平台的信息入口,帮助团队成员快速访问相关工单页面。 ```xml <issueManagement> <system>Jira</system> <url>https://issues.apache.org/jira/browse/MYPROJECT</url> </issueManagement> ``` ##### ciManagement 持续集成服务连接 指明 CI 工具服务器详情,促进持续交付管道顺畅运作。 ```xml <ciManagement> <system>Jenkins</system> <url>http://jenkins.example.com/job/my-project/</url> </ciManagement> ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值