• Home
• io.appium
• java-client
• 3.0.0
• source code
• AppiumAnnotations.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

io.appium.java_client.pagefactory.AppiumAnnotations Maven / Gradle / Ivy

package io.appium.java_client.pagefactory;

import static io.appium.java_client.remote.MobilePlatform.*;
import io.appium.java_client.MobileBy;

import java.lang.annotation.Annotation;
import java.lang.reflect.Constructor;
import java.lang.reflect.Field;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import org.openqa.selenium.By;
import org.openqa.selenium.support.pagefactory.Annotations;
import org.openqa.selenium.support.pagefactory.ByAll;
import org.openqa.selenium.support.pagefactory.ByChained;

class AppiumAnnotations extends Annotations {

	private final static List METHODS_TO_BE_EXCLUDED_WHEN_ANNOTATION_IS_READ = new ArrayList() {
		private static final long serialVersionUID = 1L;
		{
			List objectClassMethodNames = getMethodNames(Object.class
					.getDeclaredMethods());
			addAll(objectClassMethodNames);
			List annotationClassMethodNames = getMethodNames(Annotation.class
					.getDeclaredMethods());
			annotationClassMethodNames.removeAll(objectClassMethodNames);
			addAll(annotationClassMethodNames);
		}
	};
	private final static Class[] DEFAULT_ANNOTATION_METHOD_ARGUMENTS = new Class[] {};

	private static List getMethodNames(Method[] methods) {
		List names = new ArrayList();
		for (Method m : methods) {
			names.add(m.getName());
		}
		return names;
	}

	private static enum Strategies {
		BYUIAUTOMATOR("uiAutomator") {
			@Override
			By getBy(Annotation annotation) {
				String value = getValue(annotation, this);
				if (annotation.annotationType().equals(AndroidFindBy.class)) {
					return MobileBy.AndroidUIAutomator(value);
				}
				if (annotation.annotationType().equals(iOSFindBy.class)) {
					return MobileBy.IosUIAutomation(value);
				}
				return super.getBy(annotation);
			}
		},
		BYACCESSABILITY("accessibility") {
			@Override
			By getBy(Annotation annotation) {
				return MobileBy.AccessibilityId(getValue(annotation, this));
			}
		},
		BYCLASSNAME("className") {
			@Override
			By getBy(Annotation annotation) {
				return By.className(getValue(annotation, this));
			}
		},
		BYID("id") {
			@Override
			By getBy(Annotation annotation) {
				return By.id(getValue(annotation, this));
			}
		},
		BYTAG("tagName") {
			@Override
			By getBy(Annotation annotation) {
				return By.tagName(getValue(annotation, this));
			}
		},
		BYNAME("name") {
			@Override
			By getBy(Annotation annotation) {
				return By.name(getValue(annotation, this));
			}
		},
		BYXPATH("xpath") {
			@Override
			By getBy(Annotation annotation) {
				return By.xpath(getValue(annotation, this));
			}
		},
		BYLINKTEXT("linkText") {
			@Override
			By getBy(Annotation annotation) {
				return By.linkText(getValue(annotation, this));
			}
		},
		BYPARTIALLINKTEXT("partialLinkText") {
			@Override
			By getBy(Annotation annotation) {
				return By.partialLinkText(getValue(annotation, this));
			}
		};

		private final String valueName;

		private String returnValueName() {
			return valueName;
		}

		private Strategies(String valueName) {
			this.valueName = valueName;
		}

		private static String[] strategiesNames() {
			Strategies[] strategies = values();
			String[] result = new String[strategies.length];
			int i = 0;
			for (Strategies strategy : values()) {
				result[i] = strategy.valueName;
				i++;
			}
			return result;
		}

		private static String getValue(Annotation annotation,
				Strategies strategy) {
			try {
				Method m = annotation.getClass().getMethod(strategy.valueName,
						DEFAULT_ANNOTATION_METHOD_ARGUMENTS);
				return m.invoke(annotation, new Object[] {}).toString();
			} catch (NoSuchMethodException e) {
				throw new RuntimeException(e);
			} catch (SecurityException e) {
				throw new RuntimeException(e);
			} catch (IllegalAccessException e) {
				throw new RuntimeException(e);
			} catch (IllegalArgumentException e) {
				throw new RuntimeException(e);
			} catch (InvocationTargetException e) {
				throw new RuntimeException(e);
			}
		}

		By getBy(Annotation annotation) {
			return null;
		}
	}

	private final Field mobileField;
	private final String platform;
	private final String automation;

	AppiumAnnotations(Field field, String platform, String automation) {
		super(field);
		mobileField = field;
		this.platform = String.valueOf(platform).toUpperCase().trim();
		this.automation = String.valueOf(automation).toUpperCase().trim();
	}

	private static void checkDisallowedAnnotationPairs(Annotation a1,
			Annotation a2) throws IllegalArgumentException {
		if (a1 != null && a2 != null) {
			throw new IllegalArgumentException("If you use a '@"
					+ a1.getClass().getSimpleName() + "' annotation, "
					+ "you must not also use a '@"
					+ a2.getClass().getSimpleName() + "' annotation");
		}
	}

	@Override
	protected void assertValidAnnotations() {
		AndroidFindBy androidBy = mobileField
				.getAnnotation(AndroidFindBy.class);
		AndroidFindBys androidBys = mobileField
				.getAnnotation(AndroidFindBys.class);
		AndroidFindAll androidFindAll = mobileField
				.getAnnotation(AndroidFindAll.class);

		SelendroidFindBy selendroidBy = mobileField
				.getAnnotation(SelendroidFindBy.class);
		SelendroidFindBys selendroidBys = mobileField
				.getAnnotation(SelendroidFindBys.class);
		SelendroidFindAll selendroidFindAll = mobileField
				.getAnnotation(SelendroidFindAll.class);

		iOSFindBy iOSBy = mobileField.getAnnotation(iOSFindBy.class);
		iOSFindBys iOSBys = mobileField.getAnnotation(iOSFindBys.class);
		iOSFindAll iOSFindAll = mobileField.getAnnotation(iOSFindAll.class);

		checkDisallowedAnnotationPairs(androidBy, androidBys);
		checkDisallowedAnnotationPairs(androidBy, androidFindAll);
		checkDisallowedAnnotationPairs(androidBys, androidFindAll);

		checkDisallowedAnnotationPairs(selendroidBy, selendroidBys);
		checkDisallowedAnnotationPairs(selendroidBy, selendroidFindAll);
		checkDisallowedAnnotationPairs(selendroidBys, selendroidFindAll);

		checkDisallowedAnnotationPairs(iOSBy, iOSBys);
		checkDisallowedAnnotationPairs(iOSBy, iOSFindAll);
		checkDisallowedAnnotationPairs(iOSBys, iOSFindAll);
		super.assertValidAnnotations();
	}

	private static Method[] prepareAnnotationMethods(
			Class annotation) {
		List targeAnnotationMethodNamesList = getMethodNames(annotation
				.getDeclaredMethods());
		targeAnnotationMethodNamesList
				.removeAll(METHODS_TO_BE_EXCLUDED_WHEN_ANNOTATION_IS_READ);
		Method[] result = new Method[targeAnnotationMethodNamesList.size()];
		for (String methodName : targeAnnotationMethodNamesList) {
			try {
				result[targeAnnotationMethodNamesList.indexOf(methodName)] = annotation
						.getMethod(methodName,
								DEFAULT_ANNOTATION_METHOD_ARGUMENTS);
			} catch (NoSuchMethodException e) {
				throw new RuntimeException(e);
			} catch (SecurityException e) {
				throw new RuntimeException(e);
			}
		}
		return result;
	}

	// I suppose that only @AndroidFindBy and @iOSFindBy will be here
	private static String getFilledValue(Annotation mobileBy) {
		Method[] values = prepareAnnotationMethods(mobileBy.getClass());
		for (Method value : values) {
			try {
				String strategyParameter = value.invoke(mobileBy,
						new Object[] {}).toString();
				if (!"".equals(strategyParameter)) {
					return value.getName();
				}
			} catch (IllegalAccessException e) {
				throw new RuntimeException(e);
			} catch (IllegalArgumentException e) {
				throw new RuntimeException(e);
			} catch (InvocationTargetException e) {
				throw new RuntimeException(e);
			}
		}
		throw new IllegalArgumentException("@"
				+ mobileBy.getClass().getSimpleName() + ": one of "
				+ Strategies.strategiesNames().toString() + " should be filled");
	}

	private By getMobileBy(Annotation annotation, String valueName) {
		Strategies strategies[] = Strategies.values();
		for (Strategies strategy : strategies) {
			if (strategy.returnValueName().equals(valueName)) {
				return strategy.getBy(annotation);
			}
		}
		throw new IllegalArgumentException("@"
				+ annotation.getClass().getSimpleName()
				+ ": There is an unknown strategy " + valueName);
	}

	@SuppressWarnings("unchecked")
	private  T getComplexMobileBy(Annotation[] annotations,
			Class requiredByClass) {
		;
		By[] byArray = new By[annotations.length];
		for (int i = 0; i < annotations.length; i++) {
			byArray[i] = getMobileBy(annotations[i],
					getFilledValue(annotations[i]));
		}
		try {
			Constructor c = requiredByClass.getConstructor(By[].class);
			Object[] values = new Object[] { byArray };
			return (T) c.newInstance(values);
		} catch (Exception e) {
			throw new RuntimeException(e);
		}
	}

	private ContentMappedBy setByForTheNativeContentAndReturn(By by,
			Map contentMap) {
		if (by != null)
			contentMap.put(ContentType.NATIVE, by);
		return new ContentMappedBy(contentMap);
	}

	@Override
	public By buildBy() {

		Map contentMap = new HashMap();

		By defaultBy = super.buildBy();
		contentMap.put(ContentType.HTML, defaultBy);
		contentMap.put(ContentType.NATIVE, defaultBy);

		assertValidAnnotations();

		SelendroidFindBy selendroidBy = mobileField
				.getAnnotation(SelendroidFindBy.class);
		if (selendroidBy != null && ANDROID.toUpperCase().equals(platform)
				&& "Selendroid".toUpperCase().equals(automation)) {
			return setByForTheNativeContentAndReturn(
					getMobileBy(selendroidBy, getFilledValue(selendroidBy)),
					contentMap);
		}

		SelendroidFindBys selendroidBys = mobileField
				.getAnnotation(SelendroidFindBys.class);
		if (selendroidBys != null && ANDROID.toUpperCase().equals(platform)
				&& "Selendroid".toUpperCase().equals(automation)) {
			return setByForTheNativeContentAndReturn(
					getComplexMobileBy(selendroidBys.value(), ByChained.class),
					contentMap);
		}

		SelendroidFindAll selendroidAll = mobileField
				.getAnnotation(SelendroidFindAll.class);
		if (selendroidAll != null && ANDROID.toUpperCase().equals(platform)
				&& "Selendroid".toUpperCase().equals(automation)) {
			return setByForTheNativeContentAndReturn(
					getComplexMobileBy(selendroidAll.value(), ByAll.class),
					contentMap);
		}

		AndroidFindBy androidBy = mobileField
				.getAnnotation(AndroidFindBy.class);
		if (androidBy != null && ANDROID.toUpperCase().equals(platform)) {
			return setByForTheNativeContentAndReturn(
					getMobileBy(androidBy, getFilledValue(androidBy)),
					contentMap);
		}

		AndroidFindBys androidBys = mobileField
				.getAnnotation(AndroidFindBys.class);
		if (androidBys != null && ANDROID.toUpperCase().equals(platform)) {
			return setByForTheNativeContentAndReturn(
					getComplexMobileBy(androidBys.value(), ByChained.class),
					contentMap);
		}

		AndroidFindAll androidFindAll = mobileField
				.getAnnotation(AndroidFindAll.class);
		if (androidFindAll != null && ANDROID.toUpperCase().equals(platform)) {
			return setByForTheNativeContentAndReturn(
					getComplexMobileBy(androidFindAll.value(), ByAll.class),
					contentMap);
		}

		iOSFindBy iOSBy = mobileField.getAnnotation(iOSFindBy.class);
		if (iOSBy != null && IOS.toUpperCase().equals(platform)) {
			return setByForTheNativeContentAndReturn(
					getMobileBy(iOSBy, getFilledValue(iOSBy)),
					contentMap);
		}

		iOSFindBys iOSBys = mobileField.getAnnotation(iOSFindBys.class);
		if (iOSBys != null && IOS.toUpperCase().equals(platform)) {
			return setByForTheNativeContentAndReturn(
					getComplexMobileBy(iOSBys.value(), ByChained.class),
					contentMap);
		}

		iOSFindAll iOSFindAll = mobileField.getAnnotation(iOSFindAll.class);
		if (iOSFindAll != null && IOS.toUpperCase().equals(platform)) {
			return setByForTheNativeContentAndReturn(
					getComplexMobileBy(iOSFindAll.value(), ByAll.class),
					contentMap);
		}

		return new ContentMappedBy(contentMap);
	}

}