Class HotSwapClassLoader

java.lang.Object
java.lang.ClassLoader
cloud.opencode.base.classloader.loader.HotSwapClassLoader
All Implemented Interfaces:
AutoCloseable
public class HotSwapClassLoader extends ClassLoader implements AutoCloseable
HotSwap ClassLoader - Supports dynamic class replacement 热替换类加载器 - 支持类的动态替换

ClassLoader that supports hot swapping of classes at runtime.

支持运行时热替换类的类加载器。

Features | 主要功能:

  • Load classes from bytecode - 从字节码加载类
  • Reload modified classes - 重新加载修改的类
  • Version tracking - 版本跟踪
  • Class unloading - 类卸载
  • Version rollback - 版本回退
  • Hot-swap event notification - 热替换事件通知

Usage Examples | 使用示例:

HotSwapClassLoader loader = HotSwapClassLoader.create();
loader.addListener((name, oldV, newV) ->
    System.out.println(name + ": v" + oldV + " -> v" + newV));
Class<?> v1 = loader.loadClass("MyClass", bytecodeV1);
// After modification
Class<?> v2 = loader.loadClass("MyClass", bytecodeV2);
// Rollback to v1
Optional<Class<?>> rolled = loader.rollback("MyClass");

Security | 安全性:

  • Thread-safe: Yes - 线程安全: 是
  • Null-safe: Yes - 空值安全: 是
Since:
JDK 25, opencode-base-classloader V1.0.0
Author:
Leon Soo www.LeonSoo.com
See Also:

  • Constructor Details

    • HotSwapClassLoader

      public HotSwapClassLoader()
      Create HotSwap classloader with default parent 使用默认父加载器创建热替换类加载器

    • HotSwapClassLoader

      public HotSwapClassLoader(ClassLoader parent)
      Create HotSwap classloader with specified parent 使用指定父加载器创建热替换类加载器
      Parameters:
      parent - parent classloader | 父类加载器

    • HotSwapClassLoader

      public HotSwapClassLoader(ClassLoader parent, int maxHistoryVersions)
      Create HotSwap classloader with specified parent and max history versions 使用指定父加载器和最大历史版本数创建热替换类加载器
      Parameters:
      parent - parent classloader | 父类加载器
      maxHistoryVersions - max history versions to keep | 保留的最大历史版本数

  • Method Details

    • create

      public static HotSwapClassLoader create()
      Create HotSwap classloader with default parent 使用默认父加载器创建热替换类加载器
      Returns:
      new HotSwapClassLoader | 新的热替换类加载器

    • create

      public static HotSwapClassLoader create(ClassLoader parent)
      Create HotSwap classloader with specified parent 使用指定父加载器创建热替换类加载器
      Parameters:
      parent - parent classloader | 父类加载器
      Returns:
      new HotSwapClassLoader | 新的热替换类加载器

    • create

      public static HotSwapClassLoader create(int maxHistoryVersions)
      Create HotSwap classloader with default parent and specified max history versions 使用默认父加载器和指定最大历史版本数创建热替换类加载器
      Parameters:
      maxHistoryVersions - max history versions to keep | 保留的最大历史版本数
      Returns:
      new HotSwapClassLoader | 新的热替换类加载器

    • create

      public static HotSwapClassLoader create(ClassLoader parent, int maxHistoryVersions)
      Create HotSwap classloader with specified parent and max history versions 使用指定父加载器和最大历史版本数创建热替换类加载器
      Parameters:
      parent - parent classloader | 父类加载器
      maxHistoryVersions - max history versions to keep | 保留的最大历史版本数
      Returns:
      new HotSwapClassLoader | 新的热替换类加载器

    • loadClass

      public Class<?> loadClass(String name, byte[] bytecode)
      Load or reload class from bytecode 从字节码加载或重新加载类
      Parameters:
      name - class name | 类名
      bytecode - class bytecode | 类字节码
      Returns:
      loaded class | 加载的类

    • reloadClass

      public Class<?> reloadClass(String name, Path classFile)
      Reload class from file 从文件重新加载类
      Parameters:
      name - class name | 类名
      classFile - class file path | 类文件路径
      Returns:
      reloaded class | 重新加载的类

    • loadClass

      public Class<?> loadClass(String name) throws ClassNotFoundException
      Overrides:
      loadClass in class ClassLoader
      Throws:
      ClassNotFoundException

    • findClass

      protected Class<?> findClass(String name) throws ClassNotFoundException
      Overrides:
      findClass in class ClassLoader
      Throws:
      ClassNotFoundException

    • getVersion

      public int getVersion(String className)
      Get current version of class 获取类的当前版本
      Parameters:
      className - class name | 类名
      Returns:
      version number or 0 if not loaded | 版本号，未加载返回 0

    • getLoadedClassNames

      public Set<String> getLoadedClassNames()
      Get all loaded class names 获取所有已加载的类名
      Returns:
      set of class names | 类名集合

    • isLoaded

      public boolean isLoaded(String className)
      Check if class is loaded 检查类是否已加载
      Parameters:
      className - class name | 类名
      Returns:
      true if loaded | 已加载返回 true

    • getBytecode

      public Optional<byte[]> getBytecode(String className)
      Get bytecode of loaded class 获取已加载类的字节码
      Parameters:
      className - class name | 类名
      Returns:
      optional bytecode | 可选的字节码

    • rollback

      public Optional<Class<?>> rollback(String className)
      Rollback to previous version of a class 回退到类的上一个版本
      Parameters:
      className - class name | 类名
      Returns:
      the previous version class, or empty if no history | 上一个版本的类，无历史返回 empty

    • getHistoryCount

      public int getHistoryCount(String className)
      Get version history count for a class 获取类的历史版本数量
      Parameters:
      className - class name | 类名
      Returns:
      history count | 历史版本数量

    • addListener

      public void addListener(HotSwapListener listener)
      Add hot-swap event listener 添加热替换事件监听器
      Parameters:
      listener - listener to add | 要添加的监听器

    • removeListener

      public void removeListener(HotSwapListener listener)
      Remove hot-swap event listener 移除热替换事件监听器
      Parameters:
      listener - listener to remove | 要移除的监听器

    • getMaxHistoryVersions

      public int getMaxHistoryVersions()
      Get max history versions setting 获取最大历史版本设置
      Returns:
      max history versions | 最大历史版本数

    • unloadClass

      public void unloadClass(String className)
      Unload class (will be reloaded on next access) 卸载类（下次访问时重新加载）
      Parameters:
      className - class name | 类名

    • clear

      public void clear()
      Clear all loaded classes 清除所有已加载的类

    • close

      public void close()
      Specified by:
      close in interface AutoCloseable

    • isClosed

      public boolean isClosed()
      Check if classloader is closed 检查类加载器是否已关闭
      Returns:
      true if closed | 已关闭返回 true