ClassLoader

ClassLoader

ClassLoader (ClassLoader parent)

使用指定的父类加载器进行委派创建新的类加载器。

如果有安全管理器，则调用其checkCreateClassLoader方法。 这可能会导致安全异常。

ClassLoader

ClassLoader ()

使用方法 getSystemClassLoader()作为父类加载器返回的 ClassLoader创建一个新的类加载器。

如果有安全管理器，则调用其checkCreateClassLoader方法。 这可能会导致安全异常。

clearAssertionStatus

void clearAssertionStatus ()

将此类加载器的默认断言状态设置为false，并放弃与类加载器关联的所有程序包缺省值或类断言状态设置。 提供此方法的目的是使类加载器可以忽略任何命令行或持久断言状态设置，并且“以干净的版本开始”。

getParent

ClassLoader getParent ()

返回委托的父类加载器。 某些实现可能使用null来表示引导类加载器。 如果此类加载器的父类是引导类加载器，则此方法将在此类实现中返回null 。

如果安全管理器存在，并且调用者的类加载器不是此类加载器的祖先，则此方法调用安全管理器的checkPermission方法，并具有RuntimePermission("getClassLoader")权限，以验证是否允许访问父类加载器。 如果不是，则会抛出SecurityException 。

getResource

URL getResource (String name)

查找具有给定名称的资源。 资源是一些数据（图像，音频，文本等），可以通过类代码以独立于代码位置的方式访问。

资源的名称是标识资源的' / ' 分隔的路径名称。

这个方法将首先搜索父类加载器的资源; 如果父项是null ，则将搜索内置到虚拟机的类加载器的路径。 如果失败，该方法将调用findResource(String)来查找资源。

getResourceAsStream

InputStream getResourceAsStream (String name)

返回读取指定资源的输入流。

搜索顺序在 getResource(String)的文档中 getResource(String) 。

getResources

Enumeration<URL> getResources (String name)

查找具有给定名称的所有资源。 资源是一些数据（图像，音频，文本等），可以通过类代码以独立于代码位置的方式访问。

资源的名称是一个 标识资源的 /分隔的路径名。

搜索顺序在 getResource(String)的文档中有描述。

getSystemClassLoader

ClassLoader getSystemClassLoader ()

返回委托的系统类加载器。 这是新的ClassLoader实例的默认委派父项 ，通常是用于启动应用程序的类加载器。

该方法在运行时的启动序列中首先被调用，此时它会创建系统类加载器并将其设置为调用 Thread的上下文类加载器。

默认的系统类加载器是该类的实现相关实例。

如果在首次调用此方法时定义了系统属性“ java.system.class.loader ”，那么该属性的值将被视为将作为系统类加载器返回的类的名称。 该类使用默认系统类加载器加载，并且必须定义一个公共构造函数，该构造函数接受用作委派父项的类型为ClassLoader的单个参数。 然后使用此构造函数创建一个实例，并使用默认的系统类加载器作为参数。 生成的类加载器被定义为系统类加载器。

如果存在安全管理器，并且调用者的类加载器不是null ，并且调用者的类加载器与系统类加载器不相同或始祖，则此方法调用安全管理器的checkPermission方法，并具有RuntimePermission("getClassLoader")权限以验证访问权限到系统类加载器。 如果不是，则会抛出SecurityException 。

getSystemResource

URL getSystemResource (String name)

从用于加载类的搜索路径中查找指定名称的资源。 此方法通过系统类加载器查找资源（请参阅getSystemClassLoader() ）。

getSystemResourceAsStream

InputStream getSystemResourceAsStream (String name)

打开阅读，从用于加载类的搜索路径中指定名称的资源。 此方法通过系统类加载器查找资源（请参阅getSystemClassLoader() ）。

getSystemResources

Enumeration<URL> getSystemResources (String name)

从用于加载类的搜索路径中查找指定名称的所有资源。 这样找到的资源将返回为Enumeration个URL对象。

搜索顺序在 getSystemResource(String)的文档中 getSystemResource(String) 。

