okw.gui.adapter.selenium

Class SeAnyWindow

java.lang.Object

okw.gui.AnyWinBase

okw.gui.AnyWindow

okw.gui.adapter.selenium.SeAnyWindow

All Implemented Interfaces:

IOKW_FN, IGUIWindow

Direct Known Subclasses:

SeBrowserChild, SeBrowserWindow

public class SeAnyWindow
extends AnyWindow

\~german

Author:

Zoltán Hrabovszki \date 2017-06-05

Field Summary

Fields

Modifier and Type	Field and Description
protected LogMessenger	LM
protected SeDriver	mySeDriver

Fields inherited from class okw.gui.AnyWinBase

_locator

Constructor Summary

Constructors

Constructor and Description
SeAnyWindow()

Method Summary

Modifier and Type	Method and Description
void	ClickOn() \~german Klickt auf das aktuelle Objekt.
ArrayList<String>	getCaption() \~german Ermittelt den textuellen Inhalt der Überschrift eines HTML-Tags anhand des Attributee "textContent".
Boolean	getExists() \~german Prüft die Existenz des aktuellen Objektes.
ArrayList<String>	LogCaption() \~german Ermittelt den textuellen Inhalt der Beschriftung (Caption).
Boolean	LogExists() \~german Ermittelt den textuellen Inhalt des ToolTips.
Boolean	LogIsActive() \~german Ermittelt, ob das aktuelle Objket Aktiv ist.
org.openqa.selenium.WebElement	Me() \~german Ermittelt aus dem gegebenen Locator das DOM-Elelement, welches das Objekt representiert.
ArrayList<String>	MemorizeCaption() \~german Ermittelt den textuellen Inhalt des Caption/Überschrift für das Schlüsselwort MerkeWert.
Boolean	MemorizeExists() \~german Ermittelt, ob das atuelle Objekt für das Schlüsselwort MemorizeExists existiert.
Boolean	MemorizeIsActive() \~german Ermittelt für das Schlüsselwort MerkeIstAktive, ob das aktuelle Objekt aktiv ist.
Boolean	NotExists() \~german Prüft die nicht Existenz des aktuellen Objektes.
Boolean	scrollIntoView() \~german Verschiebt das aktuelle Element in den sichtbaren Bereich.
void	SelectWindow()
void	SetFocus() \~german Setzt den Focus auf das Objekt.
void	setLocator(String Locator, OKWLocatorBase... Locators)
void	TypeKey(ArrayList<String> fps_Values) \~german Tastatur Eingabe an das Objekt \param fps_Values'> Werte, die via Tastatur eingegeben werden sollen.
ArrayList<String>	VerifyCaption() \~german Ermittelt den textuellen Inhalt des ToolTips für Prüfewert.
Boolean	VerifyExists() \~german Ermittelt/Prüft, ob das aktuelle Objekt existiert.
Boolean	VerifyIsActive() \~german Ermittelt/Prüft, ob das aktuelle Objekt aktiv ist.
void	WaitForInteraction(Runnable Method2Call) \~german Methode versucht die gegebene Interaktion Method2Call gegen das aktuelle GUI-Objekt auszuführen und warten ggf.
Boolean	WaitForInteractionReturnBoolean(Supplier<Boolean> Method2Call) \~german Methode versucht die gegebene Interaktion Method2Call gegen das aktuelle GUI-Objekt auszuführen.
String	WaitForInteractionReturnString(Supplier<String> Method2Call) \~german Methode versucht die gegebene Interaktion Method2Call gegen das aktuelle GUI-Objekt auszuführen.
Boolean	WaitForMe() Wartet auf das Objekt Wenn kein Fenster gefunden wird,

Methods inherited from class okw.gui.AnyWindow

getIsActive, StartApp, StopApp, TypeKeyWindow, VerifyIsWindowActive, VerifyWindowCaption, VerifyWindowExists

Methods inherited from class okw.gui.AnyWinBase

