Maven 手册

最新推荐文章于 2024-07-29 08:06:57 发布

王军新

最新推荐文章于 2024-07-29 08:06:57 发布

阅读量978

点赞数 10

文章标签： maven

本文链接：https://blog.csdn.net/qq_39701205/article/details/138283671

版权

本文详细介绍了Maven的目录结构、依赖范围及其作用，包括不同依赖的有效期，以及Maven的属性使用、排除编译文件、依赖引用和聚合项目管理。同时涵盖了Maven中的打包机制，特别是maven-jar-plugin和SpringBoot的打包策略。

摘要由CSDN通过智能技术生成

Maven

Hello
|---src
|---|---main
|---|---|---java
|---|---|---resources
|---|---test
|---|---|---java
|---|---|---resources
|---pom.xml

依赖范围

compile ：为默认的依赖有效范围。如果在定义依赖关系的时候，没有明确指定依赖有效范围的话，则默认采用该依赖有效范围。此种依赖，在编译、运行、测试时均有效。
provided ：在编译、测试时有效，但是在运行时无效。例如：servlet-api，运行项目时，容器已经提供，就不需要Maven重复地引入一遍了。
runtime ：在运行、测试时有效，但是在编译代码时无效。例如：JDBC驱动实现，项目代码编译只需要JDK提供的JDBC接口，只有在测试或运行项目时才需要实现上述接口的具体JDBC驱动。
test ：只在测试时有效，例如：JUnit。
system ：在编译、测试时有效，但是在运行时无效。和provided的区别是，使用system范围的依赖时必须通过systemPath元素显式地指定依赖文件的路径。由于此类依赖不是通过Maven仓库解析的，而且往往与本机系统绑定，可能造成构建的不可移植，因此应该谨慎使用。

依赖的传递性

scope取值	有效范围（compile, runtime, test）	依赖传递	例子
compile	all	是	spring-core
provided	compile, test	否	servlet-api
runtime	runtime, test	是	JDBC驱动
test	test	否	JUnit
system	compile, test	是

scope 是compile 则具有依赖传递
路径最短者优先
路径相同时先声明者优先

Maven 的属性

内置属性

${basedir}：表示项目根目录，即包含pom.xml文件的目录
${version}：表示项目的版本号

POM属性（用来引用pom.xml文件中对应元素的值）

${pom.build.sourceDirectory}：项目的主源码目录，默认为src/main/java/
${project.build.testSourceDirectory}：项目的测试源码目录，默认为src/test/java/
${project.build.directory}：项目构建输出目录，默认为target/
${project.build.outputDirectory}：项目主代码编译输出目录，默认为target/classes
${project.build.testOutputDirectory}：项目测试代码编译输出目录，默认为target/test-classes
${project.groupId}：项目的groupId
${project.artifactId}：项目的artifactId
${project.version}：项目的version，与$ {version}等价
${project.build.finalName}：项目打包输出文件的名称，默认为$ {project.artifactId}-${project.version}

Settings属性

这种属性以settings.开头来引用~/.m2/settings.xml中的内容，如:${settings.localRepository} 指向用户本地仓库的地址。

java系统属性

所有java系统属性都可以使用maven属性来进行引用，例如${user.home}指向了当前用户目录。

环境变量属性

所有的环境变量都可以使用env.开头的方式来进行引用，如：${env.JAVA_HOME}
用户可以使用mvn help:system命令查看所有环境变量的值。

常用场景

排除不需要编译的文件

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>${maven-compiler-plugin.version}</version>
    <configuration>
        <source>${jdk.version}</source>
        <target>${jdk.version}</target>
        <encoding>UTF-8</encoding>
        <excludes>
            <exclude>**/ZyjsfwService.java</exclude>
            <exclude>**/ZyjsfwDao.java</exclude>
            <exclude>**/ResumeEntity.java</exclude>
            <exclude>**/ZyjsfwController.java</exclude>
        </excludes>
    </configuration>
