其中Response类包含两项主要信息:HTTP返回码,以及应答正文。
public class Response { private final int statusCode; private final String responseBody; |
不难注意到,EndPoint类所关心的是把正确的请求发送到正确的地址、取回正确的应答。它并不关心这个地址究竟是什么(这是请求路由器组件的责任),也不关心请求与应答包含什么信息(这是请求构造器和应答解析器的责任)。这一特点使得EndPoint类的测试完全不需要依赖真实服务的存在。
网络端点的测试
如前所述,EndPoint类并不关心发送请求的地址,也不关心请求与应答的内容,只关心以正确的方式来发送请求并拿回应答——“正确的方式”可能包括身份认证与授权、必要的HTTP头信息等。为了测试这样一个类,我们不需要朝真正的网络服务地址发送请求,也不需要遵循真实的请求/应答协议,完全可以自己创造一个HTTP服务,用最简单的请求/应答文本来进行测试。
Moco就是专门用于这种场合的测试工具。按照作者的介绍,Moco是“一个非常容易设置的stub框架,主要用于测试与集成”。在JUnit测试中,只需要两行代码就可以声明一个HTTP服务器,该服务器监听12306端口,对一切请求都会以字符串“foo”作为应答:
MocoHttpServer server = httpserver(12306); server.reponse("foo"); |
接下来就可以像访问正常的服务器一样,用Apache Commons HTTP Client来访问这个服务器。唯一需要注意的是,访问服务器的代码需要放在running块中,以确保服务器能被正常关闭:
running(server, new Runnable() { @Override public void run() throws IOException { Content content = Request.Get("http://localhost:12306").execute().returnContent(); assertThat(content.asString(), is("foo")); } } |
当然,作为一个测试辅助工具,Moco支持很多灵活的配置,感兴趣的读者可以自行查阅文档。接下来我们就来看如何用Moco来测试我们系统中的网络端点组件。作为例子,我们这里需要集成的是用于管理用户身份信息的OpenPTK。OpenPTK使用自定义的XML通信协议,并且每次请求之前要求客户端程序先向/openptk-server/login地址发送应用名称和密码以确认应用程序的合法身份。为此,我们先准备一个Moco server供测试之用:
server = httpserver(12306); server.post(and( by(uri("/openptk-server/login")), by("clientid=test_app&clientcred=fake_password"))).response(status(200)); |
接下来我们告诉要测试的网络端点,应该访问位于localhost:12306的服务器,并提供用户名和密码:
configuration = new IdentityServiceConfiguration(); configuration.setHost("http://localhost:12306"); configuration.setClientId("test_app"); configuration.setClientCredential("fake_password"); xmlEndPoint = new XmlEndPoint(configuration); |
然后就可以正式开始测试了。首先我们测试XmlEndPoint可以用GET方法访问一个指定的URL,取回应答正文:
@Test public void shouldBeAbleToCarryGetRequest() throws Exception { final String expectedResponse = "<message>SUCCESS</message>"; server.get(by(uri("/get_path"))).response(expectedResponse); running(server, new Runnable() { @Override public void run() { XmlEndPointResponse response = xmlEndPoint.get("http://localhost:12306/get_path"); assertThat(response.getStatusCode(), equalTo(STATUS_SUCCESS)); assertThat(response.getResponseBody(), equalTo(expectedResponse)); } }); } |
实现了这个测试以后,我们再添加一个测试,描述“应用程序登录失败”的场景,这样我们就得到了对XmlEndPoint类的get方法的完全测试覆盖:
@Test(expected = IdentityServiceSystemException.class) public void shouldRaiseExceptionIfLoginFails() throws Exception { configuration.setClientCredential("wrong_password"); running(server, new Runnable() { @Override public void run() { xmlEndPoint.get("http://localhost:12306/get_path"); } }); } |