getCAT, getKN, getLocator, getLOCATOR, getParentFN, LogError, LogFunctionEnd, LogFunctionEnd, LogFunctionEnd, LogFunctionEnd, LogFunctionEndDebug, LogFunctionEndDebug, LogFunctionEndDebug, LogFunctionEndDebug, LogFunctionStart, LogFunctionStart, LogFunctionStartDebug, LogFunctionStartDebug, LogPrint, LogPrintDebug, LogWarning, ResCloseList, ResCloseListDebug, ResOpenList, ResOpenListDebug, setCAT, setKN, setParentFN

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface okw.core.IOKW_FN

getCAT, getKN, getParentFN, setCAT, setKN, setParentFN

Field Detail

mySeDriver

protected SeDriver mySeDriver

LM

protected LogMessenger LM

Constructor Detail

SeAnyWindow

public SeAnyWindow()

Method Detail

setLocator

public void setLocator(String Locator,
                       OKWLocatorBase... Locators)

Overrides:

setLocator in class AnyWinBase

ClickOn

public void ClickOn()

\~german Klickt auf das aktuelle Objekt. \~english \~

getCaption

public ArrayList<String> getCaption()

\~german Ermittelt den textuellen Inhalt der Überschrift eines HTML-Tags anhand des Attributee "textContent".

Specified by:

getCaption in interface IGUIWindow

Overrides:

getCaption in class AnyWindow

Returns:

Rückgabe des Textuellen Inhaltes der Caption/Überschrift. \~english \~

getExists

public Boolean getExists()

\~german Prüft die Existenz des aktuellen Objektes. - Methode ist Selenium spezifisch. - Elementare Funktion, muss hier defiert werden. - Es wird nicht auf das Objekt gewarten! - Es wird nur ein eizigesmal die Existenz geprüft. - Es wird keine Ausnahme ausgelöst, wenn das Object nicht vorhanden ist. - Wenn Das Objekt nicht eindeitig ist wird false Zurückgeliefert.

Specified by:

getExists in interface IGUIWindow

Overrides:

getExists in class AnyWindow

Returns:

true, falls das Objekt eindeutig gefunden worden ist ist, sonst false. \~

LogCaption

public ArrayList<String> LogCaption()
                             throws Exception

\~german Ermittelt den textuellen Inhalt der Beschriftung (Caption). Diese Methode ist der Einstiegspunkt für LogCaption-Anpassungen durch Methoden überschreibung.

Returns:

Rückgabe des Tooltiptextes. Interface schreibt ein Listen-Element als Rückgabewert vor. \~english \~

Throws:

Exception

LogExists

public Boolean LogExists()

\~german Ermittelt den textuellen Inhalt des ToolTips. Diese Methode ist der Einstiegspunkt für MerkeWert-Anpassungen durch Methoden überschreibung.

Returns:

Rückgabe des Textuellen Inhaltes der Tooltips. Interface schreibt ein Listen-Element als Rückgabewert vor.

LogIsActive

public Boolean LogIsActive()
                    throws Exception

\~german Ermittelt, ob das aktuelle Objket Aktiv ist. Diese Methode ist der Einstiegspunkt für MerkeWert-Anpassungen durch Methoden überschreibung.

Returns:

Rückgabe des Textuellen Inhaltes der Tooltips. Interface schreibt ein Listen-Element als Rückgabewert vor.

Throws:

Exception

Me

public org.openqa.selenium.WebElement Me()

\~german Ermittelt aus dem gegebenen Locator das DOM-Elelement, welches das Objekt representiert.

Returns:

Referenz auf das gefunde DOM-Element \~

MemorizeExists

public Boolean MemorizeExists()

\~german Ermittelt, ob das atuelle Objekt für das Schlüsselwort MemorizeExists existiert. Diese Methode ist der Einstiegspunkt für MemorizeExists-Anpassungen durch Methodenüberschreibung.

Returns:

