V tejto časti sa zameriam na opísanie základných stavebných prvkov testovacieho frameworku, jeho downloadom a inštaláciou. Ďalej sa zameriam na automatické vytvorenie prvého testovacieho webtest-projektu a jeho prvé spustenie. Ako základ určite postači, že Canoo Webtest je napísaný v jazyku Java využívajúci Ant [verzia 1.7].
Stavebné prvky Canoo WebTest
- Ant – Všetky testovacie kroky sú v podstate Ant-tasky a celý Canoo Webtest plne využíva jeho API [http://ant.apache.org/ ]
- HtmlUnit – “Browser pre Java – programy” – poskytuje API, ktoré umožňuje vyvolávanie stránok, vypĺňanie formulárov, klikanie na linky, atď. [http://htmlunit.sourceforge.net/ ]
- Mozilla Rhino – “Java script pre Java – programy” [http://www.mozilla.org/rhino/ ]
- Jaxen – Java XPath Engine [http://jaxen.codehaus.org/ ] [od vezie R_1700 nahradená Java 5 XPath facilities – Xalan]
- nekoHtml – HTML skener a parser, ktorý umožňuje prístup k HTML dátam použitím štandardných XML interface [http://sourceforge.net/projects/nekohtml ]
- Jakarta commons-httpclient – Implementuje všetky HTTP metódy [GET, POST, PUT, DELETE, HEAD, OPTIONS, and TRACE] [http://hc.apache.org/httpclient-3.x/ ]
Canoo Webtest – inštalácia
Predpokladaná konfigurácia
- OS na ktorom je možné spustiť Javu
- Nainštalovaná JDK minimálne verzia 1.5
- Nástroj na rozpakovanie stiahnutých súborov
Download
Stiahnite si poslednú verziu z oficiálnej stránky [http://webtest.canoo.com/webtest/manual/Downloads.html].
Rozpakujte súbory do vami zvoleného adresára – ktorý sa stane „WebTest home“
Konfigurácia systémových ciest
Štandardná inštalácia Canoo Webtest predpokladá, že nemáte naištalovaný samostatný ANT 1.7, preto obsahuje spúšťacie skripty ANT-u, ktoré sú pribalené v inštalácii. Preto je potrebné nastavenie systémových ciest k spúštacím skriptom z adresára BIN.
Podadresár lib/ adrersára WebTest home obsahuje všetky java knižnice potrebné k behu Canoo Webtestu.
Podadresár bin/ adresára WebTest home obsahuje skripty pre Unix a Windows, ktorými sa štartuje webtest z podadresára lib/.
Nastavenie systémovej cesty – pridanie bin/ adresára so systémovej premennej “path” [Windows]: (WinKey + Pause), vyberte “Advanced tab” a cez button “Environment Variables” editujte PATH premennú. Napríklad: “C:\Program Files\Webtest\bin”;%PATH%
Nastavenie systémovej cesty – pridanie bin/ adresára so systémovej premennej “path” [Unix]:
Napríklad:
setenv PATH ${PATH}:/usr/local/webtest/bin in .login (tcsh)
… alebo
export PATH=${PATH}:/usr/local/webtest/bin in .bashrc (bash)
Vytvorenie nového WebTest projektu
WebTest obsahuje zabudovanú utilitu na vytvorenie nového projektu, ktorý obsahuje príklady testov priamo spustiteľných a ktoré môžu následne slúžiť ako vzor pre prvé skutočné testovacie skripty. V príkazovom riadku pre daný operačný system zadajte:
C:\webtest -f "cesta-k-webtest-home-adresáru"\webtest.xml wt.createProject
Po zadaní mena demo projektu sa vytvorí demo projekt so zadaným menom. Ak meno nezadáte vytvorí sa pod default menom “myWebTestProject”.
C:\>webtest -f WebTest\webtest.xml wt.createProject Buildfile: WebTest\webtest.xml wt.init: wt.createProject: [input] Enter your WebTest project name: [myWebTestProject] [echo] [echo] Your WebTest project >myWebTestProject< has been successfully created with some demo [echo] tests to get started. [echo] You can now just go to >c:\myWebTestProject< and run ant. [echo] BUILD SUCCESSFUL Total time: 7 seconds
Canoo Webtest – prvé spustenie
Ak používate proxy server, na prvé úspešné spustenie nastavte proxy server v súbore build.xml.
V build.xml stačí odkomentovať pripravené proxy nastavenie a zadať vaše nastavenia.
<!-- Activate this if you are behind a proxy and want to test a server outside your local network See http://ant.apache.org/manual/OptionalTasks/setproxy.html <setproxy proxyhost="myProxy" proxyport="1234"/> -->
… potom spustime [ak nemáme nainštalovaný ANT 1,7.]
C:\myWebTestProject>webtest
V prípade naištalovaného samostatného ANT, stačí len v adresári c:\myWebTestProject spustiť príkaz ANT.
.... wt.openResultFile: [echo] Opening result file C:\myWebTestProject\results\webtestResults.html with cmd wt.full: BUILD SUCCESSFUL Total time: 16 seconds
… pričom sa počas behu testov zobrazí okno WebTest Monitora.
Po ukončení testu sa objaví HTML report:
Zobrazenie jednotlivých krokov testu s pohľadom na “result-page” [ctrl+myš]:
Pre bližšie informácie k tomu ako si vytvoriť svoj prvý test, pozrite screen-cast.