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
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 -- 项目对象模型的描述 ，它是maven配置的核心 |
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 |