Maven 工程實踐

paraller 發(fā)布于2019-08-14 17:54 / 1323人閱讀

摘要：前言雖然勢頭很猛，但是依然是項目構(gòu)建的優(yōu)先選擇，本文簡要介紹一些工程實踐多模塊如果工程比較復(fù)雜，或者預(yù)期后續(xù)會變的比較復(fù)雜，可以將工程分成多個模塊，常用的分模塊的方法，核心代碼，工具，服務(wù)，前端在頂層文件中聲明工程包含的各個模塊在子模塊文件

前言

雖然 Gradle 勢頭很猛，但是 Maven 依然是 Java 項目構(gòu)建的優(yōu)先選擇，本文簡要介紹一些 Maven 工程實踐

多模塊（multiple module）

如果工程比較復(fù)雜，或者預(yù)期后續(xù)會變的比較復(fù)雜，可以將工程分成多個模塊，常用的分模塊的方法：

core，核心代碼）

util/common，工具

service，服務(wù)

web/front，web 前端

在 root（頂層）pom 文件中聲明工程包含的各個模塊


    ...
    pom

    
        core
        service
        util
        web

在子模塊 pom 文件中聲明 parent pom


    ...
    
        com.aachuxing.gov.report
        ...
        1.0

插件

使用 Maven 離不開各種各樣的插件，簡單介紹一下常用的插件，詳細使用說明可以參考官方文檔，或者直接 google/baidu，在聲明插件的時候推薦：

將屬性值（jdk.version）定義在 properties 標(biāo)簽中

將 build 標(biāo)簽聲明在 root pom 中

maven-compiler-plugin

maven-compiler-plugin 可以指定 jdk 版本，推薦設(shè)置 jdk8 以上版本


    ...
    
        1.8
    

    
        
            
                
                    org.apache.maven.plugins
                    maven-compiler-plugin
                    
                        ${jdk.version}
                        ${jdk.version}
                        ${jdk.version}

maven-surefire-plugin

maven-surefire-plugin 用來排除一些你不想在持續(xù)集成中運行 test case，它們可能僅僅是你用來測試你的代碼，比如測試 dao 中 SQL 書寫是否有問題


    ...
    
        
            
                org.apache.maven.plugins
                maven-surefire-plugin
                2.19.1
                
                    
                        **/XXXTest.java

maven-assembly-plugin

通常一個 Java 工程除了 jar 包之外還有各種各樣的文件：shell 腳本，properties（屬性）文件，數(shù)據(jù)文件（json, xml），使用 maven-assembly-plugin 可以對工程打包部署做深度定制


    ...
    
        
            
                org.apache.maven.plugins
                maven-assembly-plugin
                2.6
                
                    
                        make-assembly
                        package
                        
                            single
                        
                    
                
                
                    
                        src/main/assembly/assembly1.xml
                        src/main/assembly/assembly2.xml
                        src/main/assembly/assembly3.xml

assembly.xml 配置文件用于配置具體的打包過程，在 descriptors 標(biāo)簽中可以指定多個配置文件，實現(xiàn)一套代碼打出多個 "渠道包"

下面是一個 assembly.xml 文件示例：


    ${id}
    
        tar.gz
    
    false
    
        
            src/main/assembly/bin
            bin
            
                startup.sh
                shutdown.sh
            
            0755
        
        
            ${project.build.directory}/classes
            /
            
                config.properties
                log4j2.xml
            
            0644
        
    
    
        
            lib

formats，通過后綴名指定打包文件格式，tar.gz, zip, war .etc

fileSets，指定哪些文件被打到包里頭

maven-dependency-plugin

maven-dependency-plugin 用于管理依賴，一個應(yīng)用場景是將依賴的 jar 包解開合并到工程中


    
        
            
                maven-dependency-plugin
                
                    
                        prepare-package
                        
                            unpack
                        
                        
                            
                                
                                    com.compony.xxx
                                    yyy
                                
                            
                            ${project.build.outputDirectory}