junit4osgi的使用.doc

junit4osgi的使用介绍1. 简介Junit4OSGi继承于junit的简单测试框架，可以在OSGI运行环境中进行测试。针对集成测试或是需要在一个OSGI环境中进行单元测试。结构如下：它分为三个部分：（1） Testsy stem 是真正的应用，被测试的系统（比如：声明式服务部分的测试）。（2） Tests是包含测试代码的bundle，用来测试被测试的系统。（3） Framework是测试框架，包括启动测试Runner和执行测试Runtime，在测试声明式服务中我们使用内嵌的loong框架作为测试框架。2. 使用Junit4OSGi进行测试的操作说明：（1）要对被测试的系统进行测试时，Tests必须是一个新建maven工程，测试的代码必须在src/main/java目录下，而不能在被测试部分srctestjava目录下直接写测试代码（比如要测试声明式服务loong-dservice-impl中的服务注册方面，我们不能在它的srctestjava目录下写测试代码）。（2）所写的测试用例必须继承OSGiTestCase，这个类这个类继承自TestCase，并在它的基础上对OSGI中应用到的一些方法进行了封装，比如getBundle，getContext，getServiceObjects等，方便在写测试代码时获取bundle或是服务的一些信息。（3）在测试之前，要对测试代码所在工程的pom文件中进行如下信息的配置：1）添加测试时所需的依赖。测试时所要用到的bundle通过添加依赖的方式添加到pom文件中，其中loong-junit4osgi、loong-dservice-metadata为必须添加的依赖。具体操作如下：org.trustie.loong.modules.loong-dserviceloong-junit4osgi0.1.0-SNAPSHOTorg.trustie.loong.modules.loong-dserviceloong-dservice-metadata0.1.0-SNAPSHOT2）配置所需的插件，必须配置loong-junit4osgi-plugin插件，如果对声明式服务进行测试时必需配置loong-dservice-plugin插件，具体操作如下：org.trustie.loong.modules.loong-dserviceloong-junit4osgi-plugin0.1.0-SNAPSHOTtestloongorg.trustie.loong.modules.loong-dserviceloong-dservice-plugin0.1.0-SNAPSHOTdservice-bundle其中在configuration中配置的框架为测试执行的框架，目前支持loong和Felix这两种。3）在测试工程中写的TestSuite类也必须在pom中配置，TestSuite类的作用是将所有的测试类都添加进来，配置后就可以执行每一个测试类，TestSuite的写法如下：public class ServiceTestSuite extends TestSuite public static Test suite(BundleContext bc) OSGiTestSuite ot = new OSGiTestSuite(Service Test Suite, bc); ot.addTestSuite(SimpleTest.class); ot.addTestSuite(TestClass.class); ot.addTestSuite(TestProps.class); ot.addTestSuite(TestPropReconfigure.class);return ot;在pom中的配置如下：erfaces$pom.artifactIdtest.suit,erfaces.impltest.suit.ServiceTestSuite在配置完上述信息后就可以进行测试了，测试时在bundle的构件过程中执行的，可以直接在eclipse环境下对bundle打包，然后在控制台可以得出测试的结果；也可以在Dos下使用maven命令执行测试，如：mvn install。执行后会在当前bundle的target目录下生成安装的bundle和测试报告。注：在测试时有几个常用的maven命令mvn clean integration-test -DlogService=false 设置日志服务；mvn clean install -Dmaven.test.skip=true 略过测试；mvn clean install -Dmaven.test.failure.ignore=true 当测试出现失败不中断。3. 简单例子演示（1）新建一个maven工程：test.with.junit4osgi，在pom文件中配置好所需的依赖和插件。（2）在srcmainjava目录下定义好服务接口和接口的实现类（也就是构件实现类）。定义的接口和实现类如下：public interface Foo boolean foo();Properties fooProps();Boolean getObject();boolean getBoolean();int getInt();String getString();实现类：public class FooImpl implements Foo private int intProp;private String strProp;private String strAProp;private int intAProp;private boolean boolProp;public boolean foo() return boolProp;public Properties fooProps() Properties p = new Properties();p.put(intProp, new Integer(intProp);p.put(boolProp, new Boolean(boolProp);p.put(strProp, strProp);p.put(strAProp, strAProp);p.put(intAProp, intAProp);return p;public boolean getBoolean() return true;public double getDouble() return 2.1;（3）在srcmainresources目录下新建一个元数据文件metadata.xml，具体配置如下：（4）在srcmainjava目录下新建一个package，里面放置测试声明式服务的测试类，测试类都是继承于OSGiTestCase，都是使用断言的形式对注册服务、引用服务等来测试，下面是是一个简单的测试类：public class TestProps extends OSGiTestCase DserviceHelper helper = null;public void setUp() helper = new DserviceHelper(this);String type = FooProvider;helper.createComponentInstance(type, FooInstance);public void tearDown() helper.dispose();/测试属性关联字段且设置valuepublic void testProperty1() ServiceReference sr = helper.getServiceReferenceByName(Foo.class.getName(), FooInstance);/ 测试引用服务assertNotNull(The reference service is null, sr);/ 引用服务属性Integer intProp = (Integer) sr.getProperty(int);String strProp = (String) sr.getProperty(string);int intAProp = (int) sr.getProperty(intAProp);String srtProps = (String) sr.getProperty(strAProp);assertEquals(The int is not equals, intProp, new Integer(2);assertEquals(The String is not equals, strProp, new String(foo);assertNotNull(The stringArrays is null, srtProps);String v = new String foo, bar ;for (int i = 0; i srtProps.length; i+) if (!srtPropsi.equals(vi) fail(The two arrays not equals);assertNotNull(The int array is null, intAProp);int i = new int 1, 2, 3 ;for (int j = 0; j intAProp.length; j+) if (intAPropj != ij) fail(The two int arraya not same);Foo foo = (Foo) getServiceObject(sr);assertTrue(invoke service failed, foo.foo();在测试类里面我们定义了两个方法setUp和tearDown，其中setUp，负责初始化测试方法所需要的测试环境（如：创建构件实例、获取构件工厂），tearDown在每个测试方法被调用之后被调用，负责撤销测试环境（如：清除已创建了的构件实例）；以上的两个方法都用到了一个帮助工具类DserviceHelper，通过它我们可以得到构件实例（getInstanceByName）、创建构件实例（createComponentInstance）、获得构件工厂（getFactory）、得到服务对象（getServiceObject）等等。测试类写好后，把他们都加入到ProvideTestSuite中，操作如下：public class ProvideTestSuite extends TestSuite public static Test suite(BundleContext bc) OSGiTestSuite ots = new OSGiTestSuite(Provided Service Test Suite, bc); ots.addTestSuite(TestProps.class);return ots;（5）构建已经创建好的工程，当测试类中所有断言语句的结果都正确时，此bundle会构件成功，会有如下的输出结果：当测试类中有断言语句不正确时，此bundle会构件失败，如上面测试类中assertEquals(The int is not equals, intProp, new Integer(2);将2改为3时，会有如下输出结果：且在targetsurefire-reports目录下的TEST-Provided_Service_Test_Suite.xml文件中有如下错误信息： junit.framework.AssertionFailedError: The int is not equals expected:<2> but was:<3>at junit.framework.Assert.fail(Assert.java:47)at junit.framework.Assert.failNotEquals(Assert.java:282)at junit.framework.Assert.assertEquals(Assert.java:64)at test.suit.TestProps.testProperty1(TestProps.java:52)at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)注：工具类DserviceHelper里的方法详解 public static ComponentInstance createComponentInstance(Bundle bundle,String factoryName, Dictionary configuration)从给定的bundle中指定的工厂中，以给定的配置信息创建一个新的构件实例。 public static ComponentInstance createComponentInstance(Bundle bundle,String factoryName, String instanceName, Dictionary configuration)从给定的bundle中指定的工厂中，以给定的配置信息和名称创建一个新的构件实例。 public static ComponentInstance createComponentInstance(DServiceContext serviceContext, String factoryName,String instanceName)从给定的服务上下文中指定的工厂中，以给定的名称创建一个新的构件实例(包括空配置)。 public static ComponentInstance createComponentInstance(DServiceContext serviceContext, String factoryName,Dictionary configuration)从给定的服务上下文中指定的工厂中，以给定的名称创建一个新的构件实例。 public static ComponentInstance createComponentInstance(DServiceContext serviceContext, String factoryName,String instanceName, Dictionary configuration)从给定的服务上下文中指定的工厂中，以给定的名称和配置信息创建一个新的构件实例。 public ComponentInstance createComponentInstance(String factoryName,String instanceName)从本地bundle指定的工厂中，以给定的名称(和空配置信息)创建一个新的构件实例。 public ComponentInstance createComponentInstance(String factoryName,Dictionary configuration)从本地bundle指定的工厂中，以给定的配置信息创建一个新的构件实例。 public ComponentInstance createComponentInstance(String factoryName)从本地bundle指定的工厂中，以空配置信息创建一个新的构件实例。 public ComponentInstance createComponentInstance(String factoryName,String instanceName, Dictionary configuration)从本地bundle指定的工厂中，以给定的名称和配置信息创建一个新的构件实例。 public static AspectComponentFactory getHandlerFactory(Bundle bundle,String factoryName)返回一个在bundle中给定名称的方面工厂。 public static Object getServiceObject(DServiceContext serviceContext,String itf, String filter)返回一个注册在服务上下文中的服务对象, 提供指定的接口和给定的名称。 public stati