2. 程式人生 > >maven 常用外掛配置詳解

maven 常用外掛配置詳解

阿新 • • 發佈：2019-01-04
先將我用到的自定義變數貼過來，防止外掛中出現一些變數，大家不理解

Java程式碼   收藏程式碼
  1. <!-- 全域性屬性配置 -->  
  2. <properties>  
  3.     <project.build.name>tools</project.build.name>  
  4.     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>  
  5. </properties>  

project.build.name： 用來定義war包名稱 

project.build.sourceEncoding： 用來定義資原始檔的編碼格式 

下面開始講解常用的maven外掛配置 

一、編譯外掛
Java程式碼   收藏程式碼
  1. <!-- 編譯外掛 -->  
  2. <plugin>  
  3.     <groupId>org.apache.maven.plugins</groupId>  
  4.     <artifactId>maven-compiler-plugin</artifactId>  
  5.     <configuration>  
  6.         <source>1.6
    </source>  
  7.         <target>1.6</target>  
  8.         <encoding>${project.build.sourceEncoding}</encoding>  
  9.     </configuration>  
  10. </plugin>  

source：原始碼編譯版本； 
target：目標平臺編譯版本； 
encoding：字符集編碼。 

二、設定資原始檔的編碼方式
Java程式碼   收藏程式碼
  1. <!-- 設定資原始檔的編碼方式 -->  
  2. <plugin>  
  3.     <groupId>org.apache.maven.plugins</groupId>  
  4.     <artifactId>maven-resources-plugin</artifactId>  
  5.     <version>2.4.3</version>  
  6.     <executions>  
  7.         <execution>  
  8.             <phase>compile</phase>  
  9.         </execution>  
  10.     </executions>  
  11.     <configuration>  
  12.         <encoding>${project.build.sourceEncoding}</encoding>  
  13.     </configuration>  
  14. </plugin>  

xml、properties檔案都是資原始檔，編碼的時候遇到中文總要進行轉碼！用什麼編碼？UTF-8，那就記得強制<encoding>${project.build.sourceEncoding}</encoding>

三、自動拷貝jar包到target目錄
Java程式碼   收藏程式碼
  1. <!-- 依賴外掛 -->  
  2. <plugin>  
  3.     <groupId>org.apache.maven.plugins</groupId>  
  4.     <artifactId>maven-dependency-plugin</artifactId>  
  5.     <version>2.6</version>  
  6.     <executions>  
  7.         <execution>  
  8.             <id>copy-dependencies</id>  
  9.             <phase>compile</phase>  
  10.             <goals>  
  11.                 <goal>copy-dependencies</goal>  
  12.             </goals>  
  13.             <configuration>  
  14.                 <!-- ${project.build.directory}為Maven內建變數，預設為target -->  
  15.                 <outputDirectory>${project.build.directory}/lib</outputDirectory>  
  16.                 <!-- 表示是否不包含間接依賴的包 -->  
  17.                 <excludeTransitive>false</excludeTransitive>  
  18.                 <!-- 表示複製的jar檔案去掉版本資訊 -->  
  19.                 <stripVersion>true</stripVersion>  
  20.             </configuration>  
  21.         </execution>  
  22.     </executions>  
  23. </plugin>  


在部署war包時，需要將專案依賴的jar包，也打到war包中，因此就會用到上述外掛 

四、生成原始碼jar包
Java程式碼   收藏程式碼
  1. <!-- 原始碼打包外掛 -->  
  2. <plugin>  
  3.     <artifactId>maven-source-plugin</artifactId>  
  4.     <version>2.1</version>  
  5.     <configuration>  
  6.         <!-- <finalName>${project.build.name}</finalName> -->  
  7.         <attach>true</attach>  
  8.         <encoding>${project.build.sourceEncoding}</encoding>  
  9.     </configuration>  
  10.     <executions>  
  11.         <execution>  
  12.             <phase>compile</phase>  
  13.             <goals>  
  14.                 <goal>jar</goal>  
  15.             </goals>  
  16.         </execution>  
  17.     </executions>  
  18. </plugin>  

該外掛主要用於在打jar包時，把原始碼也打成jar包 

