跳到主要內容

springboot的jar為何能獨立運行

歡迎訪問我的GitHub


https://github.com/zq2599/blog_demos
內容：所有原創文章分類匯總及配套源碼，涉及Java、Docker、Kubernetes、DevOPS等；


能獨立運行的jar文件


在開發springboot應用時，通過java -jar命令啟動應用是常用的方式，今天就來一起了解這個簡單操作背後的技術；


開發demo


開發一個springboot應用作為本次研究的對象，對應的版本信息如下：



  • JDK：1.8.0_211

  • springboot：2.3.1.RELEASE

  • maven：3.6.0


接下來開發springboot應用，這個應用異常簡單：



  1. springboot應用名為springbootstarterdemo，pom.xml文件內容：


<?xml version="1.0" encoding="UTF-8"?>
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <parent>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-parent</artifactId>
         <version>2.3.1.RELEASE</version>
         <relativePath/> <!-- lookup parent from repository -->
     </parent>
     <groupId>com.bolingcavalry</groupId>
     <artifactId>springbootstarterdemo</artifactId>
     <version>0.0.1-SNAPSHOT</version>
     <name>springbootstarterdemo</name>
     <description>Demo project for Spring Boot</description>
     <properties>
         <java.version>1.8</java.version>
     </properties>
     <dependencies>
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-web</artifactId>
         </dependency>
     </dependencies>
     <build>
         <plugins>
             <plugin>
                 <groupId>org.springframework.boot</groupId>
                 <artifactId>spring-boot-maven-plugin</artifactId>
             </plugin>
         </plugins>
     </build>
 </project>


  1. 只有一個java類，裏面有個http接口：


package com.bolingcavalry.springbootstarterdemo;
 
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 import java.util.Date;
 
 @SpringBootApplication
 @RestController
 public class SpringbootstarterdemoApplication {
 
     public static void main(String[] args) {
         SpringApplication.run(SpringbootstarterdemoApplication.class, args);
     }
     @RequestMapping(value = "/hello")
     public String hello(){
         return "hello " + new Date();
     }
 }


  1. 編碼完成，在pom.xml所在目錄執行命令


mvn clean package -U -DskipTests


  1. 構建成功后，在target目錄下得到文件springbootstarterdemo-0.0.1-SNAPSHOT.jar

  2. 就是這個springbootstarterdemo-0.0.1-SNAPSHOT.jar，此時執行java -jar springbootstarterdemo-0.0.1-SNAPSHOT.jar就能啟動應用，如下圖：


接下來就用這個springbootstarterdemo-0.0.1-SNAPSHOT.jar來分析jar文件能夠獨立啟動的原因；


java -jar做了什麼



  • 先要弄清楚java -jar命令做了什麼，在oracle官網找到了該命令的描述：

    If the -jar option is specified, its argument is the name of the JAR file containing class and resource files for the application. The startup class must be indicated by the Main-Class manifest header in its source code.


  • 再次秀出我蹩腳的英文翻譯：




  1. 使用-jar參數時，後面的參數是的jar文件名(本例中是springbootstarterdemo-0.0.1-SNAPSHOT.jar)；

  2. 該jar文件中包含的是class和資源文件；

  3. 在manifest文件中有Main-Class的定義；

  4. Main-Class的源碼中指定了整個應用的啟動類；(in its source code)



  • 小結一下：
    java -jar會去找jar中的manifest文件，在那裡面找到真正的啟動類；


探查springbootstarterdemo-0.0.1-SNAPSHOT.jar



  1. springbootstarterdemo-0.0.1-SNAPSHOT.jar是前面的springboot工程的構建結果，是個壓縮包，用常見的壓縮工具就能解壓，我這裏的環境是MacBook Pro，用unzip即可解壓；


  2. 解壓後有很多內容，我們先關注manifest相關的，下圖紅框中就是manifest文件：


  3. 打開上圖紅框中的文件，內容如下：



