cn.featherfly.common.lang

类 ClassLoaderUtils

java.lang.Object

cn.featherfly.common.lang.ClassLoaderUtils

public final class ClassLoaderUtils
extends java.lang.Object

类加载器工具

从以下版本开始:

1.0

嵌套类概要

嵌套类

限定符和类型	类和说明
protected static class	ClassLoaderUtils.AggregateIterator<E> 聚合成一个能进行重复迭代和过滤的枚举实例。

方法概要

限定符和类型	方法和说明
static java.net.URL	getResource(java.lang.String resourceName) 加载给定的资源.
static java.net.URL	getResource(java.lang.String resourceName, java.lang.Class<?> callingClass) 加载给定的资源.
static java.io.InputStream	getResourceAsStream(java.lang.String resourceName) 这是一个用来方便的加载流资源的方法.
static java.io.InputStream	getResourceAsStream(java.lang.String resourceName, java.lang.Class<?> callingClass) 这是一个用来方便的加载流资源的方法.
static java.util.Iterator<java.net.URL>	getResources(java.lang.String resourceName, boolean aggregate) 加载给定名称的所有资源，将搜索类加载器或得的所有结果汇总.
static java.util.Iterator<java.net.URL>	getResources(java.lang.String resourceName, java.lang.Class<?> callingClass, boolean aggregate) 加载给定名称的所有资源，将搜索类加载器或得的所有结果汇总.
static java.lang.Class<?>	loadClass(java.lang.String className, java.lang.Class<?> callingClass) 使用传入的名称加载类（class）.
static void	printClassLoader() 打印输出当前类加载器的层次结构 - 调试很有用.
static void	printClassLoader(java.lang.ClassLoader cl) 打印输出给定类加载器的层次结构 - 调试很有用
static java.lang.String	showClassLoaderHierarchy(java.lang.ClassLoader cl) 显示给定类加载器的层次结构.
static java.lang.String	showClassLoaderHierarchy(java.lang.ClassLoader cl, java.lang.String lineBreak, java.lang.String tabText) 显示给定类加载器的层次结构.
static java.lang.String	showClassLoaderHierarchy(java.lang.Object obj, java.lang.String role) 显示类加载器的层次结构.
static java.lang.String	showClassLoaderHierarchy(java.lang.Object obj, java.lang.String role, java.lang.String lineBreak, java.lang.String tabText) 显示类加载器的层次结构.

从类继承的方法 java.lang.Object

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

方法详细资料

getResources

public static java.util.Iterator<java.net.URL> getResources(java.lang.String resourceName,
                                                            boolean aggregate)
                                                     throws java.io.IOException

加载给定名称的所有资源，将搜索类加载器或得的所有结果汇总. 如果没有发现结果，如果资源文件不是以'/'开头，则在资源名称前加前缀'/'，并再次查找。 此方法将尝试加载资源的顺序如下：

• Thread.currentThread().getContextClassLoader()
• ResourceLoader.class.getClassLoader()
• callingClass.getClassLoader()

参数:

resourceName - 需要加载的资源名称

aggregate - aggregate

返回:

资源路径的迭代器

抛出:

java.io.IOException - IO异常

getResources

public static java.util.Iterator<java.net.URL> getResources(java.lang.String resourceName,
                                                            java.lang.Class<?> callingClass,
                                                            boolean aggregate)
                                                     throws java.io.IOException

加载给定名称的所有资源，将搜索类加载器或得的所有结果汇总. 如果没有发现结果，如果资源文件不是以'/'开头，则在资源名称前加前缀'/'，并再次查找。 此方法将尝试加载资源的顺序如下：

• Thread.currentThread().getContextClassLoader()
• ResourceLoader.class.getClassLoader()
• callingClass.getClassLoader()

参数:

resourceName - 需要加载的资源名称

callingClass - 调用对象的class

aggregate - aggregate

返回:

资源路径的迭代器

抛出:

java.io.IOException - IO异常

getResource

public static java.net.URL getResource(java.lang.String resourceName)

加载给定的资源. 此方法将尝试加载资源的顺序如下：

• 从 Thread.currentThread().getContextClassLoader() 加载
• 从 ResourceLoader.class.getClassLoader() 加载
• callingClass.getClassLoader()

参数:

resourceName - 需要加载的资源名称

返回:

资源路径

getResourceAsStream

public static java.io.InputStream getResourceAsStream(java.lang.String resourceName)

这是一个用来方便的加载流资源的方法. 用于查找资源的算法在getResource（）中给出了

参数:

resourceName - 需要加载的资源名称

返回:

资源输入流

getResource

public static java.net.URL getResource(java.lang.String resourceName,
                                       java.lang.Class<?> callingClass)

加载给定的资源. 此方法将尝试加载资源的顺序如下：

• 从 Thread.currentThread().getContextClassLoader() 加载
• 从 ResourceLoader.class.getClassLoader() 加载
• callingClass.getClassLoader()

参数:

resourceName - 需要加载的资源名称

callingClass - 调用对象的class

返回:

资源路径

getResourceAsStream

public static java.io.InputStream getResourceAsStream(java.lang.String resourceName,
                                                      java.lang.Class<?> callingClass)

这是一个用来方便的加载流资源的方法. 用于查找资源的算法在getResource（）中给出了

参数:

resourceName - 需要加载的资源名称

callingClass - 调用对象的class

返回:

资源输入流

loadClass

public static java.lang.Class<?> loadClass(java.lang.String className,
                                           java.lang.Class<?> callingClass)
                                    throws java.lang.ClassNotFoundException

使用传入的名称加载类（class）. 加载的顺序如下所示：

• 从 Thread.currentThread().getContextClassLoader() 加载
• 使用 Class.forName() 加载
• 从 ResourceLoader.class.getClassLoader() 加载
• callingClass.getClassLoader()

参数:

className - 需要加载的类（class）名称

callingClass - 调用类或对象的class属性

返回:

加载的类

抛出:

java.lang.ClassNotFoundException - 如果从以上提供的几个地方都未加载到，则抛出.

printClassLoader

public static void printClassLoader()

打印输出当前类加载器的层次结构 - 调试很有用.

printClassLoader

public static void printClassLoader(java.lang.ClassLoader cl)

打印输出给定类加载器的层次结构 - 调试很有用

参数:

cl - 给定的类加载器

showClassLoaderHierarchy

public static java.lang.String showClassLoaderHierarchy(java.lang.Object obj,
                                                        java.lang.String role)

显示类加载器的层次结构. 使用默认换行符和制表符的文本字符.

参数:

obj - 对象层次结构的分析装载机

role - 当前类在应用程序中作用的说明 （例如，"servlet"或"EJB"的引用）

返回:

一个字符串，显示这个类的类加载器层次结构

showClassLoaderHierarchy

public static java.lang.String showClassLoaderHierarchy(java.lang.Object obj,
                                                        java.lang.String role,
                                                        java.lang.String lineBreak,
                                                        java.lang.String tabText)

显示类加载器的层次结构.

参数:

obj - 对象层次结构的分析装载机

role - 当前类在应用程序中作用的说明 （例如，"servlet"或"EJB"的引用）

lineBreak - 设置断行符

tabText - 设置tabText文本使用的标签

返回:

一个字符串，显示这个类的类加载器层次结构

showClassLoaderHierarchy

public static java.lang.String showClassLoaderHierarchy(java.lang.ClassLoader cl)

显示给定类加载器的层次结构. 使用默认换行符和制表符的文本字符.

参数:

cl - 需要分析的classLoader

返回:

一个字符串，显示这个类的类加载器层次结构

showClassLoaderHierarchy

public static java.lang.String showClassLoaderHierarchy(java.lang.ClassLoader cl,
                                                        java.lang.String lineBreak,
                                                        java.lang.String tabText)

显示给定类加载器的层次结构.

参数:

cl - 需要分析的classLoader

lineBreak - 设置断行符

tabText - 设置tabText文本使用的标签

返回:

一个字符串，显示这个类的类加载器层次结构