maven学习

Posted on 2018-08-15 10:57  _wahaha  阅读(78)  评论(0)    收藏  举报

Maven入门教程

1.1. 介绍、环境配置

1.1.1. Maven介绍

Maven是一个采用纯Java编写的开源项目管理工具, Maven采用了一种被称之为Project Object Model (POM)概念来管理项目,所有的项目配置信息都被定义在一个叫做POM.xml的文件中, 通过该文件Maven可以管理项目的整个声明周期,包括清除、编译,测试,报告、打包、部署等等。目前Apache下绝大多数项目都已经采用Maven进行管理. 而Maven本身还支持多种插件, 可以方便更灵活的控制项目, 开发人员的主要任务应该是关注商业逻辑并去实现它, 而不是把时间浪费在学习如何在不同的环境中去依赖jar包,项目部署等。Maven正是为了将开发人员从这些任务中解脱出来而诞生的

1.1.2. Maven能够做什么

l  Jar的声明式依赖性管理

l  项目自动构建

1.1.3. 环境配置

l  http://maven.apache.org/download.html 下载最新版本Maven 3.0.2 (Binary zip)

 

l  解压到 D(本身就是绿色版不需要安装):

 

l  配置环境变量(配置之前,必须确定配置了JDK环境变量)

MAVEN_HOME : D:\apache-maven-3.0.2
把此命令添加到Path中: %MAVEN_HOME%\bin\

l  配置用户范围的settings.xml

MAVEN_HOME/conf/settings.xml 全局的

~/.m2/settings.xml 单个用户的


l  验证安装是否成功

在命令行上输入: mvn -version;回车, 如看到下面信息表示安装成功

 

1.1.4. Maven目录分析

l  bin:含有mvn运行的脚本

l  boot:含有plexus-classworlds类加载器框架

l  conf:含有settings.xml配置文件

l  lib:含有Maven运行时所需要的java类库

l  Settings.xml 中默认的用户库: ${user.home}/.m2/repository[A1] 

l  Maven默认仓库下载地址在: maven的lib目录下maven-model-builder-3.0.4.jar的pom.xml中

1.2. 第一个Maven演示

1.2.1.     创建目录结构

Convention Over Configuration (约定优于配置)。在现实生活中,有很多常识性的东西,地球人都知道。比如说:如何过马路(红灯停绿灯行),如何开门,关门等。对于这些事情,人们已经有了默认的约定, 在软件开发过程中,道理也是类似的,如果我们事先约定好所有项目的目录结构,标准开发过程(编译,测试) , 所有人都遵循这个约定。软件项目的管理就会变得简单很多。在现在流行的很多框架中,都使用了这个概念

Hello

 --src  

 -----main

 ----------java       --用来存放Java文件

 ----------resources   --用来存放资源文件

 -----test

 ---------java        --用来存放测试的Java文件

 ---------resources

 --target           --项目输出位置,编译完毕后自动生成

 --pom.xml

1.2.2.     建立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.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

  <!-- 当前pom的版本号 -->

  <modelVersion>4.0.0</modelVersion>

  <!-- groupId: 当前jar所属的命名空间 -->

  <groupId>cn.itcast.maven</groupId>

  <!-- 当前项目模块名称 -->

  <artifactId>Hello</artifactId>

  <!-- 当前项目的版本, SNAPSHOT镜像版 -->

  <version>0.0.1-SNAPSHOT</version>

    <!-- 当前模块需要依赖的相关jar包,也称为依赖管理, 所有被依赖的包都是通过"坐标"定位的 -->

    <dependencies>

        <!-- 需要依赖junit 通过 groupId+artifactId+version来查找,如果本地没有则到中央仓库下载 -->

       <dependency>

           <!-- 当前jar所属的命名空间 -->

           <groupId>junit</groupId>

           <!-- 依赖的项目模块的名称 -->

           <artifactId>junit</artifactId>

           <!-- 依赖的版本号 -->

           <version>4.9</version>

           <!-- 依赖的范围, 有 test compile privlege -->

           <scope>test</scope>

       </dependency>    

    </dependencies>

</project>

