com.auxiliary.selenium.location

Class TextLocation

java.lang.Object

com.auxiliary.selenium.location.AbstractLocation

com.auxiliary.selenium.location.TextLocation

All Implemented Interfaces:

ReadLocation, AddPlaceholder

public class TextLocation
extends AbstractLocation

文件名：TextLcation.java

用途： 用于读取以文本形式存储的元素定位信息。其中，文本中每一行为一条元素信息，元素信息 之间与元素层级的标识，可以通过方法进行设置，之后将按照设置的方式对元素信息与层级 进行计算。默认情况下使用空格作为元素信息分隔的符号，制表符作为元素层级的标识。

元素前三个信息必须是“元素名称（分隔符）元素定位类型（分隔符）元素定位内容”，例如： “用户名==xpath==\\*[@name='username']”，缺失信息或位置错误其元素均无法识别，则抛出 UndefinedElementException异常。后两个元素信息分别为元素等待时间与元素类型， 两者均为整形数字，同样也存在顺序，例如：

• 若只存在一个数字，且数字在ElementType枚举范围内，则表示数字为元素枚举，如 “用户名==xpath==\\*[@name='username']==2”，则表示元素等待时间为2秒
• 若只存在两个个数字，则按照顺序读取元素信息，如 “用户名==xpath==\\*[@name='username']==2==0”，则表示元素类型为ElementType.COMMON_ELEMENT ，且元素等待时间为2秒

编码时间：2020年11月3日下午8:45:25

修改时间：2021年3月9日上午8:08:45

Version:

Ver1.0

Author:

彭宇琦

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_INFO_SPLIT_SIGN 默认元素信息分隔符号
static String	DEFAULT_LEVEL_SPLIT_SIGN 默认元素层级标识符
static String	ELEMENT_SPLIT_SIGN 默认元素间分隔符号
protected List<String>	iframeNameList 用于存储当前窗体的层级结构
protected String	infoSplitSign 存储设置的元素信息分隔符号
protected String	levelSplitSign 存储设置的元素层级标识符
protected String	nowElementName 用于存储当前读取的元素名称

Fields inherited from class com.auxiliary.selenium.location.AbstractLocation

END_SIGN, name, placeholder, START_SIGN

Constructor Summary

Constructors

Constructor and Description
TextLocation(String text) 通过默认元素信息及层级信息分隔符对文本中元素信息进行分割，构造相应元素信息对象。默认 元素信息分隔符为“==”（DEFAULT_INFO_SPLIT_SIGN），默认层级分隔符为制表符 （DEFAULT_LEVEL_SPLIT_SIGN）
TextLocation(String text, String infoSplitSign, String levelSplitSign) 通过自定义的元素信息与元素层级分隔符号对文本中元素信息进行分隔，构造元素信息对象。

Method Summary

Modifier and Type	Method and Description
protected void	analysisElement(String elementText) 用于对文本元素信息进行切分，将元素信息分别存储
protected String	analysisElementInformation(String elementText) 用于分析元素信息
protected void	analysisElementLevel(String name, String elementText) 用于分析元素的层级结构
ReadLocation	find(String name) 用于预读元素信息，并将元素信息进行缓存，以便于快速查找元素信息
long	getBeforeTime() 用于返回元素的前置等待时间
ArrayList<ElementLocationInfo>	getElementLocation() 用于返回元素的定位信息
ElementType	getElementType() 用于返回元素的类型
ArrayList<String>	getIframeNameList() 用于返回元素的所有父窗体名称集合
long	getWaitTime() 用于返回元素的等待时间
void	setSplitSign(String infoSign, String levelSign) 用于设置文本中元素信息切分符号与元素层级标识符号。由于字符串的切分按照 正则表达式进行切分，若使用特殊字符（如制表符“\t”），则需要按照正则的 写法（如制表符应写为“\\t”）

Methods inherited from class com.auxiliary.selenium.location.AbstractLocation

addReplaceFunction, addReplaceWord, getEndElementPlaceholder, getPlaceholder, getStartElementPlaceholder, setElementPlaceholder, toElementType, toWaitTime

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_INFO_SPLIT_SIGN

