jck28-lucio-allure2报告中添加用例分类

Allure 分类简介

  • 应用场景:可以为项目,以及项目下的不同模块对用例进行分类管理。也可以运行某个类别下的用例。
  • 报告展示:类别会展示在测试报告的 Behaviors 栏目下。
  • Allure 提供了三个注解:
    • @Epic:敏捷里面的概念,定义史诗,往下是 feature。
    • @Feature:功能点的描述,理解成模块往下是 story。
    • @Story:故事 story 是 feature 的子集。

Allure epic/feature/story 的关系

  • epic:敏捷里面的概念,用来定义史诗(需求,项目),相当于定义一个项目。
  • feature:相当于一个功能模块,相当于 testsuite,可以管理很多个子分支 story。
  • story:相当于对应这个功能或者模块下的不同场景,分支功能。
  • epic 与 feature、feature 与 story 类似于父子关系。
    image

Epic/Feature/Story 的关系

  • Epic: 创建一个购物平台。
    • Feature: 用户登录。
      • Story: 用户名密码正确,可以登录。
      • Story: 用户名错误,提示用户名不存在。
      • Story: 密码错误,提示密码错误。
    • Feature: 商品展示。
      • Story: 商品列表展示。
      • Story: 商品详情展示。

系统模块:@Epic/@Epics

  • 应用场景:在测试报告中看到用例所在的项目,或者定义一个项目的需求。
  • 解决方案:@Epic注解。
@Epic("需求1")
//@Epic("需求13")
@Epics({
    @Epic("需求2"),
    @Epic("需求3")
})
@DisplayName("步骤方法验证")
public class StepMethodTest {
    int result;

    @Test
    @DisplayName("加法步骤验证")
    void testSum() {
        //测试逻辑代码
    }

    @Test
    @DisplayName("一个测试方法中添加多个大步骤")
    void testMultipleSteps() {
        //测试逻辑代码
    }

    @Test
    @DisplayName("多个步骤验证")
    void testSum2() {
        //测试逻辑代码
    }
}

功能模块:@Feature/@Features

  • 应用场景:表示被测系统的不同功能模块或特性。
  • 解决方案:@Feature注解。
@Epic("需求1")
//@Epic("需求13")
@Epics({
    @Epic("需求2"),
    @Epic("需求3")
})
@Feature("功能模块2")
@Features({
        @Feature("功能模块3"),
        @Feature("功能模块4")

})
@DisplayName("步骤方法验证")
public class StepMethodTest {
    int result;

    @Test
    @DisplayName("加法步骤验证")
    void testSum() {
        //测试逻辑代码
    }

    @Test
    @DisplayName("一个测试方法中添加多个大步骤")
    void testMultipleSteps() {
        //测试逻辑代码
    }

    @Test
    @DisplayName("多个步骤验证")
    void testSum2() {
        //测试逻辑代码
    }
}
用户故事:@Story/@Stories
应用场景:定义具体的需求、用户故事或场景等。
解决方案:@Story注解。
@Epic("需求1")
//@Epic("需求13")
@Epics({
    @Epic("需求2"),
    @Epic("需求3")
})
@DisplayName("步骤方法验证")
public class StepMethodTest {
    int result;

    @Story("子功能1")
    @Stories({
            @Story("子功能2"),
            @Story("子功能3")

    })
    @Test
    @DisplayName("加法步骤验证")
    void testSum() {
        //测试逻辑代码
    }

    @Story("子功能2")
    @Stories({
            @Story("子功能4"),
            @Story("子功能3")

    })
    @Test
    @DisplayName("一个测试方法中添加多个大步骤")
    void testMultipleSteps() {
        //测试逻辑代码
    }

    @Story("子功能7")
    @Stories({
            @Story("子功能3"),
            @Story("子功能5")
    })
    @Test
    @DisplayName("多个步骤验证")
    void testSum2() {
        //测试逻辑代码
    }
}

用户故事:@Story/@Stories

  • 应用场景:定义具体的需求用户故事场景等。
  • 解决方案:@Story注解
@Epic("需求1")
//@Epic("需求13")
@Epics({
    @Epic("需求2"),
    @Epic("需求3")
})
@DisplayName("步骤方法验证")
public class StepMethodTest {
    int result;

    @Story("子功能1")
    @Stories({
            @Story("子功能2"),
            @Story("子功能3")

    })
    @Test
    @DisplayName("加法步骤验证")
    void testSum() {
        //测试逻辑代码
    }

