跳至主要内容

Spring DevTools

在 ChatGPT 中打开

Spring DevTools 提供代码更改时自动重启应用程序的功能。webforJ DevTools 添加了自动浏览器刷新 - 当 Spring 重启您的应用程序时，浏览器通过 webforJ 的 LiveReload 服务器自动刷新。

不同的文件类型会触发不同的重载行为。Java 代码更改会导致全量 Spring 重启和浏览器刷新。CSS 和图像更改在不重新加载页面的情况下更新，保留表单数据和应用状态。

理解 webforJ DevTools​

webforJ 扩展了 Spring DevTools，提供浏览器同步功能。当 Spring 检测到文件更改并重启时，webforJ DevTools 会自动刷新您的浏览器。

重载行为​

不同的文件类型触发不同的重载策略：

  • Java 文件：Spring 重启后全量浏览器网页重载
  • JavaScript 文件：Spring 重启后全量浏览器网页重载
  • CSS 文件：样式更新无需重新加载页面
  • 图像：就地刷新，无需重新加载页面

依赖项​

将 Spring DevTools 和 webforJ DevTools 添加到您的项目中：

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

<dependency>
    <groupId>com.webforj</groupId>
    <artifactId>webforj-spring-devtools</artifactId>
    <version>${webforj.version}</version>
    <optional>true</optional>
</dependency>

配置​

在您的 application.properties 文件中启用 webforJ DevTools：

application.properties
# 启用 webforJ 浏览器自动重载
webforj.devtools.livereload.enabled=true

# 启用即时关闭以加快重启速度
server.shutdown=immediate

高级配置​

配置 WebSocket 连接和重载行为：

application.properties
# WebSocket 服务器端口（默认：35730）
webforj.devtools.livereload.websocket-port=35730

# WebSocket 端点路径（默认：/webforj-devtools-ws）
webforj.devtools.livereload.websocket-path=/webforj-devtools-ws

# 心跳间隔（毫秒）（默认：30000）
webforj.devtools.livereload.heartbeat-interval=30000

# 启用静态资源的热重载（默认：true）
webforj.devtools.livereload.static-resources-enabled=true

25.03 配置应用启动时浏览器打开的选项：

application.properties
# 启用浏览器打开（默认：false）
webforj.devtools.browser.open=true

# localhost、主机名或 IP 地址（默认：localhost）
webforj.devtools.browser.host=localhost