Spring-Boot-Classpath-Index: BOOT-INF/classpath.idx
 Implementation-Title: springbootstarterdemo
 Implementation-Version: 0.0.1-SNAPSHOT
 Start-Class: com.bolingcavalry.springbootstarterdemo.Springbootstarter
  demoApplication
 Spring-Boot-Classes: BOOT-INF/classes/
 Spring-Boot-Lib: BOOT-INF/lib/
 Build-Jdk-Spec: 1.8
 Spring-Boot-Version: 2.3.1.RELEASE
 Created-By: Maven Jar Plugin 3.2.0
 Implementation-Vendor: Pivotal Software, Inc.
 Main-Class: org.springframework.boot.loader.JarLauncher


  1. 在上述內容可見Main-Class的值org.springframework.boot.loader.JarLauncher，這個和前面的java官方文檔對應上了，正是這個JarLauncher類的代碼中指定了真正的啟動類；


疑惑出現



  1. 在MANIFEST.MF文件中有這麼一行內容：


Start-Class: com.bolingcavalry.springbootstarterdemo.Springbootstarter
  demoApplication


  1. 前面的java官方文檔中，只提到過Main-Class ，並沒有提到Start-Class；

  2. Start-Class的值是SpringbootstarterdemoApplication，這是我們的java代碼中的唯一類，也只真正的應用啟動類；

  3. 所以問題就來了：理論上看，執行java -jar命令時JarLauncher類會被執行，但實際上是SpringbootstarterdemoApplication被執行了，這其中發生了什麼呢？


猜測


動手之前先猜一下，個人覺得原因應該如下：



  1. java -jar命令會啟動JarLauncher；

  2. Start-Class是給JarLauncher用的；

  3. JarLauncher根據Start-Class找到了SpringbootstarterdemoApplication，然後執行它；


分析JarLauncher



  1. 先下載SpringBoot源碼，我下載的是2.3.1版本，地址：https://github.com/spring-projects/spring-boot/releases/tag/v2.3.1.RELEASE


  2. JarLauncher所在的工程是spring-boot-loader，先弄明白JarLauncher的繼承關係，如下圖，可見JarLauncher繼承自ExecutableArchiveLauncher，而ExecutableArchiveLauncher的父類Launcher位於最頂層，是個抽象類：


  3. java -jar執行的是JarLauncher的main方法，如下，會實例化一個JarLauncher對象，然後執行其launch方法，並且將所有入參都帶入：



public static void main(String[] args) throws Exception {
 	new JarLauncher().launch(args);
 }


  1. 上面的launch方法在父類Launcher中：


protected void launch(String[] args) throws Exception {
     // 將jar解壓后運行的方式叫做exploded mode
     // 如果是exploded mode，就不能支持通過URL加載jar
     // 如果不是exploded mode,就可以通過URL加載jar
 	if (!isExploded()) {
 	    // 如果允許通過URL加載jar，就在此註冊對應的處理類
 		JarFile.registerUrlProtocolHandler();
 	}
 	// 創建classLoader
 	ClassLoader classLoader = createClassLoader(getClassPathArchivesIterator());
 	// jarmode是創建docker鏡像時用到的參數，使用該參數是為了生成帶有多個layer信息的鏡像
 	// 這裏暫時不關注jarmode
 	String jarMode = System.getProperty("jarmode");
 	//如果沒有jarmode參數，launchClass的值就來自getMainClass()返回
 	String launchClass = (jarMode != null && !jarMode.isEmpty()) ? JAR_MODE_LAUNCHER : getMainClass();
 	launch(args, launchClass, classLoader);
 }


  1. 可見要重點關注的是getMainClass()方法，在看這個方法之前，我們先去關注一個重要的成員變量archive，是JarLauncher的父類ExecutableArchiveLauncher的archive，如下可見，該變量又來自方法createArchive：


public ExecutableArchiveLauncher() {
 		try {
 			this.archive = createArchive();
 			this.classPathIndex = getClassPathIndex(this.archive);
 		}
 		catch (Exception ex) {
 			throw new IllegalStateException(ex);
 		}
 	}


  1. 方法來自Launcher.createArchive，如下所示，可見成員變量archive實際上是個JarFileArchive對象：