    @Story("子功能2")
    @Stories({
            @Story("子功能4"),
            @Story("子功能3")

    })
    @Test
    @DisplayName("一个测试方法中添加多个大步骤")
    void testMultipleSteps() {
        //测试逻辑代码
    }

    @Story("子功能7")
    @Stories({
            @Story("子功能3"),
            @Story("子功能5")
    })
    @Test
    @DisplayName("多个步骤验证")
    void testSum2() {
        //测试逻辑代码
    }
}
package com.junit5.allure2casedesciption_l2.allurereport_addstep;

import io.qameta.allure.*;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.function.Executable;

import java.util.ArrayList;
import java.util.List;
import java.util.stream.IntStream;

import static org.junit.jupiter.api.Assertions.assertAll;
import static org.junit.jupiter.api.Assertions.assertEquals;

@DisplayName("步骤方法验证-调用方法方式添加用例步骤")
@Epic("购物平台")
//@Epic("需求1")
/**
 * @Epic与@Epics共存时,只能各一个,不能有多个
 */
@Epics({
        @Epic("需求2"),
        @Epic("需求3"),
})
@Feature("登录模块")
public class StepMethodTest {
    int result;

    /**
     * 语法结构
     * Allure.step("输入数字 3",()->{
     *     测试步骤代码(可省略)
     * });
     */
    @Test
    @DisplayName("加法步骤验证")
    @Story("通过用户名和密码登录")
    void testSum() {
        Allure.step("输入数字 3");
        int a = pressDigit(3);
        Allure.step("输入加号");
        String str = pressAddition();
        Allure.step("输入数字 2");
        int b = pressDigit(2);
        Allure.step("点击等号");
        result = sum(a, b);
        Allure.step("验证结果是否正确");
        assertEquals(5, result, a + str + b + "计算错误");
    }

    @Test
    @DisplayName("一个测试方法中添加多个大步骤")
    @Story("通过手机号登录")
    void testSteps() {
        List<Executable> list = new ArrayList<>();
        //验证登录搜索后播放是否正常
        Allure.step("步骤1",()->{
            //步骤1代码
            System.out.println("登录");

            Allure.step("输入用户名");
            String name = "admin";
            Allure.step("输入密码");
            String pwd = "123456";
            Allure.step("点击登录");
            String login = name+pwd;
//            assert
            list.add(()->assertEquals("admin123456",login));
            //...
        });
        Allure.step("步骤2",()->{
            //步骤2代码
            System.out.println("搜索");
            Allure.step("输入搜索内容名称");

            Allure.step("点击搜索按钮");

            Allure.step("获取搜索结果");

            list.add(()->assertEquals("搜索成功","搜索成功"));
            //...
        });
        Allure.step("步骤3",()->{
            //步骤3代码
            System.out.println("播放");
            Allure.step("点击播放按钮");

            Allure.step("等待2秒");

            Allure.step("获取当前播放进度时间");
            list.add(()->assertEquals("播放成功","播放成功"));
            //...
        });

        assertAll(list);
    }

    private int pressDigit(int digit) {
        return digit;
    }

    private String pressAddition() {
        return "+";
    }

    public int sum(int... numbers) {
        return IntStream.of(numbers).sum();
    }
}

package com.junit5.allure2casedesciption_l2.allurereport_addstep;

import com.junit5.User;
import io.qameta.allure.Epic;
import io.qameta.allure.Feature;
import io.qameta.allure.Step;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;

import static org.junit.jupiter.api.Assertions.assertEquals;

/**
 * @Step只能添加到非静态测试方法上
 */
@DisplayName("步骤方法验证-注解方式添加用例步骤")
@Epic("购物平台")
@Feature("订单模块")
public class StepAnTest {
    int result;


    /**
     *@Step("步骤描述")
     */
    @Test
    @DisplayName("减法步骤验证")
    @Step("--减法步骤验证")
    void testSub() {
        User user =new User("刘诗诗",28);
        addUser(user);
        int a =  pressDigit(6);
        String str = pressSubtraction();
        int b = pressDigit(2);
        result = subtract(a, b);
        assertEquals(4, result, a + str + b + "计算错误");
    }

    @Step("输入的用户名和年龄为 {user.name},{user.age}")
    private int addUser(User user) {
        return user.getAge();
    }
    @Step("输入数字 {digit}")
    private int pressDigit(int digit) {
        return digit;
    }
    @Step("输入减号")
    private String pressSubtraction() {
        return "-";
    }

    @Step("减法计算")
    public int subtract(int x, int y) {
        return x-y;
    }
}