com.auxiliary.selenium.location

Class XmlLocation

java.lang.Object

com.auxiliary.selenium.location.AbstractLocation

com.auxiliary.selenium.location.XmlLocation

All Implemented Interfaces:

AppElementLocation, ReadElementLimit, ReadLocation, AddPlaceholder

public class XmlLocation
extends AbstractLocation
implements ReadElementLimit, AppElementLocation

文件名：XmlLocation.java

用途：该类用于从指定格式的xml中读取元素信息
注意：

1. 标签的name属性必须唯一，否则读取会出现错误
2. 不同类型的定位模板可以使用一个id属性，但同一种类型的定位模板id属性是唯一的， 如xpath模板可以使用id='1'，css模板可以使用id='1'，但另一xpath模板的id属性就不能 再定为1，但建议模板的id也唯一存在
3. 元素定位标签只能写xpath、css、classname、id、linktext、name、tagname
4. 所有标签均为小写

编码时间：2017年9月25日下午4:23:40

修改时间：2021年4月17日 上午11:21:25

Since:

JDK 8

Version:

Ver1.6

Author:

彭宇琦

Field Summary

Fields

Modifier and Type	Field and Description
protected org.dom4j.Element	element 缓存元素信息

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

END_SIGN, name, placeholder, START_SIGN

Constructor Summary

Constructors

Constructor and Description
XmlLocation(org.dom4j.Document dom) 根据xml文件的Document对象进行构造
XmlLocation(File xmlFile) 根据xml文件对象进行构造

Method Summary

Modifier and Type	Method and Description
ReadLocation	find(String name) 用于预读元素信息，并将元素信息进行缓存，以便于快速查找元素信息
long	getBeforeTime() 用于返回元素的前置等待时间
String	getContext() 用于返回当前元素的所在的上下文内容
String	getDefaultValue() 用于读取元素的默认值
ArrayList<ElementLocationInfo>	getElementLocation() 用于返回元素的定位信息
ElementType	getElementType() 用于返回元素的类型
ArrayList<String>	getIframeNameList() 用于返回元素的所有父窗体名称集合
long	getWaitTime() 用于返回元素的等待时间
boolean	isNative() 用于返回当前元素是否为app原生元素

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

element

protected org.dom4j.Element element

缓存元素信息

Constructor Detail

XmlLocation

public XmlLocation(File xmlFile)

根据xml文件对象进行构造

Parameters:

xmlFile - xml文件对象

Throws:

IncorrectFileException - xml文件有误时抛出的异常

XmlLocation

public XmlLocation(org.dom4j.Document dom)

根据xml文件的Document对象进行构造

Parameters:

dom - Document对象

Method Detail

getElementLocation

public ArrayList<ElementLocationInfo> getElementLocation()

Description copied from interface: ReadLocation

用于返回元素的定位信息

Specified by:

getElementLocation in interface ReadLocation

Returns:

元素定位信息

getElementType

public ElementType getElementType()

Description copied from interface: ReadLocation

用于返回元素的类型

Specified by:

getElementType in interface ReadLocation

Returns:

元素类型（ElementType枚举）

getIframeNameList

public ArrayList<String> getIframeNameList()

Description copied from interface: ReadLocation

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

Specified by:

getIframeNameList in interface ReadLocation

Returns:

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

getWaitTime

public long getWaitTime()

Description copied from interface: ReadLocation

用于返回元素的等待时间

Specified by:

getWaitTime in interface ReadLocation

Returns:

元素的等待时间

getDefaultValue

public String getDefaultValue()

Description copied from interface: ReadElementLimit

用于读取元素的默认值

Specified by:

getDefaultValue in interface ReadElementLimit

Returns:

元素的默认值

find

public ReadLocation find(String name)

Description copied from interface: ReadLocation

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

Specified by:

find in interface ReadLocation

Parameters:

name - 元素名称

isNative

public boolean isNative()

Description copied from interface: AppElementLocation

用于返回当前元素是否为app原生元素

Specified by:

isNative in interface AppElementLocation

Returns:

是否为app原生元素

getContext

public String getContext()

Description copied from interface: AppElementLocation

用于返回当前元素的所在的上下文内容

Specified by:

getContext in interface AppElementLocation

Returns:

上下文内容

getBeforeTime

public long getBeforeTime()

Description copied from interface: ReadLocation

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

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

Specified by:

getBeforeTime in interface ReadLocation

Returns:

元素等待时间