Hotswap 26.02

在 ChatGPT 中打开

一个热替换工具可以将编译后的类更改应用于运行中的应用程序，而无需重新启动。应用程序在更新之间保持其状态。该工具在webforJ构建插件配置中命名，并在构建启动应用程序时附加。运行命令保持不变，项目声明不需要依赖此工具。

支持两种工具：

• HotswapAgent 是开源的。构建插件在第一次运行时下载代理并进行缓存。
• JRebel 是一款商业产品。它需要您自己的安装和许可证。

仅配置一个。命名两个的构建会失败并显示错误。

HotswapAgent

一个空元素是完整的配置：

Maven

pom.xml

<plugin>
  <groupId>com.webforj</groupId>
  <artifactId>webforj-maven-plugin</artifactId>
  <extensions>true</extensions>
  <configuration>
    <hotswap>
      <hotswapAgent/>
    </hotswap>
  </configuration>
</plugin>

Gradle

build.gradle

webforj {
  hotswap {
    hotswapAgent {}
  }
}

两个选项细化附加：

选项	描述
version	用于指定代理版本，而不是插件选择的版本。
path	磁盘上的代理jar，直接使用，无需下载。适用于没有网络访问权限的机器或自定义代理构建。

Maven

pom.xml

<hotswap>
  <hotswapAgent>
    <path>/path/to/hotswap-agent.jar</path>
  </hotswapAgent>
</hotswap>

Gradle

build.gradle

webforj {
  hotswap {
    hotswapAgent {
      path = file('/path/to/hotswap-agent.jar')
    }
  }
}

类结构更改

方法体的编辑可以在任何Java虚拟机上应用。类结构的更改，如新字段或新方法，需要一个支持-XX:+AllowEnhancedClassRedefinition选项的虚拟机，该选项由JetBrains Runtime提供。构建检测此能力并启用它。有关安装JetBrains Runtime的详细信息，请参见先决条件。

如果没有此能力，方法体的编辑仍然会应用，但类结构更改在重新启动之前不会到达运行中的应用程序。构建日志会打印一个警告，说明该要求，浏览器会显示一次通知。

JRebel

JRebel 是一款商业产品，由其供应商授权。webforJ不提供它，不下载它，并且不参与其许可。构建读取配置的路径，检查文件是否存在，并保持不变地附加它。

将配置指向您JRebel安装中的代理，一个本地库或一个jar：

Maven

pom.xml

<hotswap>
  <jrebel>
    <path>/path/to/libjrebel64.dylib</path>
  </jrebel>
</hotswap>

Gradle

build.gradle

webforj {
  hotswap {
    jrebel {
      path = file('/path/to/libjrebel64.dylib')
    }
  }
}

路径是必需的。选择没有路径的JRebel的构建会因缺少设置而失败。

使用JRebel，所有类更改，包括结构更改，都可以在任何Java运行时上应用。

命令行选择

webforj.hotswap属性会覆盖构建文件，以便进行单次运行。接受的值为hotswapAgent，jrebel和off。任何其他值都会导致构建失败，并列出有效的值。选择jrebel仍然需要在配置中指定代理路径。

Maven

mvn -Dwebforj.hotswap=off
mvn -Dwebforj.hotswap=hotswapAgent

Gradle

./gradlew bootRun -Pwebforj.hotswap=off
./gradlew bootRun -Pwebforj.hotswap=hotswapAgent

应用更改

编译更改并使其达到运行中的应用程序。使用会在保存时编译的IDE进行保存，或在第二个终端中运行编译。

当每个更改的类属于当前页面呈现的内容时，受影响的部分会就地重建，应用程序状态保持不变。否则，页面会全重新加载：对于没有路由的应用程序，对于呈现路由之外的类，或当重建无法进行时。一个已编译的更改会在浏览器中产生一个更新。