protected final Archive createArchive() throws Exception {
 		ProtectionDomain protectionDomain = getClass().getProtectionDomain();
 		CodeSource codeSource = protectionDomain.getCodeSource();
 		URI location = (codeSource != null) ? codeSource.getLocation().toURI() : null;
 		String path = (location != null) ? location.getSchemeSpecificPart() : null;
 		if (path == null) {
 			throw new IllegalStateException("Unable to determine code source archive");
 		}
 		File root = new File(path);
 		if (!root.exists()) {
 			throw new IllegalStateException("Unable to determine code source archive from " + root);
 		}
 		return (root.isDirectory() ? new ExplodedArchive(root) : new JarFileArchive(root));
 	}


  1. 現在回到getMainClass()方法，可見his.archive.getManifest方法返回的是META-INF/MANIFEST.MF文件的內容，然後getValue(START_CLASS_ATTRIBUTE)方法實際上就是從META-INF/MANIFEST.MF中取得了Start-Class的屬性：


@Override
 	protected String getMainClass() throws Exception {
 	    // 對應的是JarFileArchive.getManifest方法，
 	    // 進去后發現對應的就是JarFile.getManifest方法，
 	    // JarFile.getManifest對應的就是META-INF/MANIFEST.MF文件的內容
 		Manifest manifest = this.archive.getManifest();
 		String mainClass = null;
 		if (manifest != null) {
 		    // 對應的是META-INF/MANIFEST.MF文件中的Start-Class的屬性
 			mainClass = manifest.getMainAttributes().getValue(START_CLASS_ATTRIBUTE);
 		}
 		if (mainClass == null) {
 			throw new IllegalStateException("No 'Start-Class' manifest entry specified in " + this);
 		}
 		return mainClass;
 	}


  1. 從上述分析可知：getMainClass()方法返回的是META-INF/MANIFEST.MF中取得了Start-Class的屬性com.bolingcavalry.springbootstarterdemo.SpringbootstarterdemoApplication，再次回到launch方法中，可見最終運行的代碼是launch(args, launchClass, classLoader)，它的launchClass參數就是com.bolingcavalry.springbootstarterdemo.SpringbootstarterdemoApplication：


protected void launch(String[] args) throws Exception {
 		if (!isExploded()) {
 			JarFile.registerUrlProtocolHandler();
 		}
 		ClassLoader classLoader = createClassLoader(getClassPathArchivesIterator());
 		String jarMode = System.getProperty("jarmode");
 		// 這裏的launchClass等於"com.bolingcavalry.springbootstarterdemo.SpringbootstarterdemoApplication"
 		String launchClass = (jarMode != null && !jarMode.isEmpty()) ? JAR_MODE_LAUNCHER : getMainClass();
 		// 這裏就是啟動SpringbootstarterdemoApplication的地方
 		launch(args, launchClass, classLoader);
 	}


  1. 展開launch(args, launchClass, classLoader)，最終查到了MainMethodRunner類：


public class MainMethodRunner {
 
 	private final String mainClassName;
 
 	private final String[] args;
 
 	/**
 	 * Create a new {@link MainMethodRunner} instance.
 	 * @param mainClass the main class
 	 * @param args incoming arguments
 	 */
 	public MainMethodRunner(String mainClass, String[] args) {
 	    // mainClassName被賦值為"com.bolingcavalry.springbootstarterdemo.SpringbootstarterdemoApplication"
 		this.mainClassName = mainClass;
 		this.args = (args != null) ? args.clone() : null;
 	}
 
 	public void run() throws Exception {
 	    // 得到SpringbootstarterdemoApplication的Class對象
 		Class<?> mainClass = Class.forName(this.mainClassName, false, Thread.currentThread().getContextClassLoader());
 		// 得到SpringbootstarterdemoApplication的main方法對象
 		Method mainMethod = mainClass.getDeclaredMethod("main", String[].class);
 		mainMethod.setAccessible(true);
 		// 通過反射執行main方法
 		mainMethod.invoke(null, new Object[] { this.args });
 	}
 }

終於，真相大白了；


小結


最後盡可能簡短做個小結，先看jar是如何產生的，如下圖，maven插件生成的jar文件中，有常見的class、jar，也有符合java規範的MANIFEST.MF文件，並且，還在MANIFEST.MF文件中額外生成了名為Start-Class的配置，這裏面是我們編寫的應用啟動類SpringbootstarterdemoApplication：


啟動類是JarLauncher，它是如何與MANIFEST.MF文件關聯的呢？從下圖可以看出，最終是通過JarFile類的成員變量manifestSupplier關聯上的：