pom.xml 文件是maven对一个项目的核心配置,这个文件将包含你希望如何构建项目的大多数配置信息。POM大而复杂,但你不用全部去了解,只要使用一些常用的配置就可以了

1.2.3.     创建Java类与测试类

l  在src/main/java/cn/itcast/maven目录下新建文件Hello.java

package cn.itcast.maven;

public class Hello {

   public String sayHello(String name){

      return "Hello "+name+"!";

   }

}

l  在/src/test/java/cn/itcast/maven目录下新建测试文件HelloTest.java

package cn.itcast.maven;

import org.junit.Test;

import static junit.framework.Assert.*;

public class HelloTest {

        @Test

        public void testHello(){

                 Hello hello = new Hello();

                 String results = hello.sayHello("litingwei");

                 assertEquals("Hello litingwei!",results);                

        }

}

1.2.4.     命令测试

打开cmd命令行, 进入Hello项目根目录执行mvn compile命令, 查看根目录变化

cmd 中继续录入mvn clean命令,然后再次查看根目录变化

cmd 中录入 mvn clean compile命令, 查看根目录变化

cmd 中录入 mvn clean test命令,查看根目录变化

cmd 中录入 mvn clean package命令,查看根目录变化

1.3. Maven核心概念

1.3.1.     Maven插件

Maven的核心仅仅定义了抽象的生命周期,具体的任务都是交由插件完成的每个插件都能实现多个功能,每个功能就是一个插件目标

Maven的生命周期与插件目标相互绑定,以完成某个具体的构建任务, Maven的插件在: .m2\repository\org\apache\maven\plugins

1.3.2.     Maven坐标

类似在平面几何中坐标(x,y)可以标识平面中唯一的一点, Maven世界拥有大量构建,我们需要找一个用来唯一标识一个构建的统一规范

拥有了统一规范,就可以把查找工作交给机器

l  groupId:定义当前Maven项目隶属项目  (实际对应JAVA的包的结构, 是main目录里java的目录结构)

l  artifactId:定义实际项目中的一个模块(项目的唯一的标识符,实际对应项目的名称,就是项目根目录的名称)

l  version:定义当前项目的当前版本

1.3.3.     Maven仓库

l  何为Maven仓库:用来统一存储所有Maven共享构建的位置就是仓库

l  Maven配置jar包的路径为:groupId/artifactId/version/artifactId-version

l  本地仓库(~/.m2/repository/):每个用户只有一个本地仓库

l  中央仓库(Maven默认的远程仓库):Maven默认的远程仓库下载地址为:http://repo1.maven.org/maven2

l  私服:是一种特殊的远程仓库, 它是架设在局域网内的仓库, 主要是为了团队协作开发

l  镜像:用来替代中央仓库, 速度一般比中央仓库快

1.3.4.     生命周期

 

1.4. 第二个Maven演示

1.4.1.     HelloFriend目录结构

HelloFriend

 --src

 -----main

 ----------java

 ----------resources

 -----test

 ---------java

 ---------resources

 --pom.xml

1.4.2.     建立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.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

   <modelVersion>4.0.0</modelVersion>

   <groupId>cn.itcast.maven</groupId>

   <artifactId>HelloFriend</artifactId>

   <version>1.0.0</version>

   <packaging>jar</packaging>

   <dependencies>

      <dependency>

          <groupId>junit</groupId>

          <artifactId>junit</artifactId>

          <version>4.9</version>

          <scope>test</scope>

      </dependency>

      <dependency>

          <groupId>cn.itcast.maven</groupId>

          <artifactId>Hello</artifactId>

          <version>1.0.0</version>

          <scope>compile</scope>

      </dependency>

   </dependencies>

</project>

1.4.3.     创建Java类与测试类

l  在src/main/java/cn/itcast/maven目录下新建文件HelloFriend.java

package cn.itcast.maven;

public class HelloFriend{

   public String sayHello(String name){

      return "Hello "+name+"!";

   }

}

l  在/src/test/java/cn/itcast/maven目录下新建测试文件HelloFriendTest.java

package cn.itcast.maven;

import org.junit.Test;

import cn.itcast.maven.Hello;

public class HelloFriendTest {

   @Test

