在Eclipse中高效运行HTTP / REST集成测试

最近，我有机会使用由我亲爱的Holger Staudacher编写的OSGi-JAX-RS-Connector库。通过连接器，您可以通过将@Path注释的类型注册为OSGi服务来轻松发布资源-实际上，它工作得很好。

对于我来说，使用普通的JUnit测试编写驱动的服务类测试是很自然的事，但提供附加的集成测试也很重要。这些测试允许检查此类服务的运行时可用性和功能。为了提供后者，我使用了Holger编写的另一个小助手– restfuse ，它是用于自动HTTP / REST测试的JUnit扩展。

该场景看起来像这样：

服务

@Path( '/message' )
public class SampleService {@GET@Produces( MediaType.TEXT_PLAIN )public String getMessage() {return 'Hello World';}
}

一个JUnit测试用例

public class SampleServiceTest {@Testpublic void testGetMessage() {SampleService service = new SampleService();String message = service.getMessage();assertEquals( 'Hello World', message );}
}

服务注册

<?xml version='1.0' encoding='UTF-8'?>
<scr:componentxmlns:scr='http://www.osgi.org/xmlns/scr/v1.1.0'name='SampleService'><implementation class='sample.SampleService'/><service><provide interface='sample.SampleService'/></service>
</scr:component>

Restfuse集成测试

@RunWith( HttpJUnitRunner.class )
public class SampleServiceHttpTest {@Rulepublic Destination destination= new Destination( 'http://localhost:9092' );@Contextprivate Response response;@HttpTest( method = Method.GET, path = '/services/message' )public void checkMessage() {String body = response.getBody( String.class );assertOk( response );assertEquals( MediaType.TEXT_PLAIN, response.getType() );assertEquals( 'HelloWorld', body );}
}

正在运行的服务

尽管所有这些工作都非常简单，但是它以某种方式使我感到困惑，即在我能够执行集成测试之前，首先要在本地运行集成测试才能启动服务器。由于忙于手头的任务，我经常忘记启动服务器，遇到连接超时等问题。

但是我通过使用PDE JUnit启动配置找到了解决方案，因为可以在运行测试的过程中将这样的配置设置为启动服务器。

为此，创建并选择一个包含所有要运行¹的集成测试的测试套件。

…之后切换到主标签并选择无头模式...

…最后但并非最不重要的一点是配置服务器使用的程序参数，在我们的案例中，该参数主要涉及端口定义。

“插件”选项卡中的捆绑软件选择包含与用于独立运行服务器的osgi启动配置相同的捆绑软件，以及JUnit，PDE JUnit，restfuse捆绑软件及其依赖项。所选的测试套件可能如下所示：

@RunWith( Suite.class )
@SuiteClasses( {SampleServiceHttpTest.class
} )
public class AllRestApiIntegrationTestSuite {public static String BASE_URL= 'http://localhost:'+ System.getProperty( 'org.osgi.service.http.port' );
}

唯一不寻常的是BASE_URL常量定义。如上所述，测试运行的服务器端口在启动配置中指定为程序参数。但是Restfuse测试需要在目标规则定义期间提供端口。使用上述方法可以在不影响测试的情况下更改配置中的端口。只需将常量用作定义中的参数，如下面的代码段² ^3所示。

@Rulepublic Destination destination= new Destination( BASE_URL );

这个简单的设置效果很好，并改善了我在本地运行集成测试的工作流程。将启动配置保存在共享项目中后，您的团队成员就可以轻松地重用启动配置。

今天就这样，反馈一如既往地受到高度赞赏。顺便说一句，霍尔格答应我写一篇文章，介绍如何将上述内容集成到基于Maven / tycho的版本^4中 -请继续关注

当然，您也可以使用运行选定项目，程序包或源文件夹的所有测试的可能性，但是出于我们的目的，使用套件方法并运行单个测试用例是可以的
在现实世界中，您可能会为常量定义提供一个单独的类，以避免将测试耦合到套件。为了简化起见，我在这里略过。
请注意，使用静态导入包含BASE_URL，以提高代码段的可读性
Holger信守诺言，请参阅： http : //eclipsesource.com/blogs/2012/09/11/running-httprest-integration-tests-in-an-eclipse-tycho-build/

参考：来自JCG合作伙伴 Frank Appel的Code Affine博客在Eclipse中有效地运行HTTP / REST集成测试。