場(chǎng)景再現(xiàn)

某日少年收到前端同學(xué)發(fā)來的消息說聯(lián)調(diào)的接口響應(yīng)異常，少年表現(xiàn)的很平靜，因?yàn)檫@種事情太平常了。于是詢問詳情之后開始打開自己的代碼查找問題所在，沒過五分鐘就發(fā)現(xiàn)了問題。少年修改完代碼之后將本地啟動(dòng)的項(xiàng)目停止然后再重新啟動(dòng)。由于當(dāng)前的服務(wù)端項(xiàng)目是一個(gè)巨大的單體應(yīng)用，啟動(dòng)需要花三四分鐘時(shí)間，于是少年就拿出手機(jī)開始刷起朋友圈。刷著刷著（由于注意力分散不知不覺花了十幾分鐘）突然意識(shí)到項(xiàng)目已經(jīng)重新啟動(dòng)，于是通知前端同學(xué)查看效果。

分析問題

上面的場(chǎng)景可能對(duì)很多開發(fā)者來說感同身受，在開發(fā)中修改項(xiàng)目是很平常且頻繁的一件事情。當(dāng)我們修改完代碼或其他文件的時(shí)候，我們會(huì)重新啟動(dòng)項(xiàng)目來驗(yàn)證修改是否真的生效（這里忽略我們編寫的測(cè)試代碼），以供前端或者其他客戶端來使用我們的修改。但是不知不覺這樣的流程浪費(fèi)了我們很多時(shí)間，甚至被迫分散我們的注意力（打開社交軟件、看新聞、和同事聊天），這些問題對(duì)我們的生產(chǎn)力是一個(gè)極大的威脅。

spring-boot-devtools

能否有一種方案可以讓我們對(duì)項(xiàng)目的修改快速生效，從而節(jié)省那些我們本該可以利用的時(shí)間呢？幸好有一種工具可以解決當(dāng)前所存在的問題，這就是**Spring Boot Dev Tools**。

原理簡(jiǎn)介

您可能會(huì)說，了解Spring Boot Dev Tools的工作原理并不重要，但是由于開發(fā)過程中存在很多復(fù)雜的情況，所以了解Spring Boot Dev Tools的工作原理是對(duì)我們有幫助的。

Spring Boot Dev Tools鉤接（hooks into）到Spring Boot的類加載器中，以提供一種方法來按需重新啟動(dòng)應(yīng)用程序上下文或重新加載已更改的靜態(tài)文件而無需重新啟動(dòng)整個(gè)應(yīng)用程序。

為此，Spring Boot Dev Tools將劃分應(yīng)用程序的類路徑并分配給兩個(gè)不同的類加載器：

• 基本類加載器（base classloader）：包含一些不可變類或者幾乎不會(huì)被修改文件，例如Spring Boot JAR或第三方庫(kù)。
• 重新啟動(dòng)類加載器（restart classloader）：包含應(yīng)用程序的文件，這些文件在項(xiàng)目開發(fā)過程中將頻繁更改

重新啟動(dòng)應(yīng)用程序后，現(xiàn)有的重新啟動(dòng)類加載器將被丟棄，新的重新啟動(dòng)類加載器將被啟動(dòng)。這種方法意味著應(yīng)用程序的重啟通常比“冷啟動(dòng)”要快得多，因?yàn)榛绢惣虞d器沒有受到影響并且一直存在著。

引入依賴

當(dāng)我們使用intellij IDEA的Spring Initializr創(chuàng)建項(xiàng)目時(shí)，Spring Initializr提供了內(nèi)置的Spring Boot Dev Tools依賴選項(xiàng)，我們只需選擇它即可。

Spring Initializr中引入Spring Boot Dev Tools

Maven項(xiàng)目中引入Spring Boot Dev Tools

在項(xiàng)目的pom.xml文件中引入Spring Boot Dev Tools依賴即可

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-devtools</artifactId>
  <scope>runtime</scope>
  <optional>true</optional>
</dependency>

在項(xiàng)目中添加一個(gè)簡(jiǎn)單的Controller

@SpringBootApplication
public class DevToolApplication {
  public static void main(String[] args) {
    SpringApplication.run(DevToolApplication.class, args);
  }
  @RestController
  public static class HelloWorld {
    @GetMapping("test")
    public ResponseEntity<?> getTest() {
      return ResponseEntity.ok("hello world");
    }
  }
}

啟動(dòng)項(xiàng)目，訪問http://localhost:8080/test，返回如下：

我們簡(jiǎn)單修改代碼

@RestController
public static class HelloWorld {
  @GetMapping("test")
  public ResponseEntity<?> getTest() {
    return ResponseEntity.ok("hello world after change file");
  }
}

運(yùn)行命令mvn compile，運(yùn)行完畢重新訪問http://localhost:8080/test

可以看到，我們的更改已經(jīng)生效了。

多模塊

假設(shè)現(xiàn)在我們的項(xiàng)目引用了其他項(xiàng)目作為子模塊

<dependency>
  <groupId>org.example</groupId>
  <artifactId>untitled</artifactId>
  <version>1.0-SNAPSHOT</version>
</dependency>

我們需要在程序運(yùn)行時(shí)，對(duì)上述子模塊的修改也即時(shí)生效。

在多模塊項(xiàng)目中使用Spring Boot Dev Tools比單模塊項(xiàng)目略復(fù)雜，由于在多模塊項(xiàng)目中主模塊對(duì)子模塊是引用關(guān)系，并且在運(yùn)行時(shí)主模塊通過引用子模塊的jar文件的形式來啟動(dòng)應(yīng)用程序，根據(jù)前面Spring Boot Dev Tools的原理，jar文件的加載將歸屬于基本類加載器，因此按照現(xiàn)在的做法無法做到子模塊的修改即時(shí)生效。

