• Maven基础知识与使用总结


    一、Maven介绍

    Apache Maven:https://maven.apache.org/what-is-maven.html

    Apache Maven是一个软件项目管理和综合工具。基于项目对象模型(POM)的概念,Maven可以从一个中心资料片管理项目构建,报告和文件。

    Maven主要目标是提供给开发人员:

    • 项目是可重复使用,易维护,更容易理解的一个综合模型。
    • 插件或交互的工具,这种声明性的模式。

    Maven项目的结构和内容在一个XML文件中声明,pom.xml 项目对象模型(POM),这是整个Maven系统的基本单元。有关详细信息,请参阅Maven POM的部分。

    中心仓库:https://mvnrepository.com/

    sonatype:https://search.maven.org/

    其他参考资料:

    https://www.liaoxuefeng.com/wiki/1252599548343744/1255945359327200

    http://c.biancheng.net/maven/

    二、Maven安装

    由于maven依赖jdk的运行,需要先在本地配置jdk的环境变量,然后在配置maven环境变量,本文暂就不叙述。

    a)下载maven文件

    JDK 环境安装好之后,接下来正式安装配置 Maven。

    下载地址:https://maven.apache.org/download.cgi

    解压后:

    b)配置maven环境变量

    安装好后,接下来对 Maven 进行配置。配置内容同 JDK 的配置内容一样,也是两部分:一部分是在系统环境变量或者用户环境变量中配置一个 MAVEN_HOME;另一部分也是将 Maven 里面的 bin 目录添加到 Path 环境变量。

    • 配置 MAVEN_HOME

    • 追加 Path

    • 测试安装是否成功
      打开一个 CMD 窗口,输入“mvn-v”命令运行

    c)配置maven本地仓库

    实际上我们可以将本地仓库理解“缓存”,目的是存放jar包。开发项目时项目首先会从本地仓库中获取 jar 包,当无法获取指定 jar 包的时候,本地仓库会从 远程仓库(或 中央仓库) 中下载 jar 包,并“缓存”到本地仓库中以备将来使用。

    默认路径在我们C盘目录下。这里不建议放到C盘,那么如何修改这个默认配置呢。
    打开maven安装目录\conf\setting.xml文件。我自己的路径:E:\maven_3.6.1\apache-maven-3.6.1\conf

    某个jar包一旦被Maven下载过,即可永久地安全缓存在本地。

    最后检查一下配置是否正确。输入命令:mvn help:system

    d)配置maven国内仓库源

    Maven是当前流行的项目管理工具,但官方的库在国外经常连不上,连上也下载速度很慢。

    在maven的配置文件  settings.xml  中添加

    <mirror>
        <id>alimaven</id>
        <mirrorOf>central</mirrorOf>
        <name>aliyun maven</name>
        <url>http://maven.aliyun.com/nexus/content/repositories/central/</url>
    </mirror>
    

    三、Maven基本介绍

    a)Maven坐标详解

    一个完整的坐标信息,由 groupId、artifactId、version、packaging、classifier 组成,如下是一个简单的坐标定义。

    <dependencies>
        <dependency>
            <groupid>junit</groupid>
            <artifactid>junit</artifactid>
            <version>3.8.1</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
    

    groupId :属于组织的名称,类似Java的包名;

    artifactId : 该jar包自身的名称,类似Java的类名;

    version : 该jar包的版本。

    通过上述3个变量,即可唯一确定某个jar包。Maven通过对jar包进行PGP签名确保任何一个jar包一经发布就无法修改。修改已发布jar包的唯一方法是发布一个新版本。

    注:只有以-SNAPSHOT结尾的版本号会被Maven视为开发版本,开发版本每次都会重复下载,这种SNAPSHOT版本只能用于内部私有的Maven repo,公开发布的版本不允许出现SNAPSHOT。

    b)Maven 构建生命周期

    生命周期阶段 描述
    validate(校验) 校验项目是否正确并且所有必要的信息可以完成项目的构建过程。
    initialize(初始化) 初始化构建状态,比如设置属性值。
    generate-sources(生成源代码) 生成包含在编译阶段中的任何源代码。
    process-sources(处理源代码) 处理源代码,比如说,过滤任意值。
    generate-resources(生成资源文件) 生成将会包含在项目包中的资源文件。
    process-resources (处理资源文件) 复制和处理资源到目标目录,为打包阶段最好准备。
    compile(编译) 编译项目的源代码。
    process-classes(处理类文件) 处理编译生成的文件,比如说对Java class文件做字节码改善优化。
    generate-test-sources(生成测试源代码) 生成包含在编译阶段中的任何测试源代码。
    process-test-sources(处理测试源代码) 处理测试源代码,比如说,过滤任意值。
    generate-test-resources(生成测试资源文件) 为测试创建资源文件。
    process-test-resources(处理测试资源文件) 复制和处理测试资源到目标目录。
    test-compile(编译测试源码) 编译测试源代码到测试目标目录.
    process-test-classes(处理测试类文件) 处理测试源码编译生成的文件。
    test(测试) 使用合适的单元测试框架运行测试(Juint是其中之一)。
    prepare-package(准备打包) 在实际打包之前,执行任何的必要的操作为打包做准备。
    package(打包) 将编译后的代码打包成可分发格式的文件,比如JAR、WAR或者EAR文件。
    pre-integration-test(集成测试前) 在执行集成测试前进行必要的动作。比如说,搭建需要的环境。
    integration-test(集成测试) 处理和部署项目到可以运行集成测试环境中。
    post-integration-test(集成测试后) 在执行集成测试完成后进行必要的动作。比如说,清理集成测试环境。
    verify (验证) 运行任意的检查来验证项目包有效且达到质量标准。
    install(安装) 安装项目包到本地仓库,这样项目包可以用作其他本地项目的依赖。
    deploy(部署) 将最终的项目包复制到远程仓库中与其他开发者和项目共享。

    b)版本管理介绍

    通常情况下,Maven 的版本号约定中包括如下几个部分:

    <主版本号>.<次版本号>.<增量版本号>.<里程碑版本号>

    • 主版本号:主版本号表示该项目的重大升级。例如:Maven1 到 Maven2;
    • 次版本号:表示在该主版本下,较大范围的升级或变化。例如:Maven-3.0 到 Maven-3.1;
    • 增量版本号:增量版本通常是用来修复bug的版本。例如:Maven-3.1.1;
    • 里程碑版本号:用来标记里程碑版本。例如:Maven-3.0-alpha-3。

    c)Maven依赖管理

    packaging :定义Maven项目打包的方式,使用构件的什么包。首先,打包方式通常与所生成构件的文件扩展名对应,如上例中没有packaging,则默认为jar包,最终的文件名为junit-3.8.1.jar。也可以打包成war等。

    classifier: 该元素用来帮助定义构建输出的一些附件。附属构件与主构件对应,如上例中的主构件为junit-3.8.1.jar,该项目可能还会通过一些插件生成如junit-3.8.1-javadoc.jar,junit-3.8.1-sources.jar, 这样附属构件也就拥有了自己唯一的坐标。

    上述5个元素中,groupId、artifactId、version是必须定义的,packaging是可选的(默认为jar),而classfier是不能直接定义的,需要结合插件使用。

    Maven定义了几种依赖关系,分别是compiletestruntimeprovided

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

    d)Maven命令

    如果我们运行mvn package,Maven就会执行default生命周期,它会从开始一直运行到package这个phase为止:

    • validate
    • ...
    • package

    如果我们运行mvn compile,Maven也会执行default生命周期,但这次它只会运行到compile,即以下几个phase:

    • validate
    • ...
    • compile

    Maven另一个常用的生命周期是clean,它会执行3个phase:

    • pre-clean
    • clean (注意这个clean不是lifecycle而是phase)
    • post-clean

    在实际开发过程中,经常使用的命令有:

    mvn clean:清理所有生成的class和jar;

    mvn clean compile:先清理,再执行到compile

    mvn clean test:先清理,再执行到test,因为执行test前必须执行compile,所以这里不必指定compile

    mvn clean package:先清理,再执行到package

    e)Maven的pom.xml文件

    <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.0http://maven.apache.org/maven-v4_0_0.xsd">     
        <!--父项目的坐标。如果项目中没有规定某个元素的值,那么父项目中的对应值即为项目的默认值。 坐标包括group ID,artifact ID和 version。-->    
        <parent>    
         <!--被继承的父项目的构件标识符-->    
         <artifactId/>    
         <!--被继承的父项目的全球唯一标识符-->    
         <groupId/>    
         <!--被继承的父项目的版本-->    
         <version/>    
         <!-- 父项目的pom.xml文件的相对路径。相对路径允许你选择一个不同的路径。默认值是../pom.xml。Maven首先在构建当前项目的地方寻找父项 目的pom,其次在文件系统的这个位置(relativePath位置),然后在本地仓库,最后在远程仓库寻找父项目的pom。-->    
         <relativePath/>    
     </parent>    
     <!--声明项目描述符遵循哪一个POM模型版本。模型本身的版本很少改变,虽然如此,但它仍然是必不可少的,这是为了当Maven引入了新的特性或者其他模型变更的时候,确保稳定性。-->       
        <modelVersion>4.0.0</modelVersion>     
        <!--项目的全球唯一标识符,通常使用全限定的包名区分该项目和其他项目。并且构建时生成的路径也是由此生成, 如com.onework.app生成的相对路径为:/com/onework/app-->     
        <groupId>com.onework</groupId>     
        <!-- 构件的标识符,它和group ID一起唯一标识一个构件。换句话说,你不能有两个不同的项目拥有同样的artifact ID和groupID;在某个 特定的group ID下,artifact ID也必须是唯一的。构件是项目产生的或使用的一个东西,Maven为项目产生的构件包括:JARs,源 码,二进制发布和WARs等。-->     
        <artifactId>onework-maven2</artifactId>     
        <!--项目产生的构件类型,例如jar、war、ear、pom。插件可以创建他们自己的构件类型,所以前面列的不是全部构件类型-->     
        <packaging>war</packaging>     
        <!--项目当前版本,格式为:主版本.次版本.增量版本-限定版本号-->     
        <version>1.0-SNAPSHOT</version>     
        <!--项目的名称, Maven产生的文档用-->     
        <name>onework-maven</name>     
        <!--项目主页的URL, Maven产生的文档用-->     
        <url>http://www.one-work.net/</url>     
        <!-- 项目的详细描述, Maven 产生的文档用。  当这个元素能够用HTML格式描述时(例如,CDATA中的文本会被解析器忽略,就可以包含HTML标 签), 不鼓励使用纯文本描述。如果你需要修改产生的web站点的索引页面,你应该修改你自己的索引页文件,而不是调整这里的文档。-->     
        <description>A maven project to study maven.</description>     
        <!--描述了这个项目构建环境中的前提条件。-->    
     <prerequisites>    
      <!--构建该项目或使用该插件所需要的Maven的最低版本-->    
        <maven/>    
     </prerequisites>    
     <!--项目名称和URL-->     
        <issueManagement>    
         <!--项目名字,-->     
            <system>onework</system>     
            <!--该项目使用的URL-->    
            <url>http://onework.cn</url>     
        </issueManagement>     
        <!--项目持续集成信息-->    
     <ciManagement>    
      <!--持续集成系统的名字,例如continuum-->    
      <system/>    
      <!--该项目使用的持续集成系统的URL(如果持续集成系统有web接口的话)。-->    
      <url/>    
      <!--构建完成时,需要通知的开发者/用户的配置项。包括被通知者信息和通知条件(错误,失败,成功,警告)-->    
      <notifiers>    
       <!--配置一种方式,当构建中断时,以该方式通知用户/开发者-->    
       <notifier>    
        <!--传送通知的途径-->    
        <type/>    
        <!--发生错误时是否通知-->    
        <sendOnError/>    
        <!--构建失败时是否通知-->    
        <sendOnFailure/>    
        <!--构建成功时是否通知-->    
        <sendOnSuccess/>    
        <!--发生警告时是否通知-->    
        <sendOnWarning/>    
        <!--不赞成使用。通知发送到哪里-->    
        <address/>    
        <!--扩展配置项-->    
        <configuration/>    
       </notifier>    
      </notifiers>    
     </ciManagement>    
     <!--项目创建年份,4位数字。当产生版权信息时需要使用这个值。-->    
        <inceptionYear/>    
        <!--项目相关邮件列表信息-->     
        <mailingLists>    
         <!--该元素描述了项目相关的所有邮件列表。自动产生的网站引用这些信息。-->     
            <mailingList>     
             <!--邮件的名称-->    
                <name>Demo</name>     
                <!--发送邮件的地址或链接,如果是邮件地址,创建文档时,mailto: 链接会被自动创建-->     
                <post>zhongkai1010@163.com</post>     
                <!--订阅邮件的地址或链接,如果是邮件地址,创建文档时,mailto: 链接会被自动创建-->     
                <subscribe>zhongkai1010@163.com</subscribe>     
                <!--取消订阅邮件的地址或链接,如果是邮件地址,创建文档时,mailto: 链接会被自动创建-->     
                <unsubscribe>zhongkai1010@163.com</unsubscribe>     
                <!--你可以浏览邮件信息的URL-->    
                <archive>zhongkai1010@163.com</archive>     
            </mailingList>     
        </mailingLists>     
        <!--项目开发者列表-->     
        <developers>     
         <!--某个项目开发者的信息-->    
            <developer>     
             <!--SCM里项目开发者的唯一标识符-->    
                <id>HELLO WORLD</id>     
                <!--项目开发者的全名-->    
                <name>chaimm</name>     
                <!--项目开发者的email-->    
                <email>zhongkai1010@163.com</email>     
                <!--项目开发者的主页的URL-->    
                <url/>    
                <!--项目开发者在项目中扮演的角色,角色元素描述了各种角色-->    
                <roles>     
                    <role>Project Manager</role>     
                    <role>Architect</role>     
                </roles>    
                <!--项目开发者所属组织-->    
                <organization>demo</organization>     
                <!--项目开发者所属组织的URL-->    
                <organizationUrl>http://onework.cn</organizationUrl>     
                <!--项目开发者属性,如即时消息如何处理等-->    
                <properties>     
                    <dept>No</dept>     
                </properties>    
                <!--项目开发者所在时区, -11到12范围内的整数。-->    
                <timezone>-5</timezone>     
            </developer>     
        </developers>     
        <!--项目的其他贡献者列表-->     
        <contributors>    
         <!--项目的其他贡献者。参见developers/developer元素-->    
         <contributor>    
       <name/><email/><url/><organization/><organizationUrl/><roles/><timezone/><properties/>    
         </contributor>         
        </contributors>       
        <!--该元素描述了项目所有License列表。 应该只列出该项目的license列表,不要列出依赖项目的 license列表。如果列出多个license,用户可以选择它们中的一个而不是接受所有license。-->     
        <licenses>    
         <!--描述了项目的license,用于生成项目的web站点的license页面,其他一些报表和validation也会用到该元素。-->     
            <license>    
             <!--license用于法律上的名称-->    
                <name>Apache 2</name>     
                <!--官方的license正文页面的URL-->    
                <url>http://www.baidu.com/zhongkai1010/LICENSE-2.0.txt</url>     
                <!--项目分发的主要方式:    
                  repo,可以从Maven库下载    
                  manual, 用户必须手动下载和安装依赖-->    
                <distribution>repo</distribution>     
                <!--关于license的补充信息-->    
                <comments>A business-friendly OSS license</comments>     
            </license>     
        </licenses>     
        <!--SCM(Source Control Management)标签允许你配置你的代码库,供Maven web站点和其它插件使用。-->     
        <scm>     
            <!--SCM的URL,该URL描述了版本库和如何连接到版本库。欲知详情,请看SCMs提供的URL格式和列表。该连接只读。-->     
            <connection>     
                scm:svn:http://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk)      
            </connection>     
            <!--给开发者使用的,类似connection元素。即该连接不仅仅只读-->    
            <developerConnection>     
                scm:svn:http://svn.baidu.com/banseon/maven/banseon/dao-trunk      
            </developerConnection>    
            <!--当前代码的标签,在开发阶段默认为HEAD-->    
            <tag/>           
            <!--指向项目的可浏览SCM库(例如ViewVC或者Fisheye)的URL。-->     
            <url>http://svn.baidu.com/banseon</url>     
        </scm>     
        <!--描述项目所属组织的各种属性。Maven产生的文档用-->     
        <organization>     
         <!--组织的全名-->    
            <name>demo</name>     
            <!--组织主页的URL-->    
            <url>http://www.onework.cn</url>     
        </organization>    
        <!--构建项目需要的信息-->    
        <build>    
         <!--该元素设置了项目源码目录,当构建项目的时候,构建系统会编译目录里的源码。该路径是相对于pom.xml的相对路径。-->    
      <sourceDirectory/>    
      <!--该元素设置了项目脚本源码目录,该目录和源码目录不同:绝大多数情况下,该目录下的内容 会被拷贝到输出目录(因为脚本是被解释的,而不是被编译的)。-->    
      <scriptSourceDirectory/>    
      <!--该元素设置了项目单元测试使用的源码目录,当测试项目的时候,构建系统会编译目录里的源码。该路径是相对于pom.xml的相对路径。-->    
      <testSourceDirectory/>    
      <!--被编译过的应用程序class文件存放的目录。-->    
      <outputDirectory/>    
      <!--被编译过的测试class文件存放的目录。-->    
      <testOutputDirectory/>    
      <!--使用来自该项目的一系列构建扩展-->    
      <extensions>    
       <!--描述使用到的构建扩展。-->    
       <extension>    
        <!--构建扩展的groupId-->    
        <groupId/>    
        <!--构建扩展的artifactId-->    
        <artifactId/>    
        <!--构建扩展的版本-->    
        <version/>    
       </extension>    
      </extensions>    
      <!--当项目没有规定目标(Maven2 叫做阶段)时的默认值-->    
      <defaultGoal/>    
      <!--这个元素描述了项目相关的所有资源路径列表,例如和项目相关的属性文件,这些资源被包含在最终的打包文件里。-->    
      <resources>    
       <!--这个元素描述了项目相关或测试相关的所有资源路径-->    
       <resource>    
        <!-- 描述了资源的目标路径。该路径相对target/classes目录(例如${project.build.outputDirectory})。举个例 子,如果你想资源在特定的包里(org.apache.maven.messages),你就必须该元素设置为org/apache/maven /messages。然而,如果你只是想把资源放到源码目录结构里,就不需要该配置。-->    
        <targetPath/>    
        <!--是否使用参数值代替参数名。参数值取自properties元素或者文件里配置的属性,文件在filters元素里列出。-->    
        <filtering/>    
        <!--描述存放资源的目录,该路径相对POM路径-->    
        <directory/>    
        <!--包含的模式列表,例如**/*.xml.-->    
        <includes/>    
        <!--排除的模式列表,例如**/*.xml-->    
        <excludes/>    
       </resource>    
      </resources>    
      <!--这个元素描述了单元测试相关的所有资源路径,例如和单元测试相关的属性文件。-->    
      <testResources>    
       <!--这个元素描述了测试相关的所有资源路径,参见build/resources/resource元素的说明-->    
       <testResource>    
        <targetPath/><filtering/><directory/><includes/><excludes/>    
       </testResource>    
      </testResources>    
      <!--构建产生的所有文件存放的目录-->    
      <directory/>    
      <!--产生的构件的文件名,默认值是${artifactId}-${version}。-->    
      <finalName/>    
      <!--当filtering开关打开时,使用到的过滤器属性文件列表-->    
      <filters/>    
      <!--子项目可以引用的默认插件信息。该插件配置项直到被引用时才会被解析或绑定到生命周期。给定插件的任何本地配置都会覆盖这里的配置-->    
      <pluginManagement>    
       <!--使用的插件列表 。-->    
       <plugins>    
        <!--plugin元素包含描述插件所需要的信息。-->    
        <plugin>    
         <!--插件在仓库里的group ID-->    
         <groupId/>    
         <!--插件在仓库里的artifact ID-->    
         <artifactId/>    
         <!--被使用的插件的版本(或版本范围)-->    
         <version/>    
         <!--是否从该插件下载Maven扩展(例如打包和类型处理器),由于性能原因,只有在真需要下载时,该元素才被设置成enabled。-->    
         <extensions/>    
         <!--在构建生命周期中执行一组目标的配置。每个目标可能有不同的配置。-->    
         <executions>    
          <!--execution元素包含了插件执行需要的信息-->    
          <execution>    
           <!--执行目标的标识符,用于标识构建过程中的目标,或者匹配继承过程中需要合并的执行目标-->    
           <id/>    
           <!--绑定了目标的构建生命周期阶段,如果省略,目标会被绑定到源数据里配置的默认阶段-->    
           <phase/>    
           <!--配置的执行目标-->    
           <goals/>    
           <!--配置是否被传播到子POM-->    
           <inherited/>    
           <!--作为DOM对象的配置-->    
           <configuration/>    
          </execution>    
         </executions>    
         <!--项目引入插件所需要的额外依赖-->    
         <dependencies>    
          <!--参见dependencies/dependency元素-->    
          <dependency>    
           ......    
          </dependency>    
         </dependencies>         
         <!--任何配置是否被传播到子项目-->    
         <inherited/>    
         <!--作为DOM对象的配置-->    
         <configuration/>    
        </plugin>    
       </plugins>    
      </pluginManagement>    
      <!--使用的插件列表-->    
      <plugins>    
       <!--参见build/pluginManagement/plugins/plugin元素-->    
       <plugin>    
        <groupId/><artifactId/><version/><extensions/>    
        <executions>    
         <execution>    
          <id/><phase/><goals/><inherited/><configuration/>    
         </execution>    
        </executions>    
        <dependencies>    
         <!--参见dependencies/dependency元素-->    
         <dependency>    
          ......    
         </dependency>    
        </dependencies>    
        <goals/><inherited/><configuration/>    
       </plugin>    
      </plugins>    
     </build>    
     <!--在列的项目构建profile,如果被激活,会修改构建处理-->    
     <profiles>    
      <!--根据环境参数或命令行参数激活某个构建处理-->    
      <profile>    
       <!--构建配置的唯一标识符。即用于命令行激活,也用于在继承时合并具有相同标识符的profile。-->    
       <id/>    
       <!--自动触发profile的条件逻辑。Activation是profile的开启钥匙。profile的力量来自于它    
       能够在某些特定的环境中自动使用某些特定的值;这些环境通过activation元素指定。activation元素并不是激活profile的唯一方式。-->    
       <activation>    
        <!--profile默认是否激活的标志-->    
        <activeByDefault/>    
        <!--当匹配的jdk被检测到,profile被激活。例如,1.4激活JDK1.4,1.4.0_2,而!1.4激活所有版本不是以1.4开头的JDK。-->    
        <jdk/>    
        <!--当匹配的操作系统属性被检测到,profile被激活。os元素可以定义一些操作系统相关的属性。-->    
        <os>    
         <!--激活profile的操作系统的名字-->    
         <name>Windows XP</name>    
         <!--激活profile的操作系统所属家族(如 'windows')-->    
         <family>Windows</family>    
         <!--激活profile的操作系统体系结构 -->    
         <arch>x86</arch>    
         <!--激活profile的操作系统版本-->    
         <version>5.1.2600</version>    
        </os>    
        <!--如果Maven检测到某一个属性(其值可以在POM中通过${名称}引用),其拥有对应的名称和值,Profile就会被激活。如果值    
        字段是空的,那么存在属性名称字段就会激活profile,否则按区分大小写方式匹配属性值字段-->    
        <property>    
         <!--激活profile的属性的名称-->    
         <name>mavenVersion</name>    
         <!--激活profile的属性的值-->    
         <value>2.0.3</value>    
        </property>    
        <!--提供一个文件名,通过检测该文件的存在或不存在来激活profile。missing检查文件是否存在,如果不存在则激活    
        profile。另一方面,exists则会检查文件是否存在,如果存在则激活profile。-->    
        <file>    
         <!--如果指定的文件存在,则激活profile。-->    
         <exists>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</exists>    
         <!--如果指定的文件不存在,则激活profile。-->    
         <missing>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</missing>    
        </file>    
       </activation>    
       <!--构建项目所需要的信息。参见build元素-->    
       <build>    
        <defaultGoal/>    
        <resources>    
         <resource>    
          <targetPath/><filtering/><directory/><includes/><excludes/>    
         </resource>    
        </resources>    
        <testResources>    
         <testResource>    
          <targetPath/><filtering/><directory/><includes/><excludes/>    
         </testResource>    
        </testResources>    
        <directory/><finalName/><filters/>    
        <pluginManagement>    
         <plugins>    
          <!--参见build/pluginManagement/plugins/plugin元素-->    
          <plugin>    
           <groupId/><artifactId/><version/><extensions/>    
           <executions>    
            <execution>    
             <id/><phase/><goals/><inherited/><configuration/>    
            </execution>    
           </executions>    
           <dependencies>    
            <!--参见dependencies/dependency元素-->    
            <dependency>    
             ......    
            </dependency>    
           </dependencies>    
           <goals/><inherited/><configuration/>    
          </plugin>    
         </plugins>    
        </pluginManagement>    
        <plugins>    
         <!--参见build/pluginManagement/plugins/plugin元素-->    
         <plugin>    
          <groupId/><artifactId/><version/><extensions/>    
          <executions>    
           <execution>    
            <id/><phase/><goals/><inherited/><configuration/>    
           </execution>    
          </executions>    
          <dependencies>    
           <!--参见dependencies/dependency元素-->    
           <dependency>    
            ......    
           </dependency>    
          </dependencies>    
          <goals/><inherited/><configuration/>    
         </plugin>    
        </plugins>    
       </build>    
       <!--模块(有时称作子项目) 被构建成项目的一部分。列出的每个模块元素是指向该模块的目录的相对路径-->    
       <modules/>    
       <!--发现依赖和扩展的远程仓库列表。-->    
       <repositories>    
        <!--参见repositories/repository元素-->    
        <repository>    
         <releases>    
          <enabled/><updatePolicy/><checksumPolicy/>    
         </releases>    
         <snapshots>    
          <enabled/><updatePolicy/><checksumPolicy/>    
         </snapshots>    
         <id/><name/><url/><layout/>    
        </repository>    
       </repositories>    
       <!--发现插件的远程仓库列表,这些插件用于构建和报表-->    
       <pluginRepositories>    
        <!--包含需要连接到远程插件仓库的信息.参见repositories/repository元素-->        
        <pluginRepository>    
         <releases>    
          <enabled/><updatePolicy/><checksumPolicy/>    
         </releases>    
         <snapshots>    
          <enabled/><updatePolicy/><checksumPolicy/>    
         </snapshots>    
         <id/><name/><url/><layout/>    
        </pluginRepository>    
       </pluginRepositories>    
       <!--该元素描述了项目相关的所有依赖。 这些依赖组成了项目构建过程中的一个个环节。它们自动从项目定义的仓库中下载。要获取更多信息,请看项目依赖机制。-->    
       <dependencies>    
        <!--参见dependencies/dependency元素-->    
        <dependency>    
         ......    
        </dependency>    
       </dependencies>    
       <!--不赞成使用. 现在Maven忽略该元素.-->    
       <reports/>       
       <!--该元素包括使用报表插件产生报表的规范。当用户执行“mvn site”,这些报表就会运行。 在页面导航栏能看到所有报表的链接。参见reporting元素-->    
       <reporting>    
        ......    
       </reporting>    
       <!--参见dependencyManagement元素-->    
       <dependencyManagement>    
        <dependencies>    
         <!--参见dependencies/dependency元素-->    
         <dependency>    
          ......    
         </dependency>    
        </dependencies>    
       </dependencyManagement>    
       <!--参见distributionManagement元素-->    
       <distributionManagement>    
        ......    
       </distributionManagement>    
       <!--参见properties元素-->    
       <properties/>    
      </profile>    
     </profiles>    
     <!--模块(有时称作子项目) 被构建成项目的一部分。列出的每个模块元素是指向该模块的目录的相对路径-->    
     <modules/>    
        <!--发现依赖和扩展的远程仓库列表。-->     
        <repositories>     
         <!--包含需要连接到远程仓库的信息-->    
            <repository>    
             <!--如何处理远程仓库里发布版本的下载-->    
             <releases>    
              <!--true或者false表示该仓库是否为下载某种类型构件(发布版,快照版)开启。 -->    
        <enabled/>    
        <!--该元素指定更新发生的频率。Maven会比较本地POM和远程POM的时间戳。这里的选项是:always(一直),daily(默认,每日),interval:X(这里X是以分钟为单位的时间间隔),或者never(从不)。-->    
        <updatePolicy/>    
        <!--当Maven验证构件校验文件失败时该怎么做:ignore(忽略),fail(失败),或者warn(警告)。-->    
        <checksumPolicy/>    
       </releases>    
       <!-- 如何处理远程仓库里快照版本的下载。有了releases和snapshots这两组配置,POM就可以在每个单独的仓库中,为每种类型的构件采取不同的 策略。例如,可能有人会决定只为开发目的开启对快照版本下载的支持。参见repositories/repository/releases元素 -->    
       <snapshots>    
        <enabled/><updatePolicy/><checksumPolicy/>    
       </snapshots>    
       <!--远程仓库唯一标识符。可以用来匹配在settings.xml文件里配置的远程仓库-->    
       <id>banseon-repository-proxy</id>     
       <!--远程仓库名称-->    
                <name>banseon-repository-proxy</name>     
                <!--远程仓库URL,按protocol://hostname/path形式-->    
                <url>http://192.168.1.169:9999/repository/</url>     
                <!-- 用于定位和排序构件的仓库布局类型-可以是default(默认)或者legacy(遗留)。Maven 2为其仓库提供了一个默认的布局;然 而,Maven 1.x有一种不同的布局。我们可以使用该元素指定布局是default(默认)还是legacy(遗留)。-->    
                <layout>default</layout>               
            </repository>     
        </repositories>    
        <!--发现插件的远程仓库列表,这些插件用于构建和报表-->    
        <pluginRepositories>    
         <!--包含需要连接到远程插件仓库的信息.参见repositories/repository元素-->    
      <pluginRepository>    
       ......    
      </pluginRepository>    
     </pluginRepositories>    
    
        <!--该元素描述了项目相关的所有依赖。 这些依赖组成了项目构建过程中的一个个环节。它们自动从项目定义的仓库中下载。要获取更多信息,请看项目依赖机制。-->     
        <dependencies>     
            <dependency>    
       <!--依赖的group ID-->    
                <groupId>org.apache.maven</groupId>     
                <!--依赖的artifact ID-->    
                <artifactId>maven-artifact</artifactId>     
                <!--依赖的版本号。 在Maven 2里, 也可以配置成版本号的范围。-->    
                <version>3.8.1</version>     
                <!-- 依赖类型,默认类型是jar。它通常表示依赖的文件的扩展名,但也有例外。一个类型可以被映射成另外一个扩展名或分类器。类型经常和使用的打包方式对应, 尽管这也有例外。一些类型的例子:jar,war,ejb-client和test-jar。如果设置extensions为 true,就可以在 plugin里定义新的类型。所以前面的类型的例子不完整。-->    
                <type>jar</type>    
                <!-- 依赖的分类器。分类器可以区分属于同一个POM,但不同构建方式的构件。分类器名被附加到文件名的版本号后面。例如,如果你想要构建两个单独的构件成 JAR,一个使用Java 1.4编译器,另一个使用Java 6编译器,你就可以使用分类器来生成两个单独的JAR构件。-->    
                <classifier></classifier>    
                <!--依赖范围。在项目发布过程中,帮助决定哪些构件被包括进来。欲知详情请参考依赖机制。    
                    - compile :默认范围,用于编译      
                    - provided:类似于编译,但支持你期待jdk或者容器提供,类似于classpath      
                    - runtime: 在执行时需要使用      
                    - test:    用于test任务时使用      
                    - system: 需要外在提供相应的元素。通过systemPath来取得      
                    - systemPath: 仅用于范围为system。提供相应的路径      
                    - optional:   当项目自身被依赖时,标注依赖是否传递。用于连续依赖时使用-->     
                <scope>test</scope>       
                <!--仅供system范围使用。注意,不鼓励使用这个元素,并且在新的版本中该元素可能被覆盖掉。该元素为依赖规定了文件系统上的路径。需要绝对路径而不是相对路径。推荐使用属性匹配绝对路径,例如${java.home}。-->    
                <systemPath></systemPath>     
                <!--当计算传递依赖时, 从依赖构件列表里,列出被排除的依赖构件集。即告诉maven你只依赖指定的项目,不依赖项目的依赖。此元素主要用于解决版本冲突问题-->    
                <exclusions>    
                 <exclusion>     
                        <artifactId>spring-core</artifactId>     
                        <groupId>org.springframework</groupId>     
                    </exclusion>     
                </exclusions>       
                <!--可选依赖,如果你在项目B中把C依赖声明为可选,你就需要在依赖于B的项目(例如项目A)中显式的引用对C的依赖。可选依赖阻断依赖的传递性。-->     
                <optional>true</optional>    
            </dependency>    
        </dependencies>    
        <!--不赞成使用. 现在Maven忽略该元素.-->    
        <reports></reports>    
        <!--该元素描述使用报表插件产生报表的规范。当用户执行“mvn site”,这些报表就会运行。 在页面导航栏能看到所有报表的链接。-->    
     <reporting>    
      <!--true,则,网站不包括默认的报表。这包括“项目信息”菜单中的报表。-->    
      <excludeDefaults/>    
      <!--所有产生的报表存放到哪里。默认值是${project.build.directory}/site。-->    
      <outputDirectory/>    
      <!--使用的报表插件和他们的配置。-->    
      <plugins>    
       <!--plugin元素包含描述报表插件需要的信息-->    
       <plugin>    
        <!--报表插件在仓库里的group ID-->    
        <groupId/>    
        <!--报表插件在仓库里的artifact ID-->    
        <artifactId/>    
        <!--被使用的报表插件的版本(或版本范围)-->    
        <version/>    
        <!--任何配置是否被传播到子项目-->    
        <inherited/>    
        <!--报表插件的配置-->    
        <configuration/>    
        <!--一组报表的多重规范,每个规范可能有不同的配置。一个规范(报表集)对应一个执行目标 。例如,有1,2,3,4,5,6,7,8,9个报表。1,2,5构成A报表集,对应一个执行目标。2,5,8构成B报表集,对应另一个执行目标-->    
        <reportSets>    
         <!--表示报表的一个集合,以及产生该集合的配置-->    
         <reportSet>    
          <!--报表集合的唯一标识符,POM继承时用到-->    
          <id/>    
          <!--产生报表集合时,被使用的报表的配置-->    
          <configuration/>    
          <!--配置是否被继承到子POMs-->    
          <inherited/>    
          <!--这个集合里使用到哪些报表-->    
          <reports/>    
         </reportSet>    
        </reportSets>    
       </plugin>    
      </plugins>    
     </reporting>    
     <!-- 继承自该项目的所有子项目的默认依赖信息。这部分的依赖信息不会被立即解析,而是当子项目声明一个依赖(必须描述group ID和 artifact ID信息),如果group ID和artifact ID以外的一些信息没有描述,则通过group ID和artifact ID 匹配到这里的依赖,并使用这里的依赖信息。-->    
     <dependencyManagement>    
      <dependencies>    
       <!--参见dependencies/dependency元素-->    
       <dependency>    
        ......    
       </dependency>    
      </dependencies>    
     </dependencyManagement>       
        <!--项目分发信息,在执行mvn deploy后表示要发布的位置。有了这些信息就可以把网站部署到远程服务器或者把构件部署到远程仓库。-->     
        <distributionManagement>    
            <!--部署项目产生的构件到远程仓库需要的信息-->    
            <repository>    
             <!--是分配给快照一个唯一的版本号(由时间戳和构建流水号)?还是每次都使用相同的版本号?参见repositories/repository元素-->    
       <uniqueVersion/>    
       <id>banseon-maven2</id>     
       <name>banseon maven2</name>     
                <url>file://${basedir}/target/deploy</url>     
                <layout/>    
      </repository>    
      <!--构件的快照部署到哪里?如果没有配置该元素,默认部署到repository元素配置的仓库,参见distributionManagement/repository元素-->     
      <snapshotRepository>    
       <uniqueVersion/>    
       <id>banseon-maven2</id>    
                <name>Banseon-maven2 Snapshot Repository</name>    
                <url>scp://svn.baidu.com/banseon:/usr/local/maven-snapshot</url>     
       <layout/>    
      </snapshotRepository>    
      <!--部署项目的网站需要的信息-->     
            <site>    
             <!--部署位置的唯一标识符,用来匹配站点和settings.xml文件里的配置-->     
                <id>banseon-site</id>     
                <!--部署位置的名称-->    
                <name>business api website</name>     
                <!--部署位置的URL,按protocol://hostname/path形式-->    
                <url>     
                    scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web      
                </url>     
            </site>    
      <!--项目下载页面的URL。如果没有该元素,用户应该参考主页。使用该元素的原因是:帮助定位那些不在仓库里的构件(由于license限制)。-->    
      <downloadUrl/>    
      <!--如果构件有了新的group ID和artifact ID(构件移到了新的位置),这里列出构件的重定位信息。-->    
      <relocation>    
       <!--构件新的group ID-->    
       <groupId/>    
       <!--构件新的artifact ID-->    
       <artifactId/>    
       <!--构件新的版本号-->    
       <version/>    
       <!--显示给用户的,关于移动的额外信息,例如原因。-->    
       <message/>    
      </relocation>    
      <!-- 给出该构件在远程仓库的状态。不得在本地项目中设置该元素,因为这是工具自动更新的。有效的值有:none(默认),converted(仓库管理员从 Maven 1 POM转换过来),partner(直接从伙伴Maven 2仓库同步过来),deployed(从Maven 2实例部 署),verified(被核实时正确的和最终的)。-->    
      <status/>           
        </distributionManagement>    
        <!--以值替代名称,Properties可以在整个POM中使用,也可以作为触发条件(见settings.xml配置文件里activation元素的说明)。格式是<name>value</name>。-->    
        <properties/>    
    </project>    
    

    四、构建Maven工程

    a)Maven工程目录

    一个使用Maven管理的普通的Java项目,它的目录结构默认如下:

    a-maven-project
    ├── pom.xml
    ├── src
    │   ├── main
    │   │   ├── java
    │   │   └── resources
    │   └── test
    │       ├── java
    │       └── resources
    └── target• IDEA 配置 maven 目录
    
  • 相关阅读:
    logback 指定每隔一段时间创建一个日志文件
    常用Linux命令
    Java stream的常见用法
    spring boot 整合js css 静态文件
    UnityWebRequest http post json通信
    spring boot 添加拦截器实现登陆检测
    游戏服务器业务处理线程管理
    netty如何实现零拷贝
    游戏服务器性能调优常用工具详解
    Java UTC时间与本地时间互相转换
  • 原文地址:https://www.cnblogs.com/zhongkai/p/15714547.html
Copyright © 2020-2023  润新知