超级详细的Maven使用教程

什么是Maven？

如今我们构建一个项目需要用到很多第三方的类库，如写一个使用Spring的Web项目就需要引入大量的jar包。一个项目Jar包的数量之多往往让我们瞠目结舌，并且Jar包之间的关系错综复杂，一个Jar包往往又会引用其他Jar包，缺少任何一个Jar包都会导致项目编译失败。

以往开发项目时，程序员往往需要花较多的精力在引用Jar包搭建项目环境上，而这一项工作尤为艰难，少一个Jar包、多一个Jar包往往会报一些让人摸不着头脑的异常。

而Maven就是一款帮助程序员构建项目的工具，我们只需要告诉Maven需要哪些Jar 包，它会帮助我们下载所有的Jar，极大提升开发效率。

安装Maven 和 Maven的Eclipse插件

安装Maven和Maven的Eclipse插件，用Eclipse的同学可以参考，推荐使用IDEA开发；

Maven规定的目录结构

若要使用Maven，那么项目的目录结构必须符合Maven的规范，其目录结构如下：

Maven基本命令

1. **-v:**查询Maven版本

   本命令用于检查maven是否安装成功。

   Maven安装完成之后，在命令行输入mvn -v，若出现maven信息，则说明安装成功。

2. compile：编译

   将java源文件编译成class文件

3. test:测试项目

   执行test目录下的测试用例

4. package:打包

   将项目打成jar包

5. clean:删除target文件夹

6. install:安装

   将当前项目放到Maven的本地仓库中。供其他项目使用

什么是Maven仓库？

Maven仓库用来存放Maven管理的所有Jar包。分为：本地仓库 和 中央仓库。

• 本地仓库：Maven本地的Jar包仓库。
• 中央仓库： Maven官方提供的远程仓库。

当项目编译时，Maven首先从本地仓库中寻找项目所需的Jar包，若本地仓库没有，再到Maven的中央仓库下载所需Jar包。

什么是“坐标”？

在Maven中，坐标是Jar包的唯一标识，Maven通过坐标在仓库中找到项目所需的Jar包。

如下代码中，groupId和artifactId构成了一个Jar包的坐标。

   cn.missbe.web.search
   resource-search
   jar
   1.0-SNAPSHOT

1
2
3
4
5
6

• groupId:所需Jar包的项目名
• artifactId:所需Jar包的模块名
• version:所需Jar包的版本号

传递依赖 与 排除依赖

• 传递依赖：如果我们的项目引用了一个Jar包，而该Jar包又引用了其他Jar包，那么在默认情况下项目编译时，Maven会把直接引用和间接引用的Jar包都下载到本地。

• 排除依赖：如果我们只想下载直接引用的Jar包，那么需要在pom.xml中做如下配置：(将需要排除的Jar包的坐标写在中)

  cn.missbe.web.search resource-search pom 1.0-SNAPSHOT

依赖范围scope

在项目发布过程中，帮助决定哪些构件被包括进来。欲知详情请参考依赖机制。
- compile ：默认范围，用于编译
- provided：类似于编译，但支持你期待jdk或者容器提供，类似于classpath
- runtime: 在执行时需要使用
- test: 用于test任务时使用
- system: 需要外在提供相应的元素。通过systemPath来取得
- systemPath: 仅用于范围为system。提供相应的路径
- optional: 当项目自身被依赖时，标注依赖是否传递。用于连续依赖时使用

依赖冲突

若项目中多个Jar同时引用了相同的Jar时，会产生依赖冲突，但Maven采用了两种避免冲突的策略，因此在Maven中是不存在依赖冲突的。

1.短路优先

本项目——>A.jar——>B.jar——>X.jar
本项目——>C.jar——>X.jar
1
2

若本项目引用了A.jar，A.jar又引用了B.jar，B.jar又引用了X.jar，并且C.jar也引用了X.jar。

在此时，Maven只会引用引用路径最短的Jar。

2.声明优先

若引用路径长度相同时，在pom.xml中谁先被声明，就使用谁。

聚合

1. 什么是聚合？

   将多个项目同时运行就称为聚合。

2. 如何实现聚合？

   只需在pom中作如下配置即可实现聚合：

   web-connection-pool web-java-crawler

继承

1. 什么是继承？

   在聚合多个项目时，如果这些被聚合的项目中需要引入相同的Jar，那么可以将这些Jar写入父pom中，各个子项目继承该pom即可。

2. 如何实现继承？

• 父pom配置：将需要继承的Jar包的坐标放入标签即可。

  cn.missbe.web.search resource-search pom 1.0-SNAPSHOT

• 子pom配置：

  父pom所在项目的groupId 父pom所在项目的artifactId 父pom所在项目的版本号 resource-search cn.missbe.web.search 1.0-SNAPSHOT

使用Maven构建Web项目

1. New Maven项目：选择WebApp：

2. 若使用JSP，需添加Servlet依赖：

   注：Servlet依赖只在编译和测试时使用！

   javax.servlet javax.servlet-api 3.0.1 provided

3. 在Bulid Path中设置resource输出目录：

4. 勾选：Dynamic Web Module

5. 删掉测试目录

6. 在pom中加入jetty的插件，并设置JDK版本：

   org.apache.maven.plugins maven-compiler-plugin 1.8 1.8 org.eclipse.jetty jetty-maven-plugin 9.3.10.v20160621 package

7. 运行项目：

8. 输入：jetty:run

9. 访问127.0.0.1:8080

   若出现如下界面，表示成功！

pom.xml详解

pom.xml是Maven的核心，你的项目需要什么Jar包就在pom.xml里面配置。当编译项目时Maven读取该文件，并从仓库中下载相应的Jar包。

  
    
   
      
      
      
      
      
     
    
    
  4.0.0  
    
  cn.missbe.web  
    
  search-resources  
    
  war  
    
  1.0-SNAPSHOT  
    
  search-resources  
    
  http://www.missbe.cn  
    
  A maven project to study maven.  
    
   
      
     
    
    
   
      
      
      
      
      
      
      
      
      
      
      
     
        
       
          
          
          
          
          
         
       
      
      
     
        
       
          
          
          
          
          
          
          
          
          
         
       
      
      
     
        
       
        
        
        
        
         
       
      
      
      
      
      
      
      
      
     
        
       
          
         
            
            
            
            
            
            
            
            
            
           
              
             
                
                
                
                
                
                
                
                
                
               
             
            
            
           
              
            ...... 
            
            
            
            
           
         
       
      
      
     
        
       
        
        
        
          
         
           
            
            
            
            
             
           
          
         
            
          ...... 
          
        
        
         
       
     
    
    
    
    
   
      
     
        
       
          
          
          
          
          
         
        
        
       
        
        
         
        
        
      banseon-repository-proxy  
        
      banseon-repository-proxy  
        
      http://192.168.1.169:9999/repository/  
        
      default 
     
    
    
   
      
    ...... 
    
    
   
     
        
      org.apache.maven  
        
      maven-artifact  
        
      3.8.1  
        
      jar  
        
        
        
      test  
        
        
        
       
         
          spring-core  
          org.springframework 
         
        
        
      true 
     
    
    
   
     
        
      ...... 
     
    
    
   
      
     
        
        
      banseon-maven2  
      banseon maven2  
      file://${basedir}/target/deploy  
       
      
      
     
        
      banseon-maven2  
      Banseon-maven2 Snapshot Repository  
      scp://svn.baidu.com/banseon:/usr/local/maven-snapshot  
       
      
      
     
        
      banseon-site  
        
      business api website  
        
      scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web 
      
      
      
      
     
    
    
   

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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316

---

参考原文：Maven使用详解