springboot开发人员工具(自动重启及相关的配置)

导入依赖:

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

Developer tools are automatically disabled when running a fully packaged application. If your application is launched from java -jar or if it is started from a special classloader, then it is considered a “production application”. If that does not apply to you (i.e. if you run your application from a container), consider excluding devtools or set the -Dspring.devtools.restart.enabled=false system property.(运行完全打包的应用程序时,将自动禁用开发人员工具。 如果您的应用程序是从java -jar启动的,或者是从特殊的类加载器启动的,则将其视为“生产应用程序”。 如果这不适用于您(即,如果您从容器中运行应用程序),请考虑排除devtools或设置-Dspring.devtools.restart.enabled = false系统属性。

1.属性默认值

Spring Boot支持的一些库使用缓存来提高性能。例如,模板引擎缓存已编译的模板,以避免重复解析模板文件。另外,Spring MVC可以在提供静态资源时向响应添加HTTP缓存头。

尽管缓存在生产中非常有益,但在开发过程中可能适得其反,从而使您无法看到刚刚在应用程序中所做的更改。因此,默认情况下,spring-boot-devtools禁用缓存选项。

缓存选项通常由application.properties文件中的设置配置例如,Thymeleaf提供了该spring.thymeleaf.cache属性。

spring.thymeleaf.cache=false;

由于在开发Spring MVC和Spring WebFlux应用程序时需要有关Web请求的更多信息,因此开发人员工具将启用DEBUG日志web记录组日志记录。这将为您提供有关传入请求,正在处理的处理程序,响应结果等的信息。如果您希望记录所有请求的详细信息(包括潜在的敏感信息),则可以打开spring.http.log-request-details配置属性。

spring.http.log-request-details=true;

如果你不想被应用属性默认可以设置spring.devtools.add-propertiesfalseapplication.properties

2.自动重启

spring-boot-devtools只要类路径上的文件发生更改,使用的应用程序就会自动重新启动。在IDE中工作时,这可能是一个有用的功能,因为它为代码更改提供了非常快速的反馈循环。默认情况下,将监视类路径上指向文件夹的任何条目的更改。请注意,某些资源(例如静态资产和视图模板)不需要重新启动应用程序

注:

1.DevTools依靠应用程序上下文的关闭挂钩在重新启动期间将其关闭。如果您禁用了关机挂钩(SpringApplication.setRegisterShutdownHook(false)),它将无法正常工作。

2.当决定是否在类路径中的条目应该触发重新启动时,它的变化,DevTools自动忽略命名的项目spring-bootspring-boot-devtoolsspring-boot-autoconfigurespring-boot-actuator,和spring-boot-starter.

3.DevTools需求来定制ResourceLoader使用的ApplicationContext如果您的应用程序已经提供了,它将被包装。不支持直接覆盖getResource方法ApplicationContext.

2.1重新启动与重新加载

Spring Boot提供的重启技术通过使用两个类加载器来工作。不变的类(例如,来自第三方jar的类)将被加载到类加载器中。您正在积极开发的类将加载到重新启动类加载器中。重新启动应用程序时,将丢弃重新启动类加载器,并创建一个新的类加载器。这种方法意味着应用程序的重启通常比“冷启动”要快得多,因为基本类加载器已经可用并已填充。

如果发现重新启动对于您的应用程序来说不够快,或者遇到类加载问题,则可以考虑从ZeroTurnaround 重新加载技术,例如JRebel这些方法通过在加载类时重写类来使其更易于重新加载。

2.2记录条件评估中的更改

默认情况下,每次应用程序重新启动时,都会记录一个报告,其中显示了条件评估增量。该报告显示了在进行更改(例如添加或删除Bean以及设置配置属性)时对应用程序自动配置的更改。

要禁用报告的日志记录,请设置以下属性:

spring.devtools.restart.log-condition-evaluation-delta = false

2.3排除资源

某些资源在更改时不一定需要触发重新启动。例如,Thymeleaf模板可以就地编辑。默认情况下,改变资源/META-INF/maven/META-INF/resources/resources/static/public,或/templates不触发重新启动,但确会触发现场重装如果要自定义这些排除项,则可以使用该spring.devtools.restart.exclude属性。例如,仅排除/static/public您将设置以下属性:

spring.devtools.restart.exclude =static/ **,public/ **
注:如果要保留这些默认值并添加其他排除项,请改用spring.devtools.restart.additional-exclude属性。

2.4监视其它路径

 使用该spring.devtools.restart.additional-paths属性配置其他路径以监视更改。您可以使用前面描述spring.devtools.restart.exclude属性来控制其他路径下的更改是触发完全重新启动还是实时重新加载

2.5禁用重启

如果您不想使用重新启动功能,则可以使用该spring.devtools.restart.enabled属性将其禁用在大多数情况下,您可以在自己的属性中设置此属性application.properties(这样做仍会初始化重新启动类加载器,但它不会监视文件更改)。

如果您需要完全禁用重启支持(例如,因为它不适用于特定的库),则需要在调用之前spring.devtools.restart.enabled System属性设置为,如以下示例所示:falseSpringApplication.run(…​)

public static void main(String[] args) {
    System.setProperty("spring.devtools.restart.enabled", "false");
    SpringApplication.run(MyApp.class, args);
}

2.6使用触发文件

如果使用持续编译更改文件的IDE,则可能更喜欢仅在特定时间触发重新启动。为此,您可以使用“触发文件”,这是一个特殊文件,当您要实际触发重新启动检查时必须对其进行修改。

  对文件的任何更新都将触发检查,但是只有在Devtools检测到有事情要做的情况下,重启才真正发生。

要使用触发文件,请将spring.devtools.restart.trigger-file属性设置为触发文件的名称(不包括任何路径)。触发文件必须出现在类路径上的某个位置。

例如,如果您的项目具有以下结构:

src
+-main
   +-resources
      +-.reloadtrigger

那么您的trigger-file财产将是:

spring.devtools.restart.trigger-file=.reloadtrigger

现在,仅在src/main/resources/.reloadtrigger更新时才会重新启动

  您可能希望将其设置spring.devtools.restart.trigger-file全局设置,以便所有项目以相同的方式运行。

2.7自定义重启类加载器

默认情况下,IDE中任何打开的项目都使用“重新启动”类加载器加载,而任何常规.jar文件都使用“基本”类加载器加载。如果您在多模块项目上工作,并且并非每个模块都导入到IDE中,则可能需要自定义内容。为此,您可以创建一个META-INF/spring-devtools.properties文件。

spring-devtools.properties文件可以包含以restart.exclude为前缀的属性restart.includeinclude元素是应该被拉高到“重启”的类加载器的项目,以及exclude要素是应该向下推入“基地”类加载器的项目。该属性的值是应用于类路径的正则表达式模式,如以下示例所示:

restart.exclude.companycommonlibs=/mycorp-common-[\w\d-.]+.jar
restart.include.projectcommon=/mycorp-myproj-[\w\d-.]+.jar
  所有属性键都必须是唯一的。只要属性以restart.include.开始,restart.exclude.就可以考虑。
  所有META-INF/spring-devtools.properties从类路径加载。您可以将文件打包到项目内部,也可以打包到项目使用的库中。

2.8局限性

重新启动功能不适用于通过使用标准反序列化的对象ObjectInputStream如果你需要反序列化的数据,你可能需要使用Spring的ConfigurableObjectInputStream结合Thread.currentThread().getContextClassLoader()。

不幸的是,一些第三方库在不考虑上下文类加载器的情况下反序列化。如果发现这样的问题,则需要向原始作者请求修复。

3.LiveReload

spring-boot-devtools模块包括一个嵌入式LiveReload服务器,该服务器可用于在更改资源时触发浏览器刷新。可从livereload.com免费获得适用于Chrome,Firefox和Safari的LiveReload浏览器扩展

如果您不想在应用程序运行时启动LiveReload服务器,则可以将spring.devtools.livereload.enabled属性设置false

注:一次只能运行一台LiveReload服务器。在启动应用程序之前,请确保没有其他LiveReload服务器正在运行。如果从IDE启动多个应用程序,则只有第一个具有LiveReload支持。
4.全局设置

可以通过将以下任何文件添加到$HOME/.config/spring-boot文件夹来配置全局devtools设置

  1. spring-boot-devtools.properties

  2. spring-boot-devtools.yaml

  3. spring-boot-devtools.yml

添加到这些文件的任何属性都将应用于使用devtools的计算机上的所有 Spring Boot应用程序。例如,要将重新启动配置为始终使用触发文件,应添加以下属性:

〜/ .config / spring-boot / spring-boot-devtools.properties
spring.devtools.restart.trigger-file=.reloadtrigger
注:如果在中找不到devtools配置文件$HOME/.config/spring-boot,则在$HOME文件夹的根目录中搜索是否存在.spring-boot-devtools.properties文件。这使您可以与不支持该$HOME/.config/spring-boot位置的旧版Spring Boot上的应用程序共享devtools全局配置
  在上述文件中激活的配置文件不会影响特定于配置文件的配置文件的加载。
 
原文地址:https://www.cnblogs.com/muxi0407/p/12054235.html