loadClass

Class<?> loadClass (String name)

使用指定的binary name加载课程。 该方法以与loadClass(String, boolean)方法相同的方式搜索类。 它由Java虚拟机调用以解析类引用。 调用此方法相当于调用loadClass(name, false) 。

setClassAssertionStatus

void setClassAssertionStatus (String className, 
                boolean enabled)

在此类加载器及其中包含的任何嵌套类中，为指定的顶级类设置所需的断言状态。 此设置优先于类加载器的默认断言状态以及任何适用的每个包默认值。 如果已命名的类已被初始化，则此方法不起作用。 （一旦一个类被初始化，它的断言状态就不会改变。）

如果指定的类不是顶级类，则此调用将不会影响任何类的实际断言状态。

setDefaultAssertionStatus

void setDefaultAssertionStatus (boolean enabled)

设置此类加载器的默认断言状态。 此设置确定此类加载器加载并在将来初始化的类是否默认启用或禁用断言。 通过调用setPackageAssertionStatus(String, boolean)或setClassAssertionStatus(String, boolean)可以基于每个包或每个类来覆盖此设置。

setPackageAssertionStatus

void setPackageAssertionStatus (String packageName, 
                boolean enabled)

设置命名包的包默认断言状态。 程序包缺省断言状态决定了将来初始化的属于命名程序包或其任何“子程序包”的类的断言状态。

名为p的软件包的子软件包是名称以“ p. ”开头的任何软件包。 例如，javax.swing.text是javax.swing一个子包，并且两个java.util java.lang.reflect和是java子包。

如果多个程序包默认值适用于给定的类，则与最具体程序包有关的程序包默认优先于其他程序包。 例如，如果javax.lang和javax.lang.reflect都具有与其关联的软件包默认值，则后者的软件包默认值将应用于javax.lang.reflect中的类。

包默认优先于类加载器的默认断言状态，并且可以通过调用 setClassAssertionStatus(String, boolean)以每个类为基础进行 setClassAssertionStatus(String, boolean) 。

defineClass

Class<?> defineClass (String name, 
                byte[] b, 
                int off, 
                int len, 
                ProtectionDomain protectionDomain)

使用可选的ProtectionDomain将字节数组转换为类Class的实例。 如果域名是null ，那么默认域名将被分配给类别defineClass(String, byte[], int, int)的文档中指定的defineClass(String, byte[], int, int) 。 在课程可以使用之前，必须解决。

包中定义的第一个类确定了该包中定义的所有后续类必须包含的确切证书集。 从班级的CodeSource内的CodeSource获得一组班级的证书。 添加到该软件包的任何类都必须包含相同的证书集合， 否则将抛出SecurityException 。 请注意，如果name是null ，则不执行此项检查。 您应该始终传递您定义的类的binary name以及字节。 这可以确保您定义的课程确实是您认为的课程。

指定的 name不能以“ java. ”开头，因为“ java.*包中的所有类只能由引导类加载器定义，如果 name不是 null ，它必须等于字节数组指定的类的 binary name ” b “，否则会抛出 NoClassDefFoundError 。

defineClass

Class<?> defineClass (String name, 
                ByteBuffer b, 
                ProtectionDomain protectionDomain)

一个转换ByteBuffer为Class类的实例，带有可选ProtectionDomain。 如果域名为null ，则默认域将按照defineClass(String, byte[], int, int)文档中的规定分配给该类别。 在课程可以使用之前，必须解决。

有关确定包的证书集的包中定义的第一个类的规则以及对类名的限制与 defineClass(String, byte[], int, int, ProtectionDomain)文档中指定的相同。

调用形式为 cl .defineClass(的方法 名称 , bBuffer , pd )产生与语句完全相同的结果

...
byte[] temp = new byte[ bBuffer .remaining()];
bBuffer .get(temp);
return cl.defineClass ( name , temp, 0, temp.length, pd );

defineClass

Class<?> defineClass (byte[] b, 
                int off, 
                int len)

