Maven常用命令

646 阅读4分钟

简介

Maven是咱们常用的一种项目管理工具,它的主要目标为:

  • 简化构建过程
  • 提供统一的构建过程
  • 提供优质项目信息
  • 鼓励更好开发实践

结构

咱们以最常见的java项目为例,我们一般用到的最多就是简化及统一构建过程,记得以前maven没有那么流行的时候,我们还是在用最原始的项目创建方法,如果在需要用到第三方库的时候或者导入一些别人的项目,那么就需要自己去下载这些jar包,然后全部放在项目中的lib目录下。非常麻烦。而这些maven都可以轻松解决。

maven提供了统一的构建过程,也就是说他有一套统一的项目模板,我们只需要把我们对应的资源放进去就可以完成整个项目的构建了。如下表:

目录含义
/项目根目录
/src/main/javajava源文件的目录存放所有.java的文件
/src/main/resources存放资源类文件,例如配置文件等
/src/test/java存放java测试类文件
/src/test/resources存放java测试类文件的资源配置文件
/target打包后的输出目录
/target/classes编译后的class文件
~/.m2/repositorymaven本地仓库目录,所有依赖的jar都在这里。~为用户目录

仓库

maven仓库的作用就是存放第三方依赖的库,他可以帮我们管理构建,他就是放置所有JAR(WAR,ZIP,POM)文件的地方。
maven的仓库有三种类型:

  • 本地仓库(local)
  • 中央仓库(central)
  • 远程仓库(remote) 本地仓库 本地仓库在第一次执行maven命令后会自动创建,地址为用户目录下.m2/respository/的文件夹,当项目构建时会现在本地仓库里面查找依赖的第三方库,如果没有则会尝试从远程仓库拉取,拉取之后在使用本地的仓库中第三方库。其中仓库的路径可以在maven的conf中的setting配置文件中修改
<localRepository>/maven/xxx/MyLocalRepository</localRepository></settings>

中央仓库 中央仓库是有maven社区提供的仓库,包含了大量常用的库,基本上市面上能用到的第三方库在这里都可以找到,这个仓库由maven社区管理,需要任何配置,不过需要通过网络才能访问。因为maven的中央仓库在国外,国内访问会很慢,所以通常我们可以访问国内的镜像库,例如使用阿里云的镜像仓库:

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

在maven目录下conf文件中的setting.xml文件中,在mirrors节点上添加上述内容即可,或者直接在项目中的pom.xml文件中添加但只对此项目有效

<repositories>
    <repository> 
        <id>alimaven</id> 
        <name>aliyun maven</name> 
        <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
        <releases> 
            <enabled>true</enabled>
        </releases> 
        <snapshots> 
            <enabled>false</enabled>
        </snapshots> 
    </repository>
</repositories>

插件

maven中有三个标准的声明周期clean、default、site这些周期中都包含着一系列的阶段(phase),这些phase就相当于maven提供的统一接口,实现这些接口的就是插件!

常用插件:

插件名称描述
clean构建之后清理目标文件,删除目标目录
compiler编译java源文件
surefile运行JUnit单元测试,创建测试报告
jar从当前工程中构建JAR文件
deploy常用于发布JAR包至中央仓库供大家共享使用
install将项目打包,输出到target目录下,并将打包结果放到本地仓库对应的目录中,供其他项目或者模块引用
package将项目打包,输出到target目录下

POM

POM(Project Object Model,项目对象模型)是maven工程中的基本工作单元,是一个XML文件,包含了项目基本信息,用于描述如何构建,声明项目依赖等。

我们可以在POM中指定以下配置:

  • 项目依赖
  • 插件
  • 执行目标
  • 项目构建profile
  • 项目版本
  • 项目开发中列表
  • 相关邮件列表
<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>
    
    <!-- 公司或者组织的唯一标志,并且配置时生成的路径也是由此生成, 如com.companyname.project-group,maven会将该项目打成的jar包放本地路径:/com/companyname/project-group -->
    <groupId>com.companyname.project-group</groupId> 
    
    <!-- 项目的唯一ID,一个groupId下面可能多个项目,就是靠artifactId来区分的 --> 
    <artifactId>project</artifactId>
    
    <!-- 版本号 --> 
    <version>1.0</version>
