Summary: Protected Ctors | Protected Methods | Inherited Methods | [Expand All]

Since: API Level 1

public class

SecureClassLoader

extends ClassLoader

java.lang.Object
↳	java.lang.ClassLoader
	↳	java.security.SecureClassLoader

Known Direct Subclasses

URLClassLoader

Class Overview

SecureClassLoader represents a ClassLoader which associates the classes it loads with a code source and provide mechanisms to allow the relevant permissions to be retrieved.

Summary

Protected Constructors
	SecureClassLoader() Constructs a new instance of `SecureClassLoader`.
	SecureClassLoader(ClassLoader parent) Constructs a new instance of `SecureClassLoader` with the specified parent `ClassLoader`.

Protected Methods
final Class<?>	defineClass(String name, byte[] b, int off, int len, CodeSource cs) Constructs a new class from an array of bytes containing a class definition in class file format with an optional `CodeSource`.
final Class<?>	defineClass(String name, ByteBuffer b, CodeSource cs) Constructs a new class from an array of bytes containing a class definition in class file format with an optional `CodeSource`.
PermissionCollection	getPermissions(CodeSource codesource) Returns the `PermissionCollection` for the specified `CodeSource`.

[Expand]

Inherited Methods

From class java.lang.ClassLoader

void	clearAssertionStatus() Sets the default assertion status for this class loader to `false` and removes any package default and class assertion status settings.
final Class<?>	defineClass(String name, ByteBuffer b, ProtectionDomain protectionDomain) Defines a new class with the specified name, byte code from the byte buffer and the optional protection domain.
final Class<?>	defineClass(String className, byte[] classRep, int offset, int length, ProtectionDomain protectionDomain) Constructs a new class from an array of bytes containing a class definition in class file format and assigns the specified protection domain to the new class.
final Class<?>	defineClass(String className, byte[] classRep, int offset, int length) Constructs a new class from an array of bytes containing a class definition in class file format.
final Class<?>	defineClass(byte[] classRep, int offset, int length) This method is deprecated. Use `defineClass(String, byte[], int, int)`
Package	definePackage(String name, String specTitle, String specVersion, String specVendor, String implTitle, String implVersion, String implVendor, URL sealBase) Defines and returns a new `Package` using the specified information.
Class<?>	findClass(String className) Overridden by subclasses, throws a `ClassNotFoundException` by default.
String	findLibrary(String libName) Returns the absolute path of the native library with the specified name, or `null`.
final Class<?>	findLoadedClass(String className) Returns the class with the specified name if it has already been loaded by the virtual machine or `null` if it has not yet been loaded.
URL	findResource(String resName) Finds the URL of the resource with the specified name.
Enumeration<URL>	findResources(String resName) Finds an enumeration of URLs for the resource with the specified name.
final Class<?>	findSystemClass(String className) Finds the class with the specified name, loading it using the system class loader if necessary.
Package	getPackage(String name) Returns the package with the specified name.
Package[]	getPackages() Returns all the packages known to this class loader.
final ClassLoader	getParent() Returns this class loader's parent.
URL	getResource(String resName) Returns the URL of the resource with the specified name.
InputStream	getResourceAsStream(String resName) Returns a stream for the resource with the specified name.
Enumeration<URL>	getResources(String resName) Returns an enumeration of URLs for the resource with the specified name.
static ClassLoader	getSystemClassLoader() Returns the system class loader.
static URL	getSystemResource(String resName) Finds the URL of the resource with the specified name.
static InputStream	getSystemResourceAsStream(String resName) Returns a stream for the resource with the specified name.
static Enumeration<URL>	getSystemResources(String resName) Returns an enumeration of URLs for the resource with the specified name.
Class<?>	loadClass(String className, boolean resolve) Loads the class with the specified name, optionally linking it after loading.
Class<?>	loadClass(String className) Loads the class with the specified name.
final void	resolveClass(Class<?> clazz) Forces a class to be linked (initialized).
void	setClassAssertionStatus(String cname, boolean enable) Sets the assertion status of the class with the specified name.
void	setDefaultAssertionStatus(boolean enable) Sets the default assertion status for this class loader.
void	setPackageAssertionStatus(String pname, boolean enable) Sets the assertion status of the package with the specified name.
final void	setSigners(Class<?> c, Object[] signers) Sets the signers of the specified class.

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Called before the object's memory is reclaimed by the VM.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

Protected Constructors

protected SecureClassLoader ()

Since: API Level 1

Constructs a new instance of SecureClassLoader. The default parent ClassLoader is used.

If a SecurityManager is installed, code calling this constructor needs the SecurityPermission checkCreateClassLoader to be granted, otherwise a SecurityException will be thrown.

Throws

SecurityException	if a `SecurityManager` is installed and the caller does not have permission to invoke this constructor.

protected SecureClassLoader (ClassLoader parent)

Since: API Level 1

Constructs a new instance of SecureClassLoader with the specified parent ClassLoader.

If a SecurityManager is installed, code calling this constructor needs the SecurityPermission checkCreateClassLoader to be granted, otherwise a SecurityException will be thrown.

Parameters

parent	the parent `ClassLoader`.

Throws

SecurityException	if a `SecurityManager` is installed and the caller does not have permission to invoke this constructor.

Protected Methods

protected final Class<?> defineClass (String name, byte[] b, int off, int len, CodeSource cs)

Since: API Level 1

Constructs a new class from an array of bytes containing a class definition in class file format with an optional CodeSource.

Parameters

name	the name of the new class.
b	a memory image of a class file.
off	the start offset in b of the class data.
len	the length of the class data.
cs	the `CodeSource`, or `null`.

Returns

a new class.

Throws

IndexOutOfBoundsException	if `off` or `len` are not valid in respect to `b`.
ClassFormatError	if the specified data is not valid class data.
SecurityException	if the package to which this class is to be added, already contains classes which were signed by different certificates, or if the class name begins with "java."

protected final Class<?> defineClass (String name, ByteBuffer b, CodeSource cs)

Since: API Level 1

Constructs a new class from an array of bytes containing a class definition in class file format with an optional CodeSource.

Parameters

name	the name of the new class.
b	a memory image of a class file.
cs	the `CodeSource`, or `null`.

Returns

a new class.

Throws

ClassFormatError	if the specified data is not valid class data.
SecurityException	if the package to which this class is to be added, already contains classes which were signed by different certificates, or if the class name begins with "java."

protected PermissionCollection getPermissions (CodeSource codesource)

Since: API Level 1

Returns the PermissionCollection for the specified CodeSource.

Parameters

codesource	the code source.

Returns

the PermissionCollection for the specified CodeSource.

Interfaces

Classes

Enums

Exceptions

SecureClassLoader

Class Overview

Summary

Protected Constructors

protected SecureClassLoader ()

Throws

protected SecureClassLoader (ClassLoader parent)

Parameters

Throws

Protected Methods

protected final Class<?> defineClass (String name, byte[] b, int off, int len, CodeSource cs)

Parameters

Returns

Throws

protected final Class<?> defineClass (String name, ByteBuffer b, CodeSource cs)

Parameters

Returns

Throws

protected PermissionCollection getPermissions (CodeSource codesource)

Parameters

Returns