com.alibaba.jvm.sandbox.api.resource

接口 ModuleManager

public interface ModuleManager

模块管理器

作者:

luanjia@taobao.com

方法概要

限定符和类型	方法和说明
void	active(String uniqueId) 激活模块 激活的模块能正常的感知Event
int	cCnt(String uniqueId) 获取模块当前渲染的类个数
void	flush(boolean isForce) 刷新沙箱模块 刷新沙箱模块将会对当前已经加载的用户模块进行卸载并再次重新加载, 通常用于模块JAR文件更新之后对模块进行再次的重新加载
void	frozen(String uniqueId) 冻结模块 冻结的模块将不会感知到Event,但代码的插桩还在
Module	get(String uniqueId) 获取模块
File	getJarFile(String uniqueId) 获取模块所在的Jar文件
boolean	isActivated(String uniqueId) 获取模块激活状态，判断当前模块是否已经被激活
boolean	isLoaded(String uniqueId) 获取模块加载状态，判断当前模块是否已经被加载
Collection<Module>	list() 列出所有的模块
int	mCnt(String uniqueId) 获取模块当前渲染的方法个数
void	reset() 沙箱模块重置 沙箱模块重置时会强制冻结和强制卸载当前所有模块，并对系统模块和用户模块进行重新加载; 加载过程中如果发生模块加载失败，则主动忽略掉加载失败的模块
void	unload(String uniqueId) 卸载指定模块

方法详细资料

flush

void flush(boolean isForce)
    throws ModuleException

刷新沙箱模块

刷新沙箱模块将会对当前已经加载的用户模块进行卸载并再次重新加载, 通常用于模块JAR文件更新之后对模块进行再次的重新加载

参数:

isForce - 是否强制刷新

强制刷新将会强制卸载所有已经加载的用户模块，并重新加载当前用户模块目录下所有的模块

普通刷新将会寻找变动的用户模块文件，对已经加载但模块文件已经变动（删除or变更）的模块进行卸载。 并重新加载当前用户模块目录中新增的模块

抛出:

ModuleException - 刷新模块失败

reset

void reset()
    throws ModuleException

沙箱模块重置 沙箱模块重置时会强制冻结和强制卸载当前所有模块，并对系统模块和用户模块进行重新加载; 加载过程中如果发生模块加载失败，则主动忽略掉加载失败的模块

抛出:

ModuleException - 模块重启失败

unload

void unload(String uniqueId)
     throws ModuleException

卸载指定模块

参数:

uniqueId - 模块ID

抛出:

ModuleException - 卸载模块失败

active

void active(String uniqueId)
     throws ModuleException

激活模块 激活的模块能正常的感知Event

参数:

uniqueId - 模块ID

抛出:

ModuleException - 激活模块失败

frozen

void frozen(String uniqueId)
     throws ModuleException

冻结模块 冻结的模块将不会感知到Event,但代码的插桩还在

参数:

uniqueId - 模块ID

抛出:

ModuleException - 冻结模块失败

list

Collection<Module> list()

列出所有的模块

返回:

模块集合

get

Module get(String uniqueId)

获取模块

参数:

uniqueId - 模块ID

返回:

模块

cCnt

int cCnt(String uniqueId)
  throws ModuleException

获取模块当前渲染的类个数

参数:

uniqueId - 模块ID

返回:

模块当前渲染的类个数

抛出:

ModuleException - 模块不存在

mCnt

int mCnt(String uniqueId)
  throws ModuleException

获取模块当前渲染的方法个数

参数:

uniqueId - 模块ID

返回:

模块当前渲染的方法个数

抛出:

ModuleException - 模块不存在

isActivated

boolean isActivated(String uniqueId)
             throws ModuleException

获取模块激活状态，判断当前模块是否已经被激活

参数:

uniqueId - 模块ID

返回:

true:已激活;false:未激活

抛出:

ModuleException - 模块不存在

isLoaded

boolean isLoaded(String uniqueId)
          throws ModuleException

获取模块加载状态，判断当前模块是否已经被加载

参数:

uniqueId - 模块ID

返回:

true:已加载;false:未加载

抛出:

ModuleException - 模块不存在

getJarFile

File getJarFile(String uniqueId)
         throws ModuleException

获取模块所在的Jar文件

参数:

uniqueId - 模块ID

返回:

模块所在的Jar文件

抛出:

ModuleException - 模块不存在