Rückgabe des Textuellen Inhaltes der Tooltips. Interface schreibt ein Listen-Element als Rückgabewert vor. \~english

MemorizeIsActive

public Boolean MemorizeIsActive()
                         throws Exception

\~german Ermittelt für das Schlüsselwort MerkeIstAktive, ob das aktuelle Objekt aktiv ist. Diese Methode ist der Einstiegspunkt für MerkeIstAktive-Anpassungen durch Methodenüberschreibung.

Returns:

true, falls das aktuelle Objekt aktiv ist, sonst false \~english \~

Throws:

Exception

NotExists

public Boolean NotExists()
                  throws Exception

\~german Prüft die nicht Existenz des aktuellen Objektes. __Anmerkung:__ Falls ein Objekt zunächst noch vorhand ist und dann aber verschwindet, dann es sinnvoll sein eine gewisse Zeit(Timeout) zu prüfen, ob das Objekt existiert, Erst wenn diese Zeit verstrichen ist, wird gemeldet, das das Objekt nicht vorhanden ist. Diese Funktion ist der gegenspieler zu __Exists.

Returns:

true, falls das Objekt NICHT vorhanden ist. Sonst false \~

Throws:

Exception

SelectWindow

public void SelectWindow()

Specified by:

SelectWindow in interface IGUIWindow

Overrides:

SelectWindow in class AnyWindow

SetFocus

public void SetFocus()
              throws Exception

\~german Setzt den Focus auf das Objekt. __Anmerkung:__ Kleiner Trick: Selenium kennt keine öffentliche c#-Methode für das setzen des Fokus. So weit ich es verstanden habe, wird intern jedoch methode SetFocus verwendt, wenn SendKeys aufgerufen wird. Quelle: http://stackoverflow.com/questions/7491806/in-selenium-how-do-i-find-the-current-object \~english \~

Throws:

Exception

MemorizeCaption

public ArrayList<String> MemorizeCaption()
                                  throws Exception

\~german Ermittelt den textuellen Inhalt des Caption/Überschrift für das Schlüsselwort MerkeWert. Diese Methode ist der Einstiegspunkt für MerkeWert-Anpassungen durch Methodenüberschreibung.

Returns:

Rückgabe des Textuellen Inhaltes der Caption/Überschrift. Interface schreibt ein Listen-Element als Rückgabewert vor. \~english \~

Throws:

Exception

TypeKey

public void TypeKey(ArrayList<String> fps_Values)
             throws Exception

\~german Tastatur Eingabe an das Objekt \param fps_Values'> Werte, die via Tastatur eingegeben werden sollen. \~

Throws:

Exception

VerifyCaption

public ArrayList<String> VerifyCaption()
                                throws Exception

\~german Ermittelt den textuellen Inhalt des ToolTips für Prüfewert. Diese Methode ist der Einstiegspunkt für PrüfeWert-Anpassungen durch Methodenüberschreibung.

Returns:

Rückgabe des Textuellen Inhaltes der Tooltips. Es wird immer der aktuelle Wert des Objektes zurückgeliefert Interface schreibt ein Listen-Element als Rückgabewert vor.

Throws:

Exception

VerifyExists

public Boolean VerifyExists()
                     throws InterruptedException

\~german Ermittelt/Prüft, ob das aktuelle Objekt existiert. Diese Methode ist der Einstiegspunkt für PrüfeWert-Anpassungen durch Methodenüberschreibung. \param fpbExpectedValue Erwarteter Wert.

Returns:

Rückgabe des Textuellen Inhaltes der Tooltips. Es wird immer der aktuelle Wert des Objektes zurückgeliefert Interface schreibt ein Listen-Element als Rückgabewert vor. \param fpbExpectedValue Erwarteter Wert.

Throws:

InterruptedException

VerifyIsActive

public Boolean VerifyIsActive()
                       throws Exception

\~german Ermittelt/Prüft, ob das aktuelle Objekt aktiv ist. Diese Methode ist der Einstiegspunkt für PrüfeIstAktive-Anpassungen durch Methodenüberschreibung.

