关于本文
本文是之前写的Developing Equinox/Spring-osgi/Spring Framework Web Application系列的升级版,Tomcat-OSGi的基础Demo之一,主要演示传统web application到OSGi application的转换,由于是升级版,所以本文的侧重点不再是基础配置的演示。
一、准备工作
1,JDK 1.6
2,Eclipse 3.4-jee
3,Spring-framework-2.5.6
4,spring-osgi-1.2.0
5, org.eclipse.equinox源码,可从 :pserver:anonymous@dev.eclipse.org:/cvsroot/rt 中获得
二、显示首页中的几个问题
1. ClassNotFoundException: org.springframework.web.servlet.view.InternalResourceViewResolver
META-INF/dispatcher/petstore-servlet.xml中定义的bean:
<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
<property name="prefix" value="/web/jsp/spring/"/>
<property name="suffix" value=".jsp"/>
</bean>
在之前的版本中,这里是没有问题的,可是在spring-osgi-1.2.0中,却会有这个问题,这是因为缺少一个
DynamicImport-Package: *
为何要使用动态引入?
因为无法在spring-beans中import定义的bean,因此如果不使用动态引入,那么spring-beans就无法load定义的bean,而下面统一使用spring-core中的ClassUtils.forName来查找bean class,是一个非常好的做法。
spring-beans中是这样load一个bean的
Class resolvedClass = ClassUtils.forName("org.springframework.web.servlet.view.InternalResourceViewResolver", loader);
Thread.currentThread().getContextClassLoader()中的ClassLoader是org.eclipse.core.runtime.internal.adaptor.ContextFinder,它是osgi framework的classloader,它通过查找类调用堆中距离本次loadClass调用最近的DefaultClassLoader(bundle的classloader)去加载一个类。
DefaultClassLoader中封装了ClassLoaderDelegate(BundleLoader)查找类的过程
spring-beans加载bean class的过程:
读取配置文件 -> 发现一个bean配置 -> 通过ClassUtils加载 -> 使用Thread.currentThread().getContextClassLoader()加载bean class
ContextFinder加载bean class的过程:
从类调用堆中找到距离最近DefaultClassLoader,使用ClassUtils的DefaultClassLoader来加载bean class -> 使用ClassUtils所在bundle的BundleLoader去查找一个类
BundleLoader加载bean class的过程在OSGi规范中有比较详细的介绍,这里主要看一下动态引入
private PackageSource findDynamicSource(String pkgName) {
if (isDynamicallyImported(pkgName)) {
ExportPackageDescription exportPackage = bundle.getFramework().getAdaptor().getState().linkDynamicImport(proxy.getBundleDescription(), pkgName);
if (exportPackage != null) {
PackageSource source = createExportPackageSource(exportPackage, null);
synchronized (this) {
if (importedSources == null)
importedSources = new KeyedHashSet(false);
}
synchronized (importedSources) {
importedSources.add(source);
}
return source;
}
}
return null;
}
现在,spring-bean是如何加载一个bean的过程就变得非常明了了,ClassUtils在spring-core中,当使用spring-core的BundleLoader去加载一个bean class时,如果没有动态引入,则会出现找不到class的情况。
很明显,spring-osgi-1.2.0中的spring-core并没有配置动态引入,在这个版本中或许是通过操作classloader来实现bean的加载,这个没有研究。
同理,对于数据库驱动找不到的问题,也可以这样来解决。
2. 找不到tld
index.jsp中包含了2个标签库,在上一个版本中,将其放入/web/WEB-INF目录中就可以正常显示,可是在新版本中却不行。
当一个对jsp的请求到达时,先将jsp生称java文件,之后进行编译。而生称java文件时,需要处理tld资源。
tld资源路径的处理是由TldLocationsCache来完成的,当它第一次初始化时,会在 "/WEB-INF/",classpath中的jar包,web.xml中查找tld文件并缓存起来。
private void init() throws JasperException {
if (initialized) return;
try {
processWebDotXml();
scanJars();
processTldsInFileSystem("/WEB-INF/");
initialized = true;
} catch (Exception ex) {
throw new JasperException(Localizer.getMessage(
"jsp.error.internal.tldinit", ex.getMessage()));
}
}
这里主要看一下为什么这个版本中直接将tld文件放入/web/WEB-INF目录中会提示找不到tld
processWebDotXml()方法是处理web.xml的
scanJars()是处理classpath资源
processTldsInFileSystem("/WEB-INF/"); 是查找web-inf目录中的tld (这个方法在equinox部分的实现上行不通)
在方法processTldsInFileSystem("/WEB-INF/")中使用的是当前Servlet的ServletContext.getResourcePaths()方法来获取web-inf目录中的tld资源,注册equinox-JspServlet的过程中,做了2层封装,ServletRegistration和org.eclipse.equinox.jsp.jasper.JspServlet,分别生成了2个ServletConfig和ServletContext,大概过程如下:
ProxyServlet:
//Effective registration of the servlet as defined HttpService#registerServlet()
synchronized void registerServlet(String alias, Servlet servlet, Dictionary initparams, HttpContext context, Bundle bundle) throws ServletException, NamespaceException {
checkAlias(alias);
if (servlet == null)
throw new IllegalArgumentException("Servlet cannot be null"); //$NON-NLS-1$
ServletRegistration registration = new ServletRegistration(servlet, proxyContext, context, bundle, servlets);
registration.checkServletRegistration();
ServletContext wrappedServletContext = new ServletContextAdaptor(proxyContext, getServletContext(), context, AccessController.getContext());
ServletConfig servletConfig = new ServletConfigImpl(servlet, initparams, wrappedServletContext);
registration.init(servletConfig);
registrations.put(alias, registration);
}
equinox-JspServlet:
public void init(ServletConfig config) throws ServletException {
ClassLoader original = Thread.currentThread().getContextClassLoader();
try {
Thread.currentThread().setContextClassLoader(jspLoader);
jspServlet.init(new ServletConfigAdaptor(config));
} finally {
Thread.currentThread().setContextClassLoader(original);
}
}
那么processTldsInFileSystem("/WEB-INF/")方法中的ServletContext就是从equinox-JspServlet$ServletContextAdaptor开始的
public Set getResourcePaths(String name) {
Set result = delegate.getResourcePaths(name);
Enumeration e = bundle.findEntries(bundleResourcePath + name, null, false);
if (e != null) {
if (result == null)
result = new HashSet();
while (e.hasMoreElements()) {
URL entryURL = (URL) e.nextElement();
result.add(entryURL.getFile().substring(bundleResourcePath.length()));
}
}
return result;
}
代码中的bundleResourcePath,就是注册这个Servlet填写的alias——/web/jsp
现在,已经了解如何查找tld了,只要将/WEB-INF目录放入/web/jsp中就可以了或者注册servlet的时候这样写:
httpService.registerResources("/", "/web", null);
httpService.registerServlet("/*.jsp", new JspServlet(context .getBundle(), "/web"), null, null);
为何上一个版本可以呢?时间距离太远,也不太好找源码,所以没有研究这部份,我猜测应该是在scanJars()方法中,通过classloader的URLs遍历来获取的,
equinox在处理相同HttpContext的ServletContext时,只是将attributes共享,而并没有共享资源访问,在这个例子中,应该是将相同HttpContext中的资源遍历,在Tomcat-OSGi中,使用的是naming.DirContext去处理资源的查找。
3. SpringMVC中的Controller 的问题
在上一个版本中,对于无法找到Controller的问题,是通过BundleContextAware来解决的,因为它是在Spring-OSGi中完成,因此其本质就是修改ClassLoader来解决的。
而更好的解决办法其实是export controller所在的package,使用动态引入功能,因为Spring-bean都是通过Spring-core中的ClassUtils.forName来查找的。
4. DispatcherServlet中的URI-Bean与osgi-bean引用的问题
DispatcherServlet dispatcherServlet = new DispatcherServlet();
dispatcherServlet.setContextConfigLocation("META-INF/dispatcher/petstore-servlet.xml");
DispatcherServlet读取配置文件中的bean,存放于DispatcherServlet的ApplicationContext的BeanFactory中,某个bean需要使用到OSGi的bean 引用时,例如:
<osgi:reference id="petStoreOsgi"
interface="org.extwind.osgi.demo.jpetstoreosgi.domain.logic.PetStoreFacade" />
<bean name="/shop/viewCategory.do"
class="org.extwind.osgi.demo.jpetstoreosgi.springmvc.controller.ViewCategoryController">
<property name="petStore" ref="petStoreOsgi" />
</bean>
可以看到/shop/viewCategory.do是一个bean,它被保存在DispatcherServlet的ApplicationContext中,
osgi bean引用petStoreOsgi是存放在bundle的ApplicationContext中,这2个ApplicationContext并没有关联,因此无法找到。
这个两个ApplicationContext的创建顺序是这样的:
1. 程序中注册DispatcherServlet后,它被初始化时创建ApplicationContext,加载contextConfigLocation中定义的bean
2. Spring-OSGi当监听到bundle started的事件时,为该bundle创建ApplicationContext,加载bundle中/META-INF/spring/*.xml中定义的bean
因此,这个问题的解决办法就是,让DispatcherServlet的ApplicationContext在bundle的ApplicationContext之后创建,并设置成parent-child关系
实际上这个问题应该是由mvc框架去考虑的,在Spring-OSGi的文档中有解决方法,它是通过OsgiBundleXmlWebApplicationContext来实现的,也就是说它无法在本例中使用,因为当DispatcherServlet被初始化时,使用的Equinox的ServletConfig。
>
如何让bundle的ApplicationContext成为DispatcherServlet的ApplicationContext的parent?
在DispatcherServlet的ApplicationContext在创建时的部分代码如下:
FrameworkServlet.java
/** *//**
* Initialize and publish the WebApplicationContext for this servlet.
* <p>Delegates to {@link #createWebApplicationContext} for actual creation
* of the context. Can be overridden in subclasses.
* @return the WebApplicationContext instance
* @throws BeansException if the context couldn't be initialized
* @see #setContextClass
* @see #setContextConfigLocation
*/
protected WebApplicationContext initWebApplicationContext() throws BeansException {
WebApplicationContext wac = findWebApplicationContext();
if (wac == null) {
// No fixed context defined for this servlet - create a local one.
WebApplicationContext parent =
WebApplicationContextUtils.getWebApplicationContext(getServletContext());
wac = createWebApplicationContext(parent);
}
WebApplicationContextUtils.java
/** *//**
* Find the root WebApplicationContext for this web application, which is
* typically loaded via {@link org.springframework.web.context.ContextLoaderListener} or
* {@link org.springframework.web.context.ContextLoaderServlet}.
* <p>Will rethrow an exception that happened on root context startup,
* to differentiate between a failed context startup and no context at all.
* @param sc ServletContext to find the web application context for
* @return the root WebApplicationContext for this web app, or <code>null</code> if none
* @see org.springframework.web.context.WebApplicationContext#ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE
*/
public static WebApplicationContext getWebApplicationContext(ServletContext sc) {
return getWebApplicationContext(sc, WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE);
}
可以看到,使用的是ServletContext的属性来存放ApplicationContext,因此在ApplicationContextAware.setApplicationContext(ApplicationContext bundleApplicationContext)中,可以通过下面的代码来设置:
HttpServlet tmpHttpServlet = new HttpServlet() {
public void init(ServletConfig config) {
// config.getServletContext().setAttribute(OsgiBundleXmlWebApplicationContext.BUNDLE_CONTEXT_ATTRIBUTE,
// bundleContext);
OsgiBundleXmlWebApplicationContext webApplicationContext = new OsgiBundleXmlWebApplicationContext() {
protected String[] getDefaultConfigLocations() {
return new String[0];
}
};
webApplicationContext.setParent(applicationContext);
webApplicationContext.setServletContext(config.getServletContext());
webApplicationContext.refresh();
config.getServletContext().setAttribute(
WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE,
webApplicationContext);
}
};
httpService.registerServlet("/init-context-loader-petsore-web", tmpHttpServlet, null,
httpContext);
让tmpHttpServlet和DispatcherServlet具有相同的HttpContext,那么DispatcherServlet就可以得到parent-ApplicationContext了。
>如何让DispatcherServlet的ApplicationContext在bundle的ApplicationContext之后创建?
按照上一个版本中的方法,使用spring中的ApplicationContextAware接口,在这个接口的setParentApplicationContext方法之后,进行资源注册。
这里需要注意的是在bundle停止时注销注册的资源
以上几点基本就是在新版中遇到的问题。
Demo下载:
http://extwind.googlecode.com/svn/JPetStoreOSGi_Workspace.rar
如何使用这个Demo:
建议新建一个workspace,java编译器需要6.0版本
将所有的bundles导入后,需要再将 org.extwind.osgi.demo.jpetstoreosgi.launcher 导入
本例中不包含DB数据,因此还需要准备Spring 2.5.6中的jpetstore
运行 spring-framework-2.5.6\samples\jpetstore\db\hsqldb\server.bat
在Eclipse中运行 org.extwind.osgi.demo.jpetstoreosgi.launcher.Launcher
访问首页地址:http://localhost/shop/index.do
-----------------------------------------------------------------------------------------------------------
稍后将介绍如何在Tomcat-OSGi中使用JPetStoreOSGi
posted on 2009-04-19 03:31
Phrancol Yang 阅读(4471)
评论(6) 编辑 收藏 所属分类:
OSGI