Maven使用記錄

Maven使用記錄

使用阿里雲國內鏡像

修改$M2_HOME/conf/setting.xml

<mirror>  
  <id>aliyun</id>  
  <name>aliyun maven</name>  
  <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
  <mirrorOf>central</mirrorOf>          
</mirror>

使用JDK8及解決中文亂碼

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.plugin.version>3.3</maven.compiler.plugin.version>
    <java.source.version>1.8</java.source.version>
    <java.target.version>1.8</java.target.version>
</properties>

<build>
    <plugins>
     <plugin>
      	   <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-compiler-plugin</artifactId>
           <version>${maven.compiler.plugin.version}</version>
           <configuration>
               <source>${java.source.version}</source>
               <target>${java.target.version}</target>
               <encoding>${project.build.sourceEncoding}</encoding>
           </configuration>
       </plugin>
    </plugins>
</build>

打包能運行的Jar

maven-assembly-plugin

在POM.xml文件中添加：

<properties>
    <!--此處指定入口類-->
    <main.class>com.zhanjixun.App</main.class>
</properties>

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-assembly-plugin</artifactId>
    <version>3.0.0</version>
    <configuration>
        <archive>
            <manifest>                       
                <mainClass>${main.class}</mainClass>
            </manifest>
        </archive>
        <descriptorRefs>
            <!--依賴會一起打包-->
            <descriptorRef>jar-with-dependencies</descriptorRef>
        </descriptorRefs>
    </configuration>
</plugin>

使用maven命令編譯：

mvn assembly:assembly

編譯代碼，會在target目錄下生成*-with-dependencies.jar的jar，就是我們要的結果。這樣編譯會將項目的資源文件和所有的依賴一起打包到一個jar中，一站式解決所有問題。

maven-shade-plugin

在POM.xml文件中添加：

<properties>
    <!--此處指定入口類-->
    <main.class>com.zhanjixun.App</main.class>
</properties>

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.0.0</version>
    <executions>
        <execution>
            <id>build-jar</id>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <shadedArtifactAttached>true</shadedArtifactAttached>
                <shadedClassifierName>shaded</shadedClassifierName>
                <!--這裏生成的jar的文件名稱 默認是 ${project.artifactId}-${project.version}-shaded -->
                <finalName>${project.artifactId}-${project.version}-shaded</finalName>
                <transformers>
                    <transformer
                            implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <!--這裏指定入口類-->
                        <mainClass>${main.class}</mainClass>
                    </transformer>
                </transformers>
            </configuration>
        </execution>
    </executions>
</plugin>

然後在maven打包過程中就會調用這個插件，在tagert目錄下生成一個-shaded.jar文件，就是可執行的jar。

mvn package

如何使用一個pom文件生成多個jar包呢？

maven的pom文件中executions可以指定多個execution，可以將綁定多個構建任務，通過phase可以綁定maven生命週期

生成windows可執行exe包

項目源碼：https://github.com/lukaszlenart/launch4j-maven-plugin

<properties>
    <!--此處指定入口類-->
    <main.class>com.zhanjixun.App</main.class>
</properties>

