XML-RPC 接口介绍

TestLink 自从版本 1.8.0 起，开始提供 XML-RPC 接口。在界面上可以完成的操作，大都可以通过 API 接口编程自动化的实现。通过调用这些接口，可以对 TestLink 进行定制，开发与其他研发平台进行集成的程序。用户通过实现自己的 XML-RPC 客户端，可以很方便地调用 TestLink 的接口方法，比如 createTestProject、 uploadAttachment、 getTestProjectByName 等等。在默认情况下，XML-RPC API 处于关闭状态，需要修改配置文件来启用 XML-RPC API。在使用 XML-RPC 接口之前，XML-RPC 客户端需要获取一个访问 TestLink 的密钥。登录到 TestLink 系统，在个人帐号页面点击"生成新的密钥"按钮，即可获取需要的密钥值，见图 4。

接下来，演示一下如何调用 TestLink 的编程接口。TestLink 软件安装目录 testlinklibapisample_clientsjava 中提供了基于 Java 的 Apache XML-RPC 客户端实现的例子。把它导入到 Eclipse 工作区，建立 Eclipse Java 工程 Testlink API Sample Java Client。重新配置一下构建路径，导入需要的第三方 Jar 文件，确保没有编译问题。可以在工程的源代码包 org.testlink.api.client.sample 下面发现两个 Java 文件。一个是 clientAddTestCaseToTestPlan.java，用于演示如何通过接口调用把测试用例添加到测试计划中，需要提供测试项目编码，测试计划编码，测试用例的外部编码及测试用例的版本号作为参数。另外一个是 TestlinkAPIXMLRPCClient.java，用于演示如何通过接口调用修改测试执行的结果状态，需要提供测试用例编码、测试计划编码和执行结果状态作为参数。在编译、运行这两个 Java 文件之前，使用实际数值替换 Java 文件中的密钥值 DEV_KEY 及 TestLink 站点的 SERVER_URL，如清单 5 所示：
清单 5. 修改密钥和 URL

// 替换使用你的密钥
public static final String DEV_KEY = "8f86a2a64b634aec65eeab1511646238";
// 替换使用你的 Server URL
public static final String SERVER_URL = "http://localhost/testlink/lib/api/xmlrpc.php";