Maven--Maven 入门

1.POM

 1 <?xml version="1.0" encoding="utf-8" ?>
 2 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
 4 
 5     <modelVersion>4.0.0</modelVersion>
 6     <groupId>org.wzh.MavenDemo</groupId>
 7     <artifactId>MavenDemo</artifactId>
 8     <version>1.0-SNAPSHOT</version>
 9     <name>MavenDemo</name>
10 
11 </project>

代码的第一行是 XML 头，指定了该 xml 文档的版本和编码方式。

紧接着是 project 元素，project 是所有 pom.xml 的根元素，它还声明了一些 POM 相关的命名空间及 xsd 元素，虽然这些属性不是必须的，但使用这些属性能够让第三方工具（如 IDE 中的 XML 编辑器）帮助我们快速编辑 POM。

modelVersion 指定了当前 POM 模型的版本，对于 Maven2 及 Maven3 来说，它只能是4.0.0。

groupId 定义了项目属于哪个组，这个组往往和项目所在的组织或公司存在关联。譬如在 googlecode 上建立了一个名为 myapp的项目，那么 groupId 就应该是 com.googlecode.myapp，如果你的公司是 mycom，有一个项目为 myapp，那么 groupId 就应该是 com.mycom.myapp。

artifactId 定义了当前 Maven 项目在组中唯一的 ID。

version 指定了项目当前的版本。SNAPSHOT 意为快照，说明该项目还处在开发中，是不稳定的版本。

name 元素声明了一个对于用户更为友好的项目名称，虽然这不是必须的，但还是推荐为每个 POM 声明 name，以方便信息交流。

2.编写主代码

Maven 项目标准目录结构：

参考：http://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html

项目主代码和测试代码不同，项目的主代码会被打包到最终的构件中（如jar），而测试代码只在运行测试时用到，不会被打包。默认情况下，Maven 项目主代码位于

src/main/java 目录。

3.编写测试代码

为了使项目结构保持清晰，主代码与测试代码应该分别位于独立的目录中。Maven 项目中默认的测试代码目录是

src/test/java

JUnit 是事实上的单元测试标准。要使用 JUnit，需要添加 JUnit 依赖。

1 <dependency>
2     <groupId>junit</groupId>
3     <artifactId>junit</artifactId>
4     <version>3.8.1</version>
5     <scope>test</scope>
6 </dependency>

scope 为依赖范围，若依赖范围为 test 则表示该依赖只对测试有效。如果不声明依赖范围，那么默认值就是 compile，表示该依赖对主代码和测试代码都有效。

在 Maven 执行测试（test）之前，它会自动执行项目主资源处理、主代码编译、测试资源处理、测试代码编译等工作，这是 Maven 生命周期的一个特性。

4.打包和运行

POM 中如果没有指定打包类型，使用默认打包类型 jar。

类似地，Maven 会在打包之前执行编译、测试等操作。

如果需要让其他的 Maven 项目直接引用这个 jar 包，还需要一个安装的步骤 mvn clean install。

只有将打包之后的构件安装到本地仓库之后，其他 Maven 项目才能使用它。

默认打包生成的 jar 是不能够直接运行的，因为带有 main 方法的类信息不回添加到 manifest 中（打开 jar 文件中的 META-INF/MANIFEST.MF 文件，将无法看到 Main-Class 一行）。为了生成可执行的 jar 文件，需要借助 maven-shade-plugin，配置该插件如下。

 1 <build>
 2    <plugins>
 3        <!-- shade插件打包成jar包 -->
 4        <plugin>
 5            <groupId>org.apache.maven.plugins</groupId>
 6            <artifactId>maven-shade-plugin</artifactId>
 7            <version>2.3</version>
 8            <executions>
 9                <execution>
10                    <phase>package</phase>
11                    <goals>
12                        <goal>shade</goal>
13                    </goals>
14                    <configuration>
15                        <transformers>
16                            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
17                                <mainClass>org.wzh.maven.HelloWorld</mainClass>
18                            </transformer>
19                        </transformers>
20                    </configuration>
21                </execution>
22            </executions>
23        </plugin>
24    </plugins>
25 </build>

5.使用 Archetype 生成项目骨架

运行 mvn archetype:generate。紧接着会看到一段长长的输出，有很多可用的 Archetype 供选择，包括注明的 Appfuse 项目的 Archetype、JPA 项目的 Archetype 等。每一个 Archetype 前面都会对应有一个编号，同时命令行会提示一个默认的编号，其对应的 Archetype 为 maven-archetyoe-quickstart，直接回车选择该 Archetype，紧接着 Maven 会提示输入要创建项目的 groupId、artifactId、version 以及包名 package。Archetype 插件将根据我们提供的信息创建项目骨架。

Archetype 可以帮助我们迅速的构建起项目的骨架。如果有很多拥有类似的自定义的项目结构以及配置文件，则完全可以一劳永逸地开发自己的 Archetype，然后在这些项目中使用自定义的 Archetype 来快速生成项目框架。