com.github.arachnidium.model.support.annotations.rootelements.RootAndroidElement Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of arachnidium-app-model Show documentation

The newest version!

package com.github.arachnidium.model.support.annotations.rootelements;

import io.appium.java_client.pagefactory.AndroidFindBy;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * This annotation allows to define the root element
 * in the chain of further searches. Each {@link AndroidFindBy} declaration
 * is a declaration of element in the chain of the searchings
 * for the root element. It is used when mobile app is launched
 * against Android. 
 *
 */
@Target(value = {ElementType.TYPE, ElementType.FIELD})
@Retention(value = RetentionPolicy.RUNTIME)
public @interface RootAndroidElement {
	/**
	 * It is the chain of the searchings for the target element
	 * @return the chain of the searchings for the target element as the {@link AndroidFindBy} array
	 */
	AndroidFindBy[] chain();
	/**
	 * It is the index of the desired element if there few elements are found by the 
	 * given locator chain. This chain is defined by {@link RootAndroidElement#chain()}
	 * @return  the index of the desired element if there few elements are found by the 
	 * given locator chain. This chain is defined by {@link RootAndroidElement#chain()}
	 */
	int index() default -1;
}