對于想使用Equinox來構(gòu)建OSGi應(yīng)用的同學(xué)們而言,掌握Equinox是如何加載Bundle中的Class無疑是相當(dāng)重要的,這樣在碰到各類ClassNotFoundException的時(shí)候也就有底了,否則可能出現(xiàn)的ClassNotFoundException會(huì)多的讓你非常的頭疼,本文提取自《OSGi原理與最佳實(shí)踐》,介紹下equinox是如何來加載Bundle中的class的。
Equinox在創(chuàng)建Bundle的ClassLoader時(shí),首先獲取bundle的classpath,然后執(zhí)行createBCLPrevileged方法,此方法最后轉(zhuǎn)交由BaseData來創(chuàng)建ClassLoader。
BaseDate創(chuàng)建ClassLoader的關(guān)鍵代碼片段為:
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中,默認(rèn)的情況下adaptor.getBundleClassLoaderParent返回的為bootstrap
classloader,可通過修改啟動(dòng)的osgi.parentClassLoader來改變這個(gè)parent
classloader,默認(rèn)值采用的boot,可選的其他值有:app、ext和fwk,app對應(yīng)的為SystemClassLoader,ext對應(yīng)的為SystemClassLoader的parent,fwk對應(yīng)的為啟動(dòng)Equinox的ClassLoader,ClassLoadingHook在createClassLoader的時(shí)候都沒有做動(dòng)作,因此最后ClassLoader都是通過創(chuàng)建DefaultClassLoader對象來構(gòu)建的,其中parent參數(shù)為null,delegate參數(shù)為BundleLoader實(shí)例,bundleclasspath參數(shù)為bundle的classpath。
經(jīng)過以上步驟后,完成了ClassLoader的創(chuàng)建,可以開始加載class了,根據(jù)上面上述,Bundle的Class就由DefaultClassLoader來完成了。
查看DefaultClassLoader的loadClass代碼,發(fā)現(xiàn)真正的加載class的過程是轉(zhuǎn)為調(diào)用了delegate的findClass來完成的,delegate參數(shù)對應(yīng)的為BundleLoader實(shí)例,轉(zhuǎn)為跟蹤BundleLoader的findClass方法。
BundleLoader的findClass方法的代碼片段:
if
(checkParent && parentCL != null
&& name.startsWith(JAVA_PACKAGE))
return parentCL.loadClass(name);
從以上這個(gè)代碼片段,可以看到,Equinox將java.開頭的類轉(zhuǎn)交給了parent
classloader去加載,這也意味著沒必要在系統(tǒng)中提供對外export java.開頭的package。
如果不是java.開頭的類,則交由findClassInternal方法來完成加載。
findClassInternal方法遵循的為OSGi規(guī)范中定義的Class的加載順序,不過仍然稍有改動(dòng):
1)
判斷是否交由parent classloader去完成加載
在啟動(dòng)Equinox時(shí),Equinox會(huì)讀取org.osgi.framework.bootdelegation屬性,該屬性對應(yīng)配置的為需要從parent classloader中加載的package,如值配置的為*,說明所有的都從parent classloader中加載,如值配置的為具體的package,那么則放入bootDelegation集合;如配置的為帶通配符的package,那么則放入bootDelegationStems集合。
判斷時(shí)Equinox首先判斷是否所有的都從parent
classloader中加載,如是則從parent classloader中加載;
如需要加載的類的package位于bootDelegation或bootDelegationStems集合中,那么同樣從parent
classloader中加載。
如不從parent
classloader中加載,則進(jìn)入下面的步驟。
2)
嘗試調(diào)用Equinox提供的ClassLoaderDelegateHook的擴(kuò)展來加載
Equinox對外提供了ClassLoaderDelegateHook的接口擴(kuò)展,可編寫ClassLoaderDelegateHook的實(shí)現(xiàn),注冊到Framework中,那么當(dāng)有Class需要加載等動(dòng)作時(shí)都會(huì)得到通知。
在默認(rèn)情況下,Equinox中沒有ClassLoaderDelegateHook的實(shí)現(xiàn),因此繼續(xù)下面的步驟。
3)
判斷是否在import-package中,如在則交由相應(yīng)的PackageSource去加載
根據(jù)Bundle配置的import-package,判斷目前需要加載的類是否在import-package中,如在則交由對應(yīng)的PackageSource進(jìn)行加載,PackageSource在加載時(shí)即直接交由對應(yīng)的Bundle的classloader去加載,如加載的類的package在import-package中,但加載后仍然沒有找到Class,則直接拋出ClassNotFoundException,如加載到,則直接返回。
如所需要加載的類不的package不在import-package中,則繼續(xù)下面的步驟。
4)
嘗試從require-bundle中加載
嘗試使用require-bundle來加載,如加載到,則直接返回,如加載不到,則繼續(xù)下面的步驟。
5)
嘗試從當(dāng)前Bundle中加載
直到經(jīng)過以上步驟的嘗試,才嘗試由當(dāng)前Bundle中加載,當(dāng)前Bundle加載的方法即從Bundle-Classpath或當(dāng)前Bundle的Fragment中查找相應(yīng)名稱的class文件,并讀取該文件進(jìn)行加載,如class文件已加載,則進(jìn)行緩存,再次加載時(shí)則不需要查找和解析class文件。
如從當(dāng)前Bundle中仍然未找到所需的類,則繼續(xù)下面的步驟。
6)
嘗試從DynamicImport-Package中加載
判斷需要找的類的package是否在DynamicImport-Package中,如果在,則交由相應(yīng)的PackageSource進(jìn)行加載,如PackageSource中加載不到,則拋出ClassNotFoundException;如不在DynamicImport-Package中,則繼續(xù)下面的步驟。
7)
再次嘗試調(diào)用Equinox提供的ClassLoaderDelegateHook的擴(kuò)展來加載
這步和第2)步相同,因此在默認(rèn)情況下繼續(xù)下面的步驟。
8)
嘗試使用eclipse的buddy機(jī)制來加載
Buddy機(jī)制是Eclipse的擴(kuò)展,并不符合OSGi規(guī)范,因此在此不做深入分析。
9)
判斷一定的條件,如符合則從parent classloader中加載
判斷的條件為:parent
classloader不為null、不從parent classloader中加載、Equinox的向后兼容屬性(osgi.compatibility.bootdelegation)為true以及jvm的bug class,如滿足以上條件,則嘗試從parent
classloader中加載。
如經(jīng)過以上所有步驟后,仍然未找到需要加載的class,則拋出ClassNotFoundException。
從上面的代碼分析中,在Equinox中可以通過osgi.parentClassLoader、org.osgi.framework.bootdelegation來控制從Bundle ClassLoader外來加載Class,這對于集成Equinox其他容器而言,非常有用,另外,還可以通過實(shí)現(xiàn)ClassLoaderDelegateHook來改變Class的加載。