Fakereplace 类重载器技术文档

1. 安装指南

Fakereplace 是一个用于在 JVM 中热替换类的工具，它通过字节码技术来增强 JDK 的默认热交换功能。以下是安装步骤：

• 下载最新版本的 Fakereplace，可以从 Maven 中央仓库 获取。
• 若要自行构建，运行以下命令：

  mvn package --settings=.settings.xml
  

  然后在 dist/target 目录中使用构建的 shaded jar 文件。注意，只有当你的个人设置文件中没有 JBoss Nexus 仓库时，才需要使用自定义设置文件。

2. 项目使用说明

Fakereplace 提供了一个 jar 文件 fakereplace.jar，使用时需要在 JVM 启动参数中指定 -javaagent 选项指向该 jar 文件。

在 Wildfly 中的使用：

编辑 standalone.conf 文件，并在 JAVA_OPTS 中添加以下内容：

-javaagent:/path/to/fakereplace.jar

在其他容器中的使用：

在 JVM 启动参数中添加以下内容：

-javaagent:/path/to/fakereplace.jar=packages=com.mycompany.myclasses

其中 com.mycompany.myclasses 是你想要热替换的类的顶级包。此包及其子包中的所有类都会被修改以允许替换。如果使用 Wildfly，此步骤不是必需的。

修改应用程序的启动脚本或在 IDE 中设置 VM 参数，以设置 JVM 选项。

启动应用程序并使用调试器附加。

3. 项目 API 使用文档

Fakereplace 的 API 使用主要涉及启动时的 JVM 参数设置。以下是一些支持的选项：

• packages：指定可以热替换的包（使用 ; 分隔多个包）。
• log：支持的选项有 trace、debug、info、error。
• index-file：指定 Fakereplace 索引文件的路径。
• dump-dir：在热替换时将类转储到此目录，仅对开发 Fakereplace 的开发者有用。
• remote：如果存在，Fakereplace 将启动其服务器，也可以指定端口号，例如 remote=6222。
• no-index=true：告诉 Fakereplace 不要使用索引文件以加快后续启动。

4. 项目安装方式

安装方式已在“安装指南”部分详细说明，主要包括从 Maven 中央仓库下载或自行构建。

---

在遇到问题时，可以在 Fakereplace 的 GitHub issues 页面报告。有关其工作原理的详细信息，请参考 Fakereplace 的 GitHub wiki。