okw.gui

Class OKWLocator

java.lang.Object

okw.gui.OKWLocatorBase

okw.gui.OKWLocator

Direct Known Subclasses:

OKWLocatorXPath

public class OKWLocator
extends OKWLocatorBase

\~german Beispiel 1: Ein einfacher Locator L1 enthält den konstnaten XPATH-Wert "//*[contains(@name,'name')]". OKWLocator L1 = new OKWLocator( "//*[contains(@name,'name')]" ); Beispiel 2: Ein einfache verknüpfter Locator Window kann mit dem konstnaten XPATH-Wert "//*[contains(@id,'widnow')]" identifiziert werden. Child kann mit dem konstnaten XPATH-Wert "//*[contains(@id,'child')]" erkannt werden. Child kann jedoch in mehrerern Fenstern existieren. Durch das Verbinden der XPATH Werte Window und Child, kann Child eindeutig erkannt werden: OKWLocator LWindow = new OKWLocator( "//*[contains(@name,'name')]" ); OKWLocator LChild = new OKWLocator( "$L1$//*[contains(@contains(@id,'child')]", LWindow ); LChild.getLocator liefert den Wert //*[contains(@name,'name')]//*[contains(@id,'child')]. $L1$ markiert die stelle wo LWindow eingestezt werden soll. Beispiel 3: Dynamischer Locator Es gibt GUI-Objekte, deren GUI-erkennungseigenschaft von aktuellen Werten abhängt. D.h. Ein spezifischer kleiner aber entscheidender Teil des XPATH ist bis zur konkreten Anwendung unbekannt. Erst mit der konkreten Auswahl eines Wertes wird dieser dynamische Teil bekannt. 1. "Child" hat den folgenden konstnaten XPATH-Wert "$L1$//*[contains(@name,'$L2$')]". An der Stelle "$L1$" wird Window und an der Stelle "$L2$" wird DynName eingesetzt. 2. "Window" kann mit dem konstnaten XPATH-Wert "//*[contains(@id,'widnow')]" identifiziert werden. 3. "DynName" den. Durch das Verbinden der XPATH Werte Window und Child, kann Child eindeutig erkannt werden: OKWLocator LWindow = new OKWLocator( "//*[contains(@name,'name')]" ); OKWLocator LDyName = new OKWLocator( "" ); OKWLocator LChild = new OKWLocator( "$L1$//*[contains(@id,'child')]", LWindow, LDyName ); LChild.getLocator liefert zunächst den Wert "//*[contains(@name,'name')]//*[contains(@id,'')]". LDyName enthält im Initialzustande den Leeren Locator Wert "". Dieser kann nun dynamisch angepasst werden: Mit LDyName.setLocator("myValue") kann ein neure Wert für LDyName gestezt werden. LChild.getLocator liefert nun den Wert "//*[contains(@name,'name')]//*[contains(@id,'myValue')]". \~english Description of OKWLocator.

Author:

Zoltán Hrabovszki \date 2014.04.27

Field Summary

Fields

Modifier and Type	Field and Description
protected String	_locator Base Locator
protected OKWLocatorBase[]	_Locators List of reference Locators
protected Logger_Sngltn	myLogger

Constructor Summary

Constructors

Constructor and Description
OKWLocator()
OKWLocator(String fpsLocator, OKWLocatorBase... fpLocators)

Method Summary

Modifier and Type	Method and Description
void	copyLocator(OKWLocatorBase fpSource) \~german Copiert bzw, überträgt die Werte des fpSource Locators auf die Aktuelle Instanz.
String	getlocator() \~german gettet den Basis-Locator.
String	getLocator() \~german Holt den vollständig (rekursiv) aufgelösten des Locators.
OKWLocatorBase[]	getLocators() \~german gettet die Referenz Locatoren als Liste.
void	setLocator(String fpsLocator, OKWLocatorBase... fpLocators) \~german Setzt den Wert (z.B.
void	setLocators(OKWLocatorBase... fpLocators) \~german Setzt den Wert (z.B.

Methods inherited from class java.lang.Object

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

Field Detail

_locator

protected String _locator

Base Locator

_Locators

protected OKWLocatorBase[] _Locators

List of reference Locators

myLogger

protected Logger_Sngltn myLogger

Constructor Detail

OKWLocator

public OKWLocator()

OKWLocator

public OKWLocator(String fpsLocator,
                  OKWLocatorBase... fpLocators)

Method Detail

getLocator

public String getLocator()

\~german Holt den vollständig (rekursiv) aufgelösten des Locators. Beim Aufruf dieser Methode wird der Locator jeweils vollständig neu berechnet und der aktuelle Wert zurückgeliefert. (dynamischer Locator)

Returns:

Aktueller Wert des Locators \~english Fetches the completely (recursively) resolved (e.g. XPath value) of the locator. When this method is called, the locator is recalculated completely and the current value is returned. (dynamic locator)

setLocator

public void setLocator(String fpsLocator,
                       OKWLocatorBase... fpLocators)

\~german Setzt den Wert (z.B. XPath-Wert) des Locators und die eingebtteten Referenzen Hinweis: Durch weglassen von fpLocators wird nur fpsLocator gesetzt. Wenn bereits fpLocators in der Klasse vorhanden sind dann werden diese nicht verändert. Stichwort Dynamische Locatoren. \~english

setLocators

public void setLocators(OKWLocatorBase... fpLocators)

\~german Setzt den Wert (z.B. XPath-Wert) des Locators.

Parameters:

fpLocators - Referenz Lokatoren. $L1$, $L2$, ... $Ln$ referenzieren auf diese. \~english

fpLocators - Reference Locators. $L1$, $L2$, ... $Ln$ refer to them. \~

copyLocator

public void copyLocator(OKWLocatorBase fpSource)

\~german Copiert bzw, überträgt die Werte des fpSource Locators auf die Aktuelle Instanz. \~english Copies or transfers the values of the fpSource locator to the current instance. \~

Parameters:

fpSource - Quelle, dessen Werte in das aktuelle Objekt copiert werden soll. \~english

getlocator

public String getlocator()

\~german gettet den Basis-Locator. \~english gettet the base locator. \~

getLocators

public OKWLocatorBase[] getLocators()

\~german gettet die Referenz Locatoren als Liste. \~english gets the reference locators as a list. \~