MAVEN实战 整理 笔记

参考

maven安装目录

bin：mvn运行的脚本（linux下为shell脚本）
boot：类加载器框架（对用户不重要）
conf：配置settings.xml，定义maven行为
lib：maven运行时需要的java类库

pom.xml

XML头

<?xml version="1.0" encoding="UTF-8"?>

根元素project元素

<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，指定pom模型版本（Maven2及Maven 3都是4.0.0）

<modelVersion>4.0.0</modelVersion>

groupId，artifactId和version 定位一个项目

groupId：项目所属组。org/com.公司/组织.项目名
artifactId：项目在组中的Id（子项目、模块）
version：子项目（模块）的版本（SNAPSHOT意为快照，说明该项目还处于开发中，是不稳定的版本）
name：项目名（用户友好）

    <groupId>org.onos.test</groupId>
    <artifactId>Demo</artifactId>
    <version>1.10</version>

主代码

Maven假设项目主代码位于src/main/java目录。一般包应该基于项目的groupId和artifactId
测试代码只在运行测试时用到，不会被打包

测试代码

测试代码目录是src/test/java
单元测试，需要添加一个JUnit依赖，修改项目的POM如代码清单

<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.7</version>
<scope>test</scope>
</dependency>
</dependencies>

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

调用Maven执行测试，运行 mvn clean test

编译

mvn clean compile

clean告诉Maven清理输出目录target/，默认情况下Maven构建的所有输出都在target/目录中
compile告诉Maven编译项目主代码，执行compiler:compile任务，将项目主代码编译至target/classes目录

由于历史原因，Maven的核心插件之一compiler插件默认只支持编译Java 1.3，因此我们需要配置该插件使其支持Java 5，见代码清单：

<project>
…
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.5</source>
<target>1.5</target>
</configuration>
</plugin>
</plugins>
</build>
…
</project>

打包

mvn clean package 进行打包（Maven会在打包之前执行编译、测试等操作。）

若POM中没有指定打包类型，默认打包类型jar，输出target/目录，文件根据artifact-version.jar规则命名

让其他的Maven项目直接引用这个jar——执行 mvn clean install
将项目输出的jar安装到了Maven本地仓库中，项目的pom和jar。

默认打包生成的jar是不能够直接运行，因为带有main方法的类信息不会添加到manifest中(我们可以打开jar文件中的META-INF/MANIFEST.MF文件，将无法看到Main-Class一行)。为了生成可执行的jar文件，需要maven-shade-plugin，配置mainClass

<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>1.2.1</version>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>shade</goal>
</goals>
<configuration>
<transformers>
<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"> <mainClass>com.juvenxu.mvnbook.helloworld.HelloWorld</mainClass>
</transformer>
</transformers>
</configuration>
</execution>
</executions>
</plugin>

mvn clean install生成hello-world-1.0-SNAPSHOT.jar和original-hello-world-1.0-SNAPSHOT.jar，前者是带有Main-Class信息的可运行jar，后者是原始的jar

maven项目约定

在项目的根目录中放置pom.xml，在src/main/java目录中放置项目 的主代码，在src/test/java中放置项目的测试代码

使用maven archetype来创建该项目的骨架

如果是Maven 3，简单的运行：

 mvn archetype:generate 

如果是Maven 2，最好运行如下命令：其格式为 groupId:artifactId:version:goal

 mvn org.apache.maven.plugins:maven-archetype-plugin:2.0-alpha-5:generate

有很多可用的archetype供我们选择，包括著名的Appfuse项目的archetype，JPA项目的archetype等等。每一个archetype前面都会对应有一个编号，同时命令行会提示一个默认的编号，其对应的archetype为maven-archetype-quickstart，我们直接回车以选择该archetype，紧接着Maven会提示我们输入要创建项目的groupId、artifactId、 version、以及包名package，如下输入并确认