public static final String DEFAULT_INFO_SPLIT_SIGN

默认元素信息分隔符号

See Also:

Constant Field Values

DEFAULT_LEVEL_SPLIT_SIGN

public static final String DEFAULT_LEVEL_SPLIT_SIGN

默认元素层级标识符

See Also:

Constant Field Values

ELEMENT_SPLIT_SIGN

public static final String ELEMENT_SPLIT_SIGN

默认元素间分隔符号

See Also:

Constant Field Values

infoSplitSign

protected String infoSplitSign

存储设置的元素信息分隔符号

levelSplitSign

protected String levelSplitSign

存储设置的元素层级标识符

iframeNameList

protected List<String> iframeNameList

用于存储当前窗体的层级结构

nowElementName

protected String nowElementName

用于存储当前读取的元素名称

Constructor Detail

TextLocation

public TextLocation(String text)

通过默认元素信息及层级信息分隔符对文本中元素信息进行分割，构造相应元素信息对象。默认 元素信息分隔符为“==”（DEFAULT_INFO_SPLIT_SIGN），默认层级分隔符为制表符 （DEFAULT_LEVEL_SPLIT_SIGN）

Parameters:

text - 元素信息文本

TextLocation

public TextLocation(String text,
                    String infoSplitSign,
                    String levelSplitSign)

通过自定义的元素信息与元素层级分隔符号对文本中元素信息进行分隔，构造元素信息对象。

注意：

1. 由于字符串的切分按照正则表达式进行切分，若使用特殊字符（如制表符“\t”），则需要按照正则的 写法（如制表符应写为“\\t”）。
2. 请勿在元素信息中使用元素信息分隔符，否则会导致元素信息读取异常

Parameters:

text - 元素信息文本

infoSplitSign - 元素信息分隔符

levelSplitSign - 元素层级分隔符

Method Detail

setSplitSign

public void setSplitSign(String infoSign,
                         String levelSign)

用于设置文本中元素信息切分符号与元素层级标识符号。由于字符串的切分按照 正则表达式进行切分，若使用特殊字符（如制表符“\t”），则需要按照正则的 写法（如制表符应写为“\\t”）

Parameters:

infoSign - 元素信息分隔符号

levelSign - 元素层级标识符号

getElementLocation

public ArrayList<ElementLocationInfo> getElementLocation()

Description copied from interface: ReadLocation

用于返回元素的定位信息

Returns:

元素定位信息

getElementType

public ElementType getElementType()

Description copied from interface: ReadLocation

用于返回元素的类型

Returns:

元素类型（ElementType枚举）

getIframeNameList

public ArrayList<String> getIframeNameList()

Description copied from interface: ReadLocation

用于返回元素的所有父窗体名称集合

Returns:

元素的所有父窗体名称集合

getWaitTime

public long getWaitTime()

Description copied from interface: ReadLocation

用于返回元素的等待时间

Returns:

元素的等待时间

analysisElement

protected void analysisElement(String elementText)

用于对文本元素信息进行切分，将元素信息分别存储

Parameters:

elementText - 元素信息

Throws:

UndefinedElementException - 元素信息不足或元素缺少关键信息时抛出的异常

analysisElementLevel

protected void analysisElementLevel(String name,
                                    String elementText)

用于分析元素的层级结构

Parameters:

name - 元素名称

elementText - 元素信息

analysisElementInformation

protected String analysisElementInformation(String elementText)

用于分析元素信息

Parameters:

elementText - 元素信息

Returns:

元素名称

Throws:

UndefinedElementException - 元素信息不足或元素缺少关键信息时抛出的异常

find

public ReadLocation find(String name)

Description copied from interface: ReadLocation

用于预读元素信息，并将元素信息进行缓存，以便于快速查找元素信息

Parameters:

name - 元素名称

getBeforeTime

public long getBeforeTime()

Description copied from interface: ReadLocation

用于返回元素的前置等待时间

注意：该方法读取到的时间单位为毫秒

Returns:

元素等待时间