如下所示：
|
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
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
|
<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 "> <!-- 父項目的坐標。如果項目中沒有規定某個元素的值，那么父項目中的對應值即為項目的默認值。 坐標包括group ID，artifact ID和 version。 --> <parent> <!-- 被繼承的父項目的構件標識符 --> <artifactId>xxx</artifactId> <!-- 被繼承的父項目的全球唯一標識符 --> <groupId>xxx</groupId> <!-- 被繼承的父項目的版本 --> <version>xxx</version> <!-- 父項目的pom.xml文件的相對路徑。相對路徑允許你選擇一個不同的路徑。默認值是../pom.xml。 Maven首先在構建當前項目的地方尋找父項目的pom，其次在文件系統的這個位置（relativePath位置）， 然后在本地倉庫，最后在遠程倉庫尋找父項目的pom。 --> <relativePath>xxx</relativePath> </parent> <!-- 聲明項目描述符遵循哪一個POM模型版本。模型本身的版本很少改變，雖然如此，但它仍然是必不可少的， 這是為了當Maven引入了新的特性或者其他模型變更的時候，確保穩定性。 --> <modelVersion> 4.0.0 </modelVersion> <!-- 項目的全球唯一標識符，通常使用全限定的包名區分該項目和其他項目。并且構建時生成的路徑也是由此生成， 如com.mycompany.app生成的相對路徑為：/com/mycompany/app --> <groupId>xxx</groupId> <!-- 構件的標識符，它和group ID一起唯一標識一個構件。換句話說，你不能有兩個不同的項目擁有同樣的artifact ID 和groupID；在某個特定的group ID下，artifact ID也必須是唯一的。構件是項目產生的或使用的一個東西，Maven 為項目產生的構件包括：JARs，源碼，二進制發布和WARs等。 --> <artifactId>xxx</artifactId> <!-- 項目產生的構件類型，例如jar、war、ear、pom。插件可以創建他們自己的構件類型，所以前面列的不是全部構件類型 --> <packaging> jar </packaging> <!-- 項目當前版本，格式為:主版本.次版本.增量版本-限定版本號 --> <version> 1.0-SNAPSHOT </version> <!-- 項目的名稱, Maven產生的文檔用 --> <name> xxx-maven </name> <!-- 項目主頁的URL, Maven產生的文檔用 --> <url> http://maven.apache.org </url> <!-- 項目的詳細描述, Maven 產生的文檔用。 當這個元素能夠用HTML格式描述時（例如，CDATA中的文本會被解析器忽略， 就可以包含HTML標簽）， 不鼓勵使用純文本描述。如果你需要修改產生的web站點的索引頁面，你應該修改你自己的 索引頁文件，而不是調整這里的文檔。 --> <description> A maven project to study maven. </description> <!-- 描述了這個項目構建環境中的前提條件。 --> <prerequisites> <!-- 構建該項目或使用該插件所需要的Maven的最低版本 --> <maven></maven> </prerequisites> <!-- 項目的問題管理系統(Bugzilla, Jira, Scarab,或任何你喜歡的問題管理系統)的名稱和URL，本例為 jira --> <issueManagement> <!-- 問題管理系統（例如jira）的名字， --> <system> jira </system> <!-- 該項目使用的問題管理系統的URL --> <url> http://jira.baidu.com/banseon </url> </issueManagement> <!-- 項目持續集成信息 --> <ciManagement> <!-- 持續集成系統的名字，例如continuum --> <system></system> <!-- 該項目使用的持續集成系統的URL（如果持續集成系統有web接口的話）。 --> <url></url> <!-- 構建完成時，需要通知的開發者/用戶的配置項。包括被通知者信息和通知條件（錯誤，失敗，成功，警告） --> <notifiers> <!-- 配置一種方式，當構建中斷時，以該方式通知用戶/開發者 --> <notifier> <!-- 傳送通知的途徑 --> <type></type> <!-- 發生錯誤時是否通知 --> <sendOnError></sendOnError> <!-- 構建失敗時是否通知 --> <sendOnFailure></sendOnFailure> <!-- 構建成功時是否通知 --> <sendOnSuccess></sendOnSuccess> <!-- 發生警告時是否通知 --> <sendOnWarning></sendOnWarning> <!-- 不贊成使用。通知發送到哪里 --> <address></address> <!-- 擴展配置項 --> <configuration></configuration> </notifier> </notifiers> </ciManagement> <!-- 項目創建年份，4位數字。當產生版權信息時需要使用這個值。 --> <inceptionYear /> <!-- 項目相關郵件列表信息 --> <mailingLists> <!-- 該元素描述了項目相關的所有郵件列表。自動產生的網站引用這些信息。 --> <mailingList> <!-- 郵件的名稱 --> <name> Demo </name> <!-- 發送郵件的地址或鏈接，如果是郵件地址，創建文檔時，mailto: 鏈接會被自動創建 --> <post> banseon@126.com </post> <!-- 訂閱郵件的地址或鏈接，如果是郵件地址，創建文檔時，mailto: 鏈接會被自動創建 --> <subscribe> banseon@126.com </subscribe> <!-- 取消訂閱郵件的地址或鏈接，如果是郵件地址，創建文檔時，mailto: 鏈接會被自動創建 --> <unsubscribe> banseon@126.com </unsubscribe> <!-- 你可以瀏覽郵件信息的URL --> <archive> http:/hi.baidu.com/banseon/demo/dev/ </archive> </mailingList> </mailingLists> <!-- 項目開發者列表 --> <developers> <!-- 某個項目開發者的信息 --> <developer> <!-- SCM里項目開發者的唯一標識符 --> <id> HELLO WORLD </id> <!-- 項目開發者的全名 --> <name> banseon </name> <!-- 項目開發者的email --> <email> banseon@126.com </email> <!-- 項目開發者的主頁的URL --> <url></url> <!-- 項目開發者在項目中扮演的角色，角色元素描述了各種角色 --> <roles> <role> Project Manager </role> <role> Architect </role> </roles> <!-- 項目開發者所屬組織 --> <organization> demo </organization> <!-- 項目開發者所屬組織的URL --> <organizationUrl> http://hi.baidu.com/xxx </organizationUrl> <!-- 項目開發者屬性，如即時消息如何處理等 --> <properties> <dept> No </dept> </properties> <!-- 項目開發者所在時區， -11到12范圍內的整數。 --> <timezone> -5 </timezone> </developer> </developers> <!-- 項目的其他貢獻者列表 --> <contributors> <!-- 項目的其他貢獻者。參見developers/developer元素 --> <contributor> <!-- 項目貢獻者的全名 --> <name></name> <!-- 項目貢獻者的email --> <email></email> <!-- 項目貢獻者的主頁的URL --> <url></url> <!-- 項目貢獻者所屬組織 --> <organization></organization> <!-- 項目貢獻者所屬組織的URL --> <organizationUrl></organizationUrl> <!-- 項目貢獻者在項目中扮演的角色，角色元素描述了各種角色 --> <roles> <role> Project Manager </role> <role> Architect </role> </roles> <!-- 項目貢獻者所在時區， -11到12范圍內的整數。 --> <timezone></timezone> <!-- 項目貢獻者屬性，如即時消息如何處理等 --> <properties> <dept> No </dept> </properties> </contributor> </contributors> <!-- 該元素描述了項目所有License列表。 應該只列出該項目的license列表，不要列出依賴項目的 license列表。 如果列出多個license，用戶可以選擇它們中的一個而不是接受所有license。 --> <licenses> <!-- 描述了項目的license，用于生成項目的web站點的license頁面，其他一些報表和validation也會用到該元素。 --> <license> <!-- license用于法律上的名稱 --> <name> Apache 2 </name> <!-- 官方的license正文頁面的URL --> <url> http://www.baidu.com/banseon/LICENSE-2.0.txt </url> <!-- 項目分發的主要方式： repo，可以從Maven庫下載 manual， 用戶必須手動下載和安裝依賴 --> <distribution> repo </distribution> <!-- 關于license的補充信息 --> <comments> A business-friendly OSS license </comments> </license> </licenses> <!-- SCM(Source Control Management)標簽允許你配置你的代碼庫，供Maven web站點和其它插件使用。 --> <scm> <!-- SCM的URL,該URL描述了版本庫和如何連接到版本庫。欲知詳情，請看SCMs提供的URL格式和列表。該連接只讀。 --> <connection> scm:svn:http://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk) </connection> <!-- 給開發者使用的，類似connection元素。即該連接不僅僅只讀 --> <developerConnection> scm:svn:http://svn.baidu.com/banseon/maven/banseon/dao-trunk </developerConnection> <!-- 當前代碼的標簽，在開發階段默認為HEAD --> <tag></tag> <!-- 指向項目的可瀏覽SCM庫（例如ViewVC或者Fisheye）的URL。 --> <url> http://svn.baidu.com/banseon </url> </scm> <!-- 描述項目所屬組織的各種屬性。Maven產生的文檔用 --> <organization> <!-- 組織的全名 --> <name> demo </name> <!-- 組織主頁的URL --> <url> http://www.baidu.com/banseon </url> </organization> <!-- 構建項目需要的信息 --> <build> <!-- 該元素設置了項目源碼目錄，當構建項目的時候，構建系統會編譯目錄里的源碼。該路徑是相對 于pom.xml的相對路徑。 --> <sourceDirectory></sourceDirectory> <!-- 該元素設置了項目腳本源碼目錄，該目錄和源碼目錄不同：絕大多數情況下，該目錄下的內容會 被拷貝到輸出目錄(因為腳本是被解釋的，而不是被編譯的)。 --> <scriptSourceDirectory></scriptSourceDirectory> <!-- 該元素設置了項目單元測試使用的源碼目錄，當測試項目的時候，構建系統會編譯目錄里的源碼。 該路徑是相對于pom.xml的相對路徑。 --> <testSourceDirectory></testSourceDirectory> <!-- 被編譯過的應用程序class文件存放的目錄。 --> <outputDirectory></outputDirectory> <!-- 被編譯過的測試class文件存放的目錄。 --> <testOutputDirectory></testOutputDirectory> <!-- 使用來自該項目的一系列構建擴展 --> <extensions> <!-- 描述使用到的構建擴展。 --> <extension> <!-- 構建擴展的groupId --> <groupId></groupId> <!-- 構建擴展的artifactId --> <artifactId></artifactId> <!-- 構建擴展的版本 --> <version></version> </extension> </extensions> <!-- 當項目沒有規定目標（Maven2 叫做階段）時的默認值 --> <defaultGoal></defaultGoal> <!-- 這個元素描述了項目相關的所有資源路徑列表，例如和項目相關的屬性文件，這些資源被包含在 最終的打包文件里。 --> <resources> <!-- 這個元素描述了項目相關或測試相關的所有資源路徑 --> <resource> <!-- 描述了資源的目標路徑。該路徑相對target/classes目錄（例如${project.build.outputDirectory}）。 舉個例子，如果你想資源在特定的包里(org.apache.maven.messages)，你就必須該元素設置為 org/apache/maven/messages。然而，如果你只是想把資源放到源碼目錄結構里，就不需要該配置。 --> <targetPath></targetPath> <!-- 是否使用參數值代替參數名。參數值取自properties元素或者文件里配置的屬性，文件在filters元素 里列出。 --> <filtering></filtering> <!-- 描述存放資源的目錄，該路徑相對POM路徑 --> <directory></directory> <!-- 包含的模式列表，例如**/*.xml. --> <includes> <include></include> </includes> <!-- 排除的模式列表，例如**/*.xml --> <excludes> <exclude></exclude> </excludes> </resource> </resources> <!-- 這個元素描述了單元測試相關的所有資源路徑，例如和單元測試相關的屬性文件。 --> <testResources> <!-- 這個元素描述了測試相關的所有資源路徑，參見build/resources/resource元素的說明 --> <testResource> <!-- 描述了測試相關的資源的目標路徑。該路徑相對target/classes目錄（例如${project.build.outputDirectory}）。 舉個例子，如果你想資源在特定的包里(org.apache.maven.messages)，你就必須該元素設置為 org/apache/maven/messages。然而，如果你只是想把資源放到源碼目錄結構里，就不需要該配置。 --> <targetPath></targetPath> <!-- 是否使用參數值代替參數名。參數值取自properties元素或者文件里配置的屬性，文件在filters元素 里列出。 --> <filtering></filtering> <!-- 描述存放測試相關的資源的目錄，該路徑相對POM路徑 --> <directory></directory> <!-- 包含的模式列表，例如**/*.xml. --> <includes> <include></include> </includes> <!-- 排除的模式列表，例如**/*.xml --> <excludes> <exclude></exclude> </excludes> </testResource> </testResources> <!-- 構建產生的所有文件存放的目錄 --> <directory></directory> <!-- 產生的構件的文件名，默認值是${artifactId}-${version}。 --> <finalName></finalName> <!-- 當filtering開關打開時，使用到的過濾器屬性文件列表 --> <filters></filters> <!-- 子項目可以引用的默認插件信息。該插件配置項直到被引用時才會被解析或綁定到生命周期。給定插件的任何本 地配置都會覆蓋這里的配置 --> <pluginManagement> <!-- 使用的插件列表 。 --> <plugins> <!-- plugin元素包含描述插件所需要的信息。 --> <plugin> <!-- 插件在倉庫里的group ID --> <groupId></groupId> <!-- 插件在倉庫里的artifact ID --> <artifactId></artifactId> <!-- 被使用的插件的版本（或版本范圍） --> <version></version> <!-- 是否從該插件下載Maven擴展（例如打包和類型處理器），由于性能原因，只有在真需要下載時，該 元素才被設置成enabled。 --> <extensions>true/false</extensions> <!-- 在構建生命周期中執行一組目標的配置。每個目標可能有不同的配置。 --> <executions> <!-- execution元素包含了插件執行需要的信息 --> <execution> <!-- 執行目標的標識符，用于標識構建過程中的目標，或者匹配繼承過程中需要合并的執行目標 --> <id></id> <!-- 綁定了目標的構建生命周期階段，如果省略，目標會被綁定到源數據里配置的默認階段 --> <phase></phase> <!-- 配置的執行目標 --> <goals></goals> <!-- 配置是否被傳播到子POM --> <inherited>true/false</inherited> <!-- 作為DOM對象的配置 --> <configuration></configuration> </execution> </executions> <!-- 項目引入插件所需要的額外依賴 --> <dependencies> <!-- 參見dependencies/dependency元素 --> <dependency> </dependency> </dependencies> <!-- 任何配置是否被傳播到子項目 --> <inherited>true/false</inherited> <!-- 作為DOM對象的配置 --> <configuration></configuration> </plugin> </plugins> </pluginManagement> <!-- 該項目使用的插件列表 。 --> <plugins> <!-- plugin元素包含描述插件所需要的信息。 --> <plugin> <!-- 插件在倉庫里的group ID --> <groupId></groupId> <!-- 插件在倉庫里的artifact ID --> <artifactId></artifactId> <!-- 被使用的插件的版本（或版本范圍） --> <version></version> <!-- 是否從該插件下載Maven擴展（例如打包和類型處理器），由于性能原因，只有在真需要下載時，該 元素才被設置成enabled。 --> <extensions>true/false</extensions> <!-- 在構建生命周期中執行一組目標的配置。每個目標可能有不同的配置。 --> <executions> <!-- execution元素包含了插件執行需要的信息 --> <execution> <!-- 執行目標的標識符，用于標識構建過程中的目標，或者匹配繼承過程中需要合并的執行目標 --> <id></id> <!-- 綁定了目標的構建生命周期階段，如果省略，目標會被綁定到源數據里配置的默認階段 --> <phase></phase> <!-- 配置的執行目標 --> <goals></goals> <!-- 配置是否被傳播到子POM --> <inherited>true/false</inherited> <!-- 作為DOM對象的配置 --> <configuration></configuration> </execution> </executions> <!-- 項目引入插件所需要的額外依賴 --> <dependencies> <!-- 參見dependencies/dependency元素 --> <dependency> </dependency> </dependencies> <!-- 任何配置是否被傳播到子項目 --> <inherited>true/false</inherited> <!-- 作為DOM對象的配置 --> <configuration></configuration> </plugin> </plugins> </build> <!-- 在列的項目構建profile，如果被激活，會修改構建處理 --> <profiles> <!-- 根據環境參數或命令行參數激活某個構建處理 --> <profile> <!-- 構建配置的唯一標識符。即用于命令行激活，也用于在繼承時合并具有相同標識符的profile。 --> <id></id> <!-- 自動觸發profile的條件邏輯。Activation是profile的開啟鑰匙。profile的力量來自于它能夠 在某些特定的環境中自動使用某些特定的值；這些環境通過activation元素指定。activation元 素并不是激活profile的唯一方式。 --> <activation> <!-- profile默認是否激活的標志 --> <activeByDefault>true/false</activeByDefault> <!-- 當匹配的jdk被檢測到，profile被激活。例如，1.4激活JDK1.4，1.4.0_2，而!1.4激活所有版本 不是以1.4開頭的JDK。 --> <jdk>jdk版本，如:1.7</jdk> <!-- 當匹配的操作系統屬性被檢測到，profile被激活。os元素可以定義一些操作系統相關的屬性。 --> <os> <!-- 激活profile的操作系統的名字 --> <name> Windows XP </name> <!-- 激活profile的操作系統所屬家族(如 'windows') --> <family> Windows </family> <!-- 激活profile的操作系統體系結構 --> <arch> x86 </arch> <!-- 激活profile的操作系統版本 --> <version> 5.1.2600 </version> </os> <!-- 如果Maven檢測到某一個屬性（其值可以在POM中通過${名稱}引用），其擁有對應的名稱和值，Profile 就會被激活。如果值字段是空的，那么存在屬性名稱字段就會激活profile，否則按區分大小寫方式匹 配屬性值字段 --> <property> <!-- 激活profile的屬性的名稱 --> <name> mavenVersion </name> <!-- 激活profile的屬性的值 --> <value> 2.0.3 </value> </property> <!-- 提供一個文件名，通過檢測該文件的存在或不存在來激活profile。missing檢查文件是否存在，如果不存在則激活 profile。另一方面，exists則會檢查文件是否存在，如果存在則激活profile。 --> <file> <!-- 如果指定的文件存在，則激活profile。 --> <exists> /usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/ </exists> <!-- 如果指定的文件不存在，則激活profile。 --> <missing> /usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/ </missing> </file> </activation> <!-- 構建項目所需要的信息。參見build元素 --> <build> <defaultGoal /> <resources> <resource> <targetPath></targetPath> <filtering></filtering> <directory></directory> <includes> <include></include> </includes> <excludes> <exclude></exclude> </excludes> </resource> </resources> <testResources> <testResource> <targetPath></targetPath> <filtering></filtering> <directory></directory> <includes> <include></include> </includes> <excludes> <exclude></exclude> </excludes> </testResource> </testResources> <directory></directory> <finalName></finalName> <filters></filters> <pluginManagement> <plugins> <!-- 參見build/pluginManagement/plugins/plugin元素 --> <plugin> <groupId></groupId> <artifactId></artifactId> <version></version> <extensions>true/false</extensions> <executions> <execution> <id></id> <phase></phase> <goals></goals> <inherited>true/false</inherited> <configuration></configuration> </execution> </executions> <dependencies> <!-- 參見dependencies/dependency元素 --> <dependency> </dependency> </dependencies> <goals></goals> <inherited>true/false</inherited> <configuration></configuration> </plugin> </plugins> </pluginManagement> <plugins> <!-- 參見build/pluginManagement/plugins/plugin元素 --> <plugin> <groupId></groupId> <artifactId></artifactId> <version></version> <extensions>true/false</extensions> <executions> <execution> <id></id> <phase></phase> <goals></goals> <inherited>true/false</inherited> <configuration></configuration> </execution> </executions> <dependencies> <!-- 參見dependencies/dependency元素 --> <dependency> </dependency> </dependencies> <goals></goals> <inherited>true/false</inherited> <configuration></configuration> </plugin> </plugins> </build> <!-- 模塊（有時稱作子項目） 被構建成項目的一部分。列出的每個模塊元素是指向該模塊的目錄的 相對路徑 --> <modules> <!--子項目相對路徑--> <module></module> </modules> <!-- 發現依賴和擴展的遠程倉庫列表。 --> <repositories> <!-- 參見repositories/repository元素 --> <repository> <releases> <enabled><enabled> <updatePolicy></updatePolicy> <checksumPolicy></checksumPolicy> </releases> <snapshots> <enabled><enabled> <updatePolicy></updatePolicy> <checksumPolicy></checksumPolicy> </snapshots> <id></id> <name></name> <url></url> <layout></layout> </repository> </repositories> <!-- 發現插件的遠程倉庫列表，這些插件用于構建和報表 --> <pluginRepositories> <!-- 包含需要連接到遠程插件倉庫的信息.參見repositories/repository元素 --> <pluginRepository> <releases> <enabled><enabled> <updatePolicy></updatePolicy> <checksumPolicy></checksumPolicy> </releases> <snapshots> <enabled><enabled> <updatePolicy></updatePolicy> <checksumPolicy></checksumPolicy> </snapshots> <id></id> <name></name> <url></url> <layout></layout> </pluginRepository> </pluginRepositories> <!-- 該元素描述了項目相關的所有依賴。 這些依賴組成了項目構建過程中的一個個環節。它們自動從項目定義的 倉庫中下載。要獲取更多信息，請看項目依賴機制。 --> <dependencies> <!-- 參見dependencies/dependency元素 --> <dependency> </dependency> </dependencies> <!-- 不贊成使用. 現在Maven忽略該元素. --> <reports></reports> <!-- 該元素包括使用報表插件產生報表的規范。當用戶執行“mvn site”，這些報表就會運行。 在頁面導航欄能看 到所有報表的鏈接。參見reporting元素 --> <reporting></reporting> <!-- 參見dependencyManagement元素 --> <dependencyManagement> <dependencies> <!-- 參見dependencies/dependency元素 --> <dependency> </dependency> </dependencies> </dependencyManagement> <!-- 參見distributionManagement元素 --> <distributionManagement> </distributionManagement> <!-- 參見properties元素 --> <properties /> </profile> </profiles> <!-- 模塊（有時稱作子項目） 被構建成項目的一部分。列出的每個模塊元素是指向該模塊的目錄的相對路徑 --> <modules> <!--子項目相對路徑--> <module></module> </modules> <!-- 發現依賴和擴展的遠程倉庫列表。 --> <repositories> <!-- 包含需要連接到遠程倉庫的信息 --> <repository> <!-- 如何處理遠程倉庫里發布版本的下載 --> <releases> <!-- true或者false表示該倉庫是否為下載某種類型構件（發布版，快照版）開啟。 --> <enabled><enabled> <!-- 該元素指定更新發生的頻率。Maven會比較本地POM和遠程POM的時間戳。這里的選項是：always（一直）， daily（默認，每日），interval：X（這里X是以分鐘為單位的時間間隔），或者never（從不）。 --> <updatePolicy></updatePolicy> <!-- 當Maven驗證構件校驗文件失敗時該怎么做：ignore（忽略），fail（失敗），或者warn（警告）。 --> <checksumPolicy></checksumPolicy> </releases> <!-- 如何處理遠程倉庫里快照版本的下載。有了releases和snapshots這兩組配置，POM就可以在每個單獨的倉庫中， 為每種類型的構件采取不同的策略。例如，可能有人會決定只為開發目的開啟對快照版本下載的支持。參見repositories/repository/releases元素 --> <snapshots> <enabled><enabled> <updatePolicy></updatePolicy> <checksumPolicy></checksumPolicy> </snapshots> <!-- 遠程倉庫唯一標識符。可以用來匹配在settings.xml文件里配置的遠程倉庫 --> <id> banseon-repository-proxy </id> <!-- 遠程倉庫名稱 --> <name> banseon-repository-proxy </name> <!-- 遠程倉庫URL，按protocol://hostname/path形式 --> <url> http://192.168.1.169:9999/repository/ </url> <!-- 用于定位和排序構件的倉庫布局類型-可以是default（默認）或者legacy（遺留）。Maven 2為其倉庫提供了一個默認 的布局；然而，Maven 1.x有一種不同的布局。我們可以使用該元素指定布局是default（默認）還是legacy（遺留）。 --> <layout> default </layout> </repository> </repositories> <!-- 發現插件的遠程倉庫列表，這些插件用于構建和報表 --> <pluginRepositories> <!-- 包含需要連接到遠程插件倉庫的信息.參見repositories/repository元素 --> <pluginRepository> </pluginRepository> </pluginRepositories> <!-- 該元素描述了項目相關的所有依賴。 這些依賴組成了項目構建過程中的一個個環節。它們自動從項目定義的倉庫中下載。 要獲取更多信息，請看項目依賴機制。 --> <dependencies> <dependency> <!-- 依賴的group ID --> <groupId> org.apache.maven </groupId> <!-- 依賴的artifact ID --> <artifactId> maven-artifact </artifactId> <!-- 依賴的版本號。 在Maven 2里, 也可以配置成版本號的范圍。 --> <version> 3.8.1 </version> <!-- 依賴類型，默認類型是jar。它通常表示依賴的文件的擴展名，但也有例外。一個類型可以被映射成另外一個擴展 名或分類器。類型經常和使用的打包方式對應，盡管這也有例外。一些類型的例子：jar，war，ejb-client和test-jar。 如果設置extensions為 true，就可以在plugin里定義新的類型。所以前面的類型的例子不完整。 --> <type> jar </type> <!-- 依賴的分類器。分類器可以區分屬于同一個POM，但不同構建方式的構件。分類器名被附加到文件名的版本號后面。例如， 如果你想要構建兩個單獨的構件成JAR，一個使用Java 1.4編譯器，另一個使用Java 6編譯器，你就可以使用分類器來生 成兩個單獨的JAR構件。 --> <classifier></classifier> <!-- 依賴范圍。在項目發布過程中，幫助決定哪些構件被包括進來。欲知詳情請參考依賴機制。 - compile ：默認范圍，用于編譯 - provided：類似于編譯，但支持你期待jdk或者容器提供，類似于classpath - runtime: 在執行時需要使用 - test: 用于test任務時使用 - system: 需要外在提供相應的元素。通過systemPath來取得 - systemPath: 僅用于范圍為system。提供相應的路徑 - optional: 當項目自身被依賴時，標注依賴是否傳遞。用于連續依賴時使用 --> <scope> test </scope> <!-- 僅供system范圍使用。注意，不鼓勵使用這個元素，并且在新的版本中該元素可能被覆蓋掉。該元素為依賴規定了文件 系統上的路徑。需要絕對路徑而不是相對路徑。推薦使用屬性匹配絕對路徑，例如${java.home}。 --> <systemPath></systemPath> <!-- 當計算傳遞依賴時， 從依賴構件列表里，列出被排除的依賴構件集。即告訴maven你只依賴指定的項目，不依賴項目的 依賴。此元素主要用于解決版本沖突問題 --> <exclusions> <exclusion> <artifactId> spring-core </artifactId> <groupId> org.springframework </groupId> </exclusion> </exclusions> <!-- 可選依賴，如果你在項目B中把C依賴聲明為可選，你就需要在依賴于B的項目（例如項目A）中顯式的引用對C的依賴。 可選依賴阻斷依賴的傳遞性。 --> <optional> true </optional> </dependency> </dependencies> <!-- 不贊成使用. 現在Maven忽略該元素. --> <reports></reports> <!-- 該元素描述使用報表插件產生報表的規范。當用戶執行“mvn site”，這些報表就會運行。 在頁面導航欄能看到所有報表的鏈接。 --> <reporting> <!-- true，則，網站不包括默認的報表。這包括“項目信息”菜單中的報表。 --> <excludeDefaults /> <!-- 所有產生的報表存放到哪里。默認值是${project.build.directory}/site。 --> <outputDirectory /> <!-- 使用的報表插件和他們的配置。 --> <plugins> <!-- plugin元素包含描述報表插件需要的信息 --> <plugin> <!-- 報表插件在倉庫里的group ID --> <groupId></groupId> <!-- 報表插件在倉庫里的artifact ID --> <artifactId></artifactId> <!-- 被使用的報表插件的版本（或版本范圍） --> <version></version> <!-- 任何配置是否被傳播到子項目 --> <inherited>true/false</inherited> <!-- 報表插件的配置 --> <configuration></configuration> <!-- 一組報表的多重規范，每個規范可能有不同的配置。一個規范（報表集）對應一個執行目標 。例如， 有1，2，3，4，5，6，7，8，9個報表。1，2，5構成A報表集，對應一個執行目標。2，5，8構成B報 表集，對應另一個執行目標 --> <reportSets> <!-- 表示報表的一個集合，以及產生該集合的配置 --> <reportSet> <!-- 報表集合的唯一標識符，POM繼承時用到 --> <id></id> <!-- 產生報表集合時，被使用的報表的配置 --> <configuration></configuration> <!-- 配置是否被繼承到子POMs --> <inherited>true/false</inherited> <!-- 這個集合里使用到哪些報表 --> <reports></reports> </reportSet> </reportSets> </plugin> </plugins> </reporting> <!-- 繼承自該項目的所有子項目的默認依賴信息。這部分的依賴信息不會被立即解析,而是當子項目聲明一個依賴 （必須描述group ID和artifact ID信息），如果group ID和artifact ID以外的一些信息沒有描述，則通過 group ID和artifact ID匹配到這里的依賴，并使用這里的依賴信息。 --> <dependencyManagement> <dependencies> <!-- 參見dependencies/dependency元素 --> <dependency> </dependency> </dependencies> </dependencyManagement> <!-- 項目分發信息，在執行mvn deploy后表示要發布的位置。有了這些信息就可以把網站部署到遠程服務器或者 把構件部署到遠程倉庫。 --> <distributionManagement> <!-- 部署項目產生的構件到遠程倉庫需要的信息 --> <repository> <!-- 是分配給快照一個唯一的版本號（由時間戳和構建流水號）？還是每次都使用相同的版本號？參見 repositories/repository元素 --> <uniqueVersion /> <id> banseon-maven2 </id> <name> banseon maven2 </name> <url> file://${basedir}/target/deploy </url> <layout></layout> </repository> <!-- 構件的快照部署到哪里？如果沒有配置該元素，默認部署到repository元素配置的倉庫，參見 distributionManagement/repository元素 --> <snapshotRepository> <uniqueVersion /> <id> banseon-maven2 </id> <name> Banseon-maven2 Snapshot Repository </name> <url> scp://svn.baidu.com/banseon:/usr/local/maven-snapshot </url> <layout></layout> </snapshotRepository> <!-- 部署項目的網站需要的信息 --> <site> <!-- 部署位置的唯一標識符，用來匹配站點和settings.xml文件里的配置 --> <id> banseon-site </id> <!-- 部署位置的名稱 --> <name> business api website </name> <!-- 部署位置的URL，按protocol://hostname/path形式 --> <url> scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web </url> </site> <!-- 項目下載頁面的URL。如果沒有該元素，用戶應該參考主頁。使用該元素的原因是：幫助定位 那些不在倉庫里的構件（由于license限制）。 --> <downloadUrl /> <!-- 如果構件有了新的group ID和artifact ID（構件移到了新的位置），這里列出構件的重定位信息。 --> <relocation> <!-- 構件新的group ID --> <groupId></groupId> <!-- 構件新的artifact ID --> <artifactId></artifactId> <!-- 構件新的版本號 --> <version></version> <!-- 顯示給用戶的，關于移動的額外信息，例如原因。 --> <message></message> </relocation> <!-- 給出該構件在遠程倉庫的狀態。不得在本地項目中設置該元素，因為這是工具自動更新的。有效的值 有：none（默認），converted（倉庫管理員從Maven 1 POM轉換過來），partner（直接從伙伴Maven 2倉庫同步過來），deployed（從Maven 2實例部署），verified（被核實時正確的和最終的）。 --> <status></status> </distributionManagement> <!-- 以值替代名稱，Properties可以在整個POM中使用，也可以作為觸發條件（見settings.xml配置文件里 activation元素的說明）。格式是<name>value</name>。 --> <properties> <name>value</name> </properties> </project> |
以上這篇基于Maven的pom.xml文件詳解就是小編分享給大家的全部內容了，希望能給大家一個參考，也希望大家多多支持服務器之家。