<plugin>
    <groupId>com.akathist.maven.plugins.launch4j</groupId>
    <artifactId>launch4j-maven-plugin</artifactId>
    <version>1.7.25</version>
    <executions>
        <execution>
            <id>l4j-clui</id>
            <phase>package</phase>
            <goals>
                <goal>launch4j</goal>
            </goals>
            <configuration>
                <!--生成exe程序類型，gui用戶界面 console控制檯-->
                <headerType>gui</headerType>
                <!--到哪裏找可運行的jar來製作exe-->
                <jar>${project.build.directory}/${project.artifactId}-${project.version}-shaded.jar</jar>
                <!--指定exe文件輸出路徑-->
                <outfile>${project.build.directory}/${project.name}.exe</outfile>
                <downloadUrl>http://java.com/download</downloadUrl>
                <classPath>
                    <!--這裏指定exe文件的入口類-->
                    <mainClass>${main.class}</mainClass>
                    <preCp>anything</preCp>
                </classPath>
                <!--指定exe圖標資源文件-->
                <icon>src/main/resources/application.ico</icon>
                <jre>
                    <!--指定綁定jre的路徑-->
                    <path>/bin/jre</path>
                    <!--最低jre版本-->
                    <minVersion>1.8.0</minVersion>
                    <bundledJre64Bit>true</bundledJre64Bit>
                    <jdkPreference>preferJre</jdkPreference>
                    <runtimeBits>64/32</runtimeBits>
                </jre>
                <!--這裏的信息在exe右鍵屬性的詳細信息中能查看-->
                <versionInfo>
                    <!--文件說明-->
                    <fileDescription>${project.description}</fileDescription>
                    <!--文件版本-->
                    <fileVersion>${project.version}</fileVersion>
                    <txtFileVersion>${project.version}</txtFileVersion>
                    <!--版權-->
                    <copyright>2019 http://github.com/zhanjixun</copyright>
                    <!--產品名稱-->
                    <productName>${project.name}</productName>
                    <!--產品版本-->
                    <productVersion>${project.version}</productVersion>
                    <txtProductVersion>${project.version}</txtProductVersion>
                    <companyName>http://github.com/zhanjixun</companyName>
                    <internalName>hasCode</internalName>
                    <!--原始文件名-->
                    <originalFilename>${project.name}.exe</originalFilename>
                </versionInfo>
            </configuration>
        </execution>
    </executions>
</plugin>

使用jetty啓動web項目

首先在pom.xml中添加

<build>
    <finalName>AppName</finalName>
    <plugins>
        <plugin>
            <groupId>org.eclipse.jetty</groupId>
            <artifactId>jetty-maven-plugin</artifactId>
            <version>9.4.5.v20170502</version>
            <configuration>
                <scanIntervalSeconds>10</scanIntervalSeconds>
                <httpConnector>
                    <!--指定端口號-->
                    <port>8082</port>
                </httpConnector>
            </configuration>
        </plugin>
    </plugins>
</build>

然後在項目目錄下運行以下命令即可啓動web運用

mvn jetty:run

Mybatis代碼生成插件

配置文件：mybatis-generator.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration
        PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
        "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
<generatorConfiguration>
    <!-- 數據庫驅動:選擇你的本地硬盤上面的數據庫驅動包-->
    <classPathEntry
            location="D:\apache-maven-3.6.0\repo\mysql\mysql-connector-java\5.0.5\mysql-connector-java-5.0.5.jar"/>
    <context id="DB2Tables" targetRuntime="MyBatis3">
        <commentGenerator>
            <property name="suppressDate" value="true"/>
            <!-- 是否去除自動生成的註釋 true：是 ： false:否 -->
            <property name="suppressAllComments" value="true"/>
        </commentGenerator>
        <!--數據庫鏈接URL，用戶名、密碼 -->
        <jdbcConnection driverClass="com.mysql.jdbc.Driver"
                        connectionURL="jdbc:mysql://127.0.0.1:3306/test"
                        userId="root"
                        password="123456">
        </jdbcConnection>
        <javaTypeResolver>
            <property name="forceBigDecimals" value="false"/>
        </javaTypeResolver>
        <!-- 生成模型的包名和位置-->
        <javaModelGenerator targetPackage="com.zhanjixun.dto" targetProject="src/main/java">
            <property name="enableSubPackages" value="true"/>
            <property name="trimStrings" value="true"/>
        </javaModelGenerator>
        <!-- 生成映射文件的包名和位置-->
        <sqlMapGenerator targetPackage="mapper" targetProject="src/main/resources">
            <property name="enableSubPackages" value="true"/>
        </sqlMapGenerator>
        <!-- 生成DAO的包名和位置-->
        <javaClientGenerator type="XMLMAPPER" targetPackage="com.zhanjixun.mapper"
                             targetProject="src/main/java">
            <property name="enableSubPackages" value="true"/>
        </javaClientGenerator>

        <!-- 要生成的表 tableName是數據庫中的表名或視圖名 domainObjectName是實體類名-->
        <table tableName="t_user" domainObjectName="User"
               enableCountByExample="false"
               enableUpdateByExample="false"
               enableDeleteByExample="false"
               enableSelectByExample="false"
               selectByExampleQueryId="false"/>
    </context>