此方法在API级别1中已弃用。
由defineClass(String, byte[], int, int)

将字节数组转换为类Class的实例。 在使用Class之前，必须先解决。 此方法已被弃用，以支持以binary name作为其第一个参数的版本，并且更安全。

defineClass

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

将字节数组转换为类Class的实例。 在使用Class之前，必须先解决。

该方法为新定义的类分配默认的ProtectionDomain 。 当Policy.getPolicy().getPermissions(new CodeSource(null, null))被调用时， ProtectionDomain被有效地授予返回的同一组权限。 默认域是在第一次调用defineClass创建的，并在后续调用中重新使用。

要为该类指定特定的 ProtectionDomain ，请使用 defineClass方法，该方法将 ProtectionDomain作为其参数之一。

definePackage

软件包 definePackage (String name, 
                String specTitle, 
                String specVersion, 
                String specVendor, 
                String implTitle, 
                String implVersion, 
                String implVendor, 
                URL sealBase)

在此ClassLoader中按名称定义一个包。 这允许类加载器为他们的类定义包。 包必须在类定义之前创建，并且包名在类加载器中必须是唯一的，并且一旦创建就不能重新定义或更改。

findClass

Class<?> findClass (String name)

找到具有指定binary name的课程 。 这个方法应该由加载类的代理模型loadClass的类加载器实现覆盖，并且在检查所请求的类的父类加载器后， loadClass方法调用。 默认实现抛出ClassNotFoundException 。

findLibrary

String findLibrary (String libname)

返回本机库的绝对路径名称。 VM调用此方法来查找属于使用此类加载器加载的类的本机库。 如果此方法返回null ，则VM将按照指定为“ java.library.path ”属性的路径搜索库。

findLoadedClass

Class<?> findLoadedClass (String name)

如果此加载器已被Java虚拟机记录为具有该binary name的类的启动加载器，则返回具有给定binary name的类。 否则返回null 。

findResource

URL findResource (String name)

查找具有给定名称的资源。 类加载器实现应该重写此方法以指定在哪里查找资源。

findResources

Enumeration<URL> findResources (String name)

返回表示具有给定名称的所有资源的URL对象的枚举。 类加载器实现应该重写此方法以指定从哪里加载资源。

findSystemClass

Class<?> findSystemClass (String name)

找到具有指定的 binary name的课程 ，并根据需要加载它。

此方法通过系统类加载器加载该类（请参阅getSystemClassLoader() ）。 返回的Class对象可能有多个与其关联的ClassLoader 。 ClassLoader的子类通常不需要调用这个方法，因为大多数类加载器只需要覆盖findClass(String) 。

getPackage

软件包 getPackage (String name)

返回已由此类加载器或其任何祖先定义的 软件包 。

getPackages

Package[] getPackages ()

返回由此类加载器及其祖先定义的所有 Packages 。

loadClass

Class<?> loadClass (String name, 
                boolean resolve)

使用指定的binary name加载课程。 此方法的默认实现按以下顺序搜索类：

1. 调用 findLoadedClass(String)来检查该类是否已被加载。

2. 在父类加载器上调用loadClass方法。 如果父项是null ，则会使用内置于虚拟机的类加载器。

3. 调用 findClass(String)方法来查找类。

如果使用上述步骤找到该类，并且 resolve标志为true，则此方法将调用所产生的 Class对象上的 resolveClass(Class)方法。

鼓励 ClassLoader的子类覆盖 findClass(String) ，而不是此方法。

registerAsParallelCapable

boolean registerAsParallelCapable ()

将调用者注册为并行能力。

resolveClass

void resolveClass (Class<?> c)

链接指定的类。 这个（具有误导性的命名）方法可以被类加载器用来链接一个类。 如果类c已经链接，则此方法仅返回。 否则，该类按照The Java™ Language Specification的“执行”章节中的描述进行链接 。

setSigners

void setSigners (Class<?> c, 
                Object[] signers)

设置类的签名者。 这应该在定义一个类之后调用。