com.auxiliary.testcase.templet

Class CaseData

java.lang.Object

com.auxiliary.testcase.templet.CaseData

public class CaseData
extends Object

文件名：CaseData.java

用途： 提供测试用例数据的写入和返回方法

编码时间：2023年1月4日 下午2:24:26

修改时间：2023年1月4日 下午2:24:26

Since:

JDK 1.8, autest 4.0.0

Version:

Ver1.0

Author:

彭宇琦

Constructor Summary

Constructors

Constructor and Description
CaseData(AbstractCaseTemplet caseTemplet) 构造对象，并设置当前生成用例的模板类对象

Method Summary

Modifier and Type	Method and Description
CaseData	addContent(CaseData caseDate, String... fields) 该方法用于将测试用例类对象下下指定字段的内容拼接至当前测试用例类对象相应字段下
CaseData	addContent(String field, int insertIndex, List<String> contentList) 该方法用于向指定的字段中插入指定的内容，下标支持反序遍历
CaseData	addContent(String field, int insertIndex, String... contents) 该方法用于向指定的字段中插入指定的内容，下标支持反序遍历
AbstractCaseTemplet	getCaseTemplet() 该方法用于返回用例模板类对象
List<String>	getContent(String field) 该方法用于对指定字段中的内容进行返回，若字段不存在，则返回空集合
Set<String>	getFields() 该方法用于返回用例中包含的所有字段
Placeholder	getPlaceholder() 该方法用于返回模板的占位符类对象
Map<String,DataFunction>	getReplaceWordMap() Deprecated. 该方法已失效，已有getPlaceholder()方法代替，将在5.1.0版本后删除
CaseData	removeContent(int removeIndex, String... fields) 该方法用于对指定下标的内容进行移除，下标支持反序遍历
CaseData	replaceContent(String field, int replaceIndex, String... contents) 该方法用于对指定下标的内容进行替换，下标支持反序遍历
String	toString() 该方法用于返回当前存储的用例内容，转换为json的形式进行返回

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

CaseData

public CaseData(AbstractCaseTemplet caseTemplet)

构造对象，并设置当前生成用例的模板类对象

在写入用例时需要读取模板类中的内容，若通过用例模板子类生成的测试用例数据，建议使用该构造，在构造对象时使用如下形式进行构造

 CaseData caseData = new CaseData(this)
 

若不存在模板，可传入null进行构造

Parameters:

caseTemplet - 用例模板类对象

Method Detail

getCaseTemplet

public AbstractCaseTemplet getCaseTemplet()

该方法用于返回用例模板类对象

Returns:

用例模板类对象

Since:

autest 4.0.0

addContent

public CaseData addContent(String field,
                           int insertIndex,
                           String... contents)

该方法用于向指定的字段中插入指定的内容，下标支持反序遍历

下标为内容所在位置的真实下标，其逻辑如下：

• 正序插入内容（传入正数），则在指定的真实下标前插入内容：
  • 当传入大于等于1且小于等于字段内容集合总个数（以下简称“总数”）时，则在指定的下标前插入指定的内容，例如，下标传入“2”，则在第2条内容前插入指定的内容
  • 当传入大于总数时，则在最后一条内容前插入指定的内容
  • 当传入0时，则在第1条内容前插入指定的内容
• 反序插入内容（传入负数），则在指定的真实下标后插入内容：
• 当传入小于-1且大于等于总数的相反数时，则在倒数指定的下标内容后插入指定的内容，例如，下标传入“-2”，则在倒数第2条内容后插入指定的内容
• 当传入小于总数的相反数时，则第1条内容后插入指定的内容

Parameters:

field - 字段名称

insertIndex - 插入的下标

contents - 插入的内容字符串数组

Returns:

类本身

Since:

autest 4.0.0

addContent

public CaseData addContent(String field,
                           int insertIndex,
                           List<String> contentList)

该方法用于向指定的字段中插入指定的内容，下标支持反序遍历

下标为内容所在位置的真实下标，其逻辑如下：

• 正序插入内容（传入正数）：
  • 当传入大于等于1且小于等于字段内容集合总个数（以下简称“总数”）时，则在指定的下标前插入指定的内容，例如，下标传入“2”，则在第2条内容前插入指定的内容
  • 当传入大于总数时，则在最后一条内容后插入指定的内容
  • 当传入0时，则在第1条内容前插入指定的内容