</generatorConfiguration>

maven插件： pom.xml

<!-- mybatis generator 自動生成代碼插件 -->
<plugin>
    <groupId>org.mybatis.generator</groupId>
    <artifactId>mybatis-generator-maven-plugin</artifactId>
    <version>1.3.2</version>
    <configuration>
        <!--指定mybatis-generator.xml所在路徑-->
        <configurationFile>${basedir}/src/main/resources/generator/mybatis-generator.xml</configurationFile>
        <!--是否覆蓋原有文件-->
        <overwrite>false</overwrite>
        <verbose>true</verbose>
    </configuration>
</plugin>

運行命令：

mvn mybatis-generator:generate

編譯跳過測試

maven-compiler-plugin插件

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.3</version>
    <configuration>
        <source>1.8</source>
        <target>1.8</target>
        <!--解決亂碼問題-->
        <encoding>utf-8</encoding>
        <!-- 跳過編譯和運行單元測試 -->
        <skip>true</skip>
    </configuration>
</plugin>

maven-surefire-plugin插件

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <configuration>
        <!--編譯單元測試但不運行-->
        <skipTests>true</skipTests>
    </configuration>
</plugin>

命令參數

# 跳過編譯和運行單元測試
mvn clean package -Dmaven.test.skip=true

# 編譯單元測試但不執行
mvn clean package -DskipTests

maven使用docker插件

部署war免Dockerfile文件

<properties>
    <!-- 鏡像前綴 -->
    <docker.image.prefix>zhanjixun</docker.image.prefix>
</properties>
<plugin>
    <groupId>com.spotify</groupId>
    <artifactId>docker-maven-plugin</artifactId>
    <version>0.4.14</version>
    <configuration>
        <imageName>${docker.image.prefix}/${project.build.finalName}</imageName>
        <imageTags>
            <imageTag>${project.version}</imageTag>
            <!--同時發佈最新版-->
            <imageTag>latest</imageTag>
        </imageTags>
        <baseImage>tomcat:8.0-jre8</baseImage>
        <!--<dockerDirectory>${project.basedir}</dockerDirectory>-->
        <resources>
            <resource>
                <!--複製war包到webapps目錄下-->
                <targetPath>/usr/local/tomcat/webapps</targetPath>
                <directory>${project.build.directory}</directory>
                <include>${project.build.finalName}.war</include>
            </resource>
        </resources>
    </configuration>
</plugin>

運行命令：

mvn clean install docker:build -Dmaven.test.skip=true

部署SpringBoot使用Dockerfile

在項目目錄下新建Dockerfile文件

Dockerfile

FROM openjdk:8-jdk-alpine
EXPOSE 8080

VOLUME /tmp
ADD target/app.jar  /app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

<properties>
    <!-- 鏡像前綴 -->
    <docker.image.prefix>zhanjixun</docker.image.prefix>
</properties>

<plugin>
    <groupId>com.spotify</groupId>
    <artifactId>docker-maven-plugin</artifactId>
    <version>0.4.14</version>
    <configuration>
        <imageName>${docker.image.prefix}/${project.artifactId}</imageName>
        <imageTags>
            <imageTag>${project.version}</imageTag>
            <!--同時發佈最新版-->
            <imageTag>latest</imageTag>
        </imageTags>
        <dockerDirectory>${project.basedir}</dockerDirectory>
        <resources>
            <resource>
                <targetPath>/</targetPath>
                <directory>${project.build.directory}</directory>
                <include>${project.build.finalName}.jar</include>
            </resource>
        </resources>
    </configuration>
</plugin>

運行命令：

mvn clean install docker:build -Dmaven.test.skip=true
#使用docker:build構建docker鏡像