Apache CXF 分布式OSGi部署HelloWorld

摘要

要配置Apache CXF OSGi的部署其实比较简单，但是我们一般都会在网上找资料，会遇到怎么也发现不了服务的情况，让人都很郁闷。

有了这次的经历，我要看官方的文档，以防上当。

一、环境准备

首先下载Apache CXF 的包，下载地址：http://cxf.apache.org/dosgi-releases.html

我们下载下面这两个就可以了，我们这次会用到cxf-dosgi-ri-singlebundle-distribution

Multi-bundle distribution (zip)
cxf-dosgi-ri-multibundle-distribution-1.3.1-dir.zip

Single-bundle distribution
cxf-dosgi-ri-singlebundle-distribution-1.3.1.jar

目前需要3个bundle

注意版本号

导入cxf-dosgi-ri-singlebundle-distribution-1.3.1.jar 包，在Eclipse中菜单：File->import，选择如下图所示

选择文件所在的路径

我们会在Package Explorer视图中看到

好了，我们的开发环境就配置好了。

二、创建演示程序-生产服务

创建HelloWorld演示程序

Eclipse->File->new->project-

我们就写一个helloworld的接口

代码如下：

public interface HelloWorldService {
	String sayHello();
}

接下来我们用同样的方法来，做一个HelloworldService的实现工程

Eclipse->File->new->project

我们来写一个实现类如下，首先添加对接口的依赖

实现类如下：

public class HelloWorldServiceImpl implements HelloWorldService {

	@Override
	public String sayHello() {
		System.out.println("HelloWorld");
		return (new Date()).toString();
	}
}

现在实现类有了，我们现在要注册成web服务，打开实现工程中的Activator类，注册服务代码如下：

public class Activator  implements BundleActivator {

	@SuppressWarnings("rawtypes")
	private ServiceRegistration registration;
	private static BundleContext context;

	static BundleContext getContext() {
		return context;
	}
	@Override
	public void start(BundleContext bundleContext) throws Exception {
		Activator.context = bundleContext;
		//设置服务的属性
    	Dictionary<String, String> props = new Hashtable<String, String>();

	    props.put("service.exported.interfaces","*");  
	    props.put("service.exported.intents","SOAP");  
	    props.put("service.exported.configs","org.apache.cxf.ws");  
	    props.put("org.apache.cxf.ws.address","http://localhost:9000/hello_world");  

        //注册服务
        registration = Activator.context.registerService(HelloWorldService.class.getName(), new HelloWorldServiceImpl(), props);
	}

	@Override
	public void stop(BundleContext bundleContext) throws Exception {
		Activator.context = null;
		 registration.unregister();
	}

}

好了，我们的服务已经注册成功了，我们看看在浏览器中是什么样子的，

Eclipse-Run->Run configuration,配置结果如下图所示：

点击run后我们可以看到如下日志：

这就说明了我的web服务已经注册成功了，好了，我们在浏览器中看一下结果,在浏览器中输入：http://localhost:9000/hello_world?wsdl，就可以看到如下结果

接下来我们会消费服务

三、消费服务

我们建一个插件工程，命名为：HelloWorldClient，创建好以后如下：

我们要使用服务就要先引用依赖组件，如下图所示

我们还要配置一下服务的发现，在工程下建立OSGI-INF文件夹，里面新建一个remote-service文件夹，在remote-service新建一个remote-services.xml，该文件内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<service-descriptions xmlns="http://www.osgi.org/xmlns/sd/v1.0.0">
  <!--远程服务描述-->
  <service-description>
    <!--定义远程服务映射到本地的服务的接口 -->
    <provide interface="helloworldservice.HelloWorldService" />
    <!-- 远程服务的接口 -->
    <property name="service.exported.interfaces">*</property>
    <!-- 远程服务的形式 -->
    <property name="service.exported.intents">SOAP</property>
    <!-- 服务的类型-->
    <property name="service.exported.configs">org.apache.cxf.ws</property>
    <!-- 服务的地址-->
    <property name="org.apache.cxf.ws.address">http://localhost:9000/hello_world</property>
  </service-description>
</service-descriptions>

和我们在实现类里面注册服务的代码一样

我们来看一下HelloWorldClient的Activator类的内容，主要的内容就是获取服务，然后调用服务，很简单。

public class Activator implements BundleActivator {
	@SuppressWarnings("rawtypes")
	private ServiceTracker tracker;
	private static BundleContext context;

	static BundleContext getContext() {
		return context;
	}
	/*
	 * (non-Javadoc)
	 * @see org.osgi.framework.BundleActivator#start(org.osgi.framework.BundleContext)
	 */
	@SuppressWarnings({ "unchecked", "rawtypes" })
	public void start(BundleContext bundleContext) throws Exception {
		Activator.context = bundleContext;
		//创建ServiceTracker，捕获HelloWorldService添加到OSGi框架的事件
        tracker = new ServiceTracker(Activator.context, HelloWorldService.class.getName(), null) {
            @Override
        	public Object addingService(ServiceReference reference) {
                Object result = super.addingService(reference);
                //获取服务
                HelloWorldService helloWorldService = (HelloWorldService)Activator.context.getService(reference);
                //使用服务
                System.out.println("call say hello at " + helloWorldService.sayHello());               
                return result;
            }
        };
        tracker.open();
	}

	/*
	 * (non-Javadoc)
	 * @see org.osgi.framework.BundleActivator#stop(org.osgi.framework.BundleContext)
	 */
	public void stop(BundleContext bundleContext) throws Exception {
		Activator.context = null;
		System.out.println("hello world client close");
		tracker.close();
	}

}

好了，我们的消费者就创建好了，来看一下运行效果吧

先进行运行 配置，如下图所示

我们在上图中可以看到结果

好了，我们的演示已经结束了，看起来还是比较简单的，但是在做的过程中还是遇到一些问题，比如使用了老的注册服务代码如下：

  props.put("osgi.remote.interfaces", "*");
        props.put("osgi.remote.configuration.type", "pojo");
        props.put("osgi.remote.configuration.pojo.address", "http://localhost:9000/hello_world");

使用这个代码是注册服务不成功的，请大家注意！

源码下载：下载