Class IsoClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

cloud.opencode.base.classloader.loader.IsoClassLoader

All Implemented Interfaces:

Closeable, AutoCloseable

public class IsoClassLoader
extends URLClassLoader
implements AutoCloseable

Isolated ClassLoader - Supports independent class loading environment 隔离类加载器 - 支持独立的类加载环境

ClassLoader that supports class isolation for plugin systems and hot deployment.

支持类隔离的类加载器，用于插件系统和热部署。

Features | 主要功能:

• Isolated class loading - 隔离类加载
• Configurable loading strategy - 可配置的加载策略
• Package-level isolation control - 包级别隔离控制
• Resource access - 资源访问

Usage Examples | 使用示例:

IsoClassLoader loader = IsoClassLoader.fromJar("/path/to/plugin.jar")
    .addIsolatedPackage("com.plugin")
    .build();
Class<?> pluginClass = loader.loadClass("com.plugin.MyPlugin");
loader.close();

Security | 安全性:

• Thread-safe: Yes - 线程安全: 是
• Null-safe: Yes - 空值安全: 是

Since:

JDK 25, opencode-base-classloader V1.0.0

Author:

Leon Soo www.LeonSoo.com

See Also:

• OpenCode.cloud

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	IsoClassLoader.Builder	Builder for IsoClassLoader IsoClassLoader 构建器
static enum	IsoClassLoader.LoadingStrategy	Class loading strategy 类加载策略

Method Summary

Modifier and Type	Method	Description
boolean	canLoad(String className)	Check if class can be loaded 检查类是否可加载
void	close()
static IsoClassLoader.Builder	fromDirectory(Path directory)	Create builder from directory 从目录创建构建器
static IsoClassLoader.Builder	fromJar(String jarPath)	Create builder from JAR file path string 从 JAR 文件路径字符串创建构建器
static IsoClassLoader.Builder	fromJar(Path jarPath)	Create builder from JAR file path 从 JAR 文件路径创建构建器
static IsoClassLoader.Builder	fromUrls(URL... urls)	Create builder from URLs 从 URL 创建构建器
Set<String>	getLoadedClassNames()	Get loaded class names 获取已加载的类名
URL	getResource(String name)
InputStream	getResourceAsStream(String name)
Enumeration<URL>	getResources(String name)
boolean	isClosed()	Check if classloader is closed 检查类加载器是否已关闭
Class<?>	loadClass(String name)
protected Class<?>	loadClass(String name, boolean resolve)
Class<?>	loadClassLocally(String name)	Force load class locally (from this classloader) 强制从本加载器加载类

Methods inherited from class URLClassLoader

addURL, definePackage, findClass, findResource, findResources, getPermissions, getURLs, newInstance, newInstance

Methods inherited from class SecureClassLoader

defineClass, defineClass

Methods inherited from class ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLibrary, findLoadedClass, findResource, findSystemClass, getClassLoadingLock, getDefinedPackage, getDefinedPackages, getName, getPackage, getPackages, getParent, getPlatformClassLoader, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, getUnnamedModule, isRegisteredAsParallelCapable, registerAsParallelCapable, resolveClass, resources, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

fromJar

public static IsoClassLoader.Builder fromJar(String jarPath)

Create builder from JAR file path string 从 JAR 文件路径字符串创建构建器

Parameters:

jarPath - JAR file path | JAR 文件路径

Returns:

builder | 构建器

fromJar

public static IsoClassLoader.Builder fromJar(Path jarPath)

Create builder from JAR file path 从 JAR 文件路径创建构建器

Parameters:

jarPath - JAR file path | JAR 文件路径

Returns:

builder | 构建器

fromDirectory

public static IsoClassLoader.Builder fromDirectory(Path directory)

Create builder from directory 从目录创建构建器

Parameters:

directory - directory path | 目录路径

Returns:

builder | 构建器

fromUrls

public static IsoClassLoader.Builder fromUrls(URL... urls)

Create builder from URLs 从 URL 创建构建器

Parameters:

urls - URLs | URL 数组

Returns:

builder | 构建器

loadClass

public Class<?> loadClass(String name)
                   throws ClassNotFoundException

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException

loadClass

protected Class<?> loadClass(String name,
 boolean resolve)
                      throws ClassNotFoundException

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException

loadClassLocally

public Class<?> loadClassLocally(String name)
                          throws ClassNotFoundException

Force load class locally (from this classloader) 强制从本加载器加载类

Parameters:

name - class name | 类名

Returns:

loaded class | 加载的类

Throws:

ClassNotFoundException - if class not found | 类未找到时抛出

canLoad

public boolean canLoad(String className)

Check if class can be loaded 检查类是否可加载

Parameters:

className - class name | 类名

Returns:

true if can load | 可加载返回 true

getResource

public URL getResource(String name)

Overrides:

getResource in class ClassLoader

getResources

public Enumeration<URL> getResources(String name)
                              throws IOException

Overrides:

getResources in class ClassLoader

Throws:

IOException

getResourceAsStream

public InputStream getResourceAsStream(String name)

Overrides:

getResourceAsStream in class URLClassLoader

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Overrides:

close in class URLClassLoader

isClosed

public boolean isClosed()

Check if classloader is closed 检查类加载器是否已关闭

Returns:

true if closed | 已关闭返回 true

getLoadedClassNames

public Set<String> getLoadedClassNames()

Get loaded class names 获取已加载的类名

Returns:

set of loaded class names | 已加载的类名集合