Class PluginClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

com.hypixel.hytale.server.core.plugin.PluginClassLoader

All Implemented Interfaces:

Closeable, AutoCloseable

public class PluginClassLoader
extends URLClassLoader

A class loader used to load plugin classes from JavaPlugin instances

Constructor Summary

Constructors

Constructor	Description
PluginClassLoader(PluginManager pluginManager, PluginIdentifier identifier, boolean inServerClassPath, boolean childFirst, URL... urls)	Constructor for a PluginClassLoader instance with child-first class loading support.
PluginClassLoader(PluginManager pluginManager, PluginIdentifier identifier, boolean inServerClassPath, URL... urls)	Default Constructor for a PluginClassLoader instance

Method Summary

Modifier and Type	Method	Description
URL	getResource(String name)
Enumeration<URL>	getResources(String name)
static boolean	isFromThirdPartyPlugin(Throwable throwable)	Checks if an exception originated from a third-party plugin by examining the stack trace and classloader hierarchy.
boolean	isInServerClassPath()
Class<?>	loadLocalClass(String name)	Loads the classes of the currently set plugin

Methods inherited from class URLClassLoader

close, findResource, findResources, getResourceAsStream, getURLs, newInstance, newInstance

Methods inherited from class ClassLoader

clearAssertionStatus, getDefinedPackage, getDefinedPackages, getName, getParent, getPlatformClassLoader, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, getUnnamedModule, isRegisteredAsParallelCapable, loadClass, resources, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus

Methods inherited from class Object

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

Constructor Details

PluginClassLoader

public PluginClassLoader(@Nonnull
 PluginManager pluginManager,
 @Nullable
 PluginIdentifier identifier,
 boolean inServerClassPath,
 @Nonnull
 URL... urls)

Default Constructor for a PluginClassLoader instance

Parameters:

pluginManager - The affiliated plugin manager

identifier - Optional identifier of the plugin that owns this classloader

inServerClassPath - Whether the plugin is within the server class path

urls - Additional URLs that should be considered

PluginClassLoader

public PluginClassLoader(@Nonnull
 PluginManager pluginManager,
 @Nullable
 PluginIdentifier identifier,
 boolean inServerClassPath,
 boolean childFirst,
 @Nonnull
 URL... urls)

Constructor for a PluginClassLoader instance with child-first class loading support.

Parameters:

pluginManager - The affiliated plugin manager

identifier - Optional identifier of the plugin that owns this classloader

inServerClassPath - Whether the plugin is within the server class path

childFirst - When true, loads classes from own URLs before the server classloader

urls - Additional URLs that should be considered

Method Details

isInServerClassPath

public boolean isInServerClassPath()

Returns:

true if the plugin is within the server class path, false otherwise

loadLocalClass

@Nonnull
public Class<?> loadLocalClass(@Nonnull
 String name)
                        throws ClassNotFoundException

Loads the classes of the currently set plugin

Parameters:

name - The name of the main class that we are loading from

Returns:

the loaded JavaPlugin instance

Throws:

ClassNotFoundException - Thrown if no class was found from any of the attempted loads

getResource

@Nullable
public URL getResource(@Nonnull
 String name)

Overrides:

getResource in class ClassLoader

getResources

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

Overrides:

getResources in class ClassLoader

Throws:

IOException

isFromThirdPartyPlugin

public static boolean isFromThirdPartyPlugin(@Nullable
 Throwable throwable)

Checks if an exception originated from a third-party plugin by examining the stack trace and classloader hierarchy. Used as a fallback filter for exceptions that bypass plugin loggers.