#565: initial commit

Author: TikhomirovSergey

src/main/java/io/appium/java_client/pagefactory/AndroidFindAll.java

@@ -26,17 +26,17 @@
  * series of {@link io.appium.java_client.pagefactory.AndroidFindBy} tags
  * It will then search for all elements that match any criteria. Note that elements
  * are not guaranteed to be in document order.
- * It is deprecated. Set of {@link io.appium.java_client.pagefactory.AndroidFindBy}
- * can be defined without this annotation. To define the correct way how to use
- * the defined set please take a look at {@link HowToUseLocators}. The article.
- * https://docs.oracle.com/javase/tutorial/java/annotations/repeating.html.
  */
-@Deprecated
 @Retention(RetentionPolicy.RUNTIME) @Target({ElementType.FIELD, ElementType.TYPE})
 public @interface AndroidFindAll {
     /**
      * It is a set of {@link io.appium.java_client.pagefactory.AndroidFindBy} strategies which may
      * be used to find the target element.
      */
     AndroidFindBy[] value();
+
+    /**
+     * @return priority of the searching
+     */
+    int priority() default 0;
 }

src/main/java/io/appium/java_client/pagefactory/AndroidFindBy.java

@@ -66,4 +66,9 @@
      * It is a xpath to the target element.
      */
     String xpath() default "";
+
+    /**
+     * @return priority of the searching
+     */
+    int priority() default 0;
 }

src/main/java/io/appium/java_client/pagefactory/AndroidFindBys.java

@@ -24,17 +24,17 @@
 /**
  * Used to mark a field on a Page Object to indicate that lookup should use
  * a series of {@link io.appium.java_client.pagefactory.AndroidFindBy} tags.
- * It is deprecated. Set of {@link io.appium.java_client.pagefactory.AndroidFindBy}
- * can be defined without this annotation. To define the correct way how to use
- * the defined set please take a look at {@link HowToUseLocators}. The article.
- * https://docs.oracle.com/javase/tutorial/java/annotations/repeating.html.
  */
-@Deprecated
 @Retention(RetentionPolicy.RUNTIME) @Target({ElementType.FIELD, ElementType.TYPE})
 public @interface AndroidFindBys {
     /**
      * It is a set of {@link io.appium.java_client.pagefactory.AndroidFindBy} strategies which build
      * the chain of the searching for the target element.
      */
     AndroidFindBy[] value();
+
+    /**
+     * @return priority of the searching
+     */
+    int priority() default 0;
 }

src/main/java/io/appium/java_client/pagefactory/SelendroidFindAll.java

@@ -26,17 +26,17 @@
  * series of {@link io.appium.java_client.pagefactory.SelendroidFindBy} tags
  * It will then search for all elements that match any criteria. Note that elements
  * are not guaranteed to be in document order.
- * It is deprecated. Set of {@link io.appium.java_client.pagefactory.SelendroidFindBy}
- * can be defined without this annotation. To define the correct way how to use
- * the defined set please take a look at {@link HowToUseLocators}. The article.
- * https://docs.oracle.com/javase/tutorial/java/annotations/repeating.html.
  */
-@Deprecated
 @Retention(RetentionPolicy.RUNTIME) @Target({ElementType.FIELD, ElementType.TYPE})
 public @interface SelendroidFindAll {
     /**
      * It is a set of {@link io.appium.java_client.pagefactory.SelendroidFindBy} strategies which
      * may be used to find the target element.
      */
     SelendroidFindBy[] value();
+
+    /**
+     * @return priority of the searching
+     */
+    int priority() default 0;
 }

src/main/java/io/appium/java_client/pagefactory/SelendroidFindBy.java

@@ -67,4 +67,9 @@
      * It is a part of the text of the desired element.
      */
     String partialLinkText() default "";
+
+    /**
+     * @return priority of the searching
+     */
+    int priority() default 0;
 }