</plugin>

依赖引用

聚合只需要在父项目中添加modules 属性，继承需要在子模块中指明parent
只有继承结构中才能继承父项目中的dependencies
继承和聚合都需要把package 属性设置为pom
dependencies 标签下的依赖都会被子项目继承引入到项目中
dependencyManagement 不会引入实际的依赖，只有在子类中使用dependency来引入父dependencyManagement声明的依赖之后，依赖的构建才会被真正的引入
当我们想用另一个项目的dependencyManagement 但又不想继承，可以在本项目的dependencyManagement 中添加另一个项目信息如下

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.javacode2018</groupId>
            <artifactId>javacode2018-parent</artifactId>
            <version>1.0-SNAPSHOT</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>构件2</dependency>
    </dependencies>
</dependencyManagement>

聚合项目

父工程配置

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.wjx.parent</groupId>
    <artifactId>parent</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>    
    	<!-- 在总的聚合工程中加入如下信息 -->
	<modules>
		<module>../Hello</module>
		<module>../HelloFriend</module>
		<module>../MakeFriends</module>
	</modules>       
     <!--父工程统一的依赖版本管理 -->
     <dependencyManagement>
			<dependencies>
				<dependency>
					<groupId>junit</groupId>
					<artifactId>junit</artifactId>
					<version>4.9</version>
					<scope>test</scope>
				</dependency>
			</dependencies>
   </dependencyManagement>    
</project>

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

    <modelVersion>4.0.0</modelVersion>
    
    <!--GAV maven坐标 对应仓库目录位置：仓库根目录/com/wjx/spring/springProject/1.0-SNAPSHOT/springProject-1.0-SNAPSHOT        -->
    <!-- 公司域名倒序+项目名 -->
    <groupId>com.wjx.spring</groupId>
    <!-- 模块名 -->
    <artifactId>springProject</artifactId>  
    <!-- 版本号 -->
    <version>1.0-SNAPSHOT</version>
     <packaging>pom</packaging>
    <modules>
        <module>spring01</module>
        <module>spring02</module>
        <module>spring03</module>
    </modules>


    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
        <!-- spring版本号 -->
        <spring.version>4.1.1.RELEASE</spring.version>
        <!-- mybatis版本号  <mybatis.version>3.2.6</mybatis.version> -->

        <!-- log4j日志文件管理包版本 -->
        <slf4j.version>1.7.7</slf4j.version>
        <servlet-api.version>2.5</servlet-api.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
            <version>${servlet-api.version}</version>
            <scope>provided</scope>
        </dependency>     
        <!-- Spring -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>${spring.version}</version>
        </dependency>      

    </dependencies>


    <build>
        <finalName>AtguiguWeb</finalName>
        <!--  配置项目的资源路径 -->
        <resources>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
        </resources>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.1</version>
                <configuration>
                    <source>${maven.compiler.source}</source>
                    <target>${maven.compiler.target}</target>
                    <encoding>${project.build.sourceEncoding}</encoding>
                </configuration>
            </plugin>
            <!-- 配置tomcat 运行 -->
            <plugin>
                <groupId>org.apache.tomcat.maven</groupId>
                <artifactId>tomcat7-maven-plugin</artifactId>
                <version>2.2</version>
                <configuration>
                    <!-- http port -->
                    <port>8888</port>
                    <path>/</path>
                    <uriEncoding>utf-8</uriEncoding>
                    <ignorePackaging>true</ignorePackaging>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

Maven 中的打包

Maven 中的打包默认是使用maven-jar-plugin 插件，本插件打包时不会把依赖的包直接打入jar 包，jar 包使用者需要自己提供依赖jar 包，也可以通过配置属性，指定 jar 包Main方法，和把依赖的jar 包打入到指定的lib 目录下
Spring Boot 使用 spring-boot-maven-plugin 进行打包