Maven简介及使用

工具
maven

Maven是一个项目管理和构建自动化工具。但是对于我们程序员来说，我们最关心的是它的项目构建功能。Maven使用惯例优于配置的原则。

Maven结构

它要求在没有定制之前，所有的项目都有如下的结构：

目录 目的
${basedir} 存放 pom.xml和所有的子目录
${basedir}/src/main/java 项目的 java源代码
${basedir}/src/main/resources 项目的资源，比如说 property文件
${basedir}/src/test/java 项目的测试类，比如说 JUnit代码
${basedir}/src/test/resources 测试使用的资源

一个maven项目在默认情况下会产生JAR文件，另外编译后的classes 会放在${basedir}/target/classes下面，JAR 文件会放在${basedir}/target下面。

在这个目录下面，有一个Project Object Model(POM)文件 pom.xml。这个文件用于描述项目，配置插件和管理依赖关系。

创建Maven项目

  • 在命令行中执行下面的命令来建立我们的 hello world 项目。

$mvn archetype:generate -DgroupId=com.mycompany.helloworld -DartifactId=helloworld -Dpackage=com.mycompany.helloworld -Dversion=1.0-SNAPSHOT

我们选择默认的maven-archetype-quickstart，是编号#106。
正是我们需要的 Hello World 代码。所以我们可以构建和运行这个程序了。用下面简单的命令构建：

$cd helloworld
$mvn package

常见Maven命令

  • 编译：mvn compile
  • 打包：mvn package
  • 安装：mvn install
  • 复制依赖库：mvn dependency:copy-dependencies -DoutputDirectory=lib
  • 查看依赖树：mvn dependency:tree

POM 简介

  • POM (Project Object Model)

    一个项目所有的配置都放置在 POM 文件中：定义项目的类型、名字，管理依赖关系，定制插件的行为等。比如说，你可以配置compiler 插件让它使用 java 1.5 来编译。
    下面是一个具体的pom.xml例子。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
<?xml version="1.0" encoding="utf-8"?>
<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>com.mycompany.helloworld</groupId>  
  <artifactId>helloworld</artifactId>  
  <version>1.0-SNAPSHOT</version>  
  <packaging>jar</packaging>  
  <name>helloworld</name>  
  <url>http://maven.apache.org</url>  
  <properties> 
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 
  </properties>  
  <dependencies> 
    <dependency> 
      <groupId>junit</groupId>  
      <artifactId>junit</artifactId>  
      <version>3.8.1</version>  
      <scope>test</scope> 
    </dependency> 
  </dependencies>  
  <build> 
    <plugins> 
      <plugin> 
        <groupId>org.apache.maven.plugins</groupId>  
        <artifactId>maven-compiler-plugin</artifactId>  
        <version>3.3</version>  
        <configuration> 
          <source>1.7</source>  
          <target>1.7</target>  
          <encoding>UTF-8</encoding> 
        </configuration> 
      </plugin> 
    </plugins> 
  </build> 
</project>

在 POM 中，groupId, artifactId, packaging, version 叫作 maven 坐标，它能唯一的确定一个项目。有了 maven坐标，我们就可以用它来指定我们的项目所依赖的其他项目，插件，或者父项目。一般 maven 坐标写成如下的格式：
groupId:artifactId:packaging:version

Maven依赖

  • 依赖
1
2
3
4
5
6
7
8
<dependencies> 
  <dependency> 
    <groupId>junit</groupId>  
    <artifactId>junit</artifactId>  
    <version>3.8.1</version>  
    <scope>test</scope> 
  </dependency> 
</dependencies>
  • 排除依赖
    使用<exclusions>标签将包中的部分包排除。
1
2
3
4
5
6
7
8
9
10
11
<dependency>
    <groupId>org.elasticsearch</groupId>
    <artifactId>elasticsearch</artifactId>
    <version>2.3.4</version>
    <exclusions>
        <exclusion>
        <artifactId>lucene-core</artifactId>
        <groupId>org.apache.lucene</groupId>
        </exclusion>
    </exclusions>
 </dependency>

Maven打包及插件

有的时候外卖需要将所有依赖打成一个超级Jar包，则需要借助maven-shade-plugin插件来完成。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <version>2.4.1</version>
            <configuration>
                <createDependencyReducedPom>false</createDependencyReducedPom>
            </configuration>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <relocations>
                            <relocation>
                                <pattern>com.google.guava</pattern>
                                <shadedPattern>my.elasticsearch.guava</shadedPattern>
                            </relocation>
                            <relocation>
                                <pattern>org.joda</pattern>
                                <shadedPattern>my.elasticsearch.joda</shadedPattern>
                            </relocation>
                            <relocation>
                                <pattern>com.google.common</pattern>
                                <shadedPattern>my.elasticsearch.common</shadedPattern>
                            </relocation>
                            <relocation>
                                <pattern>com.google.thirdparty</pattern>
                                <shadedPattern>my.elasticsearch.thirdparty</shadedPattern>
                            </relocation>
                            <relocation>
                                <pattern>com.fasterxml.jackson</pattern>
                                <shadedPattern>my.elasticsearch.jackson</shadedPattern>
                            </relocation>
                        </relocations>
                        <transformers>
                            <transformer
implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer" />
                        </transformers>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>
分享到 评论