src/main/java/io/appium/java_client/pagefactory/SelendroidFindBys.java

@@ -24,17 +24,17 @@
 /**
  * Used to mark a field on a Page Object to indicate that lookup should
  * use a series of {@link io.appium.java_client.pagefactory.SelendroidFindBy} tags.
- * It is deprecated. Set of {@link io.appium.java_client.pagefactory.SelendroidFindBy}
- * can be defined without this annotation. To define the correct way how to use
- * the defined set please take a look at {@link HowToUseLocators}. The article.
- * https://docs.oracle.com/javase/tutorial/java/annotations/repeating.html.
  */
-@Deprecated
 @Retention(RetentionPolicy.RUNTIME) @Target({ElementType.FIELD, ElementType.TYPE})
 public @interface SelendroidFindBys {
     /**
      * It is a set of {@link io.appium.java_client.pagefactory.SelendroidFindBy} strategies which
      * build the chain of the searching for the target element.
      */
     SelendroidFindBy[] value();
+
+    /**
+     * @return priority of the searching
+     */
+    int priority() default 0;
 }

src/main/java/io/appium/java_client/pagefactory/WindowsFindAll.java

@@ -0,0 +1,42 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.java_client.pagefactory;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Used to mark a field on a Page/Screen Object to indicate that lookup should use a series
+ * of {@link WindowsFindBy} tags
+ * It will then search for all elements that match any criteria. Note that elements
+ * are not guaranteed to be in document order.
+ */
+@Retention(RetentionPolicy.RUNTIME) @Target({ElementType.FIELD, ElementType.TYPE})
+public @interface WindowsFindAll {
+    /**
+     * It is a set of {@link WindowsFindBy} strategies which may be
+     * used to find the target element.
+     */
+    WindowsFindBy[] value();
+
+    /**
+     * @return priority of the searching
+     */
+    int priority() default 0;
+}

src/main/java/io/appium/java_client/pagefactory/WindowsFindBy.java

@@ -62,4 +62,9 @@
      * It is a xpath to the target element.
      */
     String xpath() default "";
+
+    /**
+     * @return priority of the searching
+     */
+    int priority() default 0;
 }

src/main/java/io/appium/java_client/pagefactory/WindowsFindBys.java

@@ -0,0 +1,40 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.java_client.pagefactory;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Used to mark a field on a Page Object to indicate that lookup should use
+ * a series of {@link WindowsFindBy} tags.
+ */
+@Retention(RetentionPolicy.RUNTIME) @Target({ElementType.FIELD, ElementType.TYPE})
+public @interface WindowsFindBys {
+    /**
+     * It is a set of {@link WindowsFindBy} strategies which build
+     * the chain of the searching for the target element.
+     */
+    WindowsFindBy[] value();
+
+    /**
+     * @return priority of the searching
+     */
+    int priority() default 0;
+}

src/main/java/io/appium/java_client/pagefactory/iOSFindAll.java

@@ -26,17 +26,17 @@
  * of {@link io.appium.java_client.pagefactory.iOSFindBy} tags
  * It will then search for all elements that match any criteria. Note that elements
  * are not guaranteed to be in document order.
- * It is deprecated. Set of {@link io.appium.java_client.pagefactory.iOSFindBy}
- * can be defined without this annotation. To define the correct way how to use
- * the defined set please take a look at {@link HowToUseLocators}. The article.
- * https://docs.oracle.com/javase/tutorial/java/annotations/repeating.html.
  */
-@Deprecated
 @Retention(RetentionPolicy.RUNTIME) @Target({ElementType.FIELD, ElementType.TYPE})
 public @interface iOSFindAll {
     /**
      * It is a set of {@link io.appium.java_client.pagefactory.iOSFindBy} strategies which may be
      * used to find the target element.
      */
     iOSFindBy[] value();
+
+    /**
+     * @return priority of the searching
+     */
+    int priority() default 0;
 }