再來看看關鍵代碼的執行情況，如下圖：


至此，SpringBoot的jar獨立運行的基本原理已經清楚，探究的過程中，除了熟悉關鍵代碼流程，還對jar中的文件有了更多了解，如果您正在學習SpringBoot，希望本文能給您一些參考；


官方文檔



  1. 最後附上SpringBoot官方文檔，可以看到Start-Class描述信息：


  2. 上述文檔明確提到：Start-Class定義的是實際的啟動類，此時的您應該對一切都瞭然於胸，產生本該如此的感慨；


本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】



※新北清潔公司,居家、辦公、裝潢細清專業服務



※別再煩惱如何寫文案,掌握八大原則!



※網頁設計一頭霧水該從何著手呢? 台北網頁設計公司幫您輕鬆架站!



※超省錢租車方案


Orignal From: springboot的jar為何能獨立運行

留言

張貼留言

這個網誌中的熱門文章

旅館疑有臭蟲 北市府稽查找嘸

有民眾抱怨，日前投宿的北市某旅館疑似出現臭蟲，北市觀傳局與衛生局、環保局聯合稽查，但因為沒有發現蟲屍，無法確認該旅館是否真有臭蟲，市府下周將召開專家會議處理該案，市長蔣萬安則允諾會以最高規格防範臭蟲。 北市某旅館傳出疑有臭蟲，議員陳宥丞23日在市政總質詢詢問市府處理進度，並指出法國、澳洲、韓國的臭蟲，起初都現蹤公車或地鐵卻沒被發現，直到大規模爆發，才付出大量社會成本處理，而且一般殺蟲劑無法殺掉臭蟲，北市是否有因應措施？ 觀傳局主任祕書蕭君杰表示，21日聯合環保局、衛生局到該旅館稽查，但沒有發現臭蟲，也沒有查到蟲卵跡象，只能檢查現場環境是否符合衛生相關規定，但環保局有指導業者如何針對臭蟲清潔消毒。觀傳局長王秋冬指出，下周會與專家學者召開會議，以最高規格處理此案。 想知道購買電動車哪裡補助最多? 台中電動車 補助資訊懶人包彙整 ；推薦評價好的 iphone維修 中心擁有專業的維修技術團隊，同時聘請資深iphone手機維修專家，現場說明手機問題，快速修理，沒修好不收錢住家的頂樓裝 太陽光電 聽說可發揮隔熱功效一線推薦東陽能源擁有核心技術、產品研發、系統規劃設置、專業團隊的太陽能發電廠商。 網頁設計 一頭霧水該從何著手呢? 回頭車 貨運收費標準宇安交通關係企業，自成立迄今，即秉持著「以誠待人」、「以實處事」的企業信念 台中搬家公司 教你幾個打包小技巧,輕鬆整理裝箱!還在煩惱搬家費用要多少哪？台中大展搬家線上試算搬家費用，從此不再擔心「物品怎麼計費」、「多少車才能裝完」 台中搬家 公司費用怎麼算?擁有20年純熟搬遷經驗，提供免費估價且流程透明更是5星評價的搬家公司好山好水 露營車 漫遊體驗露營車x公路旅行的十一個出遊特色。走到哪、玩到哪，彈性的出遊方案，行程跟出發地也可客製 廣告預算用在刀口上， 台北網頁設計 公司幫您達到更多曝光效益； 電動車補助 衛生局疾病管制科長張惠美表示，現場查到與臭蟲無關的多項衛生缺失，包含未提供從業人員體檢報告、簡易外傷藥品及器材超過有效期、紗窗有破損等，已要求業者2周內改善，將擇期複查，如果複查不合格，將依法裁罰3000元至2萬元罰鍰。 但陳宥丞批評，環保局未公告哪些藥劑能殺死臭蟲，很擔心北市會和韓國、法國一樣，把臭蟲防治交給民間恐造成大規模爆發，且北市內的廢棄傢俱回收廠也有可能成為臭蟲孳生的...
張貼留言
閱讀完整內容

必知必會-存儲器層次結構

