搜索策略添加描述接口

Author: LinuxSuRen

src/main/java/org/suren/autotest/web/framework/core/ElementSearchStrategy.java

@@ -14,4 +14,9 @@ public interface ElementSearchStrategy<T>
 	 * @return
 	 */
 	T search(Element element);
+	
+	/**
+	 * @return 当前策略的描述信息
+	 */
+	String description();
 }

src/main/java/org/suren/autotest/web/framework/selenium/strategy/CyleSearchStrategy.java

@@ -108,4 +108,10 @@ private WebElement findElement(By by)
 		return engine.getDriver().findElement(by);
 	}
 
+	@Override
+	public String description()
+	{
+		return "循环元素定位搜索策略。";
+	}
+
 }

src/main/java/org/suren/autotest/web/framework/selenium/strategy/PrioritySearchStrategy.java

@@ -224,4 +224,11 @@ public void setParent(WebElement parentWebElement)
 	{
 		this.parentElement = parentWebElement;
 	}
+
+	@Override
+	public String description()
+	{
+		return "根据预先给定的元素定位方法优先级进行搜索，直到找到元素或者定位方法穷举完毕。"
+				+ "如果元素指定了显式的查找超时时间，则采用可见性的超时等待。";
+	}
 }

src/main/java/org/suren/autotest/web/framework/selenium/strategy/ZoneSearchStrategy.java

@@ -38,6 +38,7 @@ public class ZoneSearchStrategy implements ElementSearchStrategy<WebElement>, Pa
 
 	private int failedCount = 0;
 	private int maxFailed = 6;
+	private int timeout = 1500;
 
 	private WebElement parentWebElement;
 
@@ -114,7 +115,6 @@ private WebElement retry(AbstractLocator<WebElement> absLocator, SearchContext w
 		}
 		else
 		{
-			int timeout = 1500;
 			logger.warn("Can not found element by locator {}, "
 					+ "will retry locate again {} millis later, failed times {}.",
 					absLocator, timeout, failedCount);
@@ -127,4 +127,11 @@ private WebElement retry(AbstractLocator<WebElement> absLocator, SearchContext w
 	public void setParent(WebElement parentWebElement) {
 		this.parentWebElement = parentWebElement;
 	}
+
+	@Override
+	public String description()
+	{
+		return String.format("区域搜索策略，按照元素的区域划分，分层次地进行多次定位搜索。每次元素查找失败，"
+				+ "都会进行重试（%s次），每次失败后的超时时间为%s毫秒。", maxFailed, timeout);
+	}
 }