   public void tesHelloFriend(){

      HelloFriend helloFriend = new HelloFriend();

      String results = helloFriend.sayHelloToFriend("litingwei");

      System.out.println(results);   

   }

}

1.4.4.     命令测试

l  在HelloFriend目录下执行 mvn clean mvn compile mvn test 都正常

l  在HelloFriend目录下执行命令mvn package 系统报错说没有找到依赖, 因为HelloFriend依赖Hello模块,但是此模块在个人仓库和中央仓库中并不存在

l  需要重新构建Hello第一个项目并安装到数据仓库, 在Hello根目录下执行mvn clean install, 就会部署的中央仓库中

1.5. Maven与Eclipse整合

1.5.1.     配置maven插件

 

1.5.2.     user settings

 

1.6. Maven部署到Tomcat中

1.6.1.     创建Java项目

l  在MyEclipse创建项目的时候选择Maven Project

 

l  在构件向导的时候选择quickstart注意, 此向导也是插件,第一次使用的时候.也要从远程仓库中下载相应的jar包, 因此需要网络环境

 

l  设置当前模块的坐标,和相应的版本号

 

l  创建完毕后默认生成的项目包目录如下

 

l  通过在pom.xml中配置相应Hello.jar即可

<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>Hello3</groupId>

  <artifactId>Hello3</artifactId>

  <version>0.0.1-SNAPSHOT</version>

  <packaging>jar</packaging>

  <!-- 当前Maven模块的相关信息,可选信息 -->

  <name>Hello3</name>

  <url>http://maven.apache.org</url>

  <!-- 设置常量, 下面可以通过${project.build.sourceEncoding}来引用,一般来说版本号设置在此处 -->

  <properties>

<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

  </properties>

  <!-- 依赖管理 -->

  <dependencies>

    <!-- 依赖Junit-->

    <dependency>

      <groupId>junit</groupId>

      <artifactId>junit</artifactId>

      <version>4.9</version>

      <scope>test</scope>

    </dependency>

    <!-- 依赖前面的Hello, 那么在仓库中必须拥有 Hello的坐标 -->

    <dependency>

       <groupId>cn.itcast.maven</groupId>

          <artifactId>Hello</artifactId>

          <version>0.0.1-SNAPSHOT</version>

        <scope>compile</scope>

    </dependency>

  </dependencies>

</project>

l  通过在pom.xml中单击右键选择相应的命令即可

 

1.6.2.     创建Web项目

l  选择创建一个普通的web工程

 

l  设置相应的坐标

 

l  如果采用src缺省的包结构,则pom.xm中需要指定编译和调试的目录.

