Maven基础入门

Maven Learning Notes

Maven学习笔记

---

一.介绍

Maven是基于项目对象模型（POM），可以通过一小段描述信息来管理项目的构建、报告和文档的软件项目管理工具。

1. bin目录是包含mvn的运行脚本
2. boot目录包含一个类加载器的框架，maven使用它加载自己的类库
3. conf配置文件
4. lib包含maven运行时的依赖类库

二.环境变量的配置

点击下载
maven环境配置，增加一个环境变量MAVEN_HOME,值是maven的安装路径（C:\Program Files\apache-maven-3.5.0-bin\apache-maven-3.5.0）
修改path则是在path最后面添加;%MAVEN_HOME%\bin。

Maven的项目结构

项目名
    -src 
       -main
            -java
                 -package
       -test
            -java
                 -package
    -pom.xml

三.常用命令

    mvn -v      查看maven版本
     compile    编译
     test       测试
     package    打包

     clean      删除target
     install    安装jar包到本地仓库

maven快速创建项目骨架目录

两种方式：

1.  mvn archetype:generate 按照提示进行选择
2.  mvn archetype:generate  -DgroupId=com.imooc.maven   -DartifactId=
  maven-service   -Dversion=1.0.0SNAPSHOT   -Dpackage=com.imooc.maven.demo
    1. -DgroupId=组织名，公司网址反写+项目名
    2. -DartifactId=项目名+模块名
    3. -Dversion=版本号
    4. -Dpackage=代码所存在的包名

四.Maven中的坐标和仓库

构件坐标:

        1. groupId:公司名字+项目名
        2. artifactId：项目名+模块名
        3. varsion:版本号

仓库：

        1. 本地仓库
        2. 远程仓库
        3. 镜像仓库

五.更改仓库默认路径

已安装到本地仓库中的jar包位置：

C:\Users\用户\.m2\repository\com\tiakon\demo

安装路径conf文件夹下settings.xml文件
打开找到这段备注是的代码：

复制粘贴出来

    /path/to/local/repo

将localRepository便签内的值替换成新路径即可。

六.maven生命周期

完整的项目构建过程包括：

清理、编译、测试、打包、集成测试、验证、部署

maven三套独立的生命周期

    clean   清理项目
            1.pre-clean 执行清理前的工作
            2.clean     清理上一次构建生成的所有文件
            3.post-clean    执行清理后的文件

    default 构建项目（最核心）
            compile test package install

    site    生成项目站点
            1. pre-site     在生成项目站点前要完成的工作
            2. site     生成项目的站点文档
            3. post-site    在生成项目站点后要完成的工作
            4. site-deploy  发布生成的站点到服务器上

七.maven中pom.xml常见元素介绍

    
    4.0.0

    com.tiakon.maven.demo
    HoictasStudio-MavenDemo01
    1.0-SNAPSHOT
    
    
    


    
    
        
        
            junit
            junit
            RELEASE
            
            
            
            
            
            
            
        
    
    
    
    
    
        
        
            
                org.apache.maven.plugins
                maven-source-plugin
                3.0.1

                
                    
                        package
                        
                            
                                jar-no-fork
                            
                        
                    
                
            
        
    
    
    
    
    

八.Maven的依赖范围

三种classpath
    1. 编译
    2. 测试
    3. 运行

maven提供了6种可选依赖范围:

1. compile: 默认范围，编译测试运行都有效。

2. provided:    在编译和测试时有效。（比如说在开发JavaEE时，你在本地运行的servlet，
是需要调用已添加到项目中的servlet-api.jar这个jar包的。这个过程就包含了编译【就是
把Java文件编译成class文件的过程中也要调用】和测试【测试就是在本地运行】，那么他说
的运行是指，整个项目已开发完成，编译、测试通过后，将class文件或包含有class文件的war包
发布到服务器上的Tomcat中运行，这时启动项目，就可以直接调Tomcat中的servlet-api.jar，
不必再将自己的jar包添加到项目中去。也就是说当你选择provided时，项目发布时Maven不会将
你添加的jar包，加入到项目中。）

