RobotFramework用户说明书翻译稿(2)

发表于:2012-03-06来源:新浪博客作者:lxg0618点击数: 标签:RobotFramewo
Test Case Action Argument Argument Test With Settings [Documentation] Another dummy test [Tags] dummy owner-johndoe Log Hello, world! 在设置表中与测试用例相关的设置 设置表提供以下测

Test Case

Action

Argument

Argument

Test With Settings

[Documentation]

Another dummy test

 

[Tags]

dummy

owner-johndoe

 

Log

Hello, world!

  在设置表中与测试用例相关的设置

  设置表提供以下测试用例相关的设置项。这些测试用例相关的设置基本使用默认值。

  Force Tags, Default Tags

  标签的强制值和默认值

  Test Setup, Test Teardown

  测试安装和销毁的默认值,和使用test Precondition和test Postcondition作用相同

  Test Template

  默认的模板关键字

  Test Timeout

  测试用例超时的默认值,超时将会在其对应的章节中进行阐述。

  2.2.2 使用参数

  之前的例子已经表明关键字可以接收不同的参数,这部分将更彻底地讨论这个重要的功能。如何真正实现使用含不同参数的用户关键字和函数库关键字将在其它章节单独介绍。

  关键字可以接受零个或多个参数,一些参数可能有自己默认的值。关键字接受哪种参数取决于其如何实现,寻找此信息最好的地方莫过于关键字注释文档。在本节的例子中,注释文档是由libdoc.Py这个工具生成的,然而相同的信息我们也可以从类似的注释文档工具例如javadoc中生成。

  必选参数

  大多数关键字通常都有确定数目的参数。在关键字注释文档中,它们是通过在指定的参数之间添加逗号来分隔开的(如 frist,second,third)。在这种情况下参数的名字并不重要,除非需要解释该参数的作用是什么,但重要的是必须保证其参数数目与注释文档中的数目保持一致。使用过少或者过多的参数都会导致错误的发生。

  下面的用例从OperatingSystem函数库中调用了Create Directory 和Copy File关键字,参数格式被规定为path和source, destination,这意味着它们分别带了一个参数和两个参数。而最后一个从BuiltIn库中调用的关键字No Operation,不带任何参数。

关键字以及参数命名

Test Case

Action

Argument

Argument

Example

Create Directory

${TEMPDIR}/stuff

 

Copy File

${CURDIR}/file.txt

${TEMPDIR}/stuff

 

No Operation

  默认值

  带有默认值的参数可以给出也可以不给出。本文档中,参数名和默认值有等号分隔,如name=default value,但是对于Java实现的关键字而言,一个关键字可能有多种实现方法,只是各个方法给出的参数不同。一般参数都可以给出默认值,但是带有默认值的参数后面不能再有确定位置的参数。(与Python不同,JAVA默认参数的实现需要用到重载机制:一个相同名字的函数,可以通过不同的参数个数区分。默认参数其实不体现在Java对应函数的参数列表中,而是在程序内实现,可见这个例子,http://stephenxjc.iteye.com/blog/358512 ,这个讲起来有点儿啰嗦,不展开了,有兴趣的同学可以找我进一步讨论。)

  下面举例说明如何使用默认值。这个例子使用Create Files关键字,关键字带有参数path、content=、coding=UTF-8编码方式。(调用的时候)如果试图不带参数或者参数超过三个,那么(此关键字方法)都不能成功调用。

带有默认关键字的

Test Case

Action

Argument

Argument

Argument

Example

Create File

${TEMPDIR}/empty.txt

 

Create File

${TEMPDIR}/utf-8.txt

Hyvä esimerkki

 

Create File

${TEMPDIR}/iso-8859-1.txt

Hyvä esimerkki

ISO-8859-1

原文转自:http://www.ltesting.net