Spring Boot DevTools使用教程

Posted 2022-11-01 阿征new

springboot - devtools

• • • • • 参考：
        • 引入
        • 自动重启
        • 在IDE中触发重新启动
        • 仅限开发
        • Live Reload
        • ------

参考：

SpringBoot热部署实现（devtools）

Spring Boot DevTools使用教程

引入

DevTools通过提供自动重启和LiveReload功能，使您更快、更轻松地开发Spring Boot应用程序。除此之外，它还将各种属性设置为更适合本地开发的值。此外，它允许您远程连接到您的应用程序，并仍然使用其大部分功能。在生产中运行时，不要使用DevTools。
如何使用DevTools进一步加快Spring Boot开发速度？你需要做的就是添加正确的依赖关系，与Spring Boot一样，设置非常简单。
如果您使用Maven：

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

自动重启

每当类路径中的文件发生更改时，DevTools会自动重新启动正在运行的应用程序，并应用新的更改。在本地开发时，这可能很有价值，因为您不需要手动重新部署应用程序。
重启仍然需要花费很多时间，你可能认为它不会那么有用，。幸运的是，这些重启比常规重启更快，因为DevTools使用了一个聪明的技巧。
在开发应用程序时，您通常会更改一个或多个类，并希望检查正在运行的应用程序中的结果以获得反馈。您更改应用程序的一小部分，因为大多数加载的类来自框架和第三方库。
，Spring DevTools使用两个类加载器 - base和restart。base类加载器加载不更改的类。你正在使用的类由restart类加载器加载。每当触发重启时，都会重新启动并重新创建restart的类加载器。这样重新启动应用程序的速度比平常快得多，并且可以使用JRebel等工具作为动态类重新加载的替代方法。

在IDE中触发重新启动

需要设置idea

1. 全局搜索 mac : double shift
2. 选择registry…
3. 勾选compile-auto…
4. 修改代码后 command+F9 重新编译后，springboot 自动重启应用
   

只要类路径发生更改，就会触发重新启动。但是，这取决于您的IDE。这意味着，仅仅更改.java文件是不够的。重要的是您的IDE实际上更新.class了类路径上的文件。
使用IntelliJ IDEA时，您需要构建项目（Ctrl + F9或Build→Build Project）。您还可以将IDEA配置为自动重建。或者，需要打开Spring Boot运行配置并定义触发应用程序更新时发生的情况，Alt + Shift + F10 或F9 进行运行配置，选择编辑配置：
在On Update action中选择Update trigger file，在调用Update操作时触发DevTools的Restart；甚至可以选择尝试热插拔的选项，并仅在热插拔失败时使用DevTools重新启动。
在On frame deactivation中选择Update classes and resources。在IDEA窗口失去焦点时重新加载所有静态资源和模板（例如，切换到浏览器窗口时）。
确认后，修改源码，切换到浏览器，刷新浏览器，可以看到更新后的结果，如果还不行按（Ctrl + F10）强行更新重启。

仅限开发

Spring Boot DevTools的用法仅用于开发，而不用于生产。如果您的应用程序检测到您正在生产中运行，则会自动禁用DevTools。

部署时有两种模式：fully packaged artifact完全打包和exploded artifact ；采取前者打包方式Spring会认为是生产应用；后者认为是开发模式，在Idea等IDE中采取的是后者。

Live Reload

LiveReload（http://livereload.com/）是一个有用的工具，它允许您在文件中进行更改时立即在浏览器中更新页面，如html，CSS，图像等。它甚至可以根据需要预处理文件 - 这意味着自动编译SASS或LESS文件。
Spring DevTools自动启动LiveReload服务器的本地实例，该服务器监视您的文件。您需要做的就是安装一个浏览器扩展，然后你就可以了。它不仅可用于开发应用程序的前端（如果将其作为Spring应用程序工件的一部分进行分发），还可用于监视和重新加载REST API的输出。

------

属性覆盖
在本地开发应用程序时，与在生产环境相比通常需要不同的配置。自己管理多组配置是不必要的复杂。好消息是Spring Boot DevTools为您的本地开发配置了许多开箱即用的属性。
spring.thymeleaf.cache=false
spring.freemarker.cache=false
spring.groovy.template.cache=false
spring.mustache.cache=false
server.servlet.session.persistent=true
spring.h2.console.enabled=true
spring.resources.cache.period=0
spring.resources.chain.cache=false
spring.template.provider.cache=false
spring.mvc.log-resolved-exception=true
server.servlet.jsp.init-parameters.development=true
spring.reactor.stacktrace-mode.enabled=true
可以检查DevToolsPropertyDefaultsPostProcessor中所有属性的列表。

远程连接
除本地开发外，您还可以连接到运行DevTools的远程应用程序。这不适用于生产环境，因为它可能是一个严重的安全风险。但是，它在预生产环境中非常有用。
默认情况下不启用远程连接。您需要通过修改pom文件显式启用它：



org.springframework.boot
spring-boot-maven-plugin

false




然后，您需要设置一个密码，以便在连接到远程应用程序时用于身份验证：

spring.devtools.remote.secret=somesecret
远程应用程序运行后，您可以启动远程连接会话，现在，您需要启动org.springframework.boot.devtools.RemoteSpringApplication，使用远程应用程序的URL作为参数启动。请注意，https如果可能，请使用https。
在IDE中轻松运行远程连接。在IDEA中，您只需创建一个新的运行配置。转到Run → Edit Configurations…并创建一个+左上角带有图标的新配置。选择Application类型。
全局配置
可以像使用任何其他Spring应用程序一样使用配置属性配置DevTools。这通常意味着编辑application.properties您的项目。此配置对于每个应用程序是独立的。
但是，在某些情况下，为同一台计算机上运行的所有应用程序进行全局配置可能很方便。您可以创建一个名为.spring-boot-devtools.properties位于$HOME目录中的属性文件。此文件中声明的配置将应用于运行DevTools的所有应用程序。

限制
使用DevTools的Spring应用程序会自动启动LiveReload服务器。不幸的是，此服务器中只有一个实例可以同时运行。更确切地说，只有第一个可行。这不仅适用于使用DevTools的Spring应用程序的多个实例，也适用于任何其他应用程序，这些应用程序也在后台使用LiverReload，例如Gatsby在开发模式下。
如果要将Spring应用程序配置为不启动LiveReload服务器，可以在application.properties加入：
spring.devtools.livereload.enabled=false
关机钩ShutdownHook
DevTools依赖于关机挂钩的SpringApplication。如果您使用以下方法手动禁用挂钩，它将无法正常工作：
springApplication.setRegisterShutdownHook(false);
认情况下，挂钩已启用，因此除非您明确禁用它，否则无需担心它。

与第三方库的冲突
DevTools通常应该正常运行，但它可能与第三方库有冲突。特别是，已知问题是使用标准ObjectInputStream进行反序列化存在存在冲突。如果发生此类冲突，您可以通过设置禁用自动重启：
spring.devtools.restart.enabled=false
将不再触发重启。但是，仍将使用重新启动类加载器。如果您需要完全禁用类加载器，则需要在启动应用程序之前执行此操作：

public static void main(String args)
System.setProperty(“spring.devtools.restart.enabled”, “false”);
SpringApplication.run(MyApp.class, args);

即使您不使用自动重启，您仍然可以从DevTools提供的其他功能中受益。