Fuse ESB Enterprise之OSGi Bunbdle部署模型

1.  Building an OSGi Bundle

     通过调用Maven Archetype生成Maven Project,例如：

     (1) Apache CXF code-first archetype

mvn archetype:generate -DarchetypeGroupId=org.apache.servicemix.tooling -DarchetypeArtifactId=servicemix-cxf-code-first-osgi-bundle -DarchetypeVersion=2012.01.0.fuse-7-060 -DgroupId=GroupId -DartifactId=ArtifactId -Dversion=Version

     (2) Apache CXF WSDL-first archetype

mvn archetype:generate -DarchetypeGroupId=org.apache.servicemix.tooling -DarchetypeArtifactId=servicemix-cxf-wsdl-first-osgi-bundle -DarchetypeVersion=2012.01.0.fuse-7-060 -DgroupId=GroupId -DartifactId=ArtifactId -Dversion=Version

     (3) Apache Camel archetype

mvn archetype:generate -DarchetypeGroupId=org.apache.servicemix.tooling -DarchetypeArtifactId=servicemix-camel-osgi-bundle -DarchetypeVersion=2012.01.0.fuse-7-061 -DgroupId=org.fusesource.example -DartifactId=camel-bundle

2.  Modifying an Existing Maven Project

     (1) Change the package type to bundle

<project .>
	...
	<packaging>bundle</packaging>
	...
</project>

     (2) Add the bundle plug-in to your POM

<project .>
	...
	<build>
		<defaultGoal>install</defaultGoal>
		<plugins>
			...
			<plugin>
				<groupId>org.apache.felix</groupId>
				<artifactId>maven-bundle-plugin</artifactId>
				<extensions>true</extensions>
				<configuration>
					<instructions>
						<Bundle-SymbolicName>${project.groupId}.${pro
							ject.artifactId}</Bundle-SymbolicName>
						<Import-Package>*</Import-Package>
					</instructions>
				</configuration>
			</plugin>
		</plugins>
	</build>
	...
</project>

     (3) Customize the JDK compiler version

<project .>
	...
	<build>
		<defaultGoal>install</defaultGoal>
		<plugins>
			...
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-compiler-plugin</artifactId>
				<configuration>
					<source>1.6</source>
					<target>1.6</target>
				</configuration>
			</plugin>
		</plugins>
	</build>
	...
</project>

3.  Packaging a Web Service in a Bundle

     (1) 修改pom.xml文件中的package类型为bundle

     (2) 添加CXF 运行需要的依赖：org.apache.cxf.bundle.

<project .>
	...
	<build>
		<plugins>
			<plugin>
				<groupId>org.apache.felix</groupId>
				<artifactId>maven-bundle-plugin</artifactId>
				<extensions>true</extensions>
				<configuration>
					<instructions>
						...
						<Require- Bundle>
							org.apache.cxf.bundle
						</Require-Bundle>
							...
					</instructions>
				</configuration>
			</plugin>
		</plugins>
	</build>
	...
</project>

     (3) 添加需要的Import-Package:

<project .>
	...
	<build>
		<plugins>
			<plugin>
				<groupId>org.apache.felix</groupId>
				<artifactId>maven-bundle-plugin</artifactId>
				<extensions>true</extensions>
				<configuration>
					<instructions>
						...
						<Import-Package>
							javax.jws,
							javax.wsdl,
							javax.xml.bind,
							javax.xml.bind.annotation,
							javax.xml.namespace,
							javax.xml.ws,
							META-INF.cxf,
							META-INF.cxf.osgi,
							org.apache.cxf.bus,
							org.apache.cxf.bus.spring,
							org.apache.cxf.bus.resource,
							org.apache.cxf.configuration.spring,
							org.apache.cxf.resource,
							org.apache.cxf.jaxws,
							org.springframework.beans.factory.config,
							*
						</Import-Package>
						...
					</instructions>
				</configuration>
			</plugin>
		</plugins>
	</build>
	...
</project>

4. Bundle 解析依赖问题

     常见的问题有下面几个：

     (1) Required features or bundles are not installed

     (2) Import-Package header is incomplete，主要注意下面几点：

     A. 确保 Import-Package中包含*

     B. Maven bundle plug-in无法计算出动态依赖

     C. Maven bundle plug-in无法计算META-INF/spring/下面的XML配置文件中所需的依赖

     D. Maven bundle plug-in可以计算出OSGI-INF/blueprint下面的XML配置文件中所需的依赖

     解决上述两个依赖问题的步骤：

     (1) 检查已经安装的Bundles和Festures:osgi:list,features:list

     (2) 安装但不启动Bundle:

     karaf@root> osgi:install MyBundleURL #生成Bundle Id:218

     (3) 使用下面的命令确保动态导入:

     karaf@root> dev:dynamic-import 218

     (4) 解析Bundle:

     karaf@root> osgi:resolve 218

     (5) 获取该Bundle所需的完整Import-Package:

     karaf@root> package:imports 218

     (6) 将上一步生成的Import-Package结果Copy至POM文件中的Maven bundle plug-in中的Import-Package处，

     重新打包工程并安装。