相信大家一定都用過各種存儲技術，比如mysql，mongodb，redis，mq等，這些存儲服務性能有非常大的區別，其中之一就是底層使用的存儲設備不同。作為一個程序員，你需要理解存儲器的層次結構，這樣才能對程序的性能差別瞭然於心。今天帶大家了解下計算機系統存儲器的層次結構。 存儲技術 首先了解下什麼是存儲器系統？ 實質上就是一個具有不同容量、成本和訪問時間的存儲設備的層次結構。從快到慢依次為：CPU寄存器、高速緩存、主存、磁盤； 這裏給大家介紹一組數據，讓大家有一個更清晰的認識： 如果數據存儲在CPU寄存器，需要0個時鐘周期就能訪問到，存儲在高速緩存中需要4~75個時鐘周期。如果存儲在主存需要上百個周期，而如果存儲在磁盤上，大約需要幾千萬個周期！ -- 出自 CSAPP 接下來一起深入了解下計算機系統涉及的幾個存儲設備： 隨機訪問存儲器 隨機訪問存儲器（RAM）分為靜態RAM （SRAM） 和動態RAM（DRAM）。SRAM的速度更快，但也貴很多，一般不會超過幾兆字節，通常用來做告訴緩存存儲器。DRAM就是就是我們常說的主存。 訪問主存 數據流是通過操作系統中的總線的共享电子電路在處理器和DRAM之間來來回回。每次CPU和主存之間的數據傳送都是通過一系列複雜的步驟完成，這些步驟成為總線事務。讀事務是將主存傳送數據到CPU。寫事務從CPU傳送數據到主存。 總線是一組并行的導線，能攜帶地址、數據和控制信號。下圖展示了CPU芯片是如何與主存DRAM連接的。 那麼我們在加載數據和存儲數據時，CPU和主存到底是怎樣交互實現的呢？ 首先來看一個基本指令，加載內存數據到CPU寄存器中: movq A,%rax 將地址A的內容加載到寄存器%rax中，這個命令會使CPU芯片上稱為總線接口（bus interface）的電路在總線上發起讀事務，具體分為三個步驟： CPU將地址A放到系統總線上，I/O橋將信號傳遞到內存總線。詳情看下下圖a 主存感覺到內存總線上的地址信號，從內存總線讀地址，從DRAM取出數據字，將其寫到內存總線。I/O橋將內存總線信號翻譯成系統總線信號，沿着系統總線傳遞到CPU總線接口。下圖b CPU感覺到系統總線上的數據，從總線上讀數據，並將數據複製到寄存器%rax...
張貼留言
閱讀完整內容

2016年電動車和插電式混合動力車銷量預計將超過70萬輛

中汽協日前預測，2016年全國電動汽車和插電式混合動力車的銷量預計將超過70萬輛，較2015年的銷量增長一倍。 2015年電動車和插電式混合動力車的合併銷量為331092輛，較2014年增長了340%。其中包括247482輛電動車和83610輛插電式混合動力車，在24萬輛多的電動汽車銷量中，包括146719輛乘用車，另有100763輛為商用車。插電式混合動力車的銷量中，60663輛為乘用車，22947輛為商用車。 根據2015年起草的藍圖，政府計畫到2020年在全國範圍內新建12000個充電站和480枚充電樁。2014年年底，全國共有780個充電站共31000枚充電樁。2015年政府還為27個省市自治區設定了電動車的最低銷量目標。 政府預計，這些措施到位後，自主品牌車企的電動車和插電式混合動力車銷量到2020年可達100萬輛，到2025年可達300萬輛。 本站聲明:網站內容來源於EnergyTrend https://www.energytrend.com.tw/ev/,如有侵權,請聯繫我們,我們將及時處理 【其他文章推薦】 ※為什麼 USB CONNECTOR 是電子產業重要的元件? ※ 網頁設計 一頭霧水??該從何著手呢? 找到專業技術的 網頁設計公司 ，幫您輕鬆架站! ※想要讓你的商品成為最夯、最多人討論的話題? 網頁設計公司 讓你強力曝光 ※想知道最厲害的 台北網頁設計公司推薦 、 台中網頁設計公司推薦 專業設計師"嚨底家"!! Orignal From: 2016年電動車和插電式混合動力車銷量預計將超過70萬輛
張貼留言
閱讀完整內容