</project>

POM标签大全详解

<!--父项目的坐标。如果项目中没有规定某个元素的值,那么父项目中的对应值即为项目的默认值。 坐标包括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.mycompany.app生成的相对路径为:/com/mycompany/app -->

<groupId>asia.banseon</groupId>

<!-- 构件的标识符,它和group ID一起唯一标识一个构件。换句话说,你不能有两个不同的项目拥有同样的artifact ID和groupID;在某个

特定的group ID下,artifact ID也必须是唯一的。构件是项目产生的或使用的一个东西,Maven为项目产生的构件包括:JARs,源 码,二进制发布和WARs等。 -->

<artifactId>banseon-maven2</artifactId>

<!--项目产生的构件类型,例如jar、war、ear、pom。插件可以创建他们自己的构件类型,所以前面列的不是全部构件类型 -->

<packaging>jar</packaging>

<!--项目当前版本,格式为:主版本.次版本.增量版本-限定版本号 -->

<version>1.0-SNAPSHOT</version>

<!--项目的名称, Maven产生的文档用 -->

<name>banseon-maven</name>

<!--项目主页的URL, Maven产生的文档用 -->

<url>http://www.baidu.com/banseon</url>

<!-- 项目的详细描述, Maven 产生的文档用。 当这个元素能够用HTML格式描述时(例如,CDATA中的文本会被解析器忽略,就可以包含HTML标

签), 不鼓励使用纯文本描述。如果你需要修改产生的web站点的索引页面,你应该修改你自己的索引页文件,而不是调整这里的文档。 -->

<description>A maven project to study maven.</description>

<!--描述了这个项目构建环境中的前提条件。 -->

<prerequisites>

<!--构建该项目或使用该插件所需要的Maven的最低版本 -->

<maven />

</prerequisites>

<!--项目的问题管理系统(Bugzilla, Jira, Scarab,或任何你喜欢的问题管理系统)的名称和URL,本例为 jira -->

<issueManagement>

<!--问题管理系统(例如jira)的名字, -->

<system>jira</system>

<!--该项目使用的问题管理系统的URL -->

<url>http://jira.baidu.com/banseon</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>banseon@126.com</post>

    <!--订阅邮件的地址或链接,如果是邮件地址,创建文档时,mailto: 链接会被自动创建 -->

    <subscribe>banseon@126.com</subscribe>

    <!--取消订阅邮件的地址或链接,如果是邮件地址,创建文档时,mailto: 链接会被自动创建 -->

    <unsubscribe>banseon@126.com</unsubscribe>

    <!--你可以浏览邮件信息的URL -->

    <archive>http:/hi.baidu.com/banseon/demo/dev/</archive>

    </mailingList>

</mailingLists>

<!--项目开发者列表 -->

<developers>

    <!--某个项目开发者的信息 -->

    <developer>

    <!--SCM里项目开发者的唯一标识符 -->

    <id>HELLO WORLD</id>

    <!--项目开发者的全名 -->

    <name>banseon</name>

    <!--项目开发者的email -->

    <email>banseon@126.com</email>

    <!--项目开发者的主页的URL -->

    <url />

    <!--项目开发者在项目中扮演的角色,角色元素描述了各种角色 -->

    <roles>

    <role>Project Manager</role>

    <role>Architect</role>

    </roles>

    <!--项目开发者所属组织 -->

    <organization>demo</organization>

    <!--项目开发者所属组织的URL -->

    <organizationUrl>http://hi.baidu.com/banseon</organizationUrl>

    <!--项目开发者属性,如即时消息如何处理等 -->

    <properties>

    <dept>No</dept>

    </properties>

    <!--项目开发者所在时区, -11到12范围内的整数。 -->

    <timezone>-5</timezone>

    </developer>

</developers>