equinox环境下web应用资源的部署

osgi的equinox实现环境下，web服务器和web应用都是以osgi的bundle的形式部署到equinox环境中的。

在equinox下部署web服务器的资源与非equinox(osgi)环境下有一些不同，这为使用Spring+Struts+Hibernate的应用向equinox环境转移带来了一定的困难。而在spring中使用acegi的应用的转换麻烦要更多一些。

equinox环境自带了jetty 5.X 作为默认的web服务器。

OSGi中在org.osgi.service.http.HttpService接口中提供向web服务器部署资源的两个方法：registerServlet(...)和registerResources(...)，为了看得清晰省略了两个方法中的形参列表，在下面会给出。

从这两个方法的命名上可以看出，equinox实现了HttpService接口的类，可以提供两种类型资源的部署(或者说注册)，一种是静态资源Resources对应registerResources(...)方法；另一种是动态资源Servlet对应registerServlet(...)。

1、注册静态资源

registerResources(String alias, String name, HttpContext context)

静态的资源是以文件形式存在的、能被web服务程序以文件流的形式读取的内容。比如，html,image,css,javascript,properties等静态的文件。

参数说明：

A、alias

alias 是请求的URL中的一部分，可以理解为URL相对路径。
比如，访问http://www.teamlet.org/index.html ，那么alias可以设置为 /index.html

约束：这个参数必须以"/"作为字符串的开始，可以是 "/",但是不可以以"/"结尾。
并且同一个alias不能注册两次。

正确的例子：  alias="/";              alias="/index.html";    alias="/test/index.html";

错误的例子： alias="test";         alias="/test/"

B、name

name是alias指定的文件的本地路径。
比如，alias为 /test.html ，而实际保存在bundle中根目录下的webroot中，因此name设定为 /webroot 。

C、context

context 是当前bundle中的上下文内容，可以设为null。当设定为null，环境将自动生成一个默认的context。
会在后面的介绍中详细说明自定义context的用法。

2、注册动态资源

registerServlet(String alias, Servlet servlet, Dictionary initparams, HttpContext context)

其他非静态资源都以servlet的形式部署(注册)。比如，serlvet，filter，listener等。

registerServlet 方法的第二个参数要求是Servlet类型的参数，因此如果注册listener、filter或者静态的内容等需要使用由equinox提供的Servlet适配器。

 

equinox提供了几个servlet的适配器(adaptor)，以满足需要初始参数的servlet、需要contextPath的servlet以及Listener和Filter的注册需要。

由于web服务器--jetty和web应用是分别处在不同的bundle中，每个bundle都是由独立的classLoader来加载资源的，所以，即使在web应用的bundle内通过Spring将servlet、fitler、listener加载，对于web服务器--jetty的bundle来说也是不可见的。必须使用registerServlet进行部署才能让jetty识别servlet、listener和filter。

在jetty的资源部署时，一个URL的相对路径(即registerSerlvet和registerResources两个方法的参数alias)只能用一次。如果有两个servlet或者资源对应一个URL的相对路径就会报错。

Filter也存在同样的问题。用FilterServletAdaptor可以将一个servlet和Filter串接起来，在servlet之前先执行filter,然后servlet再处理。多个Filter的串接需要借助其他的方式实现(后面会在其他文章中说明)。这个filter的串接在acegi中是要使用的。

Acegi是通过FilterToBeanProxy将Servlet容器和Spring容器结合起来。FilterToBeanProxy将拦截的请求通过filterChainProxy发给一串filter处理。在非OSGi的环境中，由于是一个jvm环境，web服务器可以识别并使用由spring载入的filter链，而在equinox环境中web服务器--jetty无法使用另一个bundle中未经过registerServlet注册的任何servlet和filter。因此需要使用equinox提供的几个ServletAdaptor来处理。

更多使用举例和方法说明请见后续文章。

<完>