首页 > 代码库 > eclipse插件——maven
eclipse插件——maven
项目开发中遇到的问题
都是同样的代码，为什么在我的机器上可以编译执行，而在他的机器上就不行？
为什么在我的机器上可以正常打包，而配置管理员却打不出来?
项目组加入了新的人员，我要给他说明编译环境如何设置，但是让我挠头的是，有些细节我也记不清楚了
我的项目依赖一些jar包，我应该把他们放哪里？放源码库里？
这是我开发的第二个项目，还是需要上面的那些jar包，再把它们复制到我当前项目的svn库里吧
现在是第三次，再复制一次吧 —– 这样真的好吗？
我写了一个数据库相关的通用类，并且推荐给了其他项目组，现在已经有五个项目组在使用它了，今天我发现了一个bug，并修正了它，我会把jar包通过邮件发给其他项目组,这不是一个好的分发机制，太多的环节可能导致出现bug
项目进入测试阶段，每天都要向测试服务器部署一版。每次都手动部署，太麻烦了
什么是maven
Maven的概念
- maven翻译为“专家”，“内行”。Maven是基于项目对象模型(POM)，可以通过一小段描述信息来管理项目的构建，报告和文档的软件项目管理工具。
- Maven是跨平台的项目管理工具。主要服务于基于Java平台的项目构建，依赖管理和项目信息管理。
- Maven主要有两个功能：
- 项目构建
- 依赖管理
什么是构建
为什么使用maven?
- Eclipse
手工操作较多，编译、测试、部署等工作都是独立的，很难一步完成
每个人的IDE配置都不同，很容易出现本地代码换个地方编译就出错 - Ant
没有一个约定的目录结构
必须明确让ant做什么，什么时候做，然后编译，打包
没有生命周期，必须定义目标及其实现的任务序列
没有集成依赖管理 - Maven
拥有约定，知道你的代码在哪里，放到哪里去
拥有一个生命周期，例如执行 mvn install 就可以自动执行编译，测试，打包等构建过程只需要定义一个pom.xml,然后把源码放到默认的目录，Maven帮你处理其他事情
Maven模型
Maven的安装及配置
下载maven
官方网站：http://maven.apache.org
本课程使用的maven的版本为3.0.5
Maven的安装
- 第一步：安装jdk，要求1.6或以上版本
- 第二步：解压maven的压缩包。解压目录最好不要有中文。
- 第三步：配置系统环境变量，MAVEN_HOME
- 第四步：设置环境变量Path，将%MAVEN_HOME%\bin加入Path中，一定要注意要用分号；与其他值隔开
- 第五步：5.验证安装是否成功，打开cmd窗口，敲入mvn -v 查看
Maven安装目录分析
- bin：含有mvn运行的脚本
- boot：含有plexus-classworlds类加载器框架。plexus-classworlds是一个类加载器框架，相对于默认的java类加载器，它提供了更丰富的语法以方便配置，Maven使用该框架加载自己的类库。对于一般的Maven用户来说，不必关心该文件。
- conf：含有settings.xml配置文件，此配置为maven的全局配置。
- lib：含有Maven运行时所需要的java类库
LICENSE.txt, NOTICE.txt, README.txt针对Maven版本，第三方软件等简要介绍
Maven的配置
- Maven的默认配置
- 在MAVEN_HOME下的配置文件：MAVEN_HOME/conf/settings.xml 是maven全局的配置。如果不对其修改的话，默认本地仓库的路径就是：当前用户路径C:\Users[UserName].m2
- localRepository：用户仓库，用于检索依赖包路径
用户配置
- 配置方法：
- 1、在你想保存仓库的位置创建一个目录作为仓库目录。例如在d:盘创建一个MavenRepository目录
- 2、在其中创建一个名为“repository”的目录。
- 3、修改MAVEN_HOME\conf\settings.xml
- 4、从MAVEN_HOME\conf中把settings.xml复制到MavenRepository目录。得到如下结构：
- ！注意：
用户级别的仓库在全局配置中一旦设置，全局配置将不再生效，转用用户所设置的仓库，否则使用默认路径仓库
- 配置方法：
创建Maven工程
4.1 遵从Maven约定
src/main/java —— 存放项目的.java文件
src/main/resources —— 存放项目资源文件，如spring, hibernate配置文件
src/test/java —— 存放所有测试.java文件，如JUnit测试类
src/test/resources —— 测试资源文件
target —— 项目输出位置
pom.xml——maven项目核心配置文件Project
|-src
| |-main
| | |-java —— 存放项目的.java文件
| | |-resources —— 存放项目资源文件，如spring, hibernate配置文件
| |-test
| |-java ——存放所有测试.java文件，如JUnit测试类
| |-resources —— 测试资源文件
|-target —— 目标文件输出位置例如.class、.jar、.war文件
|-pom.xml ——maven项目核心配置文件4.2 第一步：创建maven工程
首先建立MavenHelloWorld项目同时建立Maven约定的目录结构
MavenHelloWorld
|-src
| |-main
| | |-java —— 存放项目的.java文件
| | |-resources —— （暂时省略）
| |-test
| |-java ——存放所有测试.java文件，如JUnit测试类
| |-resources —— （暂时省略）
|-target —— （不手工创建）
|-pom.xml ——maven项目核心配置文件4.3 第二步：创建HelloWorld.java
在src/main/java/cn/change/maven目录下新建文件Hello.java
package cn.change.maven; public class HelloWorld { public String sayHello(String name){ return "Hello World :" + name + "!"; } }
4.4 第三步：新建测试文件HelloTest.java
在/src/test/java/cn/change/maven目录下新建测试文件HelloTest.java
package cn.change.maven; import org.junit.Test; import static junit.framework.Assert.*; public class HelloWorldTest{ @Test public void testHello(){ HelloWorld hello = new HelloWorld(); String results = hello.sayHello("maven"); assertEquals("Hello World :maven!",results); } }
4.5 第四步：创建pom.xml
在项目MavenHelloWorld根目录建立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/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.bshinfo.el</groupId> <artifactId>ccb_el_manager</artifactId> <version>0.0.1-SNAPSHOT</version> <name>ccb_el_manager Maven Webapp</name> <url>http://maven.apache.org</url> <packaging>war</packaging> <build> <finalName>ccb_el_manager</finalName> </build> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.11</version> <scope>test</scope> </dependency> <!-- spring jar --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>4.2.5.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>4.2.5.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context-support</artifactId> <version>4.2.5.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-tx</artifactId> <version>4.2.5.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-aop</artifactId> <version>4.2.5.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-beans</artifactId> <version>4.2.5.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-jdbc</artifactId> <version>4.2.5.RELEASE</version> </dependency> <dependency> <groupId>org.springframework.security</groupId> <artifactId>spring-security-core</artifactId> <version>4.0.4.RELEASE</version> </dependency> <dependency> <groupId>org.springframework.security</groupId> <artifactId>spring-security-web</artifactId> <version>4.0.4.RELEASE</version> </dependency> <dependency> <groupId>org.springframework.security</groupId> <artifactId>spring-security-config</artifactId> <version>4.0.4.RELEASE</version> </dependency> <dependency> <groupId>org.springframework.security</groupId> <artifactId>spring-security-cas</artifactId> <version>4.0.4.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-jms</artifactId> <version>4.2.5.RELEASE</version> </dependency> <!-- spring mvc jar --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-web</artifactId> <version>4.2.5.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>4.2.5.RELEASE</version> </dependency> <!-- mybatis jar --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.3.1</version> </dependency> <!-- mybatis-paginator jar --> <dependency> <groupId>com.github.miemiedev</groupId> <artifactId>mybatis-paginator</artifactId> <version>1.2.10</version> </dependency> <!-- mybatis-spring jar --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>1.2.4</version> </dependency> <!-- mysql-connector-java jar --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.38</version> </dependency> <!-- 数据库连接池 jar --> <dependency> <groupId>commons-dbcp</groupId> <artifactId>commons-dbcp</artifactId> <version>1.4</version> </dependency> <dependency> <groupId>commons-pool</groupId> <artifactId>commons-pool</artifactId> <version>1.6</version> </dependency> <!-- log jar --> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.17</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>1.7.19</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.7.19</version> </dependency> <!-- jsp Template jar --> <dependency> <groupId>org.freemarker</groupId> <artifactId>freemarker</artifactId> <version>2.3.23</version> </dependency> <!-- apache servlet api jar --> <dependency> <groupId>org.apache.tomcat</groupId> <artifactId>tomcat-servlet-api</artifactId> <version>8.0.32</version> </dependency> <dependency> <groupId>org.aspectj</groupId> <artifactId>aspectjweaver</artifactId> <version>1.8.9</version> </dependency> <dependency> <groupId>org.aspectj</groupId> <artifactId>aspectjrt</artifactId> <version>1.8.9</version> </dependency> <dependency> <groupId>org.aspectj</groupId> <artifactId>aspectjtools</artifactId> <version>1.8.9</version> </dependency> <!-- activemq --> <dependency> <groupId>org.apache.activemq</groupId> <artifactId>activemq-core</artifactId> <version>5.7.0</version> </dependency> <dependency> <groupId>org.apache.activemq</groupId> <artifactId>activemq-pool</artifactId> <version>5.13.2</version> </dependency> <!-- cas security --> <dependency> <groupId>org.jasig.cas.client</groupId> <artifactId>cas-client-core</artifactId> <version>3.4.1</version> </dependency> <!-- end of cas security --> <dependency> <groupId>net.sf.json-lib</groupId> <artifactId>json-lib</artifactId> <version>2.4</version> <classifier>jdk15</classifier> </dependency> <dependency> <groupId>commons-codec</groupId> <artifactId>commons-codec</artifactId> <version>1.10</version> </dependency> <dependency> <groupId>org.codehaus.jackson</groupId> <artifactId>jackson-mapper-asl</artifactId> <version>1.5.0</version> </dependency> <dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>1.2.2</version> </dependency> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-io</artifactId> <version>1.3.2</version> </dependency> </dependencies> </project>
4.6 第五步：测试maven命令
- 打开cmd命令行，进入Hello项目根目录(包含有pom.xml文件的目录)
4.6.1 mvn compile命令
- 执行完毕后，生成了maven工程编译完成后字节码文件的生成目录target
- 执行 mvn compile命令
- 执行完毕后，生成了maven工程编译完成后字节码文件的生成目录target
4.6.2 mvn clean命令
- cmd 中继续录入mvn clean命令
- 执行完毕后，字节码生成目录被删除
4.6.3 mvn test命令
- cmd 中录入 mvn test命令
- 执行完毕后，字节码生成目录中生成了被测试类与测试类的编译字节码和测试执行过程日志与详细报告
4.6.4 mvn clean compile命令
- cmd 中录入 mvn clean compile命令
- 组合指令，先执行clean，再执行compile，通常应用于上线前执行，清除测试类
4.6.5 mvn clean test命令
- cmd 中录入 mvn clean test命令
- 组合指令，先执行clean，再执行test，通常应用于测试环节
4.6.6 mvn clean package命令
- cmd 中录入 mvn clean package命令
- 组合指令，先执行clean，再执行package，将项目打包，通常应用于发布前
- 执行过程：
- 清理————清空环境
- 编译————编译源码
- 测试————测试源码
- 打包————将编译的非测试类打包
- 4.6.7 mvn clean install命令
- cmd 中录入 mvn clean install 查看仓库，当前项目被发布到仓库中
- 组合指令，先执行clean，再执行install，将项目打包，通常应用于发布前
- 执行过程：
- 清理————清空环境
- 编译————编译源码
- 测试————测试源码
- 打包————将编译的非测试类打包
- 部署————将打好的包发布到资源仓库中
- 4.6.8 错误范例
说明：MAVEN 命令输入错误，命令名称显示在[ERROR] Unknown lifecycle phase “compoile”
引号中的内容为输入错误的名称
[ERROR] Unknown lifecycle phase “compoile”. You must specify a valid lifecycle p
hase or a goal in the format : or :
M2Eclipse
- 5.1 安装m2eclipse插件
- Maven插件的位置，在参考资料\eclipse插件目录下：
- 只需要把这两个文件件复制到Eclipse安装目录下的dropins目录下即可。
- 5.2 配置maven插件
- 查看maven插件是否安装成功：启动Eclipse→window→preference→Maven
- 2、设置maven环境，也就是指定maven的安装目录
- 3、加载用户配置
5.3 创建maven工程
- 5.3.1 第一个maven工程
- 第一步：选择new→maven→Maven Project
- 第二步：next
- 第三步：next
- 选择maven的工程骨架，这里我们选择quickstart。点击next。
- 第四步：next
- 输入GroupId、ArtifactId、Version、Package信息点击finish完成。
- 5.3.2 执行maven命令
- 在Eclipse的maven插件中执行maven命令，需要在maven工程或者pom.xml文件上点击右键，选择Run as→maven build.
5.3.3 第二个maven工程
- 5.3.3.1 创建工程
- 第一个工程创建时选用的是maven插件提供的工程骨架，每次选择骨架时都需要联网下载，如果网络不通或者较慢的情况下会有很长时间的等待。使用很是不方便，所以创建工程时可以不选择骨架直接创建工程。
- 第一步：新建maven工程
- 输入Groupid、artifactid、version三项内容，然后选择packaging也就是工程的打包格式，常用的打包格式为jar、war、pom三种。
第三步：点击finish完成。
5.3.3.2 修改pom文件
- 需求：在second工程中调用first工程中的First类的方法，然后测试。
- `
- 5.3.1 第一个maven工程
package cn.change.second;
import cn.change.first.First;
public class Second {
public String say(String name) {
First first = new First();
String result = first.say(name);
return result + ":second";
}
}
- 5.3.3.4 创建SecondTest.java
package cn.change.sencond;
import org.junit.Assert;
import org.junit.Test;
import cn.change.second.Second;
public class SecondTest {
@Test
public void testSay() {
Second second = new Second();
String result = second.say("张三");
Assert.assertEquals("hello 张三:first:second", result);
}
}
- 5.3.3.5 测试工程
- 
- 如果maven-first工程没有安装则会出现以下错误：
[INFO] Scanning for projects…
[INFO]
[INFO] ————————————————————————
[INFO] Building maven-second 0.0.1-SNAPSHOT
[INFO] ————————————————————————
[WARNING] The POM for cn.change:maven-first:jar:0.0.1-SNAPSHOT is missing, no dependency information available
[INFO] ————————————————————————
[INFO] BUILD FAILURE
[INFO] ————————————————————————
[INFO] Total time: 0.218s
[INFO] Finished at: Fri Sep 25 15:06:00 CST 2015
[INFO] Final Memory: 4M/15M
[INFO] ————————————————————————
[ERROR] Failed to execute goal on project maven-second: Could not resolve dependencies for project cn.change:maven-second:jar:0.0.1-SNAPSHOT: Could not find artifact cn.change:maven-first:jar:0.0.1-SNAPSHOT -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR]
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/DependencyResolutionException
提示找不到maven-first的jar包。当系统运行时是从本地仓库中找依赖的jar包的，所以必须先将maven-first安装才能正常运行，需要在maven-first工程上运行 mvn install命令安装到本地仓库。
- 5.3.4 第三个工程
- 创建第三个工程此工程使用maven-second工程中的Second的方法，并测试。
- 5.3.4.1 创建工程
- 
- 5.3.4.2 修改pom文件
<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.change</groupId>
<artifactId>maven-third</artifactId>
<version>0.0.1-SNAPSHOT</version>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.9</version>
<scope>test</scope>
</dependency>
<!-- 依赖maven-first工程 -->
<dependency>
<groupId>cn.change</groupId>
<artifactId>maven-second</artifactId>
<version>0.0.1-SNAPSHOT</version>
</dependency>
</dependencies>
</project>
- 5.3.4.3 依赖关系
- 
- 5.3.4.4 创建Third.java
package cn.change.third;
import cn.change.second.Second;
public class Third {
public String say(String name) {
Second second = new Second();
String result = second.say(name);
return result + ":third";
}
}
- 5.3.4.5 创建ThirdTest.java
package cn.change.third;
import org.junit.Assert;
import org.junit.Test;
public class ThirdTest {
@Test
public void testSay() {
Third third = new Third();
String result = third.say("张三");
Assert.assertEquals("hello 张三:first:second:third", result);
}
}
Maven核心概念
Maven的核心概念包括：坐标、依赖管理、仓库管理、生命周期、插件和目标、
聚合继承。
6.1 坐标
6.1.1 什么是坐标
- groupId：定义当前Maven组织名称
- artifactId：定义实际项目名称
- version：定义当前项目的当前版本
- packaging：定义该项目的打包方式，如果没有此项则默认为jar包。
6.1.2 Maven坐标主要组成
- Maven世界拥有大量构建，我们需要找一个用来唯一标识一个构建的统一规范
拥有了统一规范，就可以把查找工作交给机器
- Maven世界拥有大量构建，我们需要找一个用来唯一标识一个构建的统一规范
6.1.3 Maven为什么使用坐标
- `依赖声明主要包含如下元素：
<dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.10</version> <scope>test</scope> </dependency>
`6.2 依赖管理
其中依赖范围scope 用来控制依赖和编译，测试，运行的classpath的关系. 主要的是三种依赖关系如下：
1.compile： 默认编译依赖范围。对于编译，测试，运行三种classpath都有效
- 2.test：测试依赖范围。只对于测试classpath有效
- 3.provided：已提供依赖范围。对于编译，测试的classpath都有效，但对于运行无效。因为由容器已经提供，例如servlet-api
- 4.runtime:运行时提供。例如:jdbc驱动
- 5.import
- 6.system
如果Two中使用One，Three中使用Two则称Two是Three的直接依赖，而称One是Three的间接依赖。
C->B B->A
C直接依赖B
C间接依赖A
- 6.3 生命周期
- -
Maven生命周期就是为了对所有的构建过程进行抽象和统一。包括项目清理，初始化，编译，打包，测试，部署等几乎所有构建步骤。
生命周期可以理解为构建工程的步骤。在Maven中有三套相互独立的生命周期，请注意这里说的是“三套”，而且“相互独立”，这三套生命周期分别是：
Clean Lifecycle 在进行真正的构建之前进行一些清理工作。 Default Lifecycle
构建的核心部分，编译，测试，打包，部署等等。 Site Lifecycle 生成项目报告，站点，发布站点。
再次强调一下它们是相互独立的，你可以仅仅调用clean来清理工作目录，仅仅调用site来生成站点。当然你也可以直接运行 mvn clean
install site 运行所有这三套生命周期。
- Maven三大生命周期
- 6.3.2.1 clean：清理项目
- 6.3.2.1 clean：清理项目
clean生命周期每套生命周期都由一组阶段(Phase)组成，我们平时在命令行输入的命令总会对应于一个特定的阶段。比如，运行mvn clean ，这个的clean是Clean生命周期的一个阶段。有Clean生命周期，也有clean阶段。Clean生命周期一共包含了三个阶段：
pre-clean 执行一些需要在clean之前完成的工作 clean 移除所有上一次构建生成的文件 post-clean
执行一些需要在clean之后立刻完成的工作mvn clean 中的clean就是上面的clean，在一个生命周期中，运行某个阶段的时候，它之前的所有阶段都会被运行，也就是说，mvn
clean 等同于 mvn pre-clean clean ，如果我们运行 mvn post-clean ，那么
pre-clean，clean 都会被运行。这是Maven很重要的一个规则，可以大大简化命令行的输入。
- 6.3.2.2 default：构建项目
-
Default生命周期Default生命周期是Maven生命周期中最重要的一个，绝大部分工作都发生在这个生命周期中。这里，只解释一些比较重要和常用的阶段：
validate generate-sources process-sources generate-resources
process-resources 复制并处理资源文件，至目标目录，准备打包。 compile 编译项目的源代码。
process-classes generate-test-sources process-test-sources
generate-test-resources process-test-resources 复制并处理资源文件，至目标测试目录。
test-compile 编译测试源代码。 process-test-classes test
使用合适的单元测试框架运行测试。这些测试代码不会被打包或部署。 prepare-package package
接受编译好的代码，打包成可发布的格式，如 JAR 。 pre-integration-test integration-test
post-integration-test verify install 将包安装至本地仓库，以让其它项目依赖。 deploy
将最终的包复制到远程的仓库，以让其它开发人员与项目共享。运行任何一个阶段的时候，它前面的所有阶段都会被运行，这也就是为什么我们运行mvn install
的时候，代码会被编译，测试，打包。此外，Maven的插件机制是完全依赖Maven的生命周期的，因此理解生命周期至关重要。
- 6.3.2.3 site：生成项目站点
-
Site生命周期
pre-site 执行一些需要在生成站点文档之前完成的工作
site 生成项目的站点文档
post-site 执行一些需要在生成站点文档之后完成的工作，并且为部署做准备
site-deploy 将生成的站点文档部署到特定的服务器上
这里经常用到的是site阶段和site-deploy阶段，用以生成和发布Maven站点，这可是Maven相当强大的功能，Manager比较喜欢，文档及统计数据自动生成，很好看。
6.4 Maven插件
- Maven的核心仅仅定义了抽象的生命周期，具体的任务都是交由插件完成的。每个插件都能实现一个功能，每个功能就是一个插件目标。Maven的生命周期与插件目标相互绑定，以完成某个具体的构建任务。
例如compile就是插件maven-compiler-plugin的一个插件目标
- Maven的核心仅仅定义了抽象的生命周期，具体的任务都是交由插件完成的。每个插件都能实现一个功能，每个功能就是一个插件目标。Maven的生命周期与插件目标相互绑定，以完成某个具体的构建任务。
eclipse插件——maven