Equinox加载Bundle Class的实现 转载

本文详细介绍了Equinox如何加载Bundle中的Class,包括通过不同方式选择ClassLoader,利用org.osgi.framework.bootdelegation配置来控制加载过程,以及Class加载的具体流程。
Equinox加载Bundle Class的实现

对于想使用Equinox来构建OSGi应用的同学们而言,掌握Equinox是如何加载Bundle中的Class无疑是相当重要的,这样在碰到各类ClassNotFoundException的时候也就有底了,否则可能出现的ClassNotFoundException会多的让你非常的头疼,本文提取自《OSGi原理与最佳实践》,介绍下equinox是如何来加载Bundle中的class的。
Equinox在创建Bundle的ClassLoader时,首先获取bundle的classpath,然后执行createBCLPrevileged方法,此方法最后转交由BaseData来创建ClassLoader。

BaseDate创建ClassLoader的关键代码片段为:

ClassLoadingHook[] hooks = adaptor.getHookRegistry().getClassLoadingHooks();

ClassLoader parent = adaptor.getBundleClassLoaderParent();

BaseClassLoader cl = null;

for (int i = 0; i < hooks.length && cl == null; i++)

cl = hooks[i].createClassLoader(parent, delegate, domain, this, bundleclasspath);

if (cl == null)

cl = new DefaultClassLoader(parent, delegate, domain, this, bundleclasspath);

return cl;

在Equinox中,默认的情况下adaptor.getBundleClassLoaderParent返回的为bootstrap classloader,可通过修改启动的osgi.parentClassLoader来改变这个parent classloader,默认值采用的boot,可选的其他值有:app、ext和fwk,app对应的为SystemClassLoader,ext对应的为SystemClassLoader的parent,fwk对应的为启动Equinox的ClassLoader,ClassLoadingHook在createClassLoader的时候都没有做动作,因此最后ClassLoader都是通过创建DefaultClassLoader对象来构建的,其中parent参数为null,delegate参数为BundleLoader实例,bundleclasspath参数为bundle的classpath。

经过以上步骤后,完成了ClassLoader的创建,可以开始加载class了,根据上面上述,Bundle的Class就由DefaultClassLoader来完成了。

查看DefaultClassLoader的loadClass代码,发现真正的加载class的过程是转为调用了delegate的findClass来完成的,delegate参数对应的为BundleLoader实例,转为跟踪BundleLoader的findClass方法。

BundleLoader的findClass方法的代码片段:

if (checkParent && parentCL != null && name.startsWith(JAVA_PACKAGE))

return parentCL.loadClass(name);

从以上这个代码片段,可以看到,Equinox将java.开头的类转交给了parent classloader去加载,这也意味着没必要在系统中提供对外export java.开头的package。

如果不是java.开头的类,则交由findClassInternal方法来完成加载。

findClassInternal方法遵循的为OSGi规范中定义的Class的加载顺序,不过仍然稍有改动:

1) 判断是否交由parent classloader去完成加载

在启动Equinox时,Equinox会读取org.osgi.framework.bootdelegation属性,该属性对应配置的为需要从parent classloader中加载的package,如值配置的为*,说明所有的都从parent classloader中加载,如值配置的为具体的package,那么则放入bootDelegation集合;如配置的为带通配符的package,那么则放入bootDelegationStems集合。

判断时Equinox首先判断是否所有的都从parent classloader中加载,如是则从parent classloader中加载;

如需要加载的类的package位于bootDelegation或bootDelegationStems集合中,那么同样从parent classloader中加载。

如不从parent classloader中加载,则进入下面的步骤。

2) 尝试调用Equinox提供的ClassLoaderDelegateHook的扩展来加载

Equinox对外提供了ClassLoaderDelegateHook的接口扩展,可编写ClassLoaderDelegateHook的实现,注册到Framework中,那么当有Class需要加载等动作时都会得到通知。

在默认情况下,Equinox中没有ClassLoaderDelegateHook的实现,因此继续下面的步骤。

3) 判断是否在import-package中,如在则交由相应的PackageSource去加载

根据Bundle配置的import-package,判断目前需要加载的类是否在import-package中,如在则交由对应的PackageSource进行加载,PackageSource在加载时即直接交由对应的Bundle的classloader去加载,如加载的类的package在import-package中,但加载后仍然没有找到Class,则直接抛出ClassNotFoundException,如加载到,则直接返回。