五、將專案打成jar包
Java程式碼   收藏程式碼
  1. <!-- jar包外掛 -->  
  2. <plugin>  
  3.     <groupId>org.apache.maven.plugins</groupId>  
  4.     <artifactId>maven-jar-plugin</artifactId>  
  5.     <version>2.4</version>  
  6.     <configuration>  
  7.         <archive>  
  8.             <manifest>  
  9.                 <!-- 告知 maven-jar-plugin新增一個 Class-Path元素到 MANIFEST.MF檔案，以及在Class-Path元素中包括所有依賴項 -->  
  10.                 <addClasspath>true</addClasspath>  
  11.                 <!-- 所有的依賴項應該位於 lib資料夾 -->  
  12.                 <classpathPrefix>lib/</classpathPrefix>  
  13.                 <!-- 當用戶使用 lib命令執行JAR檔案時，使用該元素定義將要執行的類名 -->  
  14.                 <mainClass>com.zhengtian.tools.service.phone.MobilePhoneTool</mainClass>  
  15.             </manifest>  
  16.         </archive>  
  17.     </configuration>  
  18. </plugin>  


在將專案打成jar包時，有時會需要將專案打成可以直接執行的jar包，因此就需要將專案依賴的jar包也打入jar包中，此時需要在Eclipse上安裝例外一個外掛，用來打可執行jar包，詳情見連結http://zheng12tian.iteye.com/blog/1765626

六、將專案打成war包
Java程式碼   收藏程式碼
  1. <!-- war外掛 -->  
  2. <plugin>  
  3.     <groupId>org.apache.maven.plugins</groupId>  
  4.     <artifactId>maven-war-plugin</artifactId>  
  5.     <version>2.1.1</version>  
  6.     <configuration>  
  7.         <!-- <warName>${project.build.name}</warName> -->  
  8.     </configuration>  
  9. </plugin>  

encoding：強制字符集編碼 
warName：war包名字——platform.war 
webappDirectory：產生war前，用於存放構建war包的目錄——target/platform。 
warSourceDirectory：我把web工程搞成了eclipse下的WTP型別。我不喜歡maven產生的webapp目錄，更喜歡WebContent！ 

需要注意的是：
採用上述外掛部署專案的話，使用clean package tomcat:redeploy命令。使用該命令前，需要先啟動tomcat，實際上是為了讓tomcat啟動manager專案，實現動態部署 

此部署方式雖然也是動態部署的範疇，但是每次修改檔案後，需要手動再次重新部署，才會載入更改。 

如果想讓tomcat自動掃描專案的改動，自動載入，那麼需要將maven工程的java全部編譯的webapp目錄下，然後將jar包和資原始檔也打到webapp目錄。最後在$CATALINA_HOME/conf /Catalina/localhost中新增一個xml檔案，修改docbase為webapp目錄。 

Tomcat常用的部署方式介紹：http://blog.csdn.net/yangxueyong/article/details/6130065

配置描述：當你的pom檔案中把你的當前專案的packaging配置為war後，maven會使用該外掛將當前專案生成war檔案，但是有時候我們不想要war檔案，只想讓maven生成當前專案的網站目錄結構，尤其是在除錯的時候，因為生成war檔案的同時，會生成當前專案的網站目錄結構，這樣一來，浪費了打包的時間和磁碟的空間！

maven使用war外掛生成war檔案所用的目標（goal）為war，從幫助文件中可以看出，war外掛還有一個目標（goal）是exploded，即，只生成目錄結構，而不生成war檔案。

參見：http://maven.apache.org/plugins/maven-war-plugin/plugin-info.html

可以在當前目錄下直接使用mvn war:exploded，就能生成當前專案的網站目錄結構。