3. runtime: 在测试和运行时有效。(典型例子：JDBC驱动的实现。)
4. test:    只在测试是有效。
5. system:  类似provided，与本机系统相关联，可移植性差。

6. import:  导入范围，他只是用在dependencyManagement中，表示从其他的pom中导
入dependecy的配置。（以下引用官网案例并不难理解。）

Importing Dependencies


  4.0.0
  maven
  B
  pom
  B
  1.0
  
        
                  
                    maven
                    A
                    1.0
                    pom
                    import
                  
                          
                            test
                            d
                            1.0
                          
        
  
  
            
              test
              a
              1.0
              runtime
            
                    
                      test
                      c
                      runtime
                    
  

Assuming A is the pom defined in the preceding example, the end result would be the same. All of A’s managed dependencies would be incorporated into B except for d since it is defined in this pom.

假设A是前面示例中定义的pom，那么最终结果将是相同的。所有管理的依赖项都将被合并到B中，除了在这个pom中定义的d之外。

九.依赖冲突

1.短路优先:

    C->B->A->X1(jar)
    C->B->X2(jar)

【C依赖B,B依赖A,A和B都包含同一个不同版本的Jar,则取B的依赖版本。（c的pom.xml中不必注明jar坐标）】

2.先声明先优先

    如果路径相同长度相同，则谁先声明，先解析谁。

【C依赖A和B,A和B都包含同一个不同版本的Jar,谁依赖在前取谁的依赖版本。】

十.聚合与继承

聚合

pom

    ../HoictasStudio-MavenDemo01
    ../HoictasStudio-MavenDemo02
    ../HoictasStudio-MavenDemo03

假设在HoictasStudio-MavenParent模块中添如以上代码，输入clean install命令后，即可同时安装多个jar到本地仓库中

    [INFO] HoictasStudio-MavenDemo01 .......................... SUCCESS [  4.618 s]
    [INFO] HoictasStudio-MavenDemo02 .......................... SUCCESS [  0.828 s]
    [INFO] HoictasStudio-MavenDemo03 .......................... SUCCESS [  0.923 s]
    [INFO] HoictasStudio-MavenParent .......................... SUCCESS [  0.021 s]

继承

根据官方文档说明继承会根据父模块与子模块的包含与否，对pom.xml的写法则有两种。

第一种写法

假设我们有两个模块，前一个叫 com.mycompany.app:my-app:1，后一个叫com.mycompany.app:my-module:1。

my-app的pom文件为：

  4.0.0
  com.mycompany.app
  my-app
  1

my-module的pom文件为：

  4.0.0
  com.mycompany.app
  my-module
  1

我们指定如下项目结构：

    .
     |-- my-module
     |   `-- pom.xml
     `-- pom.xml

那么，我们需要my-module去继承my-app，则需要在my-module的pom文件中添加以下代码：

    
      
        com.mycompany.app
        my-app
        1
      
      4.0.0
      com.mycompany.app
      my-module
      1
    

第二种写法

However, that would work if the parent project was already installed inour local repository or was in that specific 
directory structure (parent pom.xml is one directory higher than that of the module's pom.xml). But what if the parent 
is not yet installed and if the directory structure is
.
 |-- my-module
 |   `-- pom.xml
 `-- parent
     `-- pom.xml    

上一段话摘自官网对继承的介绍，就是说如果你的父模块已在本地安装或者父模块不包含子模块，目录级别甚至是
比子模块的还要高，就在第一种写法上添加标签。

      
        com.mycompany.app
        my-app
        1
        ../parent/pom.xml
      
      4.0.0
      my-module

笔者在看视频时就发现，当父模块与子模块处于同一级别时，在按照视频中的写法（第一种写法）test时就会报错，
而此时的情况是不包含子模块，所以应该在标签中添加标签即可测试通过。