<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>web</groupId>

  <artifactId>web</artifactId>

  <version>0.0.1-SNAPSHOT</version>

  <packaging>war</packaging>

  <!-- 配置常量 -->

  <properties>

    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

    <jstl.version>1.2</jstl.version>

    <compiler.version>1.6</compiler.version>

  </properties>

  <!-- 定义依赖管理 -->

  <dependencies>

    <!-- 定义需要依赖的系统jar, provided则在打包的时候不会包含 -->

    <dependency>

      <groupId>javax.servlet</groupId>

      <artifactId>jstl</artifactId>

      <version>${jstl.version}</version>

      <scope>provided</scope>

    </dependency>

    <dependency>

      <groupId>javax.servlet.jsp</groupId>

      <artifactId>jsp-api</artifactId>

      <version>2.1</version>

      <scope>provided</scope>

    </dependency>

    <!-- 定义依赖的第三方包,compile 则打包的时候会自动加载到lib目录中 -->

    <dependency>

    <groupId>cn.itcast.maven</groupId>

          <artifactId>Hello</artifactId>

          <version>0.0.1-SNAPSHOT</version>

        <scope>compile</scope>

    </dependency>

  </dependencies>

  <!-- 用来定义构建阶段的标签 -->

  <build>

    <!-- 由于采用的非Maven的约定,则在构建的时候要指定的目录 -->

    <sourceDirectory>${basedir}/src</sourceDirectory>

   <outputDirectory>${basedir}/WebRoot/WEB-INF/classes</outputDirectory>

    <resources>

      <!-- 资源文件也存放到src中但排除 *.java -->

      <resource>

        <directory>${basedir}/src</directory>

        <excludes>

          <exclude>**/*.java</exclude>

        </excludes>

      </resource>

    </resources>

    <plugins>

      <!-- 配置相应的打包插件  -->

      <plugin>

        <artifactId>maven-war-plugin</artifactId>

        <configuration>

          <webappDirectory>${basedir}/WebRoot</webappDirectory>

          <warSourceDirectory>${basedir}/WebRoot</warSourceDirectory>

        </configuration>

      </plugin>

      <plugin>

        <artifactId>maven-compiler-plugin</artifactId>

        <configuration>

          <source>${compiler.version}</source>

          <target>${compiler.version}</target>

        </configuration>

      </plugin>

    </plugins>

  </build>

</project>

l  在index.jsp页面中添加如下代码

<body>

      <%    // 要导入相应: cn.itcast.maven.*

        Hello hello=new Hello();

            out.println(hello.sayHello("admin"));

      %>

</body>

1.7. Maven私服

1.7.1.     关于中央仓库注意事项

l  地址: 目前来说: http://repo1.maven.org/maven2/是真正的Maven中央仓库的地址,该地址内置在Maven的源码中其他的都是镜像

l  索引: 中央仓库带有索引文件以方便用户对其进行搜索,完整的索引文件大小约为60M,索引每周更新一次

l  黑名单: 如果某个IP地址恶意的下载中央仓库内容,例如全公司100台机器使用同一个IP反复下载,这个IP(甚至是IP段)会进入黑名单,因此稍有规模的使用Maven时,应该用Nexus架设私服

1.7.2.     为什么需要私服

        为什么要搭建nexus私服,原因很简单,有些公司都不提供外网给项目组人员,因此就不能使用maven访问远程的仓库地址,所以很有必要在局域网里找一台有外网权限的机器,搭建nexus私服,然后开发人员连到这台私服上,这样的话就可以通过这台搭建了nexus私服的电脑访问maven的远程仓库

 

1.7.3.     Nexus环境搭建

第一步:下载nexus-webapp-1.9.2.4.war包,然后拷贝到tomcat下的webapps目录中

第二步:启动tomcat 默认登录账户密码为: admin  admin123

第三步:访问http://localhost:8080/项目名称/

1.7.4.     认识repository

Nexus仓库的默认的地址, nexus-2.1.2\WEB-INF\plexus.properties 中定义的

在Views/Repositories-->Repositories里进行配置, nexus里可以配置3种类型的仓库,分别是proxy、hosted、group

proxy:是远程仓库的代理。比如说在nexus中配置了一个central repository的proxy,当用户向这个proxy请求一个artifact,这个proxy就会先在本地查找,如果找不到的话,就会从远程仓库下载,然后返回给用户,相当于起到一个中转的作用

Hosted:是宿主仓库,用户可以把自己的一些构件,deploy到hosted中,也可以手工上传构件到hosted里。比如说oracle的驱动程序,ojdbc6.jar,在central repository是获取不到的,就需要手工上传到hosted里

Group:是仓库组,在maven里没有这个概念,是nexus特有的。目的是将上述多个仓库聚合,对用户暴露统一的地址,这样用户就不需要在pom中配置多个地址,只要统一配置group的地址就可以了右边那个Repository Path可以点击进去,看到仓库中artifact列表。不过要注意浏览器缓存。我今天就发现,明明构件已经更新了,在浏览器里却看不到,还以为是BUG,其实是被浏览器缓存了

virtual:也是中央仓库镜像,支持M1老版本

1.7.5.     每个仓库的作用

3rd party: 无法从公共仓库获得的第三方发布版本的构件仓库
Apache Snapshots: 用了代理ApacheMaven仓库快照版本的构件仓库
Central: 用来代理maven中央仓库中发布版本构件的仓库
Central M1 shadow: 用于提供中央仓库中M1格式的发布版本的构件镜像仓库
Codehaus Snapshots: 用来代理CodehausMaven 仓库的快照版本构件的仓库
Releases: 用来部署管理内部的发布版本构件的宿主类型仓库
Snapshots:用来部署管理内部的快照版本构件的宿主类型仓库

 

 

 

 

1.7.6.     Central Repository

最关键的一个配置, 就是Central Repository的proxy配置,因为大部分的构件,都是要通过这个proxy得到的,

1.7.7.     配置Hosted Repository

一般会配置3个hosted repository, 分别是3rd party、Snapshots、Releases,分别用来保存第三方jar(典型的比如ojdbc6.jar),项目组内部的快照、项目组内部的发布版, 这里并没有什么特别的配置,只是Deployment Policy这个选项,一般Snapshots会配置成允许,而Releases和3rd party会设置为禁止

 

1.7.8.     配置group repository

前面说过group其实是一个虚拟的仓库, 通过对实体仓库(proxy、hosted)进行聚合, 对外暴露一个统一的地址这里要注意的是,放到左边的仓库,才是会被聚合的仓库

 

1.7.9.     从私服中下载资源

l  可以在支持Maven的项目中进行如下配置

<repositories>

    <repository>

       <id>shop</id>

       <name>仓库介绍</name>

    <url>http://localhost:8080/nexus-2.1.2/content/groups/public/</url>

    </repository>

 </repositories>

 <pluginRepositories>

    <pluginRepository>

       <id>plugin</id>

       <name>插件下载地址</name>

    <url>http://localhost:8080/nexus-2.1.2/content/groups/public/</url>

    </pluginRepository>

 </pluginRepositories>

l  也可以把地址配置在setting.xml的<profiles>标签中这样对所有项目都生效

<profiles>

      <repositories>

       <repository>

           <id>shop</id>

           <name>仓库介绍</name>

    <url>http://localhost:8080/nexus-2.1.2/content/groups/public/</url>

       </repository>

    </repositories>

    <pluginRepositories>

       <pluginRepository>

           <id>plugin</id>

           <name>插件下载地址</name>     <url>http://localhost:8080/nexus-2.1.2/content/groups/public/</url>

       </pluginRepository>

    </pluginRepositories>

 </profiles>

l  把本地项目提交到私服中

<distributionManagement>

       <repository>

           <!-- 要在个人的setting.xml中配置上传的密码 -->

           <id>snapshots</id>

           <name>snapshots 测试版</name>

           <!-- nexus中查找相应的地址-->

            <url>http://localhost:8080/nexus/content/repositories

            /snapshots/</url>

       </repository>

</distributionManagement>

 

<servers>

    <!-- 在.m2\setting.xml中 配置了要上传仓库的密码 -->

    <server>

       <id>snapshots</id>

       <username>admin</username>

       <password>admin123</password>

    </server>

    <server>

       <id>releases</id>

       <username>admin</username>

       <password>admin123</password>

    </server>

  </servers>

1.8. 其它小技巧

1.8.1.     跳过单元测试

你可能想要配置 Maven 使其完全跳过单元测试。 可能你有一个很大的系统,单元测试需要花好多分钟来完成,而你不想在生成最终输出前等单元测试完成。 你可能正工作在一个遗留系统上面,这个系统有一系列的失败的单元测试,你可能仅仅想要生成一个 JAR 而不是去修复所有的单元测试。 Maven 提供了跳过单元测试的能力

l  采用命令的方式跳过单元测试

$ mvn install -D maven.test.skip=true

l  采用配置的方式跳过单元测试

surefire 插件用来在maven构建生命周期的test 的插件, 如果每次都不需要运行test则通过简单的配置即可

<build>

       <plugins>

           <plugin>

              <artifactId>maven-surefire-plugin</artifactId>

              <version>2.7.1</version>

              <configuration>

                  <skip>true</skip>

              </configuration>

           </plugin>

       </plugins>

    </build>

1.8.2.     代码的方式生成maven骨架

Archetype可以帮助我们迅速地构建起项目的骨架,在前面的例子中,我们完全可以在Archetype生成的骨架的基础上开发Hello World项目以节省大量时间,如果没有制定packageName则默认与goupId相同

mvn archetype:create -D groupId=com.test.maven -D artifactId=test1 -D packageName=a.b.c


通过maven下载的jar包都会存储到指定的个人仓库中

博客园  ©  2004-2025
浙公网安备 33010602011771号 浙ICP备2021040463号-3