Fitnesse

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单词。 

正则表达式如下：

[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 测试结果 

说明：

1. Query Table的第一行，第一列单元格：前缀Query:+类名EmployeesHiredBefore，后面的单元格式构造函数的参数。
2. QueryTable类必须有一个query方法返回结果行，每一行都是由两个元素构成，一个就是字段名，另外一个就是对应的值（String类型）。
3. 从表格中的值从最左边开始匹配返回的结果，如果该行中的第一列不匹配，则该条记录是不匹配的，执行时候就查询失败。

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