AbstractWebBrower (autest

java.lang.Object
- com.auxiliary.selenium.brower.AbstractBrower
- - com.auxiliary.selenium.brower.AbstractWebBrower

Direct Known Subclasses:

ChromeBrower, FirefoxBrower, IeBrower, RemoteBrower
```
public abstract class AbstractWebBrower
extends AbstractBrower
```
文件名：AbstractBrower.java

用途：该类定义启动浏览器时必要的方法，开启浏览器的方法由子类继承编写

编码时间：2020年4月17日下午8:51:53

修改时间：2021年4月2日上午8:28:30

Since:

JDK 1.8

Version:

Ver1.2

Author:

彭宇琦

Field Summary

Fields
Modifier and Type	Field and Description
`protected File`	`driverFile` 用于接收浏览器启动所需的文件路径
`protected Page`	`nowPage` 用于存储WebDriver当前指向的页面信息
`protected HashMap<String,Page>`	`pageMap` 存储打开的页面
`protected HashSet<String>`	`windowHandleSet` 存储浏览器打开的窗口handle值

Fields inherited from class com.auxiliary.selenium.brower.AbstractBrower
driver, informationJson

Constructor Summary

Constructors
Modifier	Constructor and Description
	`AbstractWebBrower(File driverFile)` 指定驱动文件所在路径
	`AbstractWebBrower(File driverFile, Page page)` 指定驱动文件路径并添加一个待测站点
	`AbstractWebBrower(File driverFile, String url, String pageName)` 指定驱动文件路径并添加一个待测站点
`protected`	`AbstractWebBrower(Page page)` 无参构造，方便子类扩展其他构造方法

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`String`	`alertAccept()` 定位到弹框上并且点击确定按钮，并返回弹框上的文本
`String`	`alertDimiss()` 定位到弹框上并且点击取消按钮，并返回弹框上的文本
`String`	`alertGetText()` 获取弹框上的文本
`String`	`alertInput(String content)` 定位到弹框上并且在其文本框中输入信息
`void`	`closeBrower()` 用于关闭浏览器
`void`	`closeLabel()` 用于关闭当前标签，若只存在一个标签时，关闭标签页后将生成一个空白页
`String`	`getAllInformation()` 用于以json字符串的形式返回浏览器的信息
`protected abstract String`	`getBrowerDriverSetName()` 用于返回浏览器驱动设置的名称，由于每个浏览器不同，导致启动驱动名称也不同
`org.openqa.selenium.WebDriver`	`getDriver()` 用于启动浏览器，并返回WebDriver对象
`Page`	`getNowPage()` 用于返回当前指向的窗体打开的页面`Page`对象
`List<Page>`	`getOpenPage()` 用于返回当前在浏览器中被打开的页面
`boolean`	`hasPopuWindow()` 用于判断当前浏览器中是否存在弹窗（未被存储的浏览器标签）。注意，若在浏览器上自行打开的标签，其也会被计算为弹窗
`void`	`initialization()` 用于重启浏览器，若未生成WebDriver对象时（即未调用`getDriver()`方法时），则方法调用无效
`void`	`maxWindow()` 用于将浏览器全屏显示
`void`	`openUrl(Page newPage, boolean openNewLabel)` 该方法用于打开新的站点，根据传入的openNewLabel参数，则以以下方式进入站点： openNewLabel为true，则重新打开一个标签页，在新的标签页中打开站点 openNewLabel为false，则在当前的标签页中打开站点注意：若未生成WebDriver对象时（即未调用`getDriver()`方法时），则抛出异常若生成WebDriver对象但未设置默认页面时（即调用了`AbstractWebBrower(File)`单参构造来构造对象），则在调用该方法时，无论openNewLabel传入是何值，均不影响在第一个标签中打开页面执行该方法后，其WebDriver对象将切换至新的标签页上
`void`	`openUrl(String url, String pageName, boolean openNewLabel)` 该方法用于打开新的站点，通过该方法将生成一个Page对象，存在类中，并根据传入的openNewLabel参数，则以以下方式进入站点： openNewLabel为true，则重新打开一个标签页，在新的标签页中打开站点 openNewLabel为false，则在当前的标签页中打开站点注意：若未生成WebDriver对象时（即未调用`getDriver()`方法时），则抛出异常若生成WebDriver对象但未设置默认页面时（即调用了`AbstractWebBrower(File)`单参构造来构造对象），则在调用该方法时，无论openNewLabel传入是何值，均不影响在第一个标签中打开页面执行该方法后，其WebDriver对象将切换至新的标签页上
`void`	`refreshPage()` 用于刷新当前页面，若未生成WebDriver对象时（即未调用`getDriver()`方法时），则方法调用无效
`void`	`switchNowPage()` 用于切换到当前页面
`boolean`	`switchPopuWindow()` 用于切换到弹窗上，当浏览器存在多个弹窗时，该方法无法保证能切换至理想的窗口，但调用该方法后，其弹窗会作为`Page`类对象进行存储，其页面名称为当前窗口的 handle值，若切换的窗口非理想的窗口，则可以多次调用该方法，直至切换至理想的窗口为止。若当前不存在弹窗，则返回false，若切换弹窗成功，则返回true
`void`	`switchWindow(Page page)` 用于根据页面切换页面
`void`	`switchWindow(String pageName)` 用于根据页面名称切换页面

Methods inherited from class com.auxiliary.selenium.brower.AbstractBrower
getLogRecord, openBrower

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - driverFile
```
protected File driverFile
```
    用于接收浏览器启动所需的文件路径
  - pageMap
```
protected HashMap<String,Page> pageMap
```
    存储打开的页面
  - windowHandleSet
```
protected HashSet<String> windowHandleSet
```
    存储浏览器打开的窗口handle值
  - nowPage
```
protected Page nowPage
```
    用于存储WebDriver当前指向的页面信息
- Constructor Detail
  - AbstractWebBrower
```
protected AbstractWebBrower(Page page)
```
    无参构造，方便子类扩展其他构造方法
  - AbstractWebBrower
```
public AbstractWebBrower(File driverFile)
```
    指定驱动文件所在路径
    
    Parameters:
    
    driverFile - 驱动文件对象
  - AbstractWebBrower
```
public AbstractWebBrower(File driverFile,
                         String url,
                         String pageName)
```
    指定驱动文件路径并添加一个待测站点
    
    Parameters:
    
    driverFile - 驱动文件对象
    
    url - 待测站点
    
    pageName - 待测站点名称，用于切换页面
  - AbstractWebBrower
```
public AbstractWebBrower(File driverFile,
                         Page page)
```
    指定驱动文件路径并添加一个待测站点
    
    Parameters:
    
    driverFile - 驱动文件对象
    
    page - Page类对象
- Method Detail
  - openUrl
```
public void openUrl(String url,
                    String pageName,
                    boolean openNewLabel)
```
    该方法用于打开新的站点，通过该方法将生成一个Page对象，存在类中，并根据传入的openNewLabel参数，则以以下方式进入站点：
    - openNewLabel为true，则重新打开一个标签页，在新的标签页中打开站点
    - openNewLabel为false，则在当前的标签页中打开站点
    注意：
    1. 若未生成WebDriver对象时（即未调用getDriver()方法时），则抛出异常
    2. 若生成WebDriver对象但未设置默认页面时（即调用了AbstractWebBrower(File)单参构造来构造对象），则在调用该方法时，无论openNewLabel传入是何值，均不影响在第一个标签中打开页面
    3. 执行该方法后，其WebDriver对象将切换至新的标签页上
    Parameters:
    
    url - 站点域名
    
    pageName - 页面名称
    
    openNewLabel - 是否在新标签中打开页面
    
    Throws:
    
    IncorrectPageException - 当浏览器未打开或者页面加载错误时抛出的异常
  - openUrl
```
public void openUrl(Page newPage,
                    boolean openNewLabel)
```
    该方法用于打开新的站点，根据传入的openNewLabel参数，则以以下方式进入站点：
    - openNewLabel为true，则重新打开一个标签页，在新的标签页中打开站点
    - openNewLabel为false，则在当前的标签页中打开站点
    注意：
    1. 若未生成WebDriver对象时（即未调用getDriver()方法时），则抛出异常
    2. 若生成WebDriver对象但未设置默认页面时（即调用了AbstractWebBrower(File)单参构造来构造对象），则在调用该方法时，无论openNewLabel传入是何值，均不影响在第一个标签中打开页面
    3. 执行该方法后，其WebDriver对象将切换至新的标签页上
    Parameters:
    
    newPage - Page类对象
    
    openNewLabel - 是否在新标签中打开页面
    
    Throws:
    
    IncorrectPageException - 当浏览器未打开或者页面加载错误时抛出的异常
  - getDriver
```
public org.openqa.selenium.WebDriver getDriver()
```
    Description copied from class: AbstractBrower
    
    用于启动浏览器，并返回WebDriver对象
    
    Specified by:
    
    getDriver in class AbstractBrower
    
    Returns:
    
    指向浏览器的WebDriver对象
  - getBrowerDriverSetName
```
protected abstract String getBrowerDriverSetName()
```
    用于返回浏览器驱动设置的名称，由于每个浏览器不同，导致启动驱动名称也不同
    
    Returns:
    
    驱动设置名称
  - getAllInformation
```
public String getAllInformation()
```
    Description copied from class: AbstractBrower
    
    用于以json字符串的形式返回浏览器的信息
    
    Specified by:
    
    getAllInformation in class AbstractBrower
    
    Returns:
    
    浏览器的信息
  - getOpenPage
```
public List<Page> getOpenPage()
```
    用于返回当前在浏览器中被打开的页面
    
    Returns:
    
    在浏览器中被打开的Page对象
  - getNowPage
```
public Page getNowPage()
```
    用于返回当前指向的窗体打开的页面Page对象
    
    Returns:
    
    Page对象
  - initialization
```
public void initialization()
```
    用于重启浏览器，若未生成WebDriver对象时（即未调用getDriver()方法时），则方法调用无效
  - refreshPage
```
public void refreshPage()
```
    用于刷新当前页面，若未生成WebDriver对象时（即未调用getDriver()方法时），则方法调用无效
  - maxWindow
```
public void maxWindow()
```
    用于将浏览器全屏显示
  - closeLabel
```
public void closeLabel()
```
    用于关闭当前标签，若只存在一个标签时，关闭标签页后将生成一个空白页
  - closeBrower
```
public void closeBrower()
```
    Description copied from class: AbstractBrower
    
    用于关闭浏览器
    
    Overrides:
    
    closeBrower in class AbstractBrower
  - switchWindow
```
public void switchWindow(String pageName)
```
    用于根据页面名称切换页面
    
    Parameters:
    
    pageName - 页面名称
  - switchWindow
```
public void switchWindow(Page page)
```
    用于根据页面切换页面
    
    Parameters:
    
    page - 页面对象
  - switchNowPage
```
public void switchNowPage()
```
    用于切换到当前页面
  - switchPopuWindow
```
public boolean switchPopuWindow()
```
    用于切换到弹窗上，当浏览器存在多个弹窗时，该方法无法保证能切换至理想的窗口，但调用该方法后，其弹窗会作为Page类对象进行存储，其页面名称为当前窗口的 handle值，若切换的窗口非理想的窗口，则可以多次调用该方法，直至切换至理想的窗口为止。若当前不存在弹窗，则返回false，若切换弹窗成功，则返回true
    
    Returns:
    
    是否成功切换弹窗
  - hasPopuWindow
```
public boolean hasPopuWindow()
```
    用于判断当前浏览器中是否存在弹窗（未被存储的浏览器标签）。注意，若在浏览器上自行打开的标签，其也会被计算为弹窗
    
    Returns:
    
    是否存在弹窗
  - alertAccept
```
public String alertAccept()
```
    定位到弹框上并且点击确定按钮，并返回弹框上的文本
    
    Returns:
    
    弹框上的文本
  - alertDimiss
```
public String alertDimiss()
```
    定位到弹框上并且点击取消按钮，并返回弹框上的文本
    
    Returns:
    
    弹框上的文本
  - alertInput
```
public String alertInput(String content)
```
    定位到弹框上并且在其文本框中输入信息
    
    Parameters:
    
    content - 需要输入的信息
    
    Returns:
    
    弹框上的文本
  - alertGetText
```
public String alertGetText()
```
    获取弹框上的文本
    
    Returns:
    
    弹框上的文本

Class AbstractWebBrower

Field Summary

Fields inherited from class com.auxiliary.selenium.brower.AbstractBrower

Constructor Summary

Method Summary

Methods inherited from class com.auxiliary.selenium.brower.AbstractBrower

Methods inherited from class java.lang.Object

Field Detail

driverFile

pageMap

windowHandleSet

nowPage

Constructor Detail

AbstractWebBrower

AbstractWebBrower

AbstractWebBrower

AbstractWebBrower

Method Detail

openUrl

openUrl

getDriver

getBrowerDriverSetName

getAllInformation

getOpenPage

getNowPage

initialization

refreshPage

maxWindow

closeLabel

closeBrower

switchWindow

switchWindow

switchNowPage

switchPopuWindow

hasPopuWindow

alertAccept

alertDimiss

alertInput

alertGetText