如所需要加载的类不的package不在import-package中,则继续下面的步骤。

4) 尝试从require-bundle中加载

尝试使用require-bundle来加载,如加载到,则直接返回,如加载不到,则继续下面的步骤。

5) 尝试从当前Bundle中加载

直到经过以上步骤的尝试,才尝试由当前Bundle中加载,当前Bundle加载的方法即从Bundle-Classpath或当前Bundle的Fragment中查找相应名称的class文件,并读取该文件进行加载,如class文件已加载,则进行缓存,再次加载时则不需要查找和解析class文件。

如从当前Bundle中仍然未找到所需的类,则继续下面的步骤。

6) 尝试从DynamicImport-Package中加载

判断需要找的类的package是否在DynamicImport-Package中,如果在,则交由相应的PackageSource进行加载,如PackageSource中加载不到,则抛出ClassNotFoundException;如不在DynamicImport-Package中,则继续下面的步骤。

7) 再次尝试调用Equinox提供的ClassLoaderDelegateHook的扩展来加载

这步和第2)步相同,因此在默认情况下继续下面的步骤。

8) 尝试使用eclipse的buddy机制来加载

Buddy机制是Eclipse的扩展,并不符合OSGi规范,因此在此不做深入分析。

9) 判断一定的条件,如符合则从parent classloader中加载

判断的条件为:parent classloader不为null、不从parent classloader中加载、Equinox的向后兼容属性(osgi.compatibility.bootdelegation)为true以及jvm的bug class,如满足以上条件,则尝试从parent classloader中加载。

如经过以上所有步骤后,仍然未找到需要加载的class,则抛出ClassNotFoundException。

从上面的代码分析中,在Equinox中可以通过osgi.parentClassLoader、org.osgi.framework.bootdelegation来控制从Bundle ClassLoader外来加载Class,这对于集成Equinox其他容器而言,非常有用,另外,还可以通过实现ClassLoaderDelegateHook来改变Class的加载。
!SESSION 2025-08-25 10:13:42.641 ----------------------------------------------- eclipse.buildId=unknown java.version=1.8.0_291 java.vendor=Oracle Corporation BootLoader constants: OS=win32, ARCH=x86_64, WS=win32, NL=zh_CN Framework arguments: -application test.rcp.application Command-line arguments: -application test.rcp.application -data D:\eclipse4/../runtime-test.rcp.application -dev file:D:/eclipse4/.metadata/.plugins/org.eclipse.pde.core/test.rcp.application/dev.properties -os win32 -ws win32 -arch x86_64 -consoleLog !ENTRY org.eclipse.osgi 4 0 2025-08-25 10:13:43.553 !MESSAGE Application error !STACK 1 java.lang.NoClassDefFoundError: org/cef/CefApp at test.rcp.Application.start(Application.java:17) at org.eclipse.equinox.internal.app.EclipseAppHandle.run(EclipseAppHandle.java:203) at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.runApplication(EclipseAppLauncher.java:137) at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(EclipseAppLauncher.java:107) at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:400) at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:255) at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source) at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source) at java.lang.reflect.Method.invoke(Unknown Source) at org.eclipse.equinox.launcher.Main.invokeFramework(Main.java:659) at org.eclipse.equinox.launcher.Main.basicRun(Main.java:595) at org.eclipse.equinox.launcher.Main.run(Main.java:1501) at org.eclipse.equinox.launcher.Main.main(Main.java:1474) Caused by: java.lang.ClassNotFoundException: org.cef.CefApp cannot be found by test.rcp_1.0.0.qualifier at org.eclipse.osgi.internal.loader.BundleLoader.findClassInternal(BundleLoader.java:511) at org.eclipse.osgi.internal.loader.BundleLoader.findClass(BundleLoader.java:422) at org.eclipse.osgi.internal.loader.BundleLoader.findClass(BundleLoader.java:414) at org.eclipse.osgi.internal.loader.ModuleClassLoader.loadClass(ModuleClassLoader.java:153) at java.lang.ClassLoader.loadClass(Unknown Source) ... 14 more An error has occurred. See the log file D:\runtime-test.rcp.application\.metadata\.log.
最新发布
08-26
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值