Package org.robolectric.simulator

Class SimulatorClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

org.robolectric.internal.bytecode.SandboxClassLoader

org.robolectric.internal.AndroidSandbox.SdkSandboxClassLoader

org.robolectric.simulator.SimulatorClassLoader

All Implemented Interfaces:

Closeable, AutoCloseable, ClassTracker

@AutoService(SdkSandboxClassLoader.class)
public class SimulatorClassLoader
extends AndroidSandbox.SdkSandboxClassLoader

An override of AndroidSandbox.SdkSandboxClassLoader that supports extra local Jars in the classpath.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SimulatorClassLoader.JarCollection	Encapsulates a collection of Jar files.

Constructor Summary

Constructors

Constructor	Description
SimulatorClassLoader(InstrumentationConfiguration config, Sdk runtimeSdk, ClassInstrumentor classInstrumentor, SimulatorClassLoader.JarCollection jarCollection)

Method Summary

Modifier and Type	Method	Description
Enumeration<URL>	findResources(String name)	This override is required to support ServiceLoader plugins in the extra jars passed into the simulator.
protected InputStream	getClassBytesFromAlternateClassLoader(String classResName)	This allows the simulator to provide classes from the deploy jar before classes from the runtime classpath.
protected URL	getResourceUrl(String name)

Methods inherited from class org.robolectric.internal.bytecode.SandboxClassLoader

close, getResource, isClassLoaded, loadClass

Methods inherited from class java.net.URLClassLoader

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

Methods inherited from class java.security.SecureClassLoader

defineClass, defineClass

Methods inherited from class java.lang.ClassLoader

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

Methods inherited from class java.lang.Object

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

Constructor Details

SimulatorClassLoader

public SimulatorClassLoader(InstrumentationConfiguration config,
 @Named("runtimeSdk")
 Sdk runtimeSdk,
 ClassInstrumentor classInstrumentor,
 SimulatorClassLoader.JarCollection jarCollection)

Method Details

getClassBytesFromAlternateClassLoader

protected InputStream getClassBytesFromAlternateClassLoader(String classResName)

This allows the simulator to provide classes from the deploy jar before classes from the runtime classpath.

The order of preference is:

1. The Android framework jars
2. The extra jars managed by the simulator (deploy jar and extra jars passed as args)
3. The jars that are on the runtime classpath.

Overrides:

getClassBytesFromAlternateClassLoader in class SandboxClassLoader

findResources

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

This override is required to support ServiceLoader plugins in the extra jars passed into the simulator. It looks for all service-related metadata in META-INF/services/... in the extra jars before falling back to the superclass implementation.

Overrides:

findResources in class URLClassLoader

Throws:

IOException

getResourceUrl

protected URL getResourceUrl(String name)

Overrides:

getResourceUrl in class SandboxClassLoader