Modifier and Type	Class and Description
private static record	SecureClassLoader.CodeSourceKey
private static class	SecureClassLoader.DebugHolder

Modifier and Type	Field and Description
private final Map<SecureClassLoader.CodeSourceKey, ProtectionDomain>	pdcache

Access	Constructor and Description
protected	SecureClassLoader(ClassLoader the parent ClassLoader parent) Creates a new `SecureClassLoader` using the specified parent class loader for delegation.
protected	SecureClassLoader() Creates a new `SecureClassLoader` using the default parent class loader for delegation.
protected	SecureClassLoader(String class loader name; or `null` if not named name, ClassLoader the parent class loader parent) Creates a new `SecureClassLoader` of the specified name and using the specified parent class loader for delegation.

Method Summary

Modifier and Type	Method and Description
protected final Class<?>	Returns: the `Class` object created from the data, and optional CodeSource. defineClass(String the expected name of the class, or `null` if not known, using '.' and not '/' as the separator and without a trailing ".class" suffix. name, byte[] the bytes that make up the class data. The bytes in positions `off` through `off+len-1` should have the format of a valid class file as defined by The Java Virtual Machine Specification. b, int the start offset in `b` of the class data off, int the length of the class data len, CodeSource the associated CodeSource, or `null` if none cs) Converts an array of bytes into an instance of class `Class`, with an optional CodeSource.
protected final Class<?>	Returns: the `Class` object created from the data, and optional CodeSource. defineClass(String the expected name of the class, or `null` if not known, using '.' and not '/' as the separator and without a trailing ".class" suffix. name, ByteBuffer the bytes that make up the class data. The bytes from positions `b.position()` through `b.position() + b.limit() -1` should have the format of a valid class file as defined by The Java Virtual Machine Specification. b, CodeSource the associated CodeSource, or `null` if none cs) Converts a `ByteBuffer` into an instance of class `Class`, with an optional CodeSource.
protected PermissionCollection	Returns: the permissions granted to the codesource. getPermissions(CodeSource the codesource. codesource) Returns the permissions for the given CodeSource object.
private ProtectionDomain	getProtectionDomain(CodeSource cs)
private void	resetArchivedStates() Hides java.lang.ClassLoader.resetArchivedStates. Called by the VM, during -Xshare:dump

Field Detail

pdcache	back to summary
private final Map<SecureClassLoader.CodeSourceKey, ProtectionDomain> pdcache

Constructor Detail

SecureClassLoader back to summary

SecureClassLoader	back to summary
protected SecureClassLoader(ClassLoader parent) Creates a new `SecureClassLoader` using the specified parent class loader for delegation. If there is a security manager, this method first calls the security manager's `checkCreateClassLoader` method to ensure creation of a class loader is allowed. Parameters parent:ClassLoader the parent ClassLoader Exceptions SecurityException: if a security manager exists and its `checkCreateClassLoader` method doesn't allow creation of a class loader. See Also `SecurityManager#checkCreateClassLoader`

protected SecureClassLoader(ClassLoader parent)

Creates a new SecureClassLoader using the specified parent class loader for delegation.

If there is a security manager, this method first calls the security manager's checkCreateClassLoader method to ensure creation of a class loader is allowed.

Parameters

parent:ClassLoader: the parent ClassLoader

Exceptions

SecurityException:: if a security manager exists and its checkCreateClassLoader method doesn't allow creation of a class loader.

SecureClassLoader back to summary

SecureClassLoader	back to summary
protected SecureClassLoader() Creates a new `SecureClassLoader` using the default parent class loader for delegation. If there is a security manager, this method first calls the security manager's `checkCreateClassLoader` method to ensure creation of a class loader is allowed. Exceptions SecurityException: if a security manager exists and its `checkCreateClassLoader` method doesn't allow creation of a class loader. See Also `SecurityManager#checkCreateClassLoader`

protected SecureClassLoader()

Creates a new SecureClassLoader using the default parent class loader for delegation.

If there is a security manager, this method first calls the security manager's checkCreateClassLoader method to ensure creation of a class loader is allowed.

Exceptions

SecurityException:: if a security manager exists and its checkCreateClassLoader method doesn't allow creation of a class loader.

SecureClassLoader back to summary

SecureClassLoader	back to summary
protected SecureClassLoader(String name, ClassLoader parent) Creates a new `SecureClassLoader` of the specified name and using the specified parent class loader for delegation. Parameters name:String class loader name; or `null` if not named parent:ClassLoader the parent class loader Exceptions IllegalArgumentException: if the given name is empty. SecurityException: if a security manager exists and its `SecurityManager#checkCreateClassLoader()` method doesn't allow creation of a class loader. Since 9

protected SecureClassLoader(String name, ClassLoader parent)

Creates a new SecureClassLoader of the specified name and using the specified parent class loader for delegation.

Parameters