使用mvn war:exploded生成網站目錄結構的時候，war外掛會把src/main/webapp目錄下的內容全部copy到target/${finalName}目錄下，但是，有時候webapp裡的一些資源部需要copy，比如我會在src/main/webapp的js目錄下放很多jQuery的外掛，其中包括外掛的幫助文件；但是我可能只會用到其中一部分外掛。所以在生成網站目錄結構的時候，我根本不需要把src/main/webapp的js目錄下的所以檔案都copy到target/${finalName}目錄中，這時候就需要對exploded目標（goal）進行資源過濾了——不把沒用的資源copy到網站的目錄結構中去：

  1. <plugin>
  2.     <artifactId>maven-war-plugin</artifactId>
  3.     <configuration>
  4.         <warSourceExcludes>js/參考/**</warSourceExcludes>
  5.     </configuration>
  6. </plugin>

說明：上面的配置，使用了war外掛的warSourceExcludes引數，該引數是一個String型別，需要把被排除的路徑或檔案使用逗號（comma）間隔開。

參見：

1、http://www.wsria.com/archives/1335

2、http://maven.apache.org/plugins/maven-war-plugin/exploded-mojo.html#warSourceDirectory


七、在打包時，需要清空一些指定的目錄

配置描述：maven提供了很多有用外掛，如mvn clean使用到的maven-clean-plugin，mvn compile使用到的maven-compile-plugin等，這些外掛可以通過pom檔案繫結到maven三個生命週期（life-cycle）的各階段（phase）上，也可以在命令列（如Windows下的cmd）中單獨由mvn命令呼叫，如mvn clean，可以呼叫maven-clean-plugin的clean目標（goal）。對於繫結到各階段（phase）執行的外掛的引數（parameter）可以用<configuration>標籤（tag）配置，但是在該外掛在命令列下單獨由mvn命令呼叫，那麼這個引數該如何使用pom檔案配置呢？比如，在一個J2EE專案中，想使用mvn clean命令清除target裡的內容的同時，也清除tomcat/webapp下的相應目錄，該怎麼辦呢？這就需要在pom檔案中對外掛進行全域性配置了。

  1. <plugin>
  2.     <artifactId>maven-clean-plugin</artifactId>
  3.     <configuration>
  4.         <verbose>true</verbose>
  5.         <filesets>
  6.             <fileset>
  7.                 <directory>c:/a</directory>
  8.             </fileset>
  9.       </filesets>
  10.     </configuration>
  11. </plugin>

外掛的配置分為區域性配置和全域性配置，本文中對antrun和resource外掛的配置是區域性配置，對clean外掛的配置是全域性配置，能看出差別吧？

區域性配置的<configuration>標籤（tag）放在<execution>標籤（tag）裡邊，而全域性配置的<configuration>標籤（tag）則放在<plugin>標籤（tag）裡邊，因為全域性配置里根本就沒有<execution>標籤（tag），因為全域性配置針對的是該外掛的全部目標（goal）配置的！

本例中，刪除的是C:/a目錄，即，當用戶在該maven專案中執行mvn clean後，除了刪除clean外掛預設的project.build.directory, project.build.outputDirectory,project.build.testOutputDirectory, 和 project.reporting.outputDirectory目錄外

還會刪除C:/a目錄。

注意，該配置僅針對本專案有效，即，使用者在當前專案下使用mvn clean時，會刪除C:/a目錄；當用戶在其他沒有如此配置clean外掛的maven專案中執行mvn clean時，不會刪除C:/a目錄。

設定fileset的目錄時候用到的<directory>標籤不能亂用，比如<dir>，否則maven沒法識別，因為maven使用pom設定外掛引數（parameter）的時候用的是設定java bean的方式，之所以用<directory>標籤，是因為在org.apache.maven.plugin.clean.Fileset.java中，Fileset類只有如下成員變數：

（參見：http://search.maven.org/remotecontent?filepath=org/apache/maven/plugins/maven-clean-plugin/2.4.1/maven-clean-plugin-2.4.1-source-release.zip）

  1. private File directory;  
  2. private String[] includes;  
  3. private String[] excludes;  
  4. privateboolean followSymlinks;  

相關閱讀：

1、Maven clean plugin - delete additional directories

八、利用tomcat-maven-plugin外掛將專案自動打包並部署到tomcat中
Java程式碼   收藏程式碼
  1.  <!-- tomcat外掛 -->  
  2.     <plugin>  
  3.         <groupId>org.codehaus.mojo</groupId>  
  4.         <artifactId>tomcat-maven-plugin</artifactId>  
  5.         <configuration>  
  6.             <server>tomcat6-manager</server>  
  7.             <path>/${project.build.name}</path>  
  8.             <url>http://localhost:8080/manager</url>  
  9.             <username>admin</username>  
  10.             <password>admin</password>  
  11.         </configuration>  
  12.         <executions>  
  13.             <execution>  
  14.   

相關推薦

maven 常用外掛配置詳解

先將我用到的自定義變數貼過來，防止外掛中出現一些變數，大家不理解 Java程式碼    <!-- 全域性屬性配置 -->  <properties>      <project.build.name>tools&

Maven的setting配置詳解

一.Maven的setting配置檔案 和 在Eclipse中對Maven的正確配置。 1.Maven的配置檔案（Maven的安裝目錄/conf/settings.xml ） 和 Maven倉庫下（預設的Maven倉庫的是使用者家目錄下的.m2檔案，可以另行制定）的settings.xml檔案

maven pom標籤配置詳解

<modelVersion>4.0.0</modelVersion> <!--專案的全球唯一識別符號，通常使用全限定的包名區分該專案和其他專案。並且構建時生成的路徑也是由此生成， 如com.mycompany

Gradle使用詳解(三) 之 Android Gradle外掛配置詳解

通上前兩篇博文由淺入深的學習Gradle的基礎和Gradle的Java外掛相關知識後，現在終於到了高潮部分了，讓我們來進一步正式學習Android Gradle外掛。前面提到，Android Gradle外掛是一個基於內建的Java外掛來實現的第三方外掛，它是由google的

Maven--pom.xml 配置詳解

pom作為專案物件模型。通過xml表示maven專案，使用pom.xml來實現。主要描述了專案：包括配置檔案；開發者需要遵循的規則，缺陷管理系統，組織和licenses，專案的url，專案的依賴性，以及其他所有的專案相關因素。<project> <mod

Maven常用外掛配置

<build> <finalName>xxxt-web</finalName> <resources> <resource> <directory>src/main/resources</directory&

MAVEN常用外掛配置方式

<plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-clean-plugin</artif

Maven pom.xml 配置詳解

什麼是pom?    pom作為專案物件模型。通過xml表示maven專案，使用pom.xml來實現。主要描述了專案：包括配置檔案；開發者需要遵循的規則，缺陷管理系統，組織和licenses，專案的url，專案的依賴性，以及其他所有的專案相關因素。pom.xml 配置檔案&l

Maven打jar包之maven-jar-plugin配置詳解，自動生成MANIFEST.MF檔案

一、maven-jar-plugin配置介紹 最近學習springboot多模組打jar包部署專案，用到了maven-jar-p

webpack4配置詳解之常用外掛分享

　　前言　　　　繼上一次webpack的基礎配置分享之後，本次將分享一些工作中專案常用的配置外掛、也會包含一些自己瞭解過覺得不錯的外掛，如有分析不到位的，歡迎糾錯，嗯，這些東西文件都有，大佬可繞過。　　　　Wepack4之後廢棄了很多的外掛，這裡只會講解webpack4還支援的（包含4之前外掛），已經廢棄的將

MAVEN常用命令+基本配置詳解

mvn  -v  類似於 javac -version  或者 git --version 在linux上使用maven也需要像使用java一樣設定環境變數 這是 export M2_HOME     = /? export PATH = $PATH:$M2_HOME/b

maven-compiler-plugin外掛引數配置詳解

maven-compiler-plugin外掛是一個Maven外掛，用來編譯專案程式碼；自從3.0開始預設的編譯器是javax.tools.JavaCompiler，用來編譯Java原始碼；如果你想強制外掛使用javac編譯器，你必須配置外掛的屬性forceJa

09-nginx常用配置詳解

accept 用戶與用戶組 oot 進程資源 常用 brush pan nts 還要 Nginx配置分為各個配置塊，主配置塊負責全局配置，子配置塊可以繼承全局配置，也可以相應的配置不同設置。 main block:主配置（全局配置） event{

logback 常用參數配置詳解

dna 則表達式 manual 歸檔文件 caller 執行 fig lua stdout logback 常用配置詳解（二） <appender> <appender>： <appender>是<configuratio

Tomcat學習總結（6）——Tomca常用配置詳解

mar evel 代碼段 between 取消 新建 unp -h tom 註：Tomcat 8需要JRE7以上的JRE 1. Tomcat環境變量設置 1.1 Java環境變量設置 右鍵計算機—屬性—高級系統設置—環境變量，在”系統環境變量”，設置如下三個變量（如果變量已

Nginx中常用的指令配置詳解

Nginx中的rewrite指令的應用rewrite指令的作用：是做一些訪問匹配規則的判斷，從而實現相應的操作。location / {proxy_pass http://192.168.1.5if (-d $request_filename) {...........; 這裏的意思是訪問的如果是一個目錄

Intellij IDEA常用配置詳解

excludes 自動 pattern add 快捷鍵 sync compile vss 去掉 1. IDEA內存優化 先看看你機器本身的配置而配置. \IntelliJ IDEA 8\bin\idea.exe.vmoptions ---------------------

logback logback.xml常用配置詳解（一）<configuration> and <logger>

配置文件 cti 原創文章 分類 lis ali 配置 默認值 原創 摘自：http://aub.iteye.com/blog/1101260logback logback.xml常用配置詳解（一）<configuration> and <logger&

mybatis 代碼生成器（IDEA, Maven)及配置詳解（部分配置你應該不知道）

win 項目 找到 mini 屬性 新建 ini 默認 sub 在使用 mybatis 過程中， 當手寫 JavaBean和XML 寫的越來越多的時候， 就越來越同意出錯。這種重復性的工作， 我們當然不希望做那麽多。 還好， mybatis 為我們提供了強大的代碼生成--M

時間外掛--daterangepicker使用和配置詳解

---------------------  作者：呆呆_小茗  來源：CSDN  原文：https://blog.csdn.net/baidu_38990811/article/details/79509418  版權宣告：本文為博主原創文章，轉載請附上博文