运行那些 Java 文件,可以看到执行成功的信息。除了这些例子,可以在文件 estlinklibapixmlrpc.class.php 的 __construct() 函数中查询到更多的接口。除了如上所示的直接编写 XML-RPC 客户端代码外,还可以使用 SourceForge 提供的开源 Java 项目 TestLink Java API。TestLink Java API 是独立于 Testlink 之外单独维护的项目,但版本号和 TestLink 保持一致。在 TestLink 发布新版本之后,比如对应版本 TestLink 1.9.4,TestLink Java API 会发布版本 1.9.4-1,其中末位数字 1 表示内部修订版本号,用于控制缺陷修改和功能提升。访问 TestLink Java API 网站,下载 TestLink Java API Jar 文件及其依赖的第三方类库,把它们添加到构建路径后,可以很方便的编写自己的客户端代码调用 TestLink 接口。见清单 6,实现了使用 TestLink Java API 创建项目。
清单 6. 使用 TestLink Java API 创建项目的例子
String url = "http://<server>:<port>/testlink/lib/api/xmlrpc.php";
String devKey = "key";
TestLinkAPI api = null;
TestProject project = null;
URL testlinkURL = null;
try {
testlinkURL = new URL(url);
api = new TestLinkAPI(testlinkURL, devKey);
project = api.createTestProject(
" 我的测试项目 ", // 测试项目名称
"demo", // 测试项目前缀
" 演示备注 ", // 备注
true, // 选中 Enable Requirements feature
true, // 选中 Enable Testing Priority
true, // 选中 Enable Test Automation (API keys)
false, // 选中 Enable Inventory
true, // 选中 Active
true); // 选中 Public
} catch( TestLinkAPIException te) {
te.printStackTrace( System.err );
System.exit(-1);
} catch ( MalformedURLException mue ) {
mue.printStackTrace( System.err );
System.exit(-1);
}
System.out.println(api.ping());
System.out.println( "Test project created! " );
System.out.println( "Test Project ID: [ " + project.getId() + " ]." );
总结
通过上面对 TestLink 的介绍,我们了解到如何安装、配置 TestLink;掌握了如何使用 TestLink 管理软件功能测试过程。并对 TestLink 对外提供的 XML-RPC 接口进行了演示。使用 Java 语言通过调用 XML-RPC 接口对 TestLink 进行定制开发,可以满足测试项目组的更多需求。关于如何使用 TestLink 管理自动化测试过程,请参考本系列文章的第二部分。