com.tplan.robot.util

Class LazyClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

com.tplan.robot.util.LazyClassLoader

All Implemented Interfaces:

Closeable, AutoCloseable

public final class LazyClassLoader
extends URLClassLoader

Robot class loader. To address tightened security introduced in Java 9 all classes relying on dynamically loaded libraries (JAR files) must be instantiated using this loader.

The class was redesigned in v7.0.2 to enable loading of complicated plugins from alternative locations (RB-648). It is now being used as the default JVM system class loader injected through the -Djava.system.class.loader=com.tplan.robot.util.LazyClassLoader CLI option.

Since:

4.4

T-Plan Robot Enterprise, (C) 2009-2025 T-Plan Limited. All rights reserved.

Constructor Summary

Constructors

Constructor and Description
LazyClassLoader(ClassLoader parent) Constructor.Required when this class loader is used as the system class loader.
LazyClassLoader(String name, ClassLoader parent) Constructor.
LazyClassLoader(String name, URL[] urls, ClassLoader parent)

Method Summary

Modifier and Type	Method and Description
static void	addPluginPath(String paths) Add a path or paths containing Robot plugins.
static void	addResource(File f) Add a file to the class path.
static void	addResource(URL u) Add a file resource.
void	addURL(URL url) Add a URL to this class loader.
static Class	forName(String clazz) Load a class by name.
static ClassLoader	getInstance() Get shared loader instance.
static boolean	isJava9() Indicate whether Java is version 9 or higher.
static boolean	isJGraphXMissing() Indicate if the JGraphX library is loaded or missing.
static boolean	testLibs(StringBuilder b, boolean html)
String	toString()

Methods inherited from class java.net.URLClassLoader

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

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, getParent, getResource, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus

Methods inherited from class java.lang.Object

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

Constructor Detail

LazyClassLoader

public LazyClassLoader(String name,
                       ClassLoader parent)

Constructor.

Parameters:

name - loader name.

parent - parent class loader.

LazyClassLoader

public LazyClassLoader(ClassLoader parent)

Constructor.Required when this class loader is used as the system class loader.

Parameters:

parent - parent class loader.

LazyClassLoader

public LazyClassLoader(String name,
                       URL[] urls,
                       ClassLoader parent)

Method Detail

isJava9

public static boolean isJava9()

Indicate whether Java is version 9 or higher.

Returns:

true if Java is 9+ or false otherwise.

isJGraphXMissing

public static boolean isJGraphXMissing()

Indicate if the JGraphX library is loaded or missing.

Returns:

true if missing or false if present.

Since:

6.0.1

getInstance

public static ClassLoader getInstance()

Get shared loader instance.

Returns:

the shared loader instance.

forName

public static Class forName(String clazz)
                     throws ClassNotFoundException

Load a class by name.

Parameters:

clazz - the class name.

Returns:

the class.

Throws:

ClassNotFoundException - when the class can not be loaded.

testLibs

public static boolean testLibs(StringBuilder b,
                               boolean html)

addResource

public static void addResource(URL u)

Add a file resource.

Parameters:

u - a file URL.

addResource

public static void addResource(File f)

Add a file to the class path.

Parameters:

f - a file.

addPluginPath

public static void addPluginPath(String paths)

Add a path or paths containing Robot plugins. All JARs found in the path or its folders corresponding to the Robot class paths will be loaded.

Parameters:

paths - a path or local ODS path separator separated paths.

Since:

7.0.2

addURL

public void addURL(URL url)

Add a URL to this class loader.

Overrides:

addURL in class URLClassLoader

Parameters:

url - a URL.

toString

public String toString()

Overrides:

toString in class Object