• 反序插入内容（传入负数）：
• 当传入小于等于-1且大于等于总数的相反数时，则在倒数指定的下标内容后插入指定的内容，例如，下标传入“-2”，则在倒数第2条内容后插入指定的内容
• 当传入小于总数的相反数时，则第1条内容前插入指定的内容

Parameters:

field - 字段名称

insertIndex - 插入的下标

contentList - 插入的内容字符串集合

Returns:

类本身

Since:

autest 4.0.0

addContent

public CaseData addContent(CaseData caseDate,
                           String... fields)

该方法用于将测试用例类对象下下指定字段的内容拼接至当前测试用例类对象相应字段下

Parameters:

caseDate - 已生成的测试用例类对象

fields - 指定的字段组

Returns:

当前用例类对象

Since:

autest 4.0.0

removeContent

public CaseData removeContent(int removeIndex,
                              String... fields)

该方法用于对指定下标的内容进行移除，下标支持反序遍历

下标为内容所在位置的真实下标，其逻辑如下（默认指定的字段存在内容，且不超过5条）：

• 正序插入内容（传入正数）：
  • 当传入大于等于1且小于等于字段内容集合总个数（以下简称“总数”）时，则删除指定的下标内容，例如，下标传入“2”，则删除第2条内容
  • 当传入大于总数时，则删除最后一条内容
  • 当传入0时，则删除第1条内容
• 反序插入内容（传入负数），则在指定的真实下标后插入内容：
• 当传入小于-1且大于等于总数的相反数时，则删除倒数指定下标的内容，例如，下标传入“-2”，则删除倒数第2条内容
• 当传入小于总数的相反数时，则删除第1条内容

Parameters:

removeIndex - 需要移除内容的真实所在下标

fields - 需要删除指定下标的字段组

Returns:

类本身

Since:

autest 4.0.0

replaceContent

public CaseData replaceContent(String field,
                               int replaceIndex,
                               String... contents)

该方法用于对指定下标的内容进行替换，下标支持反序遍历

下标为内容所在位置的真实下标，其逻辑如下（默认指定的字段存在内容，且不超过5条）：

• 正序插入内容（传入正数）：
  • 当传入大于等于1且小于等于字段内容集合总个数（以下简称“总数”）时，则替换指定的下标内容，例如，下标传入“2”，则替换第2条内容
  • 当传入大于总数时，则替换最后一条内容
  • 当传入0时，则替换第1条内容
• 反序插入内容（传入负数），则在指定的真实下标后插入内容：
• 当传入小于-1且大于等于总数的相反数时，则替换倒数指定下标的内容，例如，下标传入“-2”，则替换倒数第2条内容
• 当传入小于总数的相反数时，则替换第1条内容

Parameters:

field - 字段名称

replaceIndex - 需要替换的下标

contents - 替换的内容组

Returns:

类本身

Since:

autest 4.0.0

getContent

public List<String> getContent(String field)

该方法用于对指定字段中的内容进行返回，若字段不存在，则返回空集合

Parameters:

field - 字段

Returns:

字段对应的内容集合

Since:

autest 4.0.0

getFields

public Set<String> getFields()

该方法用于返回用例中包含的所有字段

Returns:

用例字段集合

Since:

autest 4.0.0

getReplaceWordMap

@Deprecated
public Map<String,DataFunction> getReplaceWordMap()

Deprecated. 该方法已失效，已有getPlaceholder()方法代替，将在5.1.0版本后删除

该方法用于返回指定的模板类对象中存储的需要替换模板占位符的词语集合，若未指定模板类对象，则返回空集合

Returns:

需要替换模板占位符的词语集合

Since:

autest 4.0.0

getPlaceholder

public Placeholder getPlaceholder()

该方法用于返回模板的占位符类对象

Returns:

占位符类对象

Since:

autest 5.0.0

toString

public String toString()

该方法用于返回当前存储的用例内容，转换为json的形式进行返回

Overrides:

toString in class Object

Returns:

用例json形式

Since:

autest 4.0.0