com.auxiliary.selenium.element

Class FindMultiElement<T extends FindMultiElement<T>>

java.lang.Object

com.auxiliary.selenium.element.FindElement

com.auxiliary.selenium.element.FindMultiElement<T>

Direct Known Subclasses:

FindDataListElement, FindSelectElement

public abstract class FindMultiElement<T extends FindMultiElement<T>>
extends FindElement

文件名：ListBy.java

用途： 提供对多元素获取与返回的基本方法

编码时间：2020年10月14日下午6:54:46

修改时间：2020年10月14日下午6:54:46

Version:

Ver1.0

Author:

彭宇琦

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	firstEmpty 用于记录当前元素集合中第一个元素是否为不可选择的元素，用于对元素的随机返回

Fields inherited from class com.auxiliary.selenium.element.FindElement

action, brower, elementData, elementList, isAutoSwitchIframe, read

Constructor Summary

Constructors

Constructor and Description
FindMultiElement(AbstractBrower brower) 构造方法，初始化浏览器对象

Method Summary

Modifier and Type	Method and Description
T	find(String elementName, String... linkKeys) 用于指定查找的元素集合名称，二次查找元素时，将覆盖上一次查找的元素。调用该方法在 无法查到页面元素时，其不会抛出TimeoutException异常
List<Element>	getAllElement() 用于返回当前元素集合中所有的元素集合。若未调用find(String, String...)方法对元素进行查找， 或者查无元素时，则调用该方法时会抛出超时异常
Element	getElement(int index) 用于获取元素集合中指定下标的元素，该下标允许反向遍历与随机返回，其下标所传入的数字即为元素所在的真实下标。
boolean	removeElement(int index) 用于移除元素集合中的指定下标的元素。其下标所传入的数字即为元素所在的真实下标，可参见 getElement(int)方法的参数说明。若未调用find(String, String...) 方法对元素进行查找，或者查无元素时，调用该方法将不进行任何操作
void	setFirstIsEmpty(boolean firstEmpty) 用于设置当前元素集合中首元素是否为允许随机返回的元素 例如：获取列表元素时，首元素为标题元素；获取下拉选项元素集合时， 第一个元素为空选项或者为类似“请选择”等选项
int	size() 用于返回当前存储的元素集合长度，若未对元素进行获取，则返回0

Methods inherited from class com.auxiliary.selenium.element.FindElement

autoSwitchContext, autoSwitchFrame, clearAction, findElement, getBy, getElementData, recognitionElement, setAction, setAutoSwitchIframe, setReadMode, setWaitTime, switchAppNativeContext, switchFrame, switchParentFrame, switchRootFrame, switchWebViewContext, toElementIndex

Methods inherited from class java.lang.Object

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

Field Detail

firstEmpty

protected boolean firstEmpty

用于记录当前元素集合中第一个元素是否为不可选择的元素，用于对元素的随机返回

Constructor Detail

FindMultiElement

public FindMultiElement(AbstractBrower brower)

构造方法，初始化浏览器对象

Parameters:

brower - AbstractBrower类对象

Method Detail

setFirstIsEmpty

public void setFirstIsEmpty(boolean firstEmpty)

用于设置当前元素集合中首元素是否为允许随机返回的元素
例如：获取列表元素时，首元素为标题元素；获取下拉选项元素集合时， 第一个元素为空选项或者为类似“请选择”等选项

Parameters:

firstEmpty - 首元素是否为允许随机返回的元素

find

public T find(String elementName,
              String... linkKeys)

用于指定查找的元素集合名称，二次查找元素时，将覆盖上一次查找的元素。调用该方法在 无法查到页面元素时，其不会抛出TimeoutException异常

Parameters:

elementName - 元素名称

linkKeys - 外链词语

size

public int size()

用于返回当前存储的元素集合长度，若未对元素进行获取，则返回0

Returns:

元素集合长度

removeElement

public boolean removeElement(int index)

用于移除元素集合中的指定下标的元素。其下标所传入的数字即为元素所在的真实下标，可参见 getElement(int)方法的参数说明。若未调用find(String, String...) 方法对元素进行查找，或者查无元素时，调用该方法将不进行任何操作

Parameters:

index - 元素下标

Returns:

是否删除成功

getElement

public Element getElement(int index)

用于获取元素集合中指定下标的元素，该下标允许反向遍历与随机返回，其下标所传入的数字即为元素所在的真实下标。

例如：

• 传入1时，表示获取元素集合中的第1个元素
• 传入0时，表示获取元素集合中在长度范围内随机一个元素
• 传入-1时，表示获取元素集合中的倒数第1个元素

注意：调用该方法前，若未调用find(String, String...)方法对元素进行查找， 或者查无元素时，调用该方法不会抛出异常，但当调用Element.getWebElement()方法时， 由于未查到元素则会抛出异常

Parameters:

index - 元素下标

Returns:

Element类对象

getAllElement

public List<Element> getAllElement()

用于返回当前元素集合中所有的元素集合。若未调用find(String, String...)方法对元素进行查找， 或者查无元素时，则调用该方法时会抛出超时异常

Returns:

Element类对象List集合

Throws:

org.openqa.selenium.TimeoutException - 元素在页面不存在时抛出的异常