name:String: class loader name; or null if not named
parent:ClassLoader: the parent class loader

Exceptions

IllegalArgumentException:: if the given name is empty.
SecurityException:: if a security manager exists and its SecurityManager#checkCreateClassLoader() method doesn't allow creation of a class loader.

Since

Method Detail

defineClass back to summary

defineClass	back to summary
protected final Class<?> defineClass(String name, byte[] b, int off, int len, CodeSource cs) Converts an array of bytes into an instance of class `Class`, with an optional CodeSource. Before the class can be used it must be resolved. If a non-null CodeSource is supplied a ProtectionDomain is constructed and associated with the class being defined. Parameters name:String the expected name of the class, or `null` if not known, using '.' and not '/' as the separator and without a trailing ".class" suffix. b:byte[] the bytes that make up the class data. The bytes in positions `off` through `off+len-1` should have the format of a valid class file as defined by The Java Virtual Machine Specification. off:int the start offset in `b` of the class data len:int the length of the class data cs:CodeSource the associated CodeSource, or `null` if none Returns:Class<?> the `Class` object created from the data, and optional CodeSource. Exceptions ClassFormatError: if the data did not contain a valid class IndexOutOfBoundsException: if either `off` or `len` is negative, or if `off+len` is greater than `b.length`. SecurityException: if an attempt is made to add this class to a package that contains classes that were signed by a different set of certificates than this class, or if the class name begins with "java.".

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

Converts an array of bytes into an instance of class Class, with an optional CodeSource. Before the class can be used it must be resolved.

If a non-null CodeSource is supplied a ProtectionDomain is constructed and associated with the class being defined.

Parameters

name:String: the expected name of the class, or null if not known, using '.' and not '/' as the separator and without a trailing ".class" suffix.
b:byte[]: the bytes that make up the class data. The bytes in positions off through off+len-1 should have the format of a valid class file as defined by The Java Virtual Machine Specification.
off:int: the start offset in b of the class data
len:int: the length of the class data
cs:CodeSource: the associated CodeSource, or null if none

Returns:Class<?>

the Class object created from the data, and optional CodeSource.

Exceptions

ClassFormatError:: if the data did not contain a valid class
IndexOutOfBoundsException:: if either off or len is negative, or if off+len is greater than b.length.
SecurityException:: if an attempt is made to add this class to a package that contains classes that were signed by a different set of certificates than this class, or if the class name begins with "java.".

defineClass back to summary

defineClass	back to summary
protected final Class<?> defineClass(String name, ByteBuffer b, CodeSource cs) Converts a `ByteBuffer` into an instance of class `Class`, with an optional CodeSource. Before the class can be used it must be resolved. If a non-null CodeSource is supplied a ProtectionDomain is constructed and associated with the class being defined. Parameters name:String the expected name of the class, or `null` if not known, using '.' and not '/' as the separator and without a trailing ".class" suffix. b:ByteBuffer the bytes that make up the class data. The bytes from positions `b.position()` through `b.position() + b.limit() -1` should have the format of a valid class file as defined by The Java Virtual Machine Specification. cs:CodeSource the associated CodeSource, or `null` if none Returns:Class<?> the `Class` object created from the data, and optional CodeSource. Exceptions ClassFormatError: if the data did not contain a valid class SecurityException: if an attempt is made to add this class to a package that contains classes that were signed by a different set of certificates than this class, or if the class name begins with "java.". Since 1.5

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

Converts a ByteBuffer into an instance of class Class, with an optional CodeSource. Before the class can be used it must be resolved.

If a non-null CodeSource is supplied a ProtectionDomain is constructed and associated with the class being defined.

Parameters

name:String: the expected name of the class, or null if not known, using '.' and not '/' as the separator and without a trailing ".class" suffix.
b:ByteBuffer: the bytes that make up the class data. The bytes from positions b.position() through b.position() + b.limit() -1 should have the format of a valid class file as defined by The Java Virtual Machine Specification.
cs:CodeSource: the associated CodeSource, or null if none

Returns:Class<?>

the Class object created from the data, and optional CodeSource.

Exceptions

ClassFormatError:: if the data did not contain a valid class
SecurityException:: if an attempt is made to add this class to a package that contains classes that were signed by a different set of certificates than this class, or if the class name begins with "java.".

Since

1.5

getPermissions	back to summary
protected PermissionCollection getPermissions(CodeSource codesource) Returns the permissions for the given CodeSource object. This method is invoked by the defineClass method which takes a CodeSource as an argument when it is constructing the ProtectionDomain for the class being defined. Parameters codesource:CodeSource the codesource. Returns:PermissionCollection the permissions granted to the codesource.

getPermissions

back to summary

protected PermissionCollection getPermissions(CodeSource codesource)

Returns the permissions for the given CodeSource object.

This method is invoked by the defineClass method which takes a CodeSource as an argument when it is constructing the ProtectionDomain for the class being defined.

Parameters

