java maven打包

一、Maven依賴中的scope作用域詳解

Maven的一個哲學是慣例優於配置(Convention Over Configuration), Maven默認的依賴配置項中,scope的默認值是compile,項目中經常傻傻的分不清,直接默認了。今天梳理一下maven的scope。

scope的分類

compile

默認就是compile,什麼都不配置也就是意味着compile。compile表示被依賴項目需要參與當前項目的編譯,當然後續的測試,運行週期也參與其中,是一個比較強的依賴。打包的時候通常需要包含進去。

test

scope爲test表示依賴項目僅僅參與測試相關的工作,包括測試代碼的編譯,執行。比較典型的如junit。

runntime

runntime表示被依賴項目無需參與項目的編譯,不過後期的測試和運行週期需要其參與。與compile相比,跳過編譯而已,說實話在終端的項目(非開源,企業內部系統)中,和compile區別不是很大。比較常見的如JSR×××的實現,對應的API jar是compile的,具體實現是runtime的,compile只需要知道接口就足夠了。Oracle jdbc驅動架包就是一個很好的例子,一般scope爲runntime。另外runntime的依賴通常和optional搭配使用,optional爲true。我可以用A實現,也可以用B實現。

provided

provided意味着打包的時候可以不用包進去,別的設施(Web Container)會提供。事實上該依賴理論上可以參與編譯,測試,運行等週期。相當於compile,但是在打包階段做了exclude的動作。

system

從參與度來說,也provided相同,不過被依賴項不會從maven倉庫抓,而是從本地文件系統拿,一定需要配合systemPath屬性使用。

scope的依賴傳遞

A–>B–>C。當前項目爲A,A依賴於B,B依賴於C。知道B在A項目中的scope,那麼怎麼知道C在A中的scope呢?答案是: 
當C是test或者provided時,C直接被丟棄,A不依賴C; 
否則A依賴C,C的scope繼承於B的scope。

下面是一張nexus畫的圖。 
依賴傳遞時scope的計算

二、SpringBoot簡單打包部署

前言

本文主要介紹SpringBoot的一些打包事項和項目部署以及在其中遇到一些問題的解決方案。

SpringBoot打包

在SpringBoot打包這塊,我們就用之前的一個web項目來進行打包。 首先需要明確的是,該項目打包的形態是可執行的jar包,還是在tomcat下運行的war包。 雖然本項目是用maven構建的,用maven打包也更加方便,但是這裏也說明普通非maven打包的項目如何打包。

Maven打包

首先是maven方式打包: 如果是jar包 需在pom.xml指定打成的包爲:

<packaging>jar</packaging>  
複製代碼

如果是war包。 需在pom.xml指定打成的包爲:

<packaging>war</packaging>  
複製代碼

並通過<scope>標籤在打包的時候排除tomcat依賴

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-tomcat</artifactId>
	<scope>provided</scope>
</dependency>
複製代碼

然後添加SpringBoot自帶的打包方式 示例如下:

<build>
		<defaultGoal>compile</defaultGoal>
		<sourceDirectory>src</sourceDirectory>
		<finalName>springboot-package</finalName>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin </artifactId>
				<configuration>
					<fork>true</fork>
					<mainClass>com.pancm.App</mainClass>
				</configuration>
				<executions>
					<execution>
						<goals>
							<goal>repackage</goal>
						</goals>
					</execution>
				</executions>
			</plugin>
		</plugins>
	</build>
複製代碼

注:<finalName>標籤是指定打包之後的名稱,<mainClass>是指定main函數。

也可以不用SpringBoot自帶的打包方式,使用mavenassembly插件進行打包。 示例如下:

添加<build></build>標籤

<build>
    <plugins>
		  <plugin>
            <groupId>org.apache.maven.plugins</groupId>  
            <artifactId>maven-assembly-plugin</artifactId>  
            <version>2.5.5</version>  
            <configuration>
                <archive>  
                    <manifest>  
                        <mainClass>com.pancm.App</mainClass>  
                    </manifest>  
                </archive>  
                <descriptorRefs>  
                    <descriptorRef>jar-with-dependencies</descriptorRef>  
                </descriptorRefs>  
            </configuration>  
        </plugin> 
       </plugins>
	</build> 
複製代碼

pom.xml中添加完相應的標籤之後,我們只需在項目同級(pom.xml同級)輸入

mvn clean package
複製代碼

即可完成打包 如果想排除測試代碼,則可以輸入:

mvn clean package  -Dmaven.test.skip=true
複製代碼

來進行打包。

一般我們是把application.propertieslogback.xml文件放在resources文件夾中,但是進行打包之後,它們也會包含在jarwar包中,如果我們想更改配置,則會比較麻煩。 如果想將它們和項目放在同級目錄下,application.properties可以直接移出和項目同級的目錄下,因爲Spring程序會按優先級從下面這些路徑來加載application.properties配置文件:

  • 當前目錄下的/config目錄
  • 當前目錄
  • classpath裏的/config目錄
  • classpath 根目錄