不過Spring Boot Dev Tools提供了對(duì)多模塊項(xiàng)目的支持，我們只需要添加簡(jiǎn)單的配置即可實(shí)現(xiàn)多模塊項(xiàng)目的修改即時(shí)生效。

在項(xiàng)目的/resources中創(chuàng)建META-INF/spring-devtools.properties文件，并添加配置

restart.include.projectcommon=/untitled-1.0-SNAPSHOT.jar

上述配置表明重新啟動(dòng)類加載器在重新啟動(dòng)的時(shí)候，會(huì)加載最新的子模塊依賴，從而做到子模塊的修改即時(shí)生效。

現(xiàn)在子模塊中存在如下類

public class DemoA {
  private String name;
  public String getName() {
    return name;
  }
  public DemoA setName(String name) {
    this.name = name+"cgsj111";
    return this;
  }
}

主模塊中引用了上面的類

@RestController
public static class HelloWorld {
  @GetMapping("test")
  public ResponseEntity<?> getTest() {
    DemoA demo = new DemoA();
    demo.setName("demo name");
    return ResponseEntity.ok(demo);
  }
}

此時(shí)啟動(dòng)應(yīng)用程序，訪問http://localhost:8080/test

可以看到響應(yīng)正常返回，此時(shí)我們修改子模塊的代碼

public class DemoA {
  private String name;
  public String getName() {
    return name;
  }
  public DemoA setName(String name) {
    this.name = name+"cgsj111 After Change";
    return this;
  }
}

然后在主模塊中運(yùn)行命令 mvn compile，此時(shí)再次訪問接口

可以看到子模塊的修改已經(jīng)在主模塊中即時(shí)生效了。

遠(yuǎn)程調(diào)試

Spring Boot Dev Tools所展現(xiàn)的高效便捷之處不僅僅局限于本地調(diào)試，對(duì)于遠(yuǎn)程調(diào)試也有很好的支持。選擇性地啟用遠(yuǎn)程支持是因?yàn)閱⒂盟赡軙?huì)帶來安全風(fēng)險(xiǎn)。僅當(dāng)在受信任的網(wǎng)絡(luò)上運(yùn)行或使用SSL保護(hù)時(shí)，才應(yīng)啟用它。如果這兩個(gè)選項(xiàng)都不滿足，則不應(yīng)使用DevTools的遠(yuǎn)程支持。您永遠(yuǎn)不應(yīng)該在生產(chǎn)環(huán)境中啟用他。

啟用它需要確保構(gòu)建物中包含devtools，修改至如下配置：

<build>
  <plugins>
    <plugin>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-maven-plugin</artifactId>
      <configuration>
        <!--確保項(xiàng)目打包是將Devtools包含進(jìn)去-->
        <excludeDevtools>false</excludeDevtools>
      </configuration>
    </plugin>
  </plugins>
</build>

然后，您需要設(shè)置spring.devtools.remote.secret屬性。像任何重要的密碼或機(jī)密一樣，該值應(yīng)唯一且強(qiáng)壯，以免被猜測(cè)或強(qiáng)行使用，例如，在application.properties中設(shè)置：

spring.devtools.remote.secret=cgsj8377

遠(yuǎn)程devtools支持分為兩部分：接受連接的服務(wù)器端端點(diǎn)和在IDE中運(yùn)行的客戶端應(yīng)用程序。設(shè)置spring.devtools.remote.secret屬性后，將自動(dòng)啟用服務(wù)器組件，客戶端組件必須手動(dòng)啟動(dòng)。

調(diào)試演示

在項(xiàng)目文件夾中運(yùn)行命令 mvn package生成jar文件，將jar文件部署到服務(wù)器（在這里我們以本地運(yùn)行jar包的方式來模擬遠(yuǎn)程部署）。然后在IDE進(jìn)行如下配置（以Intellij IDEA為例）

如上圖我們添加了一個(gè)啟動(dòng)器，啟動(dòng)類為org.springframework.boot.devtools.RemoteSpringApplication，并且傳遞了一個(gè)程序參數(shù)來指定遠(yuǎn)程應(yīng)用程序的地址，此處筆者在本機(jī)上試驗(yàn)所以是一個(gè)本機(jī)的地址。

接下來我們啟動(dòng)我們剛剛創(chuàng)建的啟動(dòng)器

啟動(dòng)日志如下

修改代碼至如下

@RestController
public static class HelloWorld {
  @GetMapping("test")
  public ResponseEntity<?> getTest() {
    DemoA demo = new DemoA();
    demo.setName("remote test");
    return ResponseEntity.ok(demo);
  }
}

然后運(yùn)行命令mvn compile，可以看到我們的更改在運(yùn)行的程序中即時(shí)生效了

總結(jié)

在我們的日常的開發(fā)過程中總會(huì)存在各種各樣的“等待”，這些時(shí)刻很大程度上會(huì)影響開發(fā)者的效率和注意力。而Developer Tools的出現(xiàn)緩解了這個(gè)問題，他使應(yīng)用程序的調(diào)試更加的便捷高效。有一點(diǎn)要注意的是在讓我們的更改生效之前需要執(zhí)行mvn compile命令，從而使本地代碼能被編譯成程序可以理解的字節(jié)碼文件。

本文示例代碼：https://gitee.com/jeker8chen/dev-tool

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。