Returns:

true, falls das Objekt aktiv ist sonst false \~english \~

Throws:

Exception

scrollIntoView

public Boolean scrollIntoView()

\~german Verschiebt das aktuelle Element in den sichtbaren Bereich.

Returns:

true, wenn erfolgreich sonst false \~english Moves the current element into the visible area.

WaitForInteraction

public void WaitForInteraction(Runnable Method2Call)

\~german Methode versucht die gegebene Interaktion Method2Call gegen das aktuelle GUI-Objekt auszuführen und warten ggf. Es wird WaitForMe_TO gewartet und während dieser Zeit alle WaitForMe_PT versucht die Interaktion zu wiederholen. Folgende Ausnahmen werden abgefangen und eine Interaktion erneut versucht. __Hinweis:__ bei jeder Iteraktion wird das GUI-Objekt neu gesucht und das Inetrne WebE.ement-referenz erneuert.

WaitForInteractionReturnString

public String WaitForInteractionReturnString(Supplier<String> Method2Call)

\~german Methode versucht die gegebene Interaktion Method2Call gegen das aktuelle GUI-Objekt auszuführen. Es wird maximal WaitForMe_TO die Interaktion erneut versucht. Während dieser Zeit wird alle WaitForMe_PT versucht die Interaktion zu wiederholen. Folgende Ausnahmen werden innerhalb von WaitForMe_TO abgefangen und eine Interaktion erneut versucht. - OKWGUIObjectNotFoundException - InvalidElementStateException - StaleElementReferenceException - fehlt noch: Exception wenn das objekt unsichbar ist. __Hinweis:__ bei jeder Iteraktion wird das GUI-Objekt neu gesucht und das Inetrne WebElement-Referenz erneuert.

Returns:

String Wert, welches aus dem WebElement ausgelesn worden ist. \~german Method tries to execute the given interaction Method2Call against the current GUI object. At most WaitForMe_TO the interaction is tried again. During this time, all WaitForMe_PT attempts to repeat the interaction. The following exceptions are caught within WaitForMe_TO and an interaction is retried. - OKWGUIObjectNotFoundException - InvalidElementStateException - StaleElementReferenceException - still missing: Exception if the object is invisible. __Note:__ At each iteration the GUI object is searched again and the Internal WebElement reference is renewed.

WaitForInteractionReturnBoolean

public Boolean WaitForInteractionReturnBoolean(Supplier<Boolean> Method2Call)

\~german Methode versucht die gegebene Interaktion Method2Call gegen das aktuelle GUI-Objekt auszuführen. Es wird maximal WaitForMe_TO die Interaktion erneut versucht. Während dieser Zeit wird alle WaitForMe_PT versucht die Interaktion zu wiederholen. Folgende Ausnahmen werden innerhalb von WaitForMe_TO abgefangen und eine Interaktion erneut versucht. - OKWGUIObjectNotFoundException - InvalidElementStateException - StaleElementReferenceException - fehlt noch: Exception wenn das objekt unsichbar ist. __Hinweis:__ bei jeder Iteraktion wird das GUI-Objekt neu gesucht und das Inetrne WebElement-Referenz erneuert.

Returns:

Boolean Wert, welches aus dem WebElement ausgelesn worden ist. \~german Method tries to execute the given interaction Method2Call against the current GUI object. At most WaitForMe_TO the interaction is tried again. During this time, all WaitForMe_PT attempts to repeat the interaction. The following exceptions are caught within WaitForMe_TO and an interaction is retried. - OKWGUIObjectNotFoundException - InvalidElementStateException - StaleElementReferenceException - still missing: Exception if the object is invisible. __Note:__ At each iteration the GUI object is searched again and the Internal WebElement reference is renewed.

WaitForMe

public Boolean WaitForMe()

Wartet auf das Objekt Wenn kein Fenster gefunden wird,

Overrides:

WaitForMe in class AnyWindow