springboot默認加載的logback是在classpath目錄下,這時我們只需要在application.properties配置文件指定logback.xml的路徑即可。 添加如下:

logging.config=logback.xml
複製代碼

如果引入了第三方的jar包,但是又無法通過maven私服進行下載,這時可以手動進行編譯。 例如,我寫了一個工具類爲Mytools,然後把它打成了一個jar包,然後放在我的這個項目中lib目錄下,並且需要引用它,那麼此時便可以對該jar包進行編譯到本地倉庫中,然後再pom.xml添加相應的名稱和版本號。 命令示例:

mvn install:install-file -Dfile=lib/pancmtools.jar -DgroupId=com.panncm.utils -DartifactId=pancm-utils -Dversion=1.0 -Dpackaging=jar
複製代碼

pom.xml添加

<dependency>
			<groupId>com.panncm.utils</groupId>
			<artifactId>pancm-utils</artifactId>
			<version>1.0</version>
</dependency>
複製代碼

便可以進行打包了。

普通項目打包

如果是普通的項目,沒有使用maven構建的話,可以使用eclipse等工具進行打包。 如果是jar包 首先在eclipse中運行該項目(main方法運行),然後在eclipse中右鍵項目 export ->java -> runnable jar file-> package required libraries into generated jar 指定main方法,然後選擇打包的名稱以及打包的路徑。點擊finish完成打包。

如果是war包 在eclipse中右鍵項目 export ->web -> war file,然後選擇打包的名稱以及打包的路徑。點擊finish完成打包。

Ant打包

介紹了上述兩種打包之後,這裏介紹下通過ant方法進行打包(需要安裝ant環境,安裝方式基本和maven一致,指定路徑,配置環境變量,這裏就不在過多講述了)。 一般打包之後,我們需要將包和配置文件放在一個目錄下,這時我們又不想手動進行復制粘貼的話,就可以用ant來進行打包,將打包的文件整合在一起。 這裏我們就編寫一個build.xml的配置文件。

<?xml version="1.0" encoding="UTF-8"?>
<project name="springboot-package" default="copyAll" basedir=".">
	<property name="build" value="build" />
	<property name="target" value="target" />
	<target name="clean">
		<delete dir="${target}" />
		<delete dir="${build}" />
	</target>

	<target name="create-path" depends="clean">
		<mkdir dir="${build}" />
	</target>

	<target name="mvn_package" depends="create-path">
		<exec executable="cmd" failonerror="true">
			<arg line="/c mvn install:install-file -Dfile=lib/pancmtools.jar -DgroupId=com.panncm.utils -DartifactId=pancm-utils -Dversion=1.0 -Dpackaging=jar" />
		</exec>
		<exec executable="cmd" failonerror="true">
			<arg line="/c mvn clean package" />
		</exec>
	</target>

	<target name="copyAll" depends="mvn_package">
		<copy todir="${build}" file="${target}/springboot-package.jar"></copy> 
		<copy todir="${build}" file="logback.xml"></copy>
		<copy todir="${build}" file="application.properties"></copy>
		<copy todir="${build}" file="run.bat"></copy>
	</target>
</project>
複製代碼

注:<mkdir dir="${build}" />是指定文件存放的文件夾,executable是使用cmd命令,line是執行的語句, 標籤是將文件複製到指定的文件夾中。

然後再新建一個 build.bat文件,裏面只需要填寫 ant就行了。 準備完之後,只需雙擊build.bat,項目和配置文件就自動到build文件中了,省去了很多操作。

雖然現在流行通過jenkins進行打包部署,不過使用ant加maven進行打包也不錯的,比較簡單。

SpringBoot部署

如果是jar項目 Windows系統在項目同級目錄下輸入:

java -jar springboot-package 
複製代碼

即可啓動項目。 關閉項目,只需關掉dos界面就可以了。 也可以寫一個bat文件進行運行。

Linux系統在項目同級目錄下輸入:

nohup -jar springboot-package &
複製代碼

即可啓動。 關閉輸入:

kill -9 pid(jar的進程id)
複製代碼

也可以在init.d註冊一個服務 示例:

ln -s /home/jars/app/springboot-package.jar /etc/init.d/springboot-package
chmod +x /etc/init.d/springboot-package
複製代碼

然後輸入:

service springboot-package start|stop|restart
複製代碼

進行啓動或者停止。 當然也可以編寫xshell腳本進行啓動和關閉。

如果是war項目 將war放在tomcat/webapp目錄下,然後啓動tomcat就可以了。Windows系統 在tomcat/bin目錄下雙擊startup.bat即可啓動,雙擊shutdown.bat關閉。 Linux系統則在tomcat/bin 目錄下輸入startup.sh即可啓動, 輸入shutdown.sh關閉。

三、徹底解析SpringBoot jar可執行原理

1、https://www.lizenghai.com/archives/23778.html

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章