Fitnesse - Slim Tables
2017-09-28
目录
1 什么是Wiki Word？
2 Query Table
2.1 Query Table的格式
2.2 源代码
3 Script Table
3.1 Script Table格式
3.2 源代码
1 什么是Wiki Word？
wiki单词（ WikiWord）的语法是驼峰式：小写字母和小写字母的交替模式。第一个字母大写后面跟小写字母或数字，这算一个驼峰，两个及以上驼峰成为wiki单词。
正则表达式如下：
\b[A-Z](?:[a-z0-9]+[A-Z][a-z0-9]*)+
Java类的命名规则是驼峰式的，所有在是用的时候，需要在wikipage中做些修改，防止被fitnesse解释。修改有两种方式：
- 一种是Literal Text：
如下2.2 QueryTable调用的类名为EmpoyeesHiredBefore，在2.1中调用是可以写成：
!-Query:EmpoyeesHiredBefore-!
- 另一种是每个驼峰以空格相隔且首字母小写
正如2.1中的格式：
Query:employees hired before
2 Query Table
2.1 Query Table的格式
| Query:employees hired before | 10-Dec-1980 | |||
| company number | employee number | first name | last name | hire date |
| 4808147 | 9942 | Bill | Mitchell | 19-Dec-1966 |
| 4808147 | 1429 | Bob | Martin | 10-Oct-1975 |
也可以让单元为空，测试是会自动填上：
| Query:employees hired before | 10-Dec-1980 | ||
| employee number | first name | last name | hire date |
| 1429 | |||
| 8832 | |||
2.2 源代码
package util; import java.util.Date;
import java.util.List; import static java.util.Arrays.asList; public class EmployeesHiredBefore { public EmployeesHiredBefore(Date date) {
} public void table(List<List<String>> table) {
// optional function
} public List<List<List<String>>> query() { return
asList( // table level
asList( // row level
asList("company number", "4808147"), // cell column name, value
asList("employee number", "1429"),
asList("first name", "Bob"),
asList("last name", "Martin"),
asList("hire date", "10-Oct-1974")
),
asList(
asList("company number", "5123122"),
asList("employee number", "8832"),
asList("first name", "James"),
asList("last name", "Grenning"),
asList("hire date", "15-Dec-1979")
)
);
}
}
图1 测试结果
说明：
- Query Table的第一行，第一列单元格：前缀Query:+类名EmployeesHiredBefore，后面的单元格式构造函数的参数。
- QueryTable类必须有一个query方法返回结果行，每一行都是由两个元素构成，一个就是字段名，另外一个就是对应的值（String类型）。
- 从表格中的值从最左边开始匹配返回的结果，如果该行中的第一列不匹配，则该条记录是不匹配的，执行时候就查询失败。
3 Script Table
3.1 Script Table格式
| script | login dialog driver | Bob | xyzzy | |
| login with username | Bob | and password | xyzzy | |
| check | login message | Bob logged in. | ||
| reject | login with username | Bob | and password | bad password |
| check | login message | Bob not logged in. | ||
| check not | login message | Bob logged in. | ||
| ensure | login with username | Bob | and password | xyzzy |
| note | this is a comment | |||
| show | number of login attempts | |||
| $symbol= | login message | |||
3.2 源代码
public class LoginDialogDriver {
private String userName;
private String password;
private String message;
private int loginAttempts;
public LoginDialogDriver(String userName, String password) {
this.userName = userName;
this.password = password;
}
public boolean loginWithUsernameAndPassword(String userName, String password) {
loginAttempts++;
boolean result = this.userName.equals(userName) && this.password.equals(password);
if (result)
message = String.format("%s logged in.", this.userName);
else
message = String.format("%s not logged in.", this.userName);
return result;
}
public String loginMessage() {
return message;
}
public int numberOfLoginAttempts() {
return loginAttempts;
}
}
图1 测试结果
说明：
很明显，这个表中每一行都是一条指令。
| Script:login dialog driver | Bob | xyzzy |
第一行Script后面跟的是类名LoginDialogDriver和构造函数的参数Bob,xyzzy，这一行称之为actor，如果table中没有actor，就沿用上一个table的actor。
Script table 调用方法可以插入式调用，即方法和参数是相间的，如下所示：
| login with username | Bob | and password | xyzzy |
也可以连续调用，可以在单元格方法名后面添加分号，然后紧接的单元格都是入参，如下所示：
| login with username and password; | Bob | xyzzy |
- 一行中如果只包含一个方法名，那么只有它返回的是布尔值，才会执行的时候变成绿色或者红色，其他情况不会有颜色
- 如果一个变量在第一个单元格，则它后面应该跟的是方法名，该变量的值就是方法返回的值
- 如果第一个单元格是check,则它后面应该跟的是方法名，最后一个单元格就是期望值
- 如果第一个单元格是check not,则它后面跟的是方法名，最后一个单元格就是不希望的期望值
- 如果第一个单元格是ensure,则它后面跟的是方法名，返回的布尔值如果是true就变成绿色，如果是false就变成红色
- 如果第一个单元格是reject,则它后面跟的是方法名，返回的布尔值如果是false就变成绿色，返回的布尔值如果是true就变成红色
- 如果第一个单元格是note,则在执行的时候就会忽略（空格，以#或者*开头的都是这种效果）
- 如果第一个单元格是show,则它后面跟的是方法名，当这个测试运行的时候，一个新的单元格将会被添加，显示的是该方法的返回值
- 如果第一个单元格是start,它后面跟的应该是一个新的类名和构造函数的参数，会开始一个新的actor,覆盖上面的，它下面的script都会沿用该actor