5. Deploying Features

     Fuse ESB Enterprise提供了一个灵活的部署单元：featurs，用于部署多个Bundle.

     (1) Creating a Feature:按照下面的步骤进行。

     A. Create a custom feature repository

     创建文件：C:\Projects\features.xml

<?xml version="1.0" encoding="UTF-8"?>
<features name="CustomRepository">
</features>

     B. Add a feature to the custom feature repository

<?xml version="1.0" encoding="UTF-8"?>
<features name="MyFeaturesRepo">
	<feature name="example-camel-bundle">
		<bundle>file:C:/Projects/camel-bundle/target/camel-bundle-1.0-SNAPSHOT.jar
		</bundle>
	</feature>
</features>

     检查系统中已经有的feature:

     karaf@root> features:refreshUrl
     karaf@root> features:list

     karaf@root> features:list | grep example-camel-bundle

     C.  Add the local repository URL to the features service

     features:addUrl file:C:/Projects/features.xml

     检查Features  URL:

     karaf@root> features:listUrl

     D. Add dependent features to the feature

<?xml version="1.0" encoding="UTF-8"?>
<features name="MyFeaturesRepo">
	<feature name="example-camel-bundle">
		<bundle>file:C:/Projects/camel-bundle/target/camel-bundle-1.0-SNAPSHOT.jar
		</bundle>
		<feature version="7.0.0.fuse-060">camel-core</feature>
		<feature version="7.0.0.fuse-060">camel-spring-osgi</feature>
		<feature version="7.0.0.fuse-060">servicemix-camel</feature>
	</feature>
</features>

     E. Add OSGi configurations to the feature    

<?xml version="1.0" encoding="UTF-8"?>
<features name="MyFeaturesRepo">
	<feature name="example-camel-bundle">
		<config name="org.fusesource.fuseesb.example">
			prefix=MyTransform
		</config>
	</feature>
</features>

     下面Spring配置文件中的${prifix}将被替换成"MyTransform":

<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
	xmlns:ctx="http://www.springframework.org/schema/context"
	xmlns:osgi="http://camel.apache.org/schema/osgi" 
	xmlns:osgix="http://www.springframework.org/schema/osgicompendium" .>
	...

	<bean id="myTransform" class="org.fusesource.fuseesb.example.MyTransform">
		<property name="prefix" value="${prefix}" />
	</bean>
	<osgix:cm-properties id="preProps" persistentid="org.fusesource.fuseesb.example">
		<prop key="prefix">DefaultValue</prop>
	</osgix:cm-properties>
	<ctx:property-placeholder properties-ref="preProps" />
</beans>

     (2) Deploying a Feature

     A. Installing at the console

     karaf@root> features:refreshUrl
     karaf@root> features:install example-camel-bundle

     B. Uninstalling at the console

     karaf@root> features:uninstall example-camel-bundle

     C. Hot Deploy

     Copy Featurs Repository 至Fuse ESB Enterprise 的安装目录下的deploy目录下。

     D. Adding a feature to the boot configuration

     编辑/etc/org.apache.felix.karaf.features.cfg配置文件中的featuresRepositories和featuresBoot值，添加自定义的

     Feature Repository.

6.  Example:Generating and Running an EIP Bundle

     (1)

mvn archetype:generate -DarchetypeGroupId=org.apache.servicemix.tooling -DarchetypeArtifactId=servicemix-camel-osgi-bundle -DarchetypeVersion=2012.01.0.fuse-7-061 -DgroupId=org.fusesource.example -DartifactId=camel-bundle

     (2) mvn clean install

     (3) osgi:install -s file:/home/fdc/temp/mvn/camel-bundle/target/camel-bundle-1.0-SNAPSHOT.jar

     (4) 输出：

     >>>> MyTransform set body:  Sat Jul 14 11:05:09 CST 2012
     >>>> MyTransform set body:  Sat Jul 14 11:05:11 CST 2012
     >>>> MyTransform set body:  Sat Jul 14 11:05:13 CST 2012

7.  Generating and Running a Web Services Bundle

     (1)

mvn archetype:generate -DarchetypeGroupId=org.apache.servicemix.tooling -DarchetypeArtifactId=servicemix-cxf-code-first-osgi-bundle -DarchetypeVersion=2012.01.0.fuse-7-061 -DgroupId=org.fusesource.example -DartifactId=cxf-code-first-bundle

     (2) 编辑生成工程的POM文件，给<Import-Package>元素添加：*

     (3) mvn clean install

     (4) osgi:install -s file:/home/fdc/temp/mvn/cxf-code-first-bundle/target/cxf-code-first-bundle-1.0-SNAPSHOT.jar

     (5) 查看WSDL文件：

     http://localhost:8181/cxf/PersonServiceCF?wsdl