1 <project xmlns="http://maven.apache.org/POM/4.0.0" 2 3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 4 5 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd "> 6 7 <!-- 父項目的坐標。如果項目中沒有規定某個元素的值，那么父項目中的對應值即為項目的默認值。 坐標包括group ID，artifact ID和 version。 --> 8 9 <parent> 10 11 <!-- 被繼承的父項目的構件標識符 --> 12 13 <artifactId /> 14 15 <!-- 被繼承的父項目的全球唯一標識符 --> 16 17 <groupId /> 18 19 <!-- 被繼承的父項目的版本 --> 20 21 <version /> 22 23 <!-- 父項目的pom.xml文件的相對路徑。相對路徑允許你選擇一個不同的路徑。默認值是../pom.xml。Maven首先在構建當前項目的地方尋找父項目的pom，其次在文件系統的這個位置（relativePath位置），然后在本地倉庫，最后在遠程倉庫尋找父項目的pom。 --> 24 25 <relativePath /> 26 27 </parent> 28 29 <!-- 聲明項目描述符遵循哪一個POM模型版本。模型本身的版本很少改變，雖然如此，但它仍然是必不可少的，這是為了當Maven引入了新的特性或者其他模型變更的時候，確保穩定性。 --> 30 31 <modelVersion> 4.0.0 </modelVersion> 32 33 <!-- 項目的全球唯一標識符，通常使用全限定的包名區分該項目和其他項目。並且構建時生成的路徑也是由此生成， 如com.mycompany.app生成的相對路徑為：/com/mycompany/app --> 34 35 <groupId> asia.banseon </groupId> 36 37 <!-- 構件的標識符，它和group ID一起唯一標識一個構件。換句話說，你不能有兩個不同的項目擁有同樣的artifact ID和groupID；在某個特定的group ID下，artifact ID也必須是唯一的。構件是項目產生的或使用的一個東西，Maven為項目產生的構件包括：JARs，源碼，二進制發布和WARs等。 --> 38 39 <artifactId> banseon-maven2 </artifactId> 40 41 <!-- 項目產生的構件類型，例如jar、war、ear、pom。插件可以創建他們自己的構件類型，所以前面列的不是全部構件類型 --> 42 43 <packaging> jar </packaging> 44 45 <!-- 項目當前版本，格式為:主版本.次版本.增量版本-限定版本號 --> 46 47 <version> 1.0-SNAPSHOT </version> 48 49 <!-- 項目的名稱, Maven產生的文檔用 --> 50 51 <name> banseon-maven </name> 52 53 <!-- 項目主頁的URL, Maven產生的文檔用 --> 54 55 <url> http://www.baidu.com/banseon </url> 56 57 <!-- 項目的詳細描述, Maven 產生的文檔用。 當這個元素能夠用HTML格式描述時（例如，CDATA中的文本會被解析器忽略，就可以包含HTML標簽）， 不鼓勵使用純文本描述。如果你需要修改產生的web站點的索引頁面，你應該修改你自己的索引頁文件，而不是調整這里的文檔。 --> 58 59 <description> A maven project to study maven. </description> 60 61 <!-- 描述了這個項目構建環境中的前提條件。 --> 62 63 <prerequisites> 64 65 <!-- 構建該項目或使用該插件所需要的Maven的最低版本 --> 66 67 <maven /> 68 69 </prerequisites> 70 71 <!-- 項目的問題管理系統(Bugzilla, Jira, Scarab,或任何你喜歡的問題管理系統)的名稱和URL，本例為 jira --> 72 73 <issueManagement> 74 75 <!-- 問題管理系統（例如jira）的名字， --> 76 77 <system> jira </system> 78 79 <!-- 該項目使用的問題管理系統的URL --> 80 81 <url> http://jira.baidu.com/banseon </url> 82 83 </issueManagement> 84 85 <!-- 項目持續集成信息 --> 86 87 <ciManagement> 88 89 <!-- 持續集成系統的名字，例如continuum --> 90 91 <system /> 92 93 <!-- 該項目使用的持續集成系統的URL（如果持續集成系統有web接口的話）。 --> 94 95 <url /> 96 97 <!-- 構建完成時，需要通知的開發者/用戶的配置項。包括被通知者信息和通知條件（錯誤，失敗，成功，警告） --> 98 99 <notifiers> 100 101 <!-- 配置一種方式，當構建中斷時，以該方式通知用戶/開發者 --> 102 103 <notifier> 104 105 <!-- 傳送通知的途徑 --> 106 107 <type /> 108 109 <!-- 發生錯誤時是否通知 --> 110 111 <sendOnError /> 112 113 <!-- 構建失敗時是否通知 --> 114 115 <sendOnFailure /> 116 117 <!-- 構建成功時是否通知 --> 118 119 <sendOnSuccess /> 120 121 <!-- 發生警告時是否通知 --> 122 123 <sendOnWarning /> 124 125 <!-- 不贊成使用。通知發送到哪里 --> 126 127 <address /> 128 129 <!-- 擴展配置項 --> 130 131 <configuration /> 132 133 </notifier> 134 135 </notifiers> 136 137 </ciManagement> 138 139 <!-- 項目創建年份，4位數字。當產生版權信息時需要使用這個值。 --> 140 141 <inceptionYear /> 142 143 <!-- 項目相關郵件列表信息 --> 144 145 <mailingLists> 146 147 <!-- 該元素描述了項目相關的所有郵件列表。自動產生的網站引用這些信息。 --> 148 149 <mailingList> 150 151 <!-- 郵件的名稱 --> 152 153 <name> Demo </name> 154 155 <!-- 發送郵件的地址或鏈接，如果是郵件地址，創建文檔時，mailto: 鏈接會被自動創建 --> 156 157 <post> banseon@126.com </post> 158 159 <!-- 訂閱郵件的地址或鏈接，如果是郵件地址，創建文檔時，mailto: 鏈接會被自動創建 --> 160 161 <subscribe> banseon@126.com </subscribe> 162 163 <!-- 取消訂閱郵件的地址或鏈接，如果是郵件地址，創建文檔時，mailto: 鏈接會被自動創建 --> 164 165 <unsubscribe> banseon@126.com </unsubscribe> 166 167 <!-- 你可以瀏覽郵件信息的URL --> 168 169 <archive> http:/hi.baidu.com/banseon/demo/dev/ </archive> 170 171 </mailingList> 172 173 </mailingLists> 174 175 <!-- 項目開發者列表 --> 176 177 <developers> 178 179 <!-- 某個項目開發者的信息 --> 180 181 <developer> 182 183 <!-- SCM里項目開發者的唯一標識符 --> 184 185 <id> HELLO WORLD </id> 186 187 <!-- 項目開發者的全名 --> 188 189 <name> banseon </name> 190 191 <!-- 項目開發者的email --> 192 193 <email> banseon@126.com </email> 194 195 <!-- 項目開發者的主頁的URL --> 196 197 <url /> 198 199 <!-- 項目開發者在項目中扮演的角色，角色元素描述了各種角色 --> 200 201 <roles> 202 203 <role> Project Manager </role> 204 205 <role> Architect </role> 206 207 </roles> 208 209 <!-- 項目開發者所屬組織 --> 210 211 <organization> demo </organization> 212 213 <!-- 項目開發者所屬組織的URL --> 214 215 <organizationUrl> http://hi.baidu.com/banseon </organizationUrl> 216 217 <!-- 項目開發者屬性，如即時消息如何處理等 --> 218 219 <properties> 220 221 <dept> No </dept> 222 223 </properties> 224 225 <!-- 項目開發者所在時區， -11到12范圍內的整數。 --> 226 227 <timezone> -5 </timezone> 228 229 </developer> 230 231 </developers> 232 233 <!-- 項目的其他貢獻者列表 --> 234 235 <contributors> 236 237 <!-- 項目的其他貢獻者。參見developers/developer元素 --> 238 239 <contributor> 240 241 <name /><email /><url /><organization /><organizationUrl /><roles /><timezone /><properties /> 242 243 </contributor> 244 245 </contributors> 246 247 <!-- 該元素描述了項目所有License列表。 應該只列出該項目的license列表，不要列出依賴項目的 license列表。如果列出多個license，用戶可以選擇它們中的一個而不是接受所有license。 --> 248 249 <licenses> 250 251 <!-- 描述了項目的license，用於生成項目的web站點的license頁面，其他一些報表和validation也會用到該元素。 --> 252 253 <license> 254 255 <!-- license用於法律上的名稱 --> 256 257 <name> Apache 2 </name> 258 259 <!-- 官方的license正文頁面的URL --> 260 261 <url> http://www.baidu.com/banseon/LICENSE-2.0.txt </url> 262 263 <!-- 項目分發的主要方式： 264 265 repo，可以從Maven庫下載 266 267 manual， 用戶必須手動下載和安裝依賴 --> 268 269 <distribution> repo </distribution> 270 271 <!-- 關於license的補充信息 --> 272 273 <comments> A business-friendly OSS license </comments> 274 275 </license> 276 277 </licenses> 278 279 <!-- SCM(Source Control Management)標簽允許你配置你的代碼庫，供Maven web站點和其它插件使用。 --> 280 281 <scm> 282 283 <!-- SCM的URL,該URL描述了版本庫和如何連接到版本庫。欲知詳情，請看SCMs提供的URL格式和列表。該連接只讀。 --> 284 285 <connection> 286 287 scm:svn:http://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk) 288 289 </connection> 290 291 <!-- 給開發者使用的，類似connection元素。即該連接不僅僅只讀 --> 292 293 <developerConnection> 294 295 scm:svn:http://svn.baidu.com/banseon/maven/banseon/dao-trunk 296 297 </developerConnection> 298 299 <!-- 當前代碼的標簽，在開發階段默認為HEAD --> 300 301 <tag /> 302 303 <!-- 指向項目的可瀏覽SCM庫（例如ViewVC或者Fisheye）的URL。 --> 304 305 <url> http://svn.baidu.com/banseon </url> 306 307 </scm> 308 309 <!-- 描述項目所屬組織的各種屬性。Maven產生的文檔用 --> 310 311 <organization> 312 313 <!-- 組織的全名 --> 314 315 <name> demo </name> 316 317 <!-- 組織主頁的URL --> 318 319 <url> http://www.baidu.com/banseon </url> 320 321 </organization> 322 323 <!-- 構建項目需要的信息 --> 324 325 <build> 326 327 <!-- 該元素設置了項目源碼目錄，當構建項目的時候，構建系統會編譯目錄里的源碼。該路徑是相對於pom.xml的相對路徑。 --> 328 329 <sourceDirectory /> 330 331 <!-- 該元素設置了項目腳本源碼目錄，該目錄和源碼目錄不同：絕大多數情況下，該目錄下的內容 會被拷貝到輸出目錄(因為腳本是被解釋的，而不是被編譯的)。 --> 332 333 <scriptSourceDirectory /> 334 335 <!-- 該元素設置了項目單元測試使用的源碼目錄，當測試項目的時候，構建系統會編譯目錄里的源碼。該路徑是相對於pom.xml的相對路徑。 --> 336 337 <testSourceDirectory /> 338 339 <!-- 被編譯過的應用程序class文件存放的目錄。 --> 340 341 <outputDirectory /> 342 343 <!-- 被編譯過的測試class文件存放的目錄。 --> 344 345 <testOutputDirectory /> 346 347 <!-- 使用來自該項目的一系列構建擴展 --> 348 349 <extensions> 350 351 <!-- 描述使用到的構建擴展。 --> 352 353 <extension> 354 355 <!-- 構建擴展的groupId --> 356 357 <groupId /> 358 359 <!-- 構建擴展的artifactId --> 360 361 <artifactId /> 362 363 <!-- 構建擴展的版本 --> 364 365 <version /> 366 367 </extension> 368 369 </extensions> 370 371 <!-- 當項目沒有規定目標（Maven2 叫做階段）時的默認值 --> 372 373 <defaultGoal /> 374 375 <!-- 這個元素描述了項目相關的所有資源路徑列表，例如和項目相關的屬性文件，這些資源被包含在最終的打包文件里。 --> 376 377 <resources> 378 379 <!-- 這個元素描述了項目相關或測試相關的所有資源路徑 --> 380 381 <resource> 382 383 <!-- 描述了資源的目標路徑。該路徑相對target/classes目錄（例如${project.build.outputDirectory}）。舉個例子，如果你想資源在特定的包里(org.apache.maven.messages)，你就必須該元素設置為org/apache/maven/messages。然而，如果你只是想把資源放到源碼目錄結構里，就不需要該配置。 --> 384 385 <targetPath /> 386 387 <!-- 是否使用參數值代替參數名。參數值取自properties元素或者文件里配置的屬性，文件在filters元素里列出。 --> 388 389 <filtering /> 390 391 <!-- 描述存放資源的目錄，該路徑相對POM路徑 --> 392 393 <directory /> 394 395 <!-- 包含的模式列表，例如**/*.xml. --> 396 397 <includes /> 398 399 <!-- 排除的模式列表，例如**/*.xml --> 400 401 <excludes /> 402 403 </resource> 404 405 </resources> 406 407 <!-- 這個元素描述了單元測試相關的所有資源路徑，例如和單元測試相關的屬性文件。 --> 408 409 <testResources> 410 411 <!-- 這個元素描述了測試相關的所有資源路徑，參見build/resources/resource元素的說明 --> 412 413 <testResource> 414 415 <targetPath /><filtering /><directory /><includes /><excludes /> 416 417 </testResource> 418 419 </testResources> 420 421 <!-- 構建產生的所有文件存放的目錄 --> 422 423 <directory /> 424 425 <!-- 產生的構件的文件名，默認值是${artifactId}-${version}。 --> 426 427 <finalName /> 428 429 <!-- 當filtering開關打開時，使用到的過濾器屬性文件列表 --> 430 431 <filters /> 432 433 <!-- 子項目可以引用的默認插件信息。該插件配置項直到被引用時才會被解析或綁定到生命周期。給定插件的任何本地配置都會覆蓋這里的配置 --> 434 435 <pluginManagement> 436 437 <!-- 使用的插件列表 。 --> 438 439 <plugins> 440 441 <!-- plugin元素包含描述插件所需要的信息。 --> 442 443 <plugin> 444 445 <!-- 插件在倉庫里的group ID --> 446 447 <groupId /> 448 449 <!-- 插件在倉庫里的artifact ID --> 450 451 <artifactId /> 452 453 <!-- 被使用的插件的版本（或版本范圍） --> 454 455 <version /> 456 457 <!-- 是否從該插件下載Maven擴展（例如打包和類型處理器），由於性能原因，只有在真需要下載時，該元素才被設置成enabled。 --> 458 459 <extensions /> 460 461 <!-- 在構建生命周期中執行一組目標的配置。每個目標可能有不同的配置。 --> 462 463 <executions> 464 465 <!-- execution元素包含了插件執行需要的信息 --> 466 467 <execution> 468 469 <!-- 執行目標的標識符，用於標識構建過程中的目標，或者匹配繼承過程中需要合並的執行目標 --> 470 471 <id /> 472 473 <!-- 綁定了目標的構建生命周期階段，如果省略，目標會被綁定到源數據里配置的默認階段 --> 474 475 <phase /> 476 477 <!-- 配置的執行目標 --> 478 479 <goals /> 480 481 <!-- 配置是否被傳播到子POM --> 482 483 <inherited /> 484 485 <!-- 作為DOM對象的配置 --> 486 487 <configuration /> 488 489 </execution> 490 491 </executions> 492 493 <!-- 項目引入插件所需要的額外依賴 --> 494 495 <dependencies> 496 497 <!-- 參見dependencies/dependency元素 --> 498 499 <dependency> 500 501 502 503 </dependency> 504 505 </dependencies> 506 507 <!-- 任何配置是否被傳播到子項目 --> 508 509 <inherited /> 510 511 <!-- 作為DOM對象的配置 --> 512 513 <configuration /> 514 515 </plugin> 516 517 </plugins> 518 519 </pluginManagement> 520 521 <!-- 使用的插件列表 --> 522 523 <plugins> 524 525 <!-- 參見build/pluginManagement/plugins/plugin元素 --> 526 527 <plugin> 528 529 <groupId /><artifactId /><version /><extensions /> 530 531 <executions> 532 533 <execution> 534 535 <id /><phase /><goals /><inherited /><configuration /> 536 537 </execution> 538 539 </executions> 540 541 <dependencies> 542 543 <!-- 參見dependencies/dependency元素 --> 544 545 <dependency> 546 547 548 549 </dependency> 550 551 </dependencies> 552 553 <goals /><inherited /><configuration /> 554 555 </plugin> 556 557 </plugins> 558 559 </build> 560 561 <!-- 在列的項目構建profile，如果被激活，會修改構建處理 --> 562 563 <profiles> 564 565 <!-- 根據環境參數或命令行參數激活某個構建處理 --> 566 567 <profile> 568 569 <!-- 構建配置的唯一標識符。即用於命令行激活，也用於在繼承時合並具有相同標識符的profile。 --> 570 571 <id /> 572 573 <!-- 自動觸發profile的條件邏輯。Activation是profile的開啟鑰匙。profile的力量來自於它 574 575 能夠在某些特定的環境中自動使用某些特定的值；這些環境通過activation元素指定。activation元素並不是激活profile的唯一方式。 --> 576 577 <activation> 578 579 <!-- profile默認是否激活的標志 --> 580 581 <activeByDefault /> 582 583 <!-- 當匹配的jdk被檢測到，profile被激活。例如，1.4激活JDK1.4，1.4.0_2，而!1.4激活所有版本不是以1.4開頭的JDK。 --> 584 585 <jdk /> 586 587 <!-- 當匹配的操作系統屬性被檢測到，profile被激活。os元素可以定義一些操作系統相關的屬性。 --> 588 589 <os> 590 591 <!-- 激活profile的操作系統的名字 --> 592 593 <name> Windows XP </name> 594 595 <!-- 激活profile的操作系統所屬家族(如 'windows') --> 596 597 <family> Windows </family> 598 599 <!-- 激活profile的操作系統體系結構 --> 600 601 <arch> x86 </arch> 602 603 <!-- 激活profile的操作系統版本 --> 604 605 <version> 5.1.2600 </version> 606 607 </os> 608 609 <!-- 如果Maven檢測到某一個屬性（其值可以在POM中通過${名稱}引用），其擁有對應的名稱和值，Profile就會被激活。如果值 610 611 字段是空的，那么存在屬性名稱字段就會激活profile，否則按區分大小寫方式匹配屬性值字段 --> 612 613 <property> 614 615 <!-- 激活profile的屬性的名稱 --> 616 617 <name> mavenVersion </name> 618 619 <!-- 激活profile的屬性的值 --> 620 621 <value> 2.0.3 </value> 622 623 </property> 624 625 <!-- 提供一個文件名，通過檢測該文件的存在或不存在來激活profile。missing檢查文件是否存在，如果不存在則激活 626 627 profile。另一方面，exists則會檢查文件是否存在，如果存在則激活profile。 --> 628 629 <file> 630 631 <!-- 如果指定的文件存在，則激活profile。 --> 632 633 <exists> /usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/ </exists> 634 635 <!-- 如果指定的文件不存在，則激活profile。 --> 636 637 <missing> /usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/ </missing> 638 639 </file> 640 641 </activation> 642 643 <!-- 構建項目所需要的信息。參見build元素 --> 644 645 <build> 646 647 <defaultGoal /> 648 649 <resources> 650 651 <resource> 652 653 <targetPath /><filtering /><directory /><includes /><excludes /> 654 655 </resource> 656 657 </resources> 658 659 <testResources> 660 661 <testResource> 662 663 <targetPath /><filtering /><directory /><includes /><excludes /> 664 665 </testResource> 666 667 </testResources> 668 669 <directory /><finalName /><filters /> 670 671 <pluginManagement> 672 673 <plugins> 674 675 <!-- 參見build/pluginManagement/plugins/plugin元素 --> 676 677 <plugin> 678 679 <groupId /><artifactId /><version /><extensions /> 680 681 <executions> 682 683 <execution> 684 685 <id /><phase /><goals /><inherited /><configuration /> 686 687 </execution> 688 689 </executions> 690 691 <dependencies> 692 693 <!-- 參見dependencies/dependency元素 --> 694 695 <dependency> 696 697 698 699 </dependency> 700 701 </dependencies> 702 703 <goals /><inherited /><configuration /> 704 705 </plugin> 706 707 </plugins> 708 709 </pluginManagement> 710 711 <plugins> 712 713 <!-- 參見build/pluginManagement/plugins/plugin元素 --> 714 715 <plugin> 716 717 <groupId /><artifactId /><version /><extensions /> 718 719 <executions> 720 721 <execution> 722 723 <id /><phase /><goals /><inherited /><configuration /> 724 725 </execution> 726 727 </executions> 728 729 <dependencies> 730 731 <!-- 參見dependencies/dependency元素 --> 732 733 <dependency> 734 735 736 737 </dependency> 738 739 </dependencies> 740 741 <goals /><inherited /><configuration /> 742 743 </plugin> 744 745 </plugins> 746 747 </build> 748 749 <!-- 模塊（有時稱作子項目） 被構建成項目的一部分。列出的每個模塊元素是指向該模塊的目錄的相對路徑 --> 750 751 <modules /> 752 753 <!-- 發現依賴和擴展的遠程倉庫列表。 --> 754 755 <repositories> 756 757 <!-- 參見repositories/repository元素 --> 758 759 <repository> 760 761 <releases> 762 763 <enabled /><updatePolicy /><checksumPolicy /> 764 765 </releases> 766 767 <snapshots> 768 769 <enabled /><updatePolicy /><checksumPolicy /> 770 771 </snapshots> 772 773 <id /><name /><url /><layout /> 774 775 </repository> 776 777 </repositories> 778 779 <!-- 發現插件的遠程倉庫列表，這些插件用於構建和報表 --> 780 781 <pluginRepositories> 782 783 <!-- 包含需要連接到遠程插件倉庫的信息.參見repositories/repository元素 --> 784 785 <pluginRepository> 786 787 <releases> 788 789 <enabled /><updatePolicy /><checksumPolicy /> 790 791 </releases> 792 793 <snapshots> 794 795 <enabled /><updatePolicy /><checksumPolicy /> 796 797 </snapshots> 798 799 <id /><name /><url /><layout /> 800 801 </pluginRepository> 802 803 </pluginRepositories> 804 805 <!-- 該元素描述了項目相關的所有依賴。 這些依賴組成了項目構建過程中的一個個環節。它們自動從項目定義的倉庫中下載。要獲取更多信息，請看項目依賴機制。 --> 806 807 <dependencies> 808 809 <!-- 參見dependencies/dependency元素 --> 810 811 <dependency> 812 813 814 815 </dependency> 816 817 </dependencies> 818 819 <!-- 不贊成使用. 現在Maven忽略該元素. --> 820 821 <reports /> 822 823 <!-- 該元素包括使用報表插件產生報表的規范。當用戶執行“mvn site”，這些報表就會運行。 在頁面導航欄能看到所有報表的鏈接。參見reporting元素 --> 824 825 <reporting> 826 827 828 829 </reporting> 830 831 <!-- 參見dependencyManagement元素 --> 832 833 <dependencyManagement> 834 835 <dependencies> 836 837 <!-- 參見dependencies/dependency元素 --> 838 839 <dependency> 840 841 842 843 </dependency> 844 845 </dependencies> 846 847 </dependencyManagement> 848 849 <!-- 參見distributionManagement元素 --> 850 851 <distributionManagement> 852 853 854 855 </distributionManagement> 856 857 <!-- 參見properties元素 --> 858 859 <properties /> 860 861 </profile> 862 863 </profiles> 864 865 <!-- 模塊（有時稱作子項目） 被構建成項目的一部分。列出的每個模塊元素是指向該模塊的目錄的相對路徑 --> 866 867 <modules /> 868 869 <!-- 發現依賴和擴展的遠程倉庫列表。 --> 870 871 <repositories> 872 873 <!-- 包含需要連接到遠程倉庫的信息 --> 874 875 <repository> 876 877 <!-- 如何處理遠程倉庫里發布版本的下載 --> 878 879 <releases> 880 881 <!-- true或者false表示該倉庫是否為下載某種類型構件（發布版，快照版）開啟。 --> 882 883 <enabled /> 884 885 <!-- 該元素指定更新發生的頻率。Maven會比較本地POM和遠程POM的時間戳。這里的選項是：always（一直），daily（默認，每日），interval：X（這里X是以分鍾為單位的時間間隔），或者never（從不）。 --> 886 887 <updatePolicy /> 888 889 <!-- 當Maven驗證構件校驗文件失敗時該怎么做：ignore（忽略），fail（失敗），或者warn（警告）。 --> 890 891 <checksumPolicy /> 892 893 </releases> 894 895 <!-- 如何處理遠程倉庫里快照版本的下載。有了releases和snapshots這兩組配置，POM就可以在每個單獨的倉庫中，為每種類型的構件采取不同的策略。例如，可能有人會決定只為開發目的開啟對快照版本下載的支持。參見repositories/repository/releases元素 --> 896 897 <snapshots> 898 899 <enabled /><updatePolicy /><checksumPolicy /> 900 901 </snapshots> 902 903 <!-- 遠程倉庫唯一標識符。可以用來匹配在settings.xml文件里配置的遠程倉庫 --> 904 905 <id> banseon-repository-proxy </id> 906 907 <!-- 遠程倉庫名稱 --> 908 909 <name> banseon-repository-proxy </name> 910 911 <!-- 遠程倉庫URL，按protocol://hostname/path形式 --> 912 913 <url> http://192.168.1.169:9999/repository/ </url> 914 915 <!-- 用於定位和排序構件的倉庫布局類型-可以是default（默認）或者legacy（遺留）。Maven 2為其倉庫提供了一個默認的布局；然而，Maven 1.x有一種不同的布局。我們可以使用該元素指定布局是default（默認）還是legacy（遺留）。 --> 916 917 <layout> default </layout> 918 919 </repository> 920 921 </repositories> 922 923 <!-- 發現插件的遠程倉庫列表，這些插件用於構建和報表 --> 924 925 <pluginRepositories> 926 927 <!-- 包含需要連接到遠程插件倉庫的信息.參見repositories/repository元素 --> 928 929 <pluginRepository> 930 931 932 933 </pluginRepository> 934 935 </pluginRepositories> 936 937 938 939 <!-- 該元素描述了項目相關的所有依賴。 這些依賴組成了項目構建過程中的一個個環節。它們自動從項目定義的倉庫中下載。要獲取更多信息，請看項目依賴機制。 --> 940 941 <dependencies> 942 943 <dependency> 944 945 <!-- 依賴的group ID --> 946 947 <groupId> org.apache.maven </groupId> 948 949 <!-- 依賴的artifact ID --> 950 951 <artifactId> maven-artifact </artifactId> 952 953 <!-- 依賴的版本號。 在Maven 2里, 也可以配置成版本號的范圍。 --> 954 955 <version> 3.8.1 </version> 956 957 <!-- 依賴類型，默認類型是jar。它通常表示依賴的文件的擴展名，但也有例外。一個類型可以被映射成另外一個擴展名或分類器。類型經常和使用的打包方式對應，盡管這也有例外。一些類型的例子：jar，war，ejb-client和test-jar。如果設置extensions為 true，就可以在plugin里定義新的類型。所以前面的類型的例子不完整。 --> 958 959 <type> jar </type> 960 961 <!-- 依賴的分類器。分類器可以區分屬於同一個POM，但不同構建方式的構件。分類器名被附加到文件名的版本號后面。例如，如果你想要構建兩個單獨的構件成JAR，一個使用Java 1.4編譯器，另一個使用Java 6編譯器，你就可以使用分類器來生成兩個單獨的JAR構件。 --> 962 963 <classifier></classifier> 964 965 <!-- 依賴范圍。在項目發布過程中，幫助決定哪些構件被包括進來。欲知詳情請參考依賴機制。 966 967 - compile ：默認范圍，用於編譯 968 969 - provided：類似於編譯，但支持你期待jdk或者容器提供，類似於classpath 970 971 - runtime: 在執行時需要使用 972 973 - test: 用於test任務時使用 974 975 - system: 需要外在提供相應的元素。通過systemPath來取得 976 977 - systemPath: 僅用於范圍為system。提供相應的路徑 978 979 - optional: 當項目自身被依賴時，標注依賴是否傳遞。用於連續依賴時使用 --> 980 981 <scope> test </scope> 982 983 <!-- 僅供system范圍使用。注意，不鼓勵使用這個元素，並且在新的版本中該元素可能被覆蓋掉。該元素為依賴規定了文件系統上的路徑。需要絕對路徑而不是相對路徑。推薦使用屬性匹配絕對路徑，例如${java.home}。 --> 984 985 <systemPath></systemPath> 986 987 <!-- 當計算傳遞依賴時， 從依賴構件列表里，列出被排除的依賴構件集。即告訴maven你只依賴指定的項目，不依賴項目的依賴。此元素主要用於解決版本沖突問題 --> 988 989 <exclusions> 990 991 <exclusion> 992 993 <artifactId> spring-core </artifactId> 994 995 <groupId> org.springframework </groupId> 996 997 </exclusion> 998 999 </exclusions> 1000 1001 <!-- 可選依賴，如果你在項目B中把C依賴聲明為可選，你就需要在依賴於B的項目（例如項目A）中顯式的引用對C的依賴。可選依賴阻斷依賴的傳遞性。 --> 1002 1003 <optional> true </optional> 1004 1005 </dependency> 1006 1007 </dependencies> 1008 1009 <!-- 不贊成使用. 現在Maven忽略該元素. --> 1010 1011 <reports></reports> 1012 1013 <!-- 該元素描述使用報表插件產生報表的規范。當用戶執行“mvn site”，這些報表就會運行。 在頁面導航欄能看到所有報表的鏈接。 --> 1014 1015 <reporting> 1016 1017 <!-- true，則，網站不包括默認的報表。這包括“項目信息”菜單中的報表。 --> 1018 1019 <excludeDefaults /> 1020 1021 <!-- 所有產生的報表存放到哪里。默認值是${project.build.directory}/site。 --> 1022 1023 <outputDirectory /> 1024 1025 <!-- 使用的報表插件和他們的配置。 --> 1026 1027 <plugins> 1028 1029 <!-- plugin元素包含描述報表插件需要的信息 --> 1030 1031 <plugin> 1032 1033 <!-- 報表插件在倉庫里的group ID --> 1034 1035 <groupId /> 1036 1037 <!-- 報表插件在倉庫里的artifact ID --> 1038 1039 <artifactId /> 1040 1041 <!-- 被使用的報表插件的版本（或版本范圍） --> 1042 1043 <version /> 1044 1045 <!-- 任何配置是否被傳播到子項目 --> 1046 1047 <inherited /> 1048 1049 <!-- 報表插件的配置 --> 1050 1051 <configuration /> 1052 1053 <!-- 一組報表的多重規范，每個規范可能有不同的配置。一個規范（報表集）對應一個執行目標 。例如，有1，2，3，4，5，6，7，8，9個報表。1，2，5構成A報表集，對應一個執行目標。2，5，8構成B報表集，對應另一個執行目標 --> 1054 1055 <reportSets> 1056 1057 <!-- 表示報表的一個集合，以及產生該集合的配置 --> 1058 1059 <reportSet> 1060 1061 <!-- 報表集合的唯一標識符，POM繼承時用到 --> 1062 1063 <id /> 1064 1065 <!-- 產生報表集合時，被使用的報表的配置 --> 1066 1067 <configuration /> 1068 1069 <!-- 配置是否被繼承到子POMs --> 1070 1071 <inherited /> 1072 1073 <!-- 這個集合里使用到哪些報表 --> 1074 1075 <reports /> 1076 1077 </reportSet> 1078 1079 </reportSets> 1080 1081 </plugin> 1082 1083 </plugins> 1084 1085 </reporting> 1086 1087 <!-- 繼承自該項目的所有子項目的默認依賴信息。這部分的依賴信息不會被立即解析,而是當子項目聲明一個依賴（必須描述group ID和artifact ID信息），如果group ID和artifact ID以外的一些信息沒有描述，則通過group ID和artifact ID匹配到這里的依賴，並使用這里的依賴信息。 --> 1088 1089 <dependencyManagement> 1090 1091 <dependencies> 1092 1093 <!-- 參見dependencies/dependency元素 --> 1094 1095 <dependency> 1096 1097 1098 1099 </dependency> 1100 1101 </dependencies> 1102 1103 </dependencyManagement> 1104 1105 <!-- 項目分發信息，在執行mvn deploy后表示要發布的位置。有了這些信息就可以把網站部署到遠程服務器或者把構件部署到遠程倉庫。 --> 1106 1107 <distributionManagement> 1108 1109 <!-- 部署項目產生的構件到遠程倉庫需要的信息 --> 1110 1111 <repository> 1112 1113 <!-- 是分配給快照一個唯一的版本號（由時間戳和構建流水號）？還是每次都使用相同的版本號？參見repositories/repository元素 --> 1114 1115 <uniqueVersion /> 1116 1117 <id> banseon-maven2 </id> 1118 1119 <name> banseon maven2 </name> 1120 1121 <url> file://${basedir}/target/deploy </url> 1122 1123 <layout /> 1124 1125 </repository> 1126 1127 <!-- 構件的快照部署到哪里？如果沒有配置該元素，默認部署到repository元素配置的倉庫，參見distributionManagement/repository元素 --> 1128 1129 <snapshotRepository> 1130 1131 <uniqueVersion /> 1132 1133 <id> banseon-maven2 </id> 1134 1135 <name> Banseon-maven2 Snapshot Repository </name> 1136 1137 <url> scp://svn.baidu.com/banseon:/usr/local/maven-snapshot </url> 1138 1139 <layout /> 1140 1141 </snapshotRepository> 1142 1143 <!-- 部署項目的網站需要的信息 --> 1144 1145 <site> 1146 1147 <!-- 部署位置的唯一標識符，用來匹配站點和settings.xml文件里的配置 --> 1148 1149 <id> banseon-site </id> 1150 1151 <!-- 部署位置的名稱 --> 1152 1153 <name> business api website </name> 1154 1155 <!-- 部署位置的URL，按protocol://hostname/path形式 --> 1156 1157 <url> 1158 1159 scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web 1160 1161 </url> 1162 1163 </site> 1164 1165 <!-- 項目下載頁面的URL。如果沒有該元素，用戶應該參考主頁。使用該元素的原因是：幫助定位那些不在倉庫里的構件（由於license限制）。 --> 1166 1167 <downloadUrl /> 1168 1169 <!-- 如果構件有了新的group ID和artifact ID（構件移到了新的位置），這里列出構件的重定位信息。 --> 1170 1171 <relocation> 1172 1173 <!-- 構件新的group ID --> 1174 1175 <groupId /> 1176 1177 <!-- 構件新的artifact ID --> 1178 1179 <artifactId /> 1180 1181 <!-- 構件新的版本號 --> 1182 1183 <version /> 1184 1185 <!-- 顯示給用戶的，關於移動的額外信息，例如原因。 --> 1186 1187 <message /> 1188 1189 </relocation> 1190 1191 <!-- 給出該構件在遠程倉庫的狀態。不得在本地項目中設置該元素，因為這是工具自動更新的。有效的值有：none（默認），converted（倉庫管理員從Maven 1 POM轉換過來），partner（直接從伙伴Maven 2倉庫同步過來），deployed（從Maven 2實例部署），verified（被核實時正確的和最終的）。 --> 1192 1193 <status /> 1194 1195 </distributionManagement> 1196 1197 <!-- 以值替代名稱，Properties可以在整個POM中使用，也可以作為觸發條件（見settings.xml配置文件里activation元素的說明）。格式是<name>value</name>。 --> 1198 1199 <properties /> 1200 1201 </project>