codesource:CodeSource: the codesource.

Returns:PermissionCollection

the permissions granted to the codesource.

getProtectionDomain	back to summary
private ProtectionDomain getProtectionDomain(CodeSource cs)

resetArchivedStates	back to summary
private void resetArchivedStates() Hides java.lang.ClassLoader.resetArchivedStates. Called by the VM, during -Xshare:dump

resetArchivedStates

back to summary

private void resetArchivedStates()

Hides java.lang.ClassLoader.resetArchivedStates.

Called by the VM, during -Xshare:dump

java.security back to summary

private final Record SecureClassLoader.CodeSourceKey

Class Inheritance

extends Record

java.lang.Object
java.lang.Record
java.security.SecureClassLoader.CodeSourceKey

Record Components

cs:CodeSource

Field Summary

Modifier and Type	Field and Description
private final CodeSource	cs Record Component accessed by cs().

Constructor Summary

Access	Constructor and Description
private	CodeSourceKey(CodeSource cs)

Method Summary

Modifier and Type	Method and Description
public CodeSource	cs() Record Component getter of cs.
public boolean	equals(Object the reference object with which to compare. obj) Implements abstract java.lang.Record.equals. Indicates whether some other object is "equal to" this one.
public int	hashCode() Implements abstract java.lang.Record.hashCode. Returns a hash code value for the record.
public final String	toString() Implements abstract java.lang.Record.toString. Returns a string representation of the record.

Field Detail

cs	back to summary
private final CodeSource cs Record Component accessed by cs().

Constructor Detail

CodeSourceKey	back to summary
private CodeSourceKey(CodeSource cs)

Method Detail

cs	back to summary
public CodeSource cs() Record Component getter of cs.

equals back to summary

equals	back to summary
public boolean equals(Object obj) Implements abstract java.lang.Record.equals. Doc from java.lang.Record.equals. Indicates whether some other object is "equal to" this one. In addition to the general contract of `Object.equals`, record classes must further obey the invariant that when a record instance is "copied" by passing the result of the record component accessor methods to the canonical constructor, as follows: R copy = new R(r.c1(), r.c2(), ..., r.cn()); then it must be the case that `r.equals(copy)`. Parameters obj:Object the reference object with which to compare. Returns:boolean `true` if this record is equal to the argument; `false` otherwise. Annotations @Override

public boolean equals(Object obj)

Implements abstract java.lang.Record.equals.

Doc from java.lang.Record.equals.

Indicates whether some other object is "equal to" this one. In addition to the general contract of Object.equals, record classes must further obey the invariant that when a record instance is "copied" by passing the result of the record component accessor methods to the canonical constructor, as follows:

    R copy = new R(r.c1(), r.c2(), ..., r.cn());

then it must be the case that r.equals(copy).

Parameters

obj:Object: the reference object with which to compare.

Returns:boolean

true if this record is equal to the argument; false otherwise.

Annotations

@Override

hashCode back to summary

hashCode	back to summary
public int hashCode() Implements abstract java.lang.Record.hashCode. Doc from java.lang.Record.hashCode. Returns a hash code value for the record. Obeys the general contract of `Object.hashCode`. For records, hashing behavior is constrained by the refined contract of `Record.equals`, so that any two records created from the same components must have the same hash code. Returns:int a hash code value for this record. Annotations @Override

public int hashCode()

Implements abstract java.lang.Record.hashCode.

Doc from java.lang.Record.hashCode.

Returns a hash code value for the record. Obeys the general contract of Object.hashCode. For records, hashing behavior is constrained by the refined contract of Record.equals, so that any two records created from the same components must have the same hash code.

Returns:int

a hash code value for this record.

Annotations

@Override

toString back to summary

toString	back to summary
public final String toString() Implements abstract java.lang.Record.toString. Doc from java.lang.Record.toString. Returns a string representation of the record. In accordance with the general contract of `Object#toString()`, the `toString` method returns a string that "textually represents" this record. The result should be a concise but informative representation that is easy for a person to read. In addition to this general contract, record classes must further participate in the invariant that any two records which are equal must produce equal strings. This invariant is necessarily relaxed in the rare case where corresponding equal component values might fail to produce equal strings for themselves. Returns:String a string representation of the object.

public final String toString()

Implements abstract java.lang.Record.toString.

Doc from java.lang.Record.toString.

Returns a string representation of the record. In accordance with the general contract of Object#toString(), the toString method returns a string that "textually represents" this record. The result should be a concise but informative representation that is easy for a person to read.

In addition to this general contract, record classes must further participate in the invariant that any two records which are equal must produce equal strings. This invariant is necessarily relaxed in the rare case where corresponding equal component values might fail to produce equal strings for themselves.

Returns:String: a string representation of the object.

public Class SecureClassLoader

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Record SecureClassLoader.CodeSourceKey

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class SecureClassLoader.DebugHolder

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail