• Home
• com.github.arachnidium
• arachnidium-app-model
• 0.9.7.2-BETA
• source code
• IDecomposableByHandles.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.

com.github.arachnidium.model.interfaces.IDecomposableByHandles Maven / Gradle / Ivy

package com.github.arachnidium.model.interfaces;

import com.github.arachnidium.core.Handle;
import com.github.arachnidium.core.HowToGetBrowserWindow;
import com.github.arachnidium.core.HowToGetMobileScreen;
import com.github.arachnidium.core.fluenthandle.IHowToGetHandle;
import com.github.arachnidium.model.support.HowToGetByFrames;

/**
 * There is an assumption that any object (whole application, page/screen and so on)
 * could be decomposed to limited set of logically final and reusable parts.
 * 
 * This interface specifies decomposition model 
 * provided by Arachnidium Java framework.
 * 
 * It is possible to interact with more than one browser windows or 
 * mobile contexts (NATIVE_APP, WEBVIEW_0, WEBVIEW_1 etc) at the same
 * time. So the interface provides advanced decomposition model and
 * considers this fact.   
 */

public interface IDecomposableByHandles extends IDecomposable {
	
	/**
	 * This method should provide the model
	 * of the getting objects by given browser window
	 * or mobile screen/context. It is for situations when 
	 * the index of window/context is expected.  
	 * 
	 * @param partClass is required class that implements {@link IDecomposable}
	 * 
	 * @param handleIndex is an expected index of the {@link Handle}, e.g. index of the
	 * browser window or mobile context
	 * 
	 * @return The instance of required class specified by partClass 
	 * parameter
	 */
	public  T getPart(Class partClass,
			int handleIndex);
	
	/**
	 * This method should provide the model
	 * of the getting objects by given browser window
	 * or mobile screen/context. It is for situations when 
	 * the index of window/context is expected.  
	 * 
	 * @param partClass is required class that implements {@link IDecomposable}
	 * @param handleIndex handleIndex is an expected index of the {@link Handle}, e.g. index of the
	 * browser window or mobile context
	 * @param timeOut is time to wait for.
	 * 
	 * @return The instance of required class specified by partClass 
	 * parameter
	 */
	public  T getPart(Class partClass,
			int handleIndex, long timeOut);	

	/**
	 * This method should provide the model
	 * of the getting objects by given browser window
	 * or mobile screen/context. It is for situations when 
	 * the index of window/context is expected. 
	 * 
	 * As it is all about UI of browser and mobile applications, 
	 * the usage of frames is possible (browser applications, hybrid mobile clients).
	 * So this fact is considered by method.
	 * 
	 * @param partClass is required class that implements {@link IDecomposable}
	 * @param handleIndex handleIndex handleIndex is an expected index of the {@link Handle}, e.g. index of the
	 * browser window or mobile context
	 * @param howToGetByFrames is a path to frame which is specified by {@link HowToGetByFrames} 
	 * 
	 * @return The instance of required class specified by partClass 
	 * parameter
	 */
	public  T getPart(Class partClass,
			int handleIndex, HowToGetByFrames howToGetByFrames);
	
	/**
	 * This method should provide the model
	 * of the getting objects by given browser window
	 * or mobile screen/context. It is for situations when 
	 * the index of window/context is expected. 
	 * 
	 * As it is all about UI of browser and mobile applications, 
	 * the usage of frames is possible (browser applications, hybrid mobile clients).
	 * So this fact is considered by method.
	 * 
	 * @param partClass is required class that implements {@link IDecomposable}
	 * @param handleIndex handleIndex handleIndex is an expected index of the {@link Handle}, e.g. index of the
	 * browser window or mobile context
	 * @param howToGetByFrames is a path to frame which is specified by {@link HowToGetByFrames} 
	 * @param timeOut is time to wait for.
	 * 
	 * @return The instance of required class specified by partClass 
	 * parameter
	 */
	public  T getPart(Class partClass,
			int handleIndex, HowToGetByFrames howToGetByFrames, long timeOut);	
	
	/**
	 * This method should provide the model 
	 * of the getting objects by given browser 
	 * window or mobile screen/context. 
	 * It is for situations when some complex condition is known, 
	 * e.g. URLs, title of the page, 
	 * index of the window/context, 
	 * context name (or part of the name) activities (is for Android) and so on. 
	 * 
	 * @param partClass is required class that implements {@link IDecomposable}
	 * @param howToGetHandle is a strategy where conditions are combined. Conditions are
	 * expected URLs, page title or context name, index of the window/context, activities
	 * etc.
	 * @return The instance of required class specified by partClass 
	 * parameter
	 * 
	 * @see IHowToGetHandle
	 * @see HowToGetBrowserWindow
	 * @see HowToGetMobileScreen
	 */
	public  T getPart(Class partClass,
			U howToGetHandle);
	
	/**
	 * This method should provide the model 
	 * of the getting objects by given browser 
	 * window or mobile screen/context. 
	 * It is for situations when some complex condition is known, 
	 * e.g. URLs, title of the page, 
	 * index of the window/context, 
	 * context name (or part of the name) activities (is for Android) and so on. 
	 * 
	 * @param partClass is required class that implements {@link IDecomposable}
	 * @param howToGetHandle howToGetHandle is a strategy where conditions are combined. Conditions are
	 * expected URLs, page title or context name, index of the window/context, activities
	 * etc.
	 * @param timeOut is time to wait for.
	 * 
	 * @returnThe instance of required class specified by partClass 
	 * parameter
	 * 
	 * @see IHowToGetHandle
	 * @see HowToGetBrowserWindow
	 * @see HowToGetMobileScreen
	 */
	public  T getPart(Class partClass,
			U howToGetHandle, long timeOut);
	
	/**
	 * This method should provide the model 
	 * of the getting objects by given browser 
	 * window or mobile screen/context. 
	 * It is for situations when some complex condition is known, 
	 * e.g. URLs, title of the page, 
	 * index of the window/context, 
	 * context name (or part of the name) activities (is for Android) and so on. 
	 * 
	 * As it is all about UI of browser and mobile applications, 
	 * the usage of frames is possible (browser applications, hybrid mobile clients).
	 * So this fact is considered by method.
	 * 
	 * @param partClass is required class that implements {@link IDecomposable}
	 * @param howToGetHandle howToGetHandle howToGetHandle is a strategy where conditions are combined. Conditions are
	 * expected URLs, page title or context name, index of the window/context, activities
	 * etc.
	 * @param howToGetByFrames is a path to frame which is specified by {@link HowToGetByFrames} 
	 * @return instance of required class specified by partClass 
	 * parameter
	 * 
	 * @see IHowToGetHandle
	 * @see HowToGetBrowserWindow
	 * @see HowToGetMobileScreen
	 */
	public  T getPart(Class partClass,
			U howToGetHandle, HowToGetByFrames howToGetByFrames);
	
	/**
	 * This method should provide the model 
	 * of the getting objects by given browser 
	 * window or mobile screen/context. 
	 * It is for situations when some complex condition is known, 
	 * e.g. URLs, title of the page, 
	 * index of the window/context, 
	 * context name (or part of the name) activities (is for Android) and so on. 
	 * 
	 * As it is all about UI of browser and mobile applications, 
	 * the usage of frames is possible (browser applications, hybrid mobile clients).
	 * So this fact is considered by method.
	 * 
	 * @param partClass partClass is required class that implements {@link IDecomposable}
	 * @param howToGetHandle howToGetHandle howToGetHandle howToGetHandle is a strategy where conditions are combined. Conditions are
	 * expected URLs, page title or context name, index of the window/context, activities
	 * etc.
	 * @param howToGetByFrames is a path to frame which is specified by {@link HowToGetByFrames}
	 * @param timeOut is time to wait for.
	 * 
	 * @return instance of required class specified by partClass 
	 * parameter
	 * 
	 * @see IHowToGetHandle
	 * @see HowToGetBrowserWindow
	 * @see HowToGetMobileScreen
	 */
	public  T getPart(Class partClass,
			U howToGetHandle, HowToGetByFrames howToGetByFrames, long timeOut);	
}