com.alipay.sofa.ark.spi.service.classloader

接口 ClassLoaderHook<T>

类型参数:

T - Plugin or Biz

@Extensible
public interface ClassLoaderHook<T>

implementation of ClassLoaderHook is used to customize the strategy of loading class and resources.

从以下版本开始:

0.6.0

作者:

qilong.zql

方法概要

限定符和类型	方法和说明
Class<?>	postFindClass(String name, ClassLoaderService classLoaderService, T t) This method will only be called if no class was found from the normal loading process.
URL	postFindResource(String name, ClassLoaderService classLoaderService, T t) This method will only be called if no resource was found from the normal loading process.
Enumeration<URL>	postFindResources(String name, ClassLoaderService classLoaderService, T t) This method will only be called if no resources were found from the normal loading process.
Class<?>	preFindClass(String name, ClassLoaderService classLoaderService, T t) invoke this method before load class using biz classLoader or plugin classLoader.
URL	preFindResource(String name, ClassLoaderService classLoaderService, T t) invoke this method before load resource using biz classLoader or plugin classLoader.
Enumeration<URL>	preFindResources(String name, ClassLoaderService classLoaderService, T t) If this method returns null then normal loading process is done.

方法详细资料

preFindClass

Class<?> preFindClass(String name,
                      ClassLoaderService classLoaderService,
                      T t)
               throws ClassNotFoundException

invoke this method before load class using biz classLoader or plugin classLoader. If this method returns null then normal loading process is done. If this method returns a non-null value then the rest of the loading process is skipped and the returned value is used.

参数:

name - class name

classLoaderService - ClassLoaderService

t - plugin or biz instance where this hook is invoked

返回:

the class found by this hook or null if normal loading process should continue

抛出:

ClassNotFoundException - to terminate the hook and throw an exception

postFindClass

Class<?> postFindClass(String name,
                       ClassLoaderService classLoaderService,
                       T t)
                throws ClassNotFoundException

This method will only be called if no class was found from the normal loading process.

参数:

name - class name

classLoaderService - ClassLoaderService

t - plugin or biz instance where this hook is invoked

返回:

the class found by this hook or null if normal loading process should continue

抛出:

ClassNotFoundException - to terminate the hook and throw an exception

preFindResource

URL preFindResource(String name,
                    ClassLoaderService classLoaderService,
                    T t)

invoke this method before load resource using biz classLoader or plugin classLoader. If this method returns null then normal loading process is done. If this method returns a non-null value then the rest of the loading process is skipped and the returned value is used.

参数:

name - resource name

classLoaderService - ClassLoaderService

t - plugin or biz instance where this hook is invoked

返回:

the resource found by this hook or null if normal loading process should continue

postFindResource

URL postFindResource(String name,
                     ClassLoaderService classLoaderService,
                     T t)

This method will only be called if no resource was found from the normal loading process.

参数:

name - resource name

classLoaderService - ClassLoaderService

t - plugin or biz instance where this hook is invoked

返回:

the resource found by this hook or null if normal loading process should continue

preFindResources

Enumeration<URL> preFindResources(String name,
                                  ClassLoaderService classLoaderService,
                                  T t)
                           throws IOException

If this method returns null then normal loading process is done. If this method returns a non-null value then the rest of the loading process is skipped and the returned value is used. If this method throws an FileNotFoundException then the loading process is terminated

参数:

name - the name of the resource to find

classLoaderService - ClassLoaderService

t - plugin or biz instance where this hook is invoked

返回:

the resources found by this hook or empty if normal loading process should continue

抛出:

IOException - throw an exception when error occurs.

postFindResources

Enumeration<URL> postFindResources(String name,
                                   ClassLoaderService classLoaderService,
                                   T t)
                            throws IOException

This method will only be called if no resources were found from the normal loading process.

参数:

name - the name of the resource to find

classLoaderService - ClassLoaderService

t - plugin or biz instance where this hook is invoked

返回:

the resources found by this hook or empty if normal loading process should continue

抛出:

IOException - throw an exception when error occurs.