OSGI下的web应用开发(3)

上节讲了如何对web应用进行大体的模块划分,现在开始进入正题,对本次应用进行开发。

首先需要知道应用最终有几个模块,如图


一共分为7个bundle,其中5个bundle上一节已经讲过了,为了让整个系统能够真正的运行起来,还需要domain bundle和datasource bundle。

domain bundle是将所有的域对象定义到一个模块中,这样可以被其余的任何模块进行访问,它是被除了datasource bundle外的所有模块所访问的,这里省略连接线;

datasource bundle是将datasource进行配置并以OSGI服务的方式发布,如果其它的模块需要直接访问datasource的时候,就引入该模块。

That‘s it!让我们开始进入开发!

Note:后面所有用到的bundle都可以到这个地址下载

http://ebr.springsource.com/repository/app/

这个是spring提供的庞大的第三方bundle的库,方便我们索取,不然就需要我们自己通过修改第三方的jar包将其变成一个bundle,这在有些时候是很可怕且繁琐且容易出错的操作!

除了Web bundle,其余的bundle都将是一个Spring DM Bundle,所以会spring的bundle project方式进行开发。

DataSource Bundle的开发

建议在spring perspective下进行开发,这也是STS的默认perspective,如图所示。


(1)新建一个Bundle Project,点击菜单new>>project,进入下图的对话框



 
 选择Bundle Project,然后点击Next,进入下图


输入project名,这里推荐使用顶层的包名作为项目名,便于查找维护项目。然后点击Next,进入下图



 symbolic-name会默认使用项目名,这里不需要做改变了,bundle name可以自行修改,只是用于描述而已。

Bundle version默认是1.0.0,也可以不用改。Modle Type不用选择,记得勾选Enable Bundle Classpath Container,这样才能引用其它的bundle进行import关联。target runtime也不需要管它,再次点击Next



 
 这里的class输出目录不需要做改变,默认就可以了,然后点击Finish,project 建立。

由于Datasource bundle只是配置一个可用的数据源并将它作为OSGI服务发布,所以这个工程下是没有源代码的,只有配置文件。项目的结构图如下



 
 项目默认会在src目录中生成META-INF目录,和MANIFEST.MF文件。为了让bundle成为一个spring bundle,我们需要在META-INF目录下创建spring目录,这样virgo server就能认出这个bundle是一个spring-powered bundle。

一般在spring目录下会有两个文件,一个是appContext.xml文件,另一个则是osgi-context.xml文件。其中appContext.xml文件用于配置当前bundle内定义的所有的bean,然后通过osgi-context.xml文件进行服务的发布或者引用。

(1)appContext.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd"
	xmlns:p="http://www.springframework.org/schema/p">

	<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource"
		p:driverClassName="com.mysql.jdbc.Driver"
		p:url="jdbc:mysql://localhost:3306/test?autoReconnect=true"
		p:username="root" p:password="111111" init-method="createDataSource"
		destroy-method="close" />

</beans>
 

这里定义了datasource的bean。

(2)osgi-context.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:osgi="http://www.springframework.org/schema/osgi"
	xmlns:context="http://www.springframework.org/schema/context"
	xsi:schemaLocation="http://www.springframework.org/schema/beans
		http://www.springframework.org/schema/beans/spring-beans.xsd
		http://www.springframework.org/schema/osgi
		http://www.springframework.org/schema/osgi/spring-osgi.xsd
		http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd">

	<osgi:service ref="dataSource" interface="javax.sql.DataSource"/>
		

</beans>

这里将定义好的datasource bean作为OSGI服务发布。

(3)MANIFEST.MF

我们还需要对此文件进行相应的配置才能让bundle正常发布运行,通过STS我们可以很方便的对这个文件进行编辑,尽量不要自己手动使用文本编辑该文件,因为它有很多格式限制。

如图


MANIFEST.MF打开后的编辑界面共有4个标签,分别Overview,Dependencies,Runtime, MANIFEST.MF

其中Overview就是对bundle的大致描述,比如可以编辑bundle-symbolic name(即ID),还有version等信息;

Dependencies则是用于配置import的依赖关系

Runtime则是用于设置export和bundle classpath的内容

而MANIFEST.MF则是最终生成的内容的文本内容,即文件的真面目。



 
 上图是dependencies的内容,可以看到有3个panel,分别是Import Package,Import Bundle和Import Library,每个panel都有4个按钮,Add,Download,Remove和Properties。

其中Import Bundle和Import Library是virgo server提供的,与Require-Bundle的头信息是不一样的,这两个内容实际上是为了简化Import Package,因为你可能会使用一个bundle中很多的package,

如果你一个个引入就很繁琐,你可以直接对整个bundle进行引入,当virgo遇到这个头信息时会将它自动拆解到Import Package中,所以这3个Import最终都会变成Import Package中的内容。所以Import Library是对一些bundle进行引入,而不用每个bundle来引入,这需要使用后缀名为.libd的文件来引入。spring本身提供了一个.libd文件用来引入整个spring库。

请记住,Import Bundle的内容和Import Library的内容最终还是会变成Import Package中的内容,所以跟OSGI中的Require-Bundle是不一样的。

4个按钮的作用分别是:

1)Add

用来添加可以查找到的package,bundle或者library

那么它是查找哪个位置的呢?它是查找virgo server的目录下的repository目录的,这里是用于存放virgo server运行时相关的bundle的地方,所以如果你有新的bundle(不管是第三方的还是自己的)需要引用,你需要将它bundle放置到repository目录中的某个子目录中(这个目录默认有两个子目录,一个是ext,一个是usr,推荐将bundle都放入ext中,或者重新配置usr的读取属性再放入usr中,这个内容将在后面如何操作virgo server的章节中详细介绍)。

2)Download

如果你没有需要的bundle,那么可以通过download去下载你需要的,不过不推荐在这里下载,这个按钮可以不管。

3)Remove

有添加就肯定可以移除,这个按钮就是用于移除你不需要的依赖引入。

4)Properties

这个按钮是用于编辑某个import的版本的范围和是否是optional的(即解析的时候是否忽略这个依赖的检查)

在Datasource bundle中,我们需要引入图中的package才能正常使用此bundle

(3.3)Runtime


如图,有2个panel,一个是Exported Packages,一个是Classpath

其中Exported Packages是用于曝露该bundle内的package给其它bundle进行import的,classpath panel则是设置Bundle-Classpath这个头信息的,它的内容是可以排序的,编辑的内容是属于本bundle内的目录路径或者是jar包。

Exported Packages中的4个按钮

1)Add

曝露bundle内的package

2)Remove

可增加就可以删除

3)Properteies

用于编辑曝露的package的版本

4)Caclculate Uses

跟import中的uses指令有关系的

这里Datasource bundle不需要配置任何的export

(3.4)MANIFEST.MF标签

通过上面的配置生成最终的内容如下图


至此,Datasource Bundle的开发就完成了。

这里附上当前项目的源代码

猜你喜欢

转载自georgezeng.iteye.com/blog/1129717