Navrhněte a implementujte automatický přihazovací program pro aukční portál e- bay.com

Zad´ an´ı bakal´ aˇ rsk´ e pr´ ace • Navrhnˇete a implementujte automatick´ y pˇrihazovac´ı program pro aukˇcn´ı port´ al ebay.com. • Program bude sledovat zadanou aukci a v poslednich 5 sekundách pˇrihod´ı v této aukci zadanou cenu. • Program mus´ı umˇet hl´ıdat v´ıce aukc´ı zároveˇ n. • Program mus´ı bˇeˇzet pod operaˇcn´ım systémem Linux. • GUI nen´ı vyˇzadov´ ano, program lze ovládat pˇres pˇr´ıkazovou ˇrádku.

1

2

ˇ e vysoké uˇcen´ı technické v Praze Cesk´ Fakulta elektrotechnická Katedra poˇc´ıtaˇc˚ u

Bakaláˇrská práce

Automatick´ y pˇ rihazovac´ı syst´ em pro e-bay.com Ondˇrej Hrabal

Vedouc´ı práce: Ing. Jiˇr´ı Sm´ıtka

Studijn´ı program: Elektrotechnika a informatika, dob´ıhaj´ıc´ı, Bakaláˇrsk´ y Obor: V´ ypoˇcetn´ı technika 10. bˇrezna 2013

iv

v

Podˇ ekov´ an´ı Velmi r´ ad bych t´ımto podˇekoval vedouc´ımu své bakaláˇrské práce, Ing. Jiˇr´ımu Sm´ıtkovi, za hodnotné rady a veˇsker´ y ˇcas, kter´ y mi vˇenoval. Dále pak sv´ ym rodiˇc˚ um a kamarád˚ um za vynikaj´ıc´ı pasivn´ı podporu v dlouhodobé práci.

vi

vii

Prohl´ aˇ sen´ı Prohlaˇsuji, ˇze jsem pr´ aci vypracoval samostatnˇe a pouˇzil jsem pouze podklady uvedené v pˇriloˇzeném seznamu. Nemám z´ avaˇzn´ y d˚ uvod proti uˇzit´ı tohoto ˇskoln´ıho d´ıla ve smyslu §60 Zákona ˇc. 121/2000 Sb., o pr´ avu autorském, o pr´ avech souvisej´ıc´ıch s právem autorsk´ ym a o zmˇenˇe nˇekter´ ych zákon˚ u (autorsk´ y z´ akon).

V Hranic´ıch dne 18. 5. 2010

.............................................................

viii

Abstract The purpose and goal of my work is to design and implement an automatic bidding system for (the auction portal) e-bay.com. The program will watch a given auction and make a bid in last 5 seconds to win the auction and also has to be able watch more auctions simultaneosly. The program must be compatible with Linux operating system. GUI is not required as the program can be controlled via command line.

Abstrakt Podstatou a c´ılem pr´ ace je navrhnout a implementovat automatick´ y pˇrihazovac´ı program pro aukˇcn´ı port´ al e-bay.com. Program bude sledovat zadanou aukci a v posledn´ıch 5 sekundách pˇrihod´ı v této aukci zadanou cenu, z´ aroveˇ n vˇsak mus´ı umˇet hl´ıdat v´ıce aukc´ı zároveˇ n. Program mus´ı bˇeˇzet pod operaˇcn´ım systémem Linux, pˇriˇcemˇz grafické uˇzivatelské rozhran´ı (GUI) nen´ı vyˇzadov´ ano, ovládán´ı lze provést pˇres pˇr´ıkazovou ˇrádku.

ix

x

Obsah ´ 1 Uvod 1.1 Historie eBay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2 Princip on-line aukce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3 Souˇcasné trendy on-line nakupován´ı . . . . . . . . . . . . . . . . . . . . . . .

1 1 2 2

2 Motivace 2.1 C´ıle pr´ ace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.2 V´ ysledek pr´ ace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.3 Existuj´ıc´ı implementace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5 5 6 6

3 Anal´ yza a n´ avrh ˇ reˇ sen´ı 3.1 Programovac´ı jazyk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.2 Pouˇzité prostˇred´ı pro tvorbu . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7 9 9

4 Realizace 4.1 Implementace vyuˇz´ıvaj´ıc´ı eBay API . . . . . . . . . . . 4.2 Pˇrihl´ aˇsen´ı do systému . . . . . . . . . . . . . . . . . . . 4.2.1 Struktura XML . . . . . . . . . . . . . . . . . . . 4.3 Z´ısk´ an´ı informac´ı o poloˇzce na eBay . . . . . . . . . . . 4.4 Pˇrihozen´ı . . . . . . . . . . . . . . . . . . . . . . . . . . 4.4.1 Klasick´ a pˇrihazovac´ı aukce . . . . . . . . . . . . 4.4.1.1 Vytvoˇren´ı nab´ıdky a pˇrihozen´ı . . . . . 4.4.1.2 Monitorován´ı aukc´ı . . . . . . . . . . . 4.4.1.3 Vyhodnocen´ı ˇcasu pˇrihozen´ı . . . . . . 4.4.1.4 Zruˇsen´ı monitorované aukce . . . . . . 4.4.1.5 N´ azorn´ y popis celého procesu pˇrihozen´ı 4.4.2 Koupˇe poloˇzky za fixn´ı cenu . . . . . . . . . . . . 4.4.3 Posl´ an´ı nejlepˇs´ı nab´ıdky . . . . . . . . . . . . . . 4.5 Posl´ an´ı poˇzadavku PlaceOffer . . . . . . . . . . . . . . . 4.5.1 Struktura HTTP hlaviˇcky . . . . . . . . . . . . . 4.5.2 Struktura XML poˇzadavku . . . . . . . . . . . .

. . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . .

11 11 12 13 15 16 18 18 19 20 21 21 22 22 22 22 23

5 Testov´ an´ı 25 5.1 Jednotkové testy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 5.2 Testy grafického uˇzivatelského rozhran´ı . . . . . . . . . . . . . . . . . . . . . . 26 5.2.1 Mockov´ an´ı objekt˚ u . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

xi

xii

OBSAH

5.3

5.4 5.5

Praktické testov´ an´ı testery . . 5.3.1 V´ ysledky testov´ an´ı . . ˇ 5.3.2 Cekac´ ı dialogové okno 5.3.3 Resource bundle . . . Funkˇcnost programu . . . . . Zhodnocen´ı testov´ an´ı . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

27 28 28 29 30 30

6 Z´ avˇ er

31

Literatura

33

A Seznam pouˇ zit´ ych zkratek

35

B Instalaˇ cn´ı a uˇ zivatelsk´ a pˇ r´ıruˇ cka

37

C Obsah pˇ riloˇ zen´ eho CD

43

Seznam obr´ azk˚ u 1.1

Ofici´ aln´ı internetov´ a str´ anka eBay . . . . . . . . . . . . . . . . . . . . . . . .

2

2.1

Program JBidwatcher verze 2.1pre5 . . . . . . . . . . . . . . . . . . . . . . . .

6

3.1 3.2

Model poˇzadavk˚ u pˇrihazovac´ıho programu . . . . . . . . . . . . . . . . . . . . Model pˇr´ıpad˚ u uˇzit´ı pˇrihazovac´ıho programu . . . . . . . . . . . . . . . . . .

7 8

4.1 4.2 4.3 4.4 4.5

Model nasazen´ı pˇrihazovac´ıho programu . . . . . . . . . Sekvenˇcn´ı diagram uloˇzen´ı pˇrihlaˇsovac´ıch u ´daj˚ u do XML Z´ısk´ an´ı tzv. Item number u poloˇzky na eBay . . . . . . Okno zobrazuj´ıc´ı pˇrihazovac´ı menu . . . . . . . . . . . . Bussiness model pˇrihozen´ı . . . . . . . . . . . . . . . . .

. . . . .

13 15 16 17 21

5.1 5.2

Graf v´ ysledk˚ u dotazn´ıku . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Informaˇcn´ı dialogové okno . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

28 29

B.1 B.2 B.3 B.4 B.5

Hlavn´ı okno pˇrihazovac´ıho programu . . . . . . . . Okno zobrazuj´ıc´ı pˇrihlaˇsovac´ı u ´daje do eBay . . . . Okno zobrazuj´ıc´ı uloˇzen´ı nebo naˇcten´ı souboru . . Okno zobrazuj´ıc´ı pˇrihazovac´ı menu . . . . . . . . . Okno zobrazuj´ıc´ı tabulku monitorovan´ ych poloˇzek

. . . . .

38 39 40 41 42

C.1 Seznam pˇriloˇzeného CD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

43

xiii

. . . . .

. . . . .

. . . . .

. . . . . souboru . . . . . . . . . . . . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

xiv

´ U ˚ SEZNAM OBRAZK

Kapitola 1

´ Uvod V bakal´ aˇrské pr´ aci se zab´ yv´ am asi nejznámˇejˇs´ı americkou internetovou aukˇcn´ı s´ın´ı eBay[6]. Hlavn´ım tématem mé pr´ ace je vytvoˇrit aplikaci schopnou automaticky sledovat v´ıce aukc´ı soubˇeˇznˇe a v posledn´ı chv´ıli prob´ıhaj´ıc´ı aukce pˇrihodit pˇredem nastavenou ˇcástku. Pokus´ım se ˇcten´ aˇre kr´ atce obezn´ amit s histori´ı a souˇcasn´ ymi trendy internetov´ ych aukc´ı. Dále bl´ıˇze specifikuji c´ıle, vytvoˇr´ım anal´ yzu a návrh ˇreˇsen´ı, provedu realizaci, tedy implementaci ˇreˇsen´ı, kterou ˇr´ adnˇe otestuji a na z´ avˇer zhodnot´ım splnˇen´ı c´ıl˚ u bakaláˇrské práce a budu diskutovat o jej´ım dalˇs´ım moˇzném pokraˇcován´ı.

1.1

Historie eBay

Obchodn´ı aukˇcn´ı port´ al eBay 1.1 (dále jen eBay) byl zaloˇzen v San José 4. záˇr´ı 1995 poˇc´ıtaˇcov´ ym program´ atorem Pierrem Omidyarem jako AuctionWeb.1 AuctionWeb patˇril Omidyarovˇe konzultaˇcn´ı spoleˇcnosti jménem Echo Bay Technology Group. Protoˇze vˇsak doménu echobuy.com tehdy vlastnila jedna kanadská tˇeˇzebn´ı spoleˇcnost, Sierr Omidyar zkrátil n´ azev a v z´ aˇr´ı 1997 zaregistroval doménu ebay.com. Za tu dobu proˇsla ˇradou zmˇen a vylepˇsen´ı. Od roku 1999 eBay proˇz´ıvá mezinárodn´ı expanzi2 a stal se nejvˇetˇs´ı svˇetovou aukˇcn´ı s´ın´ı, která p˚ usob´ı jiˇz ve ˇctyˇrech des´ıtkách zem´ı na vˇsech svˇetov´ ych kontinentech. Dnes má v´ıce neˇz 90 milion˚ u uˇzivatel˚ u po celém svˇetˇe. eBay také u ´zce spolupracuje s dalˇs´ımi svˇetov´ ymi softwarov´ ymi systémy[13] jako je PayPal, MoneyBookers ˇci BidPay nebo Skype, kter´ y v roce 2005 koupil a stal se tak jeho vˇetˇsinov´ ym vlastn´ıkem. Málokdo v´ı, ˇze je eBay pr˚ ukopn´ıkem v porovnáván´ı cen produkt˚ u od jednotliv´ ych prodejc˚ u, které je velmi popul´ arn´ım a rozˇs´ıˇrilo se do celého svˇeta (u nás známe napˇr. zbozi.cz). Za zm´ınku také stoj´ı, ˇze od roku 2008 funguje v Praze eBay Center of Excellence, mar´ ketingové a analytické centrum zamˇeˇruj´ıc´ı se na evropské a asijské trhy. Uplnou novinkou je oficiáln´ı expanze eBay k datu 25. bˇrezna 2010 na ˇcesk´ y trh, coˇz pˇrináˇs´ı plnou lokalizaci do ˇceského jazyka[4]. 1 2

Prvn´ı prodanou poloˇzku a tou bylo rozbité laserové ukazov´ atko, které se prodalo za cenu 14.83 dolar˚ u. Trˇziˇstˇe eIM tzv. elektronick´ y mezin´ arodn´ı obchodn´ı port´ al.

1

´ KAPITOLA 1. UVOD

2

Obr´ azek 1.1: Ofici´ aln´ı internetová stránka eBay

1.2

Princip on-line aukce

Aktivnˇe se u ´ˇcastnit aukce[3] mohou jen registrovan´ı uˇzivatelé, ostatn´ı sm´ı jen aukci pozorovat. Registrace je zdarma, pˇriˇcemˇz se zpravidla vyˇzaduje jméno, pˇr´ıjmen´ı, kontaktn´ı a emailová adresa, na kterou je poté zasl´ an potvrzovac´ı email, kter´ y obsahuje odkaz, po jehoˇz kliknut´ı se dokonˇc´ı registrace. Aukce prob´ıhaj´ı od zvolené ˇc´ astky a trvaj´ı r˚ uznˇe dlouho (zpravidla ne déle jak mˇes´ıc). Aukci vyhrává pochopitelnˇe nejvyˇsˇs´ı nab´ıdka. Kromˇe klasického aukˇcn´ıho pˇrihazován´ı“, ” ˇcemuˇz se na eBay ofici´ alnˇe ˇr´ık´ a Chinese auction, lze vyuˇz´ıt moˇznosti Buy it now, coˇz znamená nakoupit zboˇz´ı okamˇzitˇe za stanovenou fixn´ı cenu. Tyto dva typy aukc´ı je moˇzno kombinovat tak, ˇze daná poloˇzka aukce je draˇzena tradiˇcn´ım zp˚ usobem a pˇritom má nastavenu fixn´ı cenu. Je zˇrejmé, ˇze fixn´ı cena je vyˇsˇs´ı neˇz poˇc´ ateˇcn´ı cena nastavená klasick´ ym pˇrihazován´ım. Dále lze vyuˇz´ıt tˇret´ıho typu aukce, jenˇz se vyskytuje pouze spoleˇcnˇe s Buy it now aukc´ı a to je tzv. Best offer. To znamen´ a, ˇze kromˇe moˇznosti koupˇe poloˇzky za fixn´ı cenu, je umoˇznˇeno prodejci udˇelat nab´ıdku vlastn´ı ceny, kterou m˚ uˇze a nemus´ı pˇrijmout. Po skonˇcen´ı aukce má prodejce sedm dn´ı na vyˇr´ızen´ı obchodu, tedy v´ ymˇeny zboˇz´ı a penˇez. Je uˇziteˇcné m´ıt zaregistrovan´ yu ´ˇcet v systému PayPal, protoˇze se ho dá u vˇetˇsiny aukc´ı vyuˇz´ıt. Nejlepˇs´ı je m´ıt u ´ˇcet ovˇeˇren´ y, k ˇcemuˇz staˇc´ı registrovaná platebn´ı karta s neblokovanou moˇznost´ı on-line plateb.

1.3

Souˇ casn´ e trendy on-line nakupov´ an´ı

Internetov´ a aukce se posléze stala celosvˇetov´ ym hitem, jenˇz umoˇzn ˇuje lidem prodávat a nakupovat ˇsiroké spektrum zboˇz´ı a sluˇzeb on-line. D´ıky velmi ˇsiroké nab´ıdce zboˇz´ı od prodejc˚ u z celého svˇeta lze pˇres eBay koupit ˇci prodat prakticky cokoliv3 . Aukce eBay se nachaz´ı na nˇekolika domén´ ach (ebay.com, ebay.de, ebay.ca, ebay.co.uk, ebay.cz, ebay.com.au 3

Jsou zn´ amy i pˇr´ıpady, kdy nespokojen´ y manˇzel prod´ aval v aukci svou manˇzelku.

ˇ ´ TRENDY ON-LINE NAKUPOVAN ´ Í 1.3. SOUCASN E

3

atd.), které jsou vz´ ajemnˇe propojeny, tud´ıˇz pro spokojené nakupován´ı staˇc´ı jeden uˇzivatelsk´ y u ´ˇcet. Pro informaci uvedu i jiné konkurenˇcn´ı aukˇcn´ı portály: • http://www.amazon.com • http://www.aukro.cz • http://heureka.cz • http://ikup.cz V´ yhod internetov´ ych aukc´ı je nespoˇcet, proto krátce uvedu jen ty hlavn´ı. V prvé ˇradˇe je to nab´ıdka obrovského sortimentu zboˇz´ı, které nem˚ uˇze konkurovat ˇzádn´ y obchod na svˇetˇe. Dále jsou to niˇzˇs´ı ceny, jelikoˇz aukˇcn´ı systém pruˇznˇe reaguje na celkovou poptávku a nab´ıdku zboˇz´ı, tud´ıˇz poskytuje rovnov´ aˇznou cenu. Z dalˇs´ıch v´ yhod jmenujme napˇr. snadnou komunikaci mezi prodejci a z´ akazn´ıky, fotografie a popisy zboˇz´ı, dále pak vyhledáván´ı podle kl´ıˇcov´ ych slov a v neposledn´ı ˇradˇe pohodlnost vyˇr´ızen´ı obchodu (ponˇevadˇz vˇse, co ˇclovˇek potˇrebuje, je zaregistrovan´ y u ´ˇcet na portálu a zaˇr´ızen´ı pˇripojené k internetu) a rychlost, protoˇze kaˇzd´ y prodejce je povinen m´ıt zboˇz´ı fyzicky k dispozici, tud´ıˇz nehroz´ı problém jako v ˇradˇe internetov´ ych obchod˚ u, kdy zboˇz´ı nen´ı skladem dostupné. Existuj´ı ovˇsem i nev´ yhody. A to kupˇr´ıkladu placen´ı poˇstovného, jeˇz se m˚ uˇze prodraˇzit v pˇr´ıpadˇe, ˇze nakupujeme od v´ıce prodejc˚ u. Dalˇs´ı nev´ yhodou je nutnost bojovat“ se soupeˇri v ” aukci, kteˇr´ı maj´ı z´ ajem o to samé zboˇz´ı. Tento problém se pokus´ım vyˇreˇsit ve své bakaláˇrské práci.

4

´ KAPITOLA 1. UVOD

Kapitola 2

Motivace Motivac´ı pro vytvoˇren´ı programu mi bylo zjiˇstˇen´ı, ˇze eBay poskytuje API pro nˇekteré své sluˇzby.1 To se mi jev´ı jako velmi kladn´ y pˇr´ıstup, z kterého mohou ˇcerpat i ostatn´ı v´ yvoj´ aˇri. Tato pr´ ace nen´ı reˇserˇsn´ı, coˇz znamená, ˇze se nesnaˇz´ım popsat r˚ uzné zp˚ usoby dosaˇzen´ı téhoˇz v´ ysledku, ale naopak vol´ım jeden, dle mého názoru nejlepˇs´ı a nejjednoduˇsˇs´ı (na ostatn´ı ˇreˇsen´ı pˇr´ıpadnˇe upozorˇ nuji) a ten podrobnˇe rozeb´ırám. Vˇse jsem se snaˇzil co moˇzn´ a nejpraktiˇctˇeji vysvˇetlit a popsat, aby ˇctenáˇr dokázal snadno proniknout do problematiky.

2.1

C´ıle pr´ ace

Hlavn´ım c´ılem této pr´ ace je na základˇe uveden´ ych poˇzadavk˚ u vytvoˇrit funguj´ıc´ı program, a ˇrádnˇe ho otestovat. • Popis ˇreˇseného problému, vymezen´ı c´ıl˚ u bakaláˇrské práce a poˇzadavk˚ u na implementovan´ y systém. • Zhodnocen´ı existuj´ıc´ıch implementac´ı. • Anal´ yza a n´ avrh implementace. • Vytvoˇren´ı programu a n´ asledn´ y popis implementace. • Testov´ an´ı aplikace. • Zhodnocen´ı splnˇen´ı c´ıl˚ u bakaláˇrské práce a vlastn´ıho pˇr´ınosu. • Diskuze dalˇs´ıho moˇzného pokraˇcován´ı práce. 1

O tom pozdˇeji v anal´ yze a n´ avrhu ˇreˇsen´ı.

5

6

KAPITOLA 2. MOTIVACE

2.2

V´ ysledek pr´ ace

Jak vypad´ a konkrétn´ı podoba v´ ysledného programu? Je to desktopová aplikace, která: • po zadán´ı pˇrihlaˇsovac´ıch u ´daj˚ u vytvoˇr´ı spojen´ı s aukˇcn´ım portálem eBay.com, • podle ID pˇr´ısluˇsné aukce zobraz´ı informace o dané aukci, • dokáˇze monitorovat v´ıce aukc´ı souˇcasnˇe, • zjist´ı ofici´ aln´ı ˇcas aukˇcn´ıho port´ alu eBay.com pro synchronizaci pˇresného ˇcasu pˇr´ıhozu“, ” • po nastaven´ı fin´ aln´ı ˇc´ astky pˇrihod´ı“ tuto sumu v posledn´ıch 5 sekundách aukce, ” • funguje pod operaˇcn´ım systémem Linux i Windows, • má grafické uˇzivatelské prostˇred´ı (GUI).

2.3

Existuj´ıc´ı implementace

V souˇcasné dobˇe je mi zn´ ama pouze jedna desktopová aplikace funguj´ıc´ı na podobném principu a to jBidwatcher[10]. Je to freeware program implementovan´ y v Javˇe, maj´ıc´ı za u ´kol monitorovat a pˇrihazovat ˇc´ astku v posledn´ım momentˇe aukce. Kromˇe toho umoˇzn ˇuje vyhledáván´ı poloˇzek na eBay a ˇcasovou synchronizaci s eBay serverem. V dobˇe psan´ı této práce se aplikace nach´ azela v pre-release stadiu, viz Obrázek 2.1.

Obr´ azek 2.1: Program JBidwatcher verze 2.1pre5

Dále existuje nˇekolik doplˇ nk˚ u pro prohl´ıˇzeˇc Mozilla Firefox[7], jeˇz jsou vˇetˇsinou neaktuáln´ı a zastaralé s t´ım, jak eBay mˇen´ı své str´ anky a zabezpeˇcuje se proti sniffingu[18] nebo jsou tyto pluginy propojené s u ´ˇcty on-line aplikaci[2], které vˇsak vyˇzaduj´ı registraci a maj´ı jisté omezen´ı ˇci nev´ yhody, jako kupˇr´ıkladu si vynucuj´ı pod´ıl na vyhrané aukci nebo pˇri zadán´ı monitorován´ı nové aukce poˇzaduj´ı zaplacen´ı jednorázového poplatku apod.

Kapitola 3

Anal´ yza a n´ avrh ˇ reˇ sen´ı Jaké poˇzadavky jsou tedy kladeny na program? Vycház´ım z oficiáln´ıho zadán´ı práce a dále pak poˇzadavk˚ u bˇeˇzného uˇzivatele. Aplikace by mˇela b´ yt stabiln´ı a co se t´ yká ovlád´ an´ı uˇ zivatelsky pˇ r´ıvˇ etiv´ a. Z tohoto d˚ uvodu jsem se rozhodl implementovat GUI, ovˇsem pˇri podm´ınce zachov´ an´ı jednoduchosti. A to proto, ˇze bych byl nerad, kdyby se GUI stalo obtˇeˇzuj´ıc´ım faktorem, jenˇz uˇzivateli znepˇrehledˇ nuje ˇcinnost a zhorˇsuje schopnosti ovl´ adat program a orientovat se v nˇem. Co se t´ yká stability programu jsou kladeny nároky pˇredevˇs´ım na chyby zp˚ usobené uˇzivatelem, jako napˇr. nevhodná forma vstupn´ıch dat i na chyby prostˇre” d´ı“ jako je napˇr. n´ ahl´ a ztr´ ata internetového spojen´ı. Jednou z d˚ uleˇzit´ ych a ˇcasto opom´ıjen´ ych vlastnost´ı je také nen´ aroˇ cnost instalace programu a jeho spuˇ stˇ en´ı. Tady bych, i z d˚ uvod˚ u popsan´ ych n´ıˇze 3.1, preferoval programovac´ı jazyk Java, jenˇz má tu moˇznost vytvoˇrit spustiteln´ y soubor - jar archiv, coˇz je pro bˇeˇzného uˇzivatele pohodlnˇejˇs´ı neˇz napˇr. spouˇstˇet bash skript ˇci instalovat lok´ aln´ı server.

Obr´ azek 3.1: Model poˇzadavk˚ u pˇrihazovac´ıho programu

Vzhledem k tomu, ˇze jsem si stanovil za c´ıl, aby program byl schopn´ y se autentifikovat a autorizovat na eBay, bude nutné, aby uˇzivatel vyplnil své pˇrihlaˇsovac´ı u ´daje. T´ım vznik´ a dalˇs´ı poˇzadavek na program a nen´ı j´ım nic jiného neˇz bezpeˇ cnost. Protoˇze je standardem, aby aplikace umˇela pˇrihlaˇsovac´ı u ´daje naˇc´ıtat a ukládat, ponˇevadˇz vyplˇ novat je s kaˇzd´ ym dalˇs´ım spuˇstˇen´ım programu je nepohodlné, rozhodl jsem se, ˇze tuto funkˇcnost implementuji ve svém ˇreˇsen´ı. Za vhodn´ y form´ at uloˇzen´ı textov´ ych dat povaˇzuji stromovou strukturu, s n´ıˇz se velmi dobˇre pracuje. Programovac´ı jazyk Java nab´ız´ı ˇradu technologi´ı pro práci s jazykem

7

´ ´ ˇ SEN ˇ Í KAPITOLA 3. ANALYZA A NAVRH RE

8

XML. Proto jsem se rozhodl pouˇz´ıt tento znaˇckovac´ı jazyk, jenˇz spln´ı mé poˇzadavky na jednoduchost pr´ ace a stromovou strukturu. Pracovat budu s DOMem, ponˇevadˇz je mi bliˇzˇs´ı neˇz práce s SAX, i kdyˇz ten m´ a nesporné v´ yhody v niˇzˇs´ı pamˇet’ové nároˇcnosti a rychlosti u vˇetˇs´ıch“ dokument˚ u. J´ a budu ovˇsem pouˇz´ıvat jednoduchou stromovou strukturu, kde ” v´ ysledn´ y dokument nebude velk´ y“ 1 , tud´ıˇz pro ˇreˇsen´ı mého problému mi vystaˇc´ı pouˇz´ıvat ” DOM. Co se t´ yk´ a zm´ınˇené bezpeˇcnosti, bude vhodné data ukládat v ˇ sifrovan´ e podobˇ ea pˇri naˇc´ıtán´ı je deˇsifrovat. Nemysl´ım si, ˇze je nezbytnˇe nutné pouˇz´ıt silné ˇsifrován´ı nároˇcné na v´ ypoˇcetn´ı v´ ykon. Jde mi sp´ıˇse o to, vyfiltrovat moˇznost pouhého otevˇren´ı souboru v textovém reˇzimu a z´ıskán´ı tak veˇsker´ ych pˇrihlaˇsovac´ıch u ´daj˚ u. Pro názornˇejˇs´ı pˇredstavu jsem vytvoˇril model pˇr´ıpad˚ u uˇzit´ı, kter´ y je zobrazen na následuj´ıc´ım obrázku 3.2.

Obr´ azek 3.2: Model pˇr´ıpad˚ u uˇzit´ı pˇrihazovac´ıho programu

Podle moˇznost´ı a ˇcasu bych d´ ale aplikaci rozˇs´ıˇril o dalˇs´ı schopnosti, jenˇz by z n´ı udˇelaly mohutnˇejˇs´ı nástroj na spravov´ an´ı aukc´ı na eBay. Budu dávat pˇrednost funkcionalitám, které budou data z eBay z´ısk´ avat a zpracov´ avat, nikoliv dodávat. 1

Strom nebude obsahovat v´ıce jak 20 uzl˚ u.

3.1. PROGRAMOVACÍ JAZYK

3.1

9

Programovac´ı jazyk

Hled´ an´ı relevantn´ıch informac´ı o eBay mˇe zavedlo na pro mˇe urˇcitˇe nejhodnotnˇejˇs´ı stránky eBay Developers Programu[5]. Neváhal jsem a po bezplatné registraci se pˇripojil do v´ yvojáˇrského centra2 . Prvn´ı rozhodnut´ı, které jsem musel uˇcinit, se t´ ykalo programovac´ıho jazyka, v kterém budu implementovat ˇreˇsen´ı své bakaláˇrské práce. D˚ uleˇzitá pro mˇe byla znalost jazyka a jeho multiplatformnost. Developersk´ y program eBay nab´ız´ı podporu pro tato implementaˇcn´ı prostˇred´ı a technologie: • JavaScript Dev Center (JavaScript, JSON, AJAX) • Flash Dev Center (ActionScript, Flex) • PHP Dev Center (PHP, Perl, Python) • Windows Dev Center (.NET, C#, ASP, VB) • Java Dev Center (Java, JSP) Hlavn´ı roli v mém rozhodnut´ı hrály osobn´ı zkuˇsenosti s dan´ ymi programovac´ımi jazyky. Nejvˇetˇs´ı zkuˇsenosti m´ am s programovac´ım jazykem Java, o ˇrád menˇs´ı potom s PHP a JavaScriptem. Pro Javu jsem se rozhodl z nˇekolika dalˇs´ıch d˚ uvod˚ u. Jedn´ım z rozhoduj´ıc´ıch faktor˚ u byla moˇznost st´ ahnout kompletn´ı software developement kit (SDK) pro Javu vˇcetnˇe dokumentace. Dalˇs´ı v´ yhodou Javy oproti PHP ˇci JavaScriptu je fakt, ˇze pro bˇeh aplikace nen´ı nutné m´ıt nainstalovan´ y a funkˇcn´ı aplikaˇcn´ı server. V neposledn´ı ˇradˇe Java nab´ız´ı moˇznost vytvoˇren´ı spustitelného jar archivu. K v´ yvoji programu je ovˇsem potˇreba m´ıt nainstalované JDK[11] ve verzi 1.6 update 3 nebo vyˇsˇs´ı, ke spuˇstˇen´ı pak JRE[11] a pochopitelnˇe vlastnit zaˇr´ızen´ı pˇripojené k internetu.

3.2

Pouˇ zit´ e prostˇ red´ı pro tvorbu

Vzhledem k podm´ınce fungován´ı programu v linuxovém prostˇred´ı jsem se rozhodl implementovat v Ubuntu 9.10 the Karmic Koala. Jako IDE jsem si vybral Eclipse 3.5 SR2, které dostateˇcnˇe vyhovuje poˇzadavk˚ um pro v´ yvoj, testován´ı i bˇeh programu.

2

Doporuˇcuji se registrovat, z´ısk´ ate t´ım automaticky vygenerovan´ a ID a tokeny potˇrebné pro testov´ an´ı a bˇeh aplikace

10

´ ´ ˇ SEN ˇ Í KAPITOLA 3. ANALYZA A NAVRH RE

Kapitola 4

Realizace V této kapitole se zamˇeˇr´ım na popis implementace se zamˇeˇren´ım na nestandardn´ı ˇc´ asti ˇreˇsen´ı, ponˇevadˇz aplikace je rozs´ ahlá a pˇrijde mi nevhodné popisovat ˇreknˇeme standardn´ı“ ” souˇcásti programu jako napˇr. GUI nebo vysvˇetlovat rozˇs´ıˇrené funkce programu oproti zad´ an´ı, ´ které jsem se dobrovolnˇe rozhodl implementovat. Dále odkazuji do kapitoly Uvod konkrétnˇe do bodu 1.2 Princip online aukce na vysvˇetlen´ı typ˚ u aukc´ı eBay a jejich moˇzn´ ymi kombinacemi, nebot’ jsou tyto informace nezbytné pro pochopen´ı samotného kódu a pouˇzit´ ych v´ yraz˚ u v této kapitole.

4.1

Implementace vyuˇ z´ıvaj´ıc´ı eBay API

Program je navrˇzen s vyuˇzit´ım eBay API, v dobˇe psan´ı tohoto textu v posledn´ı verzi 665. eBay API se skl´ ad´ a z nˇekolika d´ılˇc´ıch API, které spravuj´ı svou urˇcitou oblast, pracuj´ı na r˚ uzn´ ych protokolech a podporuj´ı r˚ uzné formáty dat. eBay oznaˇcuje mnoˇzinu podporovan´ ych API jako eBay Web Services. Tato mnoˇzina se potom dˇel´ı do pˇeti podmnoˇzin, jimiˇz jsou Search, Selling, Buying, Users a Alerts. Jednotlivé podmnoˇziny pak obsahuj´ı konkrétn´ı API. Pro pˇredstavu uvedu nˇekteré z nich spadaj´ıc´ı do v´ yˇse zm´ınˇen´ ych skupin. V podmnoˇzinˇe Search je to napˇr. • Finding API umoˇzn ˇuj´ıc´ı vyhledávat poloˇzky na eBay, v Selling: • Trading API zajiˇst’uj´ıc´ı autentizovan´ y pˇr´ıstup k soukrom´ ym dat˚ um na eBay a spravuj´ıc´ı prodejn´ı management, • Research API zprostˇredkovávaj´ıc´ı historické informace o eBay, v Buying: • Shopping API, které slouˇz´ı na vyhledáván´ı produkt˚ u, ovˇsem na rozd´ıl od Finding API je optimalizov´ an na rychlost, pouˇzitelnost a menˇs´ı objem pˇrenáˇsen´ ych dat pro pˇr´ıstup k veˇrejn´ ym read-only dat˚ um na eBay ve svˇetˇe Web 2.0,

11

12

KAPITOLA 4. REALIZACE

v Users: • Feedback API poskytuj´ıc´ı spr´ avu uˇzivatelsk´ ych u ´ˇct˚ u a v Alerts: • Server Notification API poskytuj´ıc´ı serverové oznámen´ı vhodné pro aplikace serverového typu, jenˇz mohou tˇemto notifikac´ım z eBay naslouchat. Pro komunikaci s eBay API se vyuˇz´ıv´ a protokol HTTP (kromˇe Trading API, kde se vyuˇz´ıvá zabezpeˇcen´ y HTTPS protokol v poˇzadavku POST) v poˇzadavc´ıch GET(REST[17]) a POST. Pro formát dat se vyuˇz´ıv´ a XML, SOAP[19] a JSON[12]. Protoˇze jednotlivé API jsou znaˇcnˇe rozsáhlé a vydaly by na celou knihu, jsou popsány detailnˇeji pouze ty, které jsou v aplikaci prakticky vyuˇzity a pro z´ıskán´ı dalˇs´ıch informac´ı odkazuji[1] na detailn´ı popis a dokumentaci k jednotliv´ ym API na internetov´ ych stránkách eBay Developers Programu.

4.2

Pˇ rihl´ aˇ sen´ı do syst´ emu

Cel´ y program pracuje jako celek a autentizuje se v˚ uˇci eBay Trading Web Services zabezpeˇcen´ ym HTTPS protokolem. Tud´ıˇz je zapotˇreb´ı m´ıt registrovan´ yu ´ˇcet na eBay, ale také v eBay ´ Developers Programu, jejichˇz u ´ˇcty jsou vzájemnˇe propojeny. Uˇcet v eBay Developers Programu poskytuje DeveloperID, ApplicationID, CetrificateID na základˇe nichˇz se vygeneruje eBay token. Ten je n´ aslednˇe pouˇzit pro veˇskerou dalˇs´ı komunikaci a má ˇcasovˇe omezenou dobu trván´ı, ˇrádovˇe asi rok. Vˇsechny tyto identifikaˇcn´ı u ´daje lze také plnˇe vyuˇz´ıt pro pˇripojen´ı do testovac´ıho prostˇred´ı eBay Developers Program Sandbox, kde je moˇzno virtuálnˇe spravovat sv˚ uj mini“ eBay. Podle toho se liˇs´ı i pˇrihlaˇsovac´ı u ´daje, viz Dodatek B. Pokud byla ” v´ıcekrát zadána ˇspatn´ a kombinace pˇrihlaˇsovac´ıho jména a hesla, m˚ uˇze se server dotázat na tzv. CAPTCHA. T´ım se snaˇz´ı pˇredcházet slovn´ıkovému u ´toku. Následuj´ıc´ı u ´sek kódu popisuje pˇrihláˇsen´ı na eBay: ApiContext apiContext = new ApiContext(); ApiCredential apiCred = new ApiCredential(); this.apiContext.setApiCredential(apiCred); ApiAccount account = new ApiAccount(); this.apiCred.setApiAccount(account); ApiLogging apiLogging = new ApiLogging(); this.apiContext.setApiLogging(apiLogging); this.apiContext.setApiServerUrl("apiServerURL"); this.apiContext.setEpsServerUrl("epsServerURL"); this.apiContext.setSignInUrl("signInURL");

ˇ ´ SEN ˇ Í DO SYSTEMU ´ 4.2. PRIHL A

13

this.account.setDeveloper("developerID"); this.account.setApplication("applicationID"); this.account.setCertificate("certificateID"); this.apiCred.seteBayToken("token"); Ve skuteˇcnosti t´ımto zp˚ usobem neprob´ıhá ˇzádné pˇrihlaˇsován´ı. Pouze se do promˇenné apiContext nastavuj´ı veˇskeré pˇrihlaˇsovac´ı u ´daje a adresy. Promˇenná apiContext se pouˇz´ıv´ a pro vˇsechnu komunikaci se serverem. API pak dále zajist´ı zvolen´ı názvu sluˇzby, ke které pˇristupujeme. Vlastn´ı autorizace je provedena pˇri prvn´ı komunikaci se serverem, odpadá tak nutnost autorizov´ an´ı se pˇri kaˇzdé v´ ymˇenˇe dat.

Obr´ azek 4.1: Model nasazen´ı pˇrihazovac´ıho programu

Na obr´ azku 4.1 se nach´ az´ı zjednoduˇsen´ y model nasazen´ı. Zjednoduˇsen´ y proto, ˇze se na nˇem nevyskytuj´ı vˇsechny API, s kter´ ymi program komunikuje, ale pouze ty nejpouˇz´ıvanˇejˇs´ı. Je tomu tak z d˚ uvodu pˇrehlednosti a názornosti, ponˇevadˇz se vˇsemi ostatn´ımi API komunikuje taktéˇz pˇres HTTP protokol.

4.2.1

Struktura XML

Program ukl´ ad´ a pˇrihlaˇsovac´ı u ´daje do souboru ve formátu XML, jehoˇz stromová struktura je zobrazena n´ıˇze. Tˇr´ıda StringEncrypter zaˇsifrovává hodnoty uzl˚ u Developer, Application, Certificate a Token, pˇriˇcemˇz ostatn´ı poloˇzky ˇsifrovány nejsou. Pouˇzit je open source algoritmus Base64 s veˇrejn´ ym kl´ıˇcem a 8 bytovou sol´ı, kter´ y má tu v´ yhodu, ˇze v´ ysledn´ y zakódovan´ y ˇretˇezec se skl´ ad´ a z tisknuteln´ ych znak˚ u ASCII, a proto jej mohu zapsat do XML souboru. Pˇri nahr´ av´ an´ı pˇrihlaˇsovac´ıch u ´daj˚ u jsou dané poloˇzky zpˇet deˇsifrovány.

14


Stromov´ a struktura XML souboru:

<ServerUrl>https://api.ebay.com/wsapi <EpsServerUrl>https://api.ebay.com/ws/api.dll <SignInUrl>https://signin.ebay.com/ws/eBayISAPI.dll?SignIn <ApiCredential> <Application/> <eBayCredential> <Username/> <Password/>

Cel´ y proces uloˇzen´ı pˇrihlaˇsovac´ıch u ´daj˚ u do XML souboru je názornˇe popsán sekvenˇcn´ım diagramem (Obr´ azek 4.2). Uˇzivatel se rozhodne uloˇzit své u ´daje, vybere si absolutn´ı cestu, kam je chce uloˇzit, urˇc´ı n´ azev souboru a stiskne tlaˇc´ıtko v GUI. To vyvolá akci, v n´ıˇz tˇr´ıda Saver1 nasetuje uˇzivatelem zadané pˇrihlaˇsovac´ı u ´daje do promˇenn´ ych a pˇredá je tˇr´ıdˇe StringEncrypt k zaˇsifrov´ an´ı. Zaˇsifrované u ´daje jsou pˇredány tˇr´ıdˇe XML Builder, která vytvoˇr´ı v´ yˇse zm´ınˇen´ y stromov´ y model XML souboru a zap´ıˇse do nˇeho zaˇsifrované hodnoty. Takto vytvoˇren´ y model je uloˇzen do XML souboru se zvolen´ ym názvem a absolutn´ı cestou. Nakonec je uˇzivatel informov´ an o probˇehnuté akci zobrazen´ım dialogového okna v GUI. Naˇcten´ı pˇrihlaˇsovac´ıch u ´daj˚ u ze souboru funguje analogicky.

1

N´ azvy tˇr´ıd nekoresponduj´ı pˇresnˇe s n´ azvy tˇr´ıd v implementaci z d˚ uvodu pˇrehlednosti a n´ azornosti diagramu.

´ Í INFORMACÍ O POLOZCE ˇ 4.3. ZÍSKAN NA EBAY

15

Obr´ azek 4.2: Sekvenˇcn´ı diagram uloˇzen´ı pˇrihlaˇsovac´ıch u ´daj˚ u do XML souboru

4.3

Z´ısk´ an´ı informac´ı o poloˇ zce na eBay

Po pˇrihl´ aˇsen´ı a v´ ybˇeru akce z hlavn´ıho menu je v pˇreváˇzné vˇetˇsinˇe nutné zadat item ID dané poloˇzky, o n´ıˇz chce uˇzivatel zjistit urˇcité informace. Proto je vhodné vˇedˇet, kde je moˇzné item ID nalézt a jak s n´ım program dále pracuje. Item ID je jednoznaˇcn´ y identifikátor poloˇzky na eBay oznaˇcen´ y jako Item number, coˇz je dvanáctim´ıstné ˇc´ıslo. Toto ˇc´ıslo je zobrazeno u kaˇzdé aukce na eBay, viz Obr´ azek 4.3 zakrouˇzkováno ˇcervenˇe. Po zad´ an´ı spr´ avného item ID program zobraz´ı informace o dané poloˇzce. K z´ıskán´ı dat se vyuˇz´ıv´ a tˇr´ıda z eBay Trading API GetItemCall, které se do konstruktoru pˇredá apiContext. Metoda této tˇr´ıdy getItem(itemID) vrac´ı data v objektu typu ItemType. K takto z´ıskan´ ym dat˚ um lze pˇristupovat vol´ an´ım jednotliv´ ych get metod, jak je zˇrejmé z následuj´ıc´ıho u ´seku kódu. Z´ıskané hodnoty se potom zobraz´ı v jednotliv´ ych textboxech pˇr´ıpadnˇe tabulkách v GUI aplikace. ApiContext apiContext = new ApiContext(); GetItemCall api = new GetItemCall(apiContext); String itemID = txtItemId.getText(); ItemType item = api.getItem(itemID); item.getTitle(); item.getSellingStatus().getCurrentPrice().getValue()).toString()); item.getQuantity().toString(); item.getPrimaryCategory().getCategoryID();

16


Obr´ azek 4.3: Z´ısk´ an´ı tzv. Item number u poloˇzky na eBay

4.4

Pˇ rihozen´ı

Podle zadaného item ID program rozhodne, o jak´ y typ aukce se u dané poloˇzky jedná t´ım, ˇze se zavolá metoda z eBay Trading API getListingType().value(), která do promˇenné typu String auktionType uloˇz´ı hodnotu typu aukce. String auctionType = item.getListingType().value(); Metoda getListingType().value() vrac´ı tyto hodnoty: • Chinese pro pˇrihazovac´ı“ typ aukce ” • FixedPriceItem pro aukce typu Buy It Now Pro zjiˇstˇen´ı, zda dan´ a aukce nab´ız´ı moˇznost vytvoˇrit vlastn´ı nab´ıdku, tzv. BestOffer, slouˇz´ı metoda getBestOfferDetails(), která do objektu tˇr´ıdy BestOfferDeatilsType uloˇz´ı informace ohlednˇe BestOffer aukci nebo null. Pokud objekt nen´ı null, zavolá se metoda isBestOfferEnabled(), kter´ a do promˇenné typu String bestOffer uloˇz´ı hodnotu "Yes" v pˇr´ıpadˇe, ˇze aukce podporuje BestOffer. V opaˇcném pˇr´ıpadˇe je v promˇenné uloˇzena hodnota "No".

ˇ Í 4.4. PRIHOZEN

17

BestOfferDetailsType bod = item.getBestOfferDetails(); String bestOffer = "No"; if (bod != null) { bestOffer = Utils.booleanToYesNo(bod.isBestOfferEnabled()); } Aplikace t´ımto zp˚ usobem zjist´ı, o jakou aukci pˇr´ıpadnˇe kombinaci typ˚ u aukc´ı se jedn´ a 2 a zpˇr´ıstupn´ı uˇzivateli dalˇs´ı moˇznosti resp. tlaˇc´ıtka, co lze s aukc´ı provést a nastav´ı také omezen´ı na fin´ aln´ı cenu a kvantitu, kdy pro Snipe mus´ı b´ yt nastavena v´ yˇse fináln´ı ˇcástky vˇetˇs´ı, neˇz je ta souˇcasn´ a, pro Buy It Now mus´ı b´ yt nastavená pˇresnˇe Buy It Now Price ˇcástka zjiˇstˇen´ a pro danou poloˇzku a v Best Offer záleˇz´ı na uˇzivateli, jakou ˇcástku nab´ıdne. Kvantita mus´ı b´ yt celoˇc´ıseln´ a a vˇzdy menˇs´ı nebo rovna kvantitˇe daného zboˇz´ı na eBay.

Obr´ azek 4.4: Okno zobrazuj´ıc´ı pˇrihazovac´ı menu 2

N´ azvy tlaˇc´ıtek koresponduj´ı s n´ azvy typ˚ u aukc´ı v anglické verzi eBay, tedy Buy It Now, Best Offer a pro Chinese aukci je to tlaˇc´ıtko Snipe.

18


Tlaˇc´ıtkem Get IP se program pokus´ı z´ıskat IP adresu poˇc´ıtaˇce, na nˇemˇz je spuˇstˇen. IP adresa se zjiˇst’uje posl´ an´ım POST poˇzadavku na internetovou stránku whatismyip.com, uloˇzenou v promˇenné strUrl, metodou executeMethod(post). Metoda getResponseBodyAs String() vrac´ı odpovˇed’ na poˇzadavek, tedy pokud vˇse probˇehne bez chyb, IP adresu ve formátu String. V pˇr´ıpadˇe chyby se zachyt´ı v´ yjimka. Metoda releaseConnection() nakonec uvoln´ı“ spojen´ı. ” String strURL = "http://whatismyip.com/automation/n09230945NL.asp"; PostMethod post = new PostMethod(strURL); HttpClient httpclient = new HttpClient(); try { httpclient.executeMethod(post); this.txtIP.setText(post.getResponseBodyAsString()); } catch (Exception ex) { loger.log(Priority.ERROR, ex); } finally { post.releaseConnection(); } Pokud se nepodaˇr´ı z´ıskat IP adresu, je nutné, aby ji uˇzivatel zadal ruˇcnˇe. V tomto pˇr´ıpadˇe je kontrolov´ ana validita IP adresy metodou validateIpAdress(String), které se jako parametr pˇred´ a promˇenn´ a typu String - ona IP adresa, a která metodou matches() porovná podle regul´ arn´ıho v´ yrazu vstupn´ı IP adresu a vyhodnot´ı jej´ı validitu. Regulárn´ı v´ yraz kontroluje, zda se mezi tˇremi teˇckami nacház´ı minimálnˇe jedna, maximálnˇe tˇri celoˇc´ıselné hodnoty v uzavˇreném intervalu nula aˇz devˇet. private boolean validateIpAddress(String iPaddress) { final Pattern IP_PATTERN = Pattern.compile("[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}"); return IP_PATTERN.matcher(iPaddress.trim()).matches(); } Takto zadané u ´daje jsou pˇripraveny ke zpracován´ı, tedy pˇrihozen´ı 4.4.1, koupi 4.4.2 nebo vytvoˇren´ı nejlepˇs´ı nab´ıdky 4.4.3.

4.4.1 4.4.1.1

Klasick´ a pˇ rihazovac´ı aukce Vytvoˇ ren´ı nab´ıdky a pˇ rihozen´ı

Pˇred samotn´ ym pˇrihozen´ım je nutné vytvoˇrit nab´ıdku. K tomu slouˇz´ı objekt offer tˇr´ıdy OfferType, kterému se nastav´ı tˇri hodnoty. Tˇemi jsou ˇcástka, která má b´ yt pˇrihozena, kvanˇ tita zboˇz´ı, které chceme koupit a typ aukce. Cástku i kvantitu urˇcil uˇzivatel, proto se metodami offer.setMaxBid(amount) respektive offer.setQuantity(item.getFinalQuantity())


19

z´ıská, pˇriˇcemˇz ˇc´ astka nen´ı typu Integer nebo Double, jak by se mohl ˇctenáˇr domn´ıvat, ale obaluje ji tˇr´ıda AmountType. Objektu amount této tˇr´ıdy mus´ı b´ yt nastavena mˇena stejná, jako je mˇena kupované poloˇzky, coˇz se zaruˇc´ı metodami amount.setCurrencyID(item.getCurren cy()). Pro dokonˇcen´ı nastaven´ı nab´ıdky je nutné specifikovat typ aukce metodou offer.set Action(BidActionCodeType.BID). V tomto pˇr´ıpadˇe konstanta BID urˇcuje klasickou pˇrihazovac´ı aukci neboli Chinese auction. Nyn´ı je vytvoˇrena nab´ıdka. Dále je vˇsak nutné vytvoˇrit poˇzadavek pˇrihozen´ı. K tomu slouˇz´ı tˇr´ıda z eBay Trading API PlaceOfferCall, které se jako parametr do konstruktoru pˇred´ a nˇekolikr´ at zm´ınˇen´ y apiContext. Objektu pf tˇr´ıdy PlaceOfferCall se nastav´ı metodou pf.setItemID(String.valueOf(item.getItemId())) item ID poloˇzky a metodou pf.setEndUserIP(item.getIpAddress()) IP adresa koncového zaˇr´ızen´ı. Metoda pf.setBlo ckOnWarning(false) urˇcuje, zda se pˇri varován´ı má - hodnota true nebo nemá - hodnota false blokovat posl´ an´ı nab´ıdky. Nakonec se poˇzadavek pˇrihozen´ı odeˇsle metodou pf.placeOf fer(). AmountType amount = new AmountType(); amount.setCurrencyID(item.getCurrency()); amount.setValue(item.getFinalPrice().doubleValue()); OfferType offer = new OfferType(); offer.setMaxBid(amount); offer.setQuantity(item.getFinalQuantity()); offer.setAction(BidActionCodeType.BID); PlaceOfferCall pf = new PlaceOfferCall(item.getApiContex()); pf.setBlockOnWarning(false); pf.setItemID(String.valueOf(item.getItemId())); pf.setOffer(offer); pf.setEndUserIP(item.getIpAddress()); pf.placeOffer(); 4.4.1.2

Monitorov´ an´ı aukc´ı

Dle zad´ an´ı m´ a program monitorovat v´ıce aukc´ı souˇcasnˇe a pˇrihodit zadanou ˇcástku v posledn´ıch pˇeti vteˇrin´ ach pˇred koncem aukce. Jak je toho doc´ıleno, bude popsáno v této podkapitole. Z´ akladem je synchronizovaná kolekce tasks, která obsahuje veˇskerá data o monitorovan´ ych aukc´ıch. Synchronizovaná je proto, aby jej´ı operace prob´ıhaly atomicky. Samotné monitorov´ an´ı prob´ıhá ve vláknˇe, které bˇeˇz´ı v nekoneˇcném while cyklu. Vl´ akno je metodou Thread.sleep(1000) po vteˇrinˇe uspáváno, pˇriˇcemˇz s kaˇzdou uplynuvˇs´ı vteˇrinou se zv´ yˇs´ı o jedniˇcku promˇenn´ a counter typu long. Podle hodnoty této promˇenné doch´ az´ı k pravideln´ ym aktualizac´ım dat monitorovan´ ych poloˇzek co dvˇe minuty, coˇz zajiˇst’uje podm´ınka if (counter % 120 == 0) a vytvoˇren´ı nového vlákna new RefreshThread(tasks.get(i)). start(), které automaticky z´ısk´ a a uloˇz´ı aktuáln´ı data o vˇsech poloˇzkách v kolekci3 . Podm´ınka if(counter == Long.MAX VALUE) slouˇz´ı k oˇsetˇren´ı situace, ˇze dojde k pˇreteˇcen´ı rozsahu typu Long. 3

Z´ısk´ an´ı dat o poloˇzce bylo pops´ ano v kapitole 4.3.

20


4.4.1.3

Vyhodnocen´ı ˇ casu pˇ rihozen´ı

Pro vˇsechny prvky kolekce se zjist´ı pˇresné datum konce aukce s pˇeti sekundov´ ym pˇredstihem metodou new Date(tasks.get(i).getEndTime().getTime() - 5000), která ho uloˇz´ı do ˇ konce aukce je v podm´ınce if(endDate.before(date) nového objektu endDate typu Date. Cas && tasks.get(i).isFinished() == false) porovnáván s aktuáln´ım ˇcasem. Pokud je podm´ınka splnˇena, oznaˇc´ı se aukce metodou tasks.get(i).setFinished(true) jako skonˇcená, aby neprobˇehlo opˇetovné pˇrihozen´ı a v podm´ınce if(tasks.get(i).getFinalPrice().compa reTo(tasks.get(i).getCurrentPrice()) == 1) se vyhodnocuje, zda nastavená fináln´ı hodnota ceny pˇr´ıhozu je vˇetˇs´ı neˇz aktu´ aln´ı cena poloˇzky. Pokud ano, vytvoˇr´ı se nové vlákno new SnipeThread(tasks.get(i)).start(), které provede pˇrihozen´ı, dle nastaven´ ych parametr˚ u. Pokud nen´ı splnˇena podm´ınka, nen´ı uˇzivatel nijak upozornˇen, ˇze program nepˇrihodil a to proto, at’ nen´ı obtˇeˇzov´ an vyskakuj´ıc´ımi okny apod. Pouh´ ym zkontrolován´ım v´ ysledku aukce pozná, ˇze fináln´ı hodnota ˇc´ astky pˇrihozen´ı je vyˇsˇs´ı, neˇz byla j´ım nastavená hodnota, tud´ıˇz nebylo moˇzné aukci vyhr´ at. private static List<SnipeTask> tasks = Collections.synchronizedList(new LinkedList<SnipeTask>()); private long counter = 0; public void run() { while (true) { for (int i = 0; i < tasks.size(); i++) { Date endDate = new Date(tasks.get(i).getEndTime().getTime() - 5000); Date date = new Date(); if (endDate.before(date) && tasks.get(i).isFinished() == false) { tasks.get(i).setFinished(true); if (tasks.get(i).getFinalPrice().compareTo(tasks.get(i). getCurrentPrice()) == 1) new SnipeThread(tasks.get(i)).start(); } else { if (counter % 120 == 0) new RefreshThread(tasks.get(i)).start(); } } tasks.removeAll(toDelete); try { Thread.sleep(1000); counter++; if(counter == Long.MAX_VALUE) counter = 0; } } }


4.4.1.4

21

Zruˇ sen´ı monitorovan´ e aukce

Aby nedoch´ azelo k ˇcasovˇe z´ avisl´ ym chybám, je poloˇzka, kterou chce uˇzivatel smazat z monitorovan´ ych aukc´ı, nejdˇr´ıve pˇridána metodou toDelete.add(tasks.get(index)) do kolekce toDelete a aˇz mimo for cyklus zm´ınˇen´ y v´ yˇse smazána metodou tasks.removeAll(to Delete). Pokud by se ono maz´ an´ı poloˇzky vyskytovalo uvnitˇr for cyklu, doˇslo by k n´ ahlé zmˇenˇe hodnoty tasks.size() omezuj´ıc´ı poˇcet iterac´ı cyklu a nastala by v´ yjimka. private static List<SnipeTask> toDelete = new ArrayList<SnipeTask>(); public void removeFromTasksList(int index) { toDelete.add(tasks.get(index)); } 4.4.1.5

N´ azorn´ y popis cel´ eho procesu pˇ rihozen´ı

Jak prob´ıh´ a cel´ y postup od spuˇstˇen´ı aplikace aˇz po pˇrihozen´ı ˇcástky popisuje iterativnˇe obr´ azek 4.5. Po pˇrihl´ aˇsen´ı uˇzivatele se zjist´ı informace o poloˇzce, vytvoˇr´ı se nab´ıdka zadán´ım hodnoty ceny, kter´ a m´ a b´ yt pˇrihozena. Pokud je vˇse nastavené správnˇe, dojde k potvrzen´ı nab´ıdky a jej´ımu pˇrihozen´ı. Pokud pˇrihozen´ı probˇehlo bez chyb, oznám´ı se nejvyˇsˇs´ı pˇrihazuj´ıc´ı.

Obr´ azek 4.5: Bussiness model pˇrihozen´ı

22


4.4.2

Koupˇ e poloˇ zky za fixn´ı cenu

Koupˇe poloˇzky za fixn´ı cenu se oproti klasické pˇrihazovac´ı aukci liˇs´ı pochopitelnˇe v typu nastavené aukce. V tomto pˇr´ıpadˇe je potˇreba zmˇenit BidActionCodeType na PURCHASE. Dále se mus´ı nastavit pˇresnˇe urˇcen´ a hodnota ceny Buy It Now poloˇzky na eBay. Metodami amount.setValue(item.getBuyItNowPrice()) se do objektu amount tˇr´ıdy AmountType uloˇz´ı hodnota této ceny, aby se n´ aslednˇe mohla vytvoˇrit nab´ıdka metodou setMaxBid(amount). Nastaven´ı IP adresy, mˇeny, kvantity a ID kupované poloˇzky z˚ ustává stejné jako v pˇr´ıpadˇe klasické pˇrihazovac´ı aukce. offer.setAction(BidActionCodeType.PURCHASE); AmountType amount = new AmountType(); amount.setValue(item.getBuyItNowPrice()); OfferType offer = new OfferType(); offer.setMaxBid(amount);

4.4.3

Posl´ an´ı nejlepˇ s´ı nab´ıdky

Vytvoˇren´ı nejlepˇs´ı nab´ıdky se oproti koupi poloˇzky za fixn´ı cenu liˇs´ı pochopitelnˇe v typu nastavené aukce. V tomto pˇr´ıpadˇe je potˇreba nastavit BidActionCodeType na OFFER. Nastaven´ı ostatn´ıch hodnot je stejné. offer.setAction(BidActionCodeType.OFFER);

4.5

Posl´ an´ı poˇ zadavku PlaceOffer

EBay Developers Program poskytuje na sv´ ych stránkách testovac´ı prostˇred´ı eBay API tzv. API Test Tool[20], kde je developer˚ um umoˇznˇeno testovat jednotlivá API a jejich metody a to jak pro sandbox tak i pro produkˇcn´ı verzi eBay. Práce s tˇr´ıdou PlaceOffer, která se stará o vytvoˇren´ı a pˇrihozen´ı nab´ıdky, uˇz byla popsána v kapitole 4.4. Nyn´ı bude vysvˇetleno, jak prob´ıhá komunikace. C´ılov´ y poˇc´ıtaˇc4 pos´ılá HTTP POST poˇzadavek eBay serveru. HTTP poˇzadavek ze skl´ ad´ a z HTTP hlaviˇcky a tˇela v XML formátu (onˇech vytvoˇren´ ych dat).

4.5.1

Struktura HTTP hlaviˇ cky

HTTP hlaviˇcka se skl´ ad´ a z atribut˚ u X-EBAY-API-COMPATIBILITY-LEVEL oznaˇcuj´ıc´ı verzi eBay API, X-EBAY-API-DEV-NAME, X-EBAY-API-APP-NAME a X-EBAY-API-CERT-NAME, které obsahuj´ı Developer ID, Application ID a Certificate ID, X-EBAY-API-SITEID udávaj´ıc´ı kód státu5 a atribut X-EBAY-API-CALL-NAME, kter´ y urˇcuje název poˇzadavku. 4 5

C´ılov´ ym poˇc´ıtaˇcem je myˇsleno koncové zaˇr´ızen´ı uˇzivatele. V uk´ azce je hodnota 0, kter´ a oznaˇcuje str´ anky eBay n´ aleˇzej´ıc´ı Spojen´ ym st´ at˚ um americk´ ym.

´ Í POZADAVKU ˇ 4.5. POSLAN PLACEOFFER

23

X-EBAY-API-COMPATIBILITY-LEVEL:665 X-EBAY-API-DEV-NAME:a83980e8-72b0-4ec5-9c04-f20accc48e8d X-EBAY-API-APP-NAME:Ccece4dc5-8cb1-4a1a-80a6-a7ac622be0e X-EBAY-API-CERT-NAME:066d0133-0ae9-4144-8e07-f509b800068c X-EBAY-API-SITEID:0 X-EBAY-API-CALL-NAME:PlaceOffer

4.5.2

Struktura XML poˇ zadavku

Tˇelo HTTP poˇzadavku obsahuje XML data. Jak si m˚ uˇze pozorn´ y ˇctenáˇr vˇsimnout, jsou to právˇe ta data, jejichˇz vytvoˇren´ı bylo popsáno v kapitole 4.4. Uzel RequesterCredentials respektive jeho potomek eBayAuthToken obsahuje token uˇzivatele. Zde je vidˇet, ˇze k datové komunikaci staˇc´ı opravdu pouze token a nen´ı nutné se znovu autorizovat v˚ uˇci eBay serveru, jak jiˇz bylo zm´ınˇeno v kapitole 4.2. Uzel Offer tedy jeho potomci obsahuj´ı data vztahuj´ıc´ı se ke konkrétn´ımu poˇzadavku pˇr´ıhozu6 . Hodnota v uzlu Action urˇcuje druh aukce podle tˇechto kl´ıˇcov´ ych slov: Bid|Purchase|Accept|Counter|Decline|Offer. V uzlu MaxBid je nastavena hodnota ˇc´ astky pˇrihozen´ı, v uzlu Quantity pak kvantita kupovaného zboˇz´ı. Uzel UserConsent obsahuje kl´ıˇcová slova true|false, které v pˇr´ıpadˇe, ˇze daná poloˇzka vyˇzaduje potvrzen´ı licenˇcn´ıch práv, popisuj´ı, zda s nimi uˇzivatel souhlas´ı ˇci nikoliv. Uzel Message umoˇzn ˇuje poslat zpr´ avu prodejci ve formátu String. Pokud aukce podporuje i vytvoˇren´ı nejlepˇs´ı nab´ıdky, m˚ uˇze se v poˇzadavku vyskytnout uzel BestOfferID, oznaˇcuj´ıc´ı ID této nab´ıdky. Posledn´ı zm´ınˇené tˇri uzly jsou pouze volitelné, zat´ımco vˇsechny ostatn´ı jsou vyˇzadov´ any. Uzel ItemID nese informaci o ID poloˇzky a uzel EndUserIP obsahuje IP adresu c´ılového zaˇr´ızen´ı. <eBayAuthToken> Bid|Purchase|Accept|Counter|Decline|Offer <MaxBid> AmountType int <UserConsent> boolean <Message> string <EndUserIP> string Na konkrétn´ı poˇzadavek v pˇr´ıpadˇe, ˇze nenastane chyba, poˇsle API následuj´ıc´ı odpovˇed’. Ou ´spˇechu komunikace informuje uzel Ack svoj´ı hodnotou Success. Uzel Timestamp infor6

Za pˇrihozen´ı se povaˇzuje i koupˇe poloˇzky za fixn´ı cenu a vytvoˇren´ı nejlepˇs´ı nab´ıdky. Nen´ı to sice pˇrihazov´ an´ı v pravém slova smyslu, ale jedn´ a se o jednor´ azové pˇrihozen´ı.

24


muje o ˇcasu posl´ an´ı odpovˇedi na poˇzadavek, uzly Version a Build oznaˇcuj´ı aktuáln´ı verzi a v´ yvojové sestaven´ı API. Uzel SellingStatus informuje o stavu prodeje. Atributy uzl˚ u ConvertedCurrentPrice a CurrentPrice currencyID informuj´ı o druhu mˇeny a v´ yˇsi hodnoty souˇcasné ceny v aukci. Uzel HighBidder respektive jeho potomek UserID oznaˇcuje ID aktuáln´ıho nejvyˇsˇs´ıho pˇrihazuj´ıc´ıho a uzel MinimumToBid udává minimáln´ı hodnotu dalˇs´ıho pˇr´ıhozu v dané mˇenˇe. <Timestamp>2010-05-22T23:53:28.571Z Success 665 <Build>E665_CORE_BUNDLED_11160767_R1 <UsageData>MTMyOTgxNjM3LzE0NzUxOw** <SellingStatus> 10.0 10.0 <UserID>testuser_ondras <MinimumToBid currencyID="USD">10.5 V pˇr´ıpadˇe chyby se v uzlu Ack vrac´ı hodnota Failure a uzel Errors s jeho potomky ShortMessage, LongMessage, ErrorCode, SeverityCode a ErrorClassification popisuje detailnˇe chybové hl´ aˇsen´ı. Failure <Errors> <ShortMessage>Please specify a query! Please specify a query! <ErrorCode>10.1 <SeverityCode>Error <ErrorClassification>RequestError Pro ucelen´ı poznatk˚ u o posl´ an´ı nab´ıdky a pr˚ ubˇehu komunikace c´ılového poˇc´ıtaˇce s eBay Trading API odkazuji[14] na referenˇcn´ı pˇr´ıruˇcku.

Kapitola 5

Testov´ an´ı Celou aplikaci bylo nutné pokr´ yt jednotkov´ ymi testy a testy grafického uˇzivatelského rozhran´ı. Pouze s t´ım jsem se vˇsak nespokojil a vytvoˇril jsem dotazn´ık, kter´ y jsem spoleˇcnˇe s programem rozeslal skupinˇe1 lid´ı k testován´ı. Spektrum osob, které mou aplikaci testovalo, jsem se snaˇzil vybrat co nejˇsirˇs´ı. Od naprost´ ych laik˚ u, aˇz po kolegy znalé softwarov´ ych technologi´ı, od mladˇs´ıch aˇz po osoby stˇredn´ıho vˇeku. Tuto metodu testován´ı jsem zvolil z d˚ uvodu objektivnosti a r˚ uzn´ ych nárok˚ u jednotliv´ ych uˇzivatel˚ u a pak také proto, abych mohl pruˇznˇe reagovat na opravu chyb, dodˇelán´ı nedostatk˚ u apod.

5.1

Jednotkov´ e testy

Jednotkové neboli unit testy pokr´ yvaj´ı bussiness logiku programu. Testovat bussiness logiku eBay API je kontraproduktivn´ı, ponˇevadˇz souˇcást´ı zdroj˚ u jsou Perf testy a Sanity testy, které pokr´ yvaj´ı celé eBay API. Testoval jsem proto pouze vlastn´ı kód. Na pˇr´ıkladu uvád´ım unit test ˇsifrov´ an´ı, kdy v promˇenné encode je text, kter´ y se má zaˇsifrovat a v promˇenné expectedCorrectResult je oˇcekávan´ y text po zaˇsifrován´ı. Na objektu tˇr´ıdy String Encrypter se zavol´ a metoda encrypt(String), která má b´ yt t´ımto unit testem pokryta, a které se pˇred´ a jako parametr obsah promˇenné encode, tedy text k zaˇsifrován´ı. Zaˇsifrovan´ y text se uloˇz´ı do promˇenné encrypted, která se porovnává v metodˇe assertEquals(String, String) na rovnost s promˇennou expectedCorrectResult, v n´ıˇz je oˇcekávan´ y v´ ysledek po zaˇsifrov´ an´ı. @Test public void testEncrypt() { StringEncrypter encrypter = new StringEncrypter(); String encode = "123456abcdEFGH"; String expectedCorrectResult = "RSoGc1TNhZlfUO5ZxcKI6g=="; String encrypted = encrypter.encrypt(encode); assertEquals(encrypted, expectedCorrectResult); } 1

Skupinou zde rozum´ım 10 tester˚ u

25

´ Í KAPITOLA 5. TESTOVAN

26

Ukázka popisuje oˇcek´ avan´ y v´ ystup, ale dále se testuj´ı chybové stavy, nepovolené, mezn´ı, nedefinované, minim´ aln´ı a maxim´ aln´ı hodnoty, prázdná a ne´ uplná vstupn´ı data apod.

5.2

Testy grafick´ eho uˇ zivatelsk´ eho rozhran´ı

GUI testy, jak uˇz z jejich zkratky vypov´ıdá, testuj´ı grafické uˇzivatelské rozhran´ı programu. K tomuto u ´ˇcelu je pouˇzit framework UISpec4J[9], kter´ y napomáhá testován´ı GUI Java aplikac´ı zaloˇzen´ ych na Swingu2 .

5.2.1

Mockov´ an´ı objekt˚ u

Technika zvan´ a mockov´ an´ı objekt˚ u se snaˇz´ı ˇreˇsit závislost testovaného kódu na ostatn´ım kódu tak, ˇze z´ avislost je nahrazov´ ana modelov´ ymi implementacemi tzv. mock objekty. Tyto objekty jsou propojeny s testovan´ ym kódem, a tak lze tento kód testovat tzv. zevnitˇr. Nahrazen´ım závislosti mock objekty je zaruˇcena izolovanost testu v˚ uˇci ostatn´ımu kódu. Ve tˇr´ıdˇe DialogGeteBayOfficialTimeCallMock se nacház´ı metoda geteBayOfficialTi me(), která vrac´ı instanci tˇr´ıdy typu Calendar. Instance tohoto objektu je právˇe mock objektem, s kter´ ym se potom d´ ale pracuje. public class DialogGeteBayOfficialTimeCallMock extends GeteBayOfficialTimeCall { @Override public Calendar geteBayOfficialTime() throws Exception { return Calendar.getInstance(); } } V metodˇe testGeteBayOfficialTime() se testuje správné zobrazen´ı z´ıskan´ ych dat, v tomto pˇr´ıpadˇe ofici´ aln´ıho ˇcasu eBay a v´ yskyt komponent knihovny Swing. Jelikoˇz oficiáln´ı ˇcas eBay se neust´ ale mˇen´ı a u ´ˇcelem nen´ı testovat, zda správnˇe funguje z´ıskáván´ı ˇcasu ze serveru eBay, je zde pouˇzit pr´ avˇe onen vytvoˇren´ y mock objekt, tedy instance tˇr´ıdy Calendar. T´ım se doc´ıl´ı pouze testov´ an´ı GUI, coˇz je v tomto pˇr´ıpadˇe poˇzadavkem. Vytvoˇr´ı se objekt mock, kter´ y je instanc´ı tˇr´ıdy DialogGeteBayOfficialTimeCallMock. Na tomto objektu se zavolá v´ yˇse zm´ınˇen´ a metoda geteBayOfficialTime(), jej´ıˇz návratová hodnota se uloˇz´ı do promˇenné expected. Framework UISpec4J je vyuˇzit k testován´ı v´ yskytu grafick´ ych komponent Swingu. Testuje se, zda se na komponentˇe Panel vyskytuje komponenta TextBox, a komponenta Button s dan´ ym názvem. Komponentˇe TextBox se metodou setText(String) nastav´ı obsah promˇenné expected, coˇz se projev´ı zobrazen´ım z´ıskaného ˇcasu (mock objektu) v dané komponentˇe. Potom se zavolá metoda getText(), kter´ a z´ısk´ a zobrazen´ y ˇcas a uloˇz´ı jej do promˇenné showed. Promˇenné expected a showed porovn´ ame metodou assertEquals(String, String) na rovnost a t´ım se zjist´ı, zda ˇcas, kter´ y byl pˇred´ an komponentˇe TextBox se zobrazil správnˇe. 2

Knihovna Swing poskytuje aplikaˇcn´ı rozhran´ı pro tvorbu a obsluhu klasického grafického uˇzivatelského rozhran´ı na platformˇe Java.

´ TESTOVAN ´ Í TESTERY 5.3. PRAKTICKE

27

public void testGeteBayOfficialTime() throws Exception { Frame frame = new Frame(); DialogGeteBayOfficialTime dE = new DialogGeteBayOfficialTime(frame, null, true); DialogGeteBayOfficialTimeCallMock mock = new DialogGeteBayOfficialTimeCallMock(); String expected = mock.geteBayOfficialTime().toString(); Panel p = new Panel(dE); TextBox t = p.getInputTextBox(); t.setText(expected); Button b = p.getButton("GeteBayOfficialTime"); String showed = t.getText(); assertEquals(showed, expected); }

5.3

Praktick´ e testov´ an´ı testery

Za nejd˚ uleˇzitˇejˇs´ı povaˇzuji praktické otestován´ı aplikace v reálném provozu. Proto jsem sv˚ uj program uvolnil k veˇrejnému testovan´ı. S c´ılem z´ıskat co nejv´ıce relevantn´ıch dat a informac´ı, vytvoˇril jsem dotazn´ık, v nˇemˇz bylo poloˇzeno následuj´ıc´ıch osm otázek: 1 Je instalaˇcn´ı a uˇzivatelsk´ y manuál srozumiteln´ y? 2 Podaˇrilo se V´ am bez problém˚ u spustit program? 3 Pˇrihl´ asili jste se bez problému pˇres program na eBay? 4 Je grafické uˇzivatelské prostˇred´ı pˇrehledné a srozumitelné? 5 Funguje program spr´ avnˇe? Pokud ne, co je ˇspatnˇe? 6 Nastal nˇejak´ y problém bˇehem testován´ı? Pád“ programu, zaseknut´ı“ apod.? ” ” 7 Pˇrihodil program fin´ aln´ı ˇca´stku ve správn´ y ˇcas? 8 Nezatˇeˇzovala aplikace pˇr´ıliˇs poˇc´ıtaˇc? V implementaci programu je pouˇzita vlastn´ı konfigurace pluginu Apache Log4J, kter´ y slouˇz´ı k v´ ypisu chybov´ ych (i jin´ ych) hláˇsen´ı do souboru log4j.log. Vyˇzádal jsem si proto tento soubor spolu s vyplnˇen´ ym dotazn´ıkem od jednotliv´ ych tester˚ u, abych mohl pˇresnˇe identifikovat a opravit chyby.


28

5.3.1

V´ ysledky testov´ an´ı

V´ ysledky jsem zpracoval do pˇrehledného grafu:

Obr´ azek 5.1: Graf v´ ysledk˚ u dotazn´ıku

U otázek 5 a 6 se vyskytly n´ asleduj´ıc´ı slovn´ı odpovˇedi (uvedu jen nˇekolik, protoˇze se opakovaly): Program vykon´ av´ a nˇeco“ na pozad´ı a uˇzivatel nen´ı upozornˇen. Po stisknut´ı ” tlaˇc´ıtka nastáv´ a dlouh´ a prodleva, neˇz se objev´ı v´ ysledek. Dlouhé ˇcekán´ı na dokonˇcen´ı operace. Nˇekteré labely nejsou celé korektnˇe zobrazeny. Upravit velikost textbox˚ u na vkládán´ı u ´daj˚ u. Pouze anglick´ y jazyk. Chyb´ı varovn´ y dialog pˇri uzav´ıran´ı celé aplikace. Jak ukazuj´ı v´ ysledky, jedn´ım z nedostatk˚ u je informován´ı uˇzivatele, ˇze prob´ıhá nˇejaká v´ ypoˇcetn´ı ˇcinnost a ˇze by mˇel b´ yt trpˇeliv´ y. Z detailnˇejˇs´ıch dotaz˚ u jsem se dozvˇedˇel, ˇze nˇekteˇr´ı testeˇri byli ochotni chv´ıli ˇcekat a n´ aslednˇe okno zavˇreli, ponˇevadˇz si mysleli, ˇze nastala bl´ıˇze nespecifikovan´ a chyba. Tento nedostatek jsem pruˇznˇe opravil, viz 5.3.2. Dalˇs´ım z nedostatk˚ u, které vyplynuly z dotazn´ıku, je pouze anglická lokalizace programu. Neuvˇedomil jsem si, ˇze nˇekteˇr´ı uˇzivatelé maj´ı minim´ aln´ı nebo zcela ˇzádn´ y základ znalost´ı anglického jazyka. Op´ıral jsem se o skuteˇcnost, ˇze znalost anglického jazyka je vˇseobecnˇe povaˇzována za standart. ˇ sen´ı je nasnadˇe - vytvoˇrit resource bundle[16] pro m˚ To byla chyba! Reˇ uj program 5.3.3. Drobné nedostatky jako chybˇej´ıc´ı varovn´ y dialog pˇri uzav´ıran´ı celé aplikace byly odstranˇeny a nebudou v této kapitole pops´ any.

5.3.2

ˇ Cekac´ ı dialogov´ e okno

Vytvoˇril jsem nové dialogové okno, viz Obrázek 5.2, které se objev´ı pokaˇzdé, kdy je nutné ˇcekat na dokonˇcen´ı zpracov´ an´ı poˇzadavk˚ u uˇzivatele. Toto okno nelze násilnˇe zavˇr´ıt. T´ım je zaruˇceno, ˇze uˇzivatel neukonˇc´ı pr´ avˇe prob´ıhaj´ıc´ı ˇcinnost a vˇedomˇe se doˇcká k´ yˇzeného v´ ysledku. V kódu se to potom projevilo vytvoˇren´ım nové tˇr´ıdy pojmenované Waiter.java. V kaˇzdé tˇr´ıdˇe, kde doch´ az´ı ke komunikaci s internetov´ ym serverem eBay a t´ım pádem k delˇs´ım ˇcasov´ ym prodlev´ am pˇri zobrazen´ı v´ ysledk˚ u, bylo nutné pˇridat tyto ˇrádky kódu:

´ TESTOVAN ´ Í TESTERY 5.3. PRAKTICKE

29

Obr´ azek 5.2: Informaˇcn´ı dialogové okno

void btnGetItem_actionPerformed(ActionEvent e) { JDialog dialog = new Waiter(DialogGetItem.this); Doer doer = new Doer(dialog); new Thread(doer).start(); dialog.setVisible(true); } private class Doer implements Runnable { private JDialog waiter; public Doer(JDialog waiter) { this.waiter = waiter; } public void run() { . . Vytvoˇren´ı podtˇr´ıdy v kaˇzdé takové tˇr´ıdˇe mi umoˇznilo elegantnˇe oddˇelit grafickou ˇc´ ast kódu a bussiness logiku, tak jak je to v aplikac´ıch vhodné a u ´ˇcelné. Podtˇr´ıda se spouˇst´ı v novém vl´ aknˇe paralelnˇe se zobrazen´ ym ˇcekac´ım“ dialogem. ”

5.3.3

Resource bundle

Spr´ avnˇe napsan´ a aplikace by nemˇela obsahovat texty pˇr´ımo v kódu. Proto je pouˇzita tˇr´ıda Messages.java, kter´ a se stará o lokalizaci podle tˇr´ıdy ResourceBundle, konkrétnˇe metody getBundle(BUNDLE NAME). public class Messages { private static final String BUNDLE_NAME = "ebay.messages"; private static final ResourceBundle RESOURCE_BUNDLE = ResourceBundle .getBundle(BUNDLE_NAME);


30

private Messages() { } public static String getString(String key) { try { return RESOURCE_BUNDLE.getString(key); } catch (MissingResourceException e) { return ’!’ + key + ’!’; } } } V kódu se pak odkazuje na texty jen pomoc´ı kl´ıˇc˚ u, a konkrétn´ı text se dohledává podle specifikovaného Locale. Defaultn´ı Locale je nastaven na anglick´ y jazyk. V souboru messages.properties jsou uloˇzeny vˇsechny kl´ıˇce, které jsou pojmenovány podle tˇr´ıd, v nichˇz se vyskytuj´ı, a hodnoty. AboutBox.2=Copyright (c) 2010 AboutBox.3=based on eBay SDK DialogSnipe.1=ItemID: DialogSnipe.10=Current Price: DialogSnipe.11=Buy It Now Price: . . Souˇcást´ı programu je pouze anglick´ y jazyk. Rozˇs´ıˇren´ı o dalˇs´ı lokalizace je primitivn´ı záleˇzitost´ı, kdy staˇc´ı vytvoˇrit nov´ y soubor podle souboru messages.properties a pouze pˇrepsat hodnoty kl´ıˇc˚ u do ˇz´ adaného jazyku.

5.4

Funkˇ cnost programu

Program pracuje bez omezen´ı v Sandbox verzi eBay. Aby byl plnˇe funkˇcn´ı3 i v produkˇcn´ı verzi eBay, mus´ıte administr´ atora eBay poˇzádat emailem o povolen´ı aplikaci pouˇz´ıvat, coˇz je podm´ınˇeno seps´ an´ım smlouvy a dalˇs´ıch náleˇzitost´ı. Kaˇzdopádnˇe se mus´ıte stát partnerem eBay. Jinak se pˇri pˇrihozen´ı (ostatn´ı funkce programu nejsou omezeny) zobraz´ı dialogové okno s chybou This call, or certain logic flows within the call, are restricted to specific applications. Tato problematika je ˇreˇsena i na oficiáln´ım fóru eBay, a proto uvád´ım odkaz[8], kde se doˇctete v´ıce, pˇr´ıpadnˇe pˇr´ımo zde[15], kde jsou popsány detaily a podm´ınky.

5.5

Zhodnocen´ı testov´ an´ı

Testován´ı mi pomohlo odhalit chyby, ˇci drobné nedostatky, které jsem v pr˚ ubˇehu v´ yvoje postupnˇe odstranil a umoˇznilo mi lépe pochopit sv˚ uj vlastn´ı kód. Souˇcasnˇe pˇrispˇelo k lepˇs´ımu návrhu aplikace ˇci pˇr´ıpadnému refaktorován´ı jiˇz implementovaného zdrojového kódu. 3

T´ım m´ am na mysli, aby fungovalo pˇrihozen´ı.

Kapitola 6

Z´ avˇ er Implementov´ an´ım programu jsem splnil poˇzadavky na jednoduch´ y pˇrihazovac´ı program na eBay. Jelikoˇz jsem pouˇzil eBay API, bylo moˇzné rozˇs´ıˇrit funkˇcnost programu nad rámec zadán´ı o vyhled´ av´ an´ı poloˇzek na eBay, zobrazen´ı a smazán´ı zpráv uˇzivatele, zjiˇstˇen´ı informac´ı o uˇzivateli a dalˇs´ı. Implementoval jsem rovnˇeˇz grafické uˇzivatelské prostˇred´ı. K automatickému ukl´ ad´ an´ı a naˇc´ıt´ an´ı pˇrihlaˇsovac´ıch u ´daj˚ u slouˇz´ı XML soubor, do kterého jsou data z d˚ uvodu bezpeˇcnosti ˇsifrov´ ana. Vˇsechny funkce jsou pokryty jednotkov´ ymi testy a grafické uˇzivatelské prostˇred´ı je otestov´ ano s pomoc´ı frameworku UISpec4J. Za v´ yhodu povaˇzuji, ˇze je aplikace implementov´ ana na základˇe eBay API, tud´ıˇz pˇri vydán´ı nové verze nen´ı nutné modifikovat k´ od. T´ım je program pˇrizp˚ usoben zmˇenám eBay. Jako moˇzné pokraˇcov´ an´ı pr´ ace bych doporuˇcil rozˇs´ıˇrit funkˇcnost programu smˇerem od ” uˇzivatele k eBay“. T´ım m´ am na mysli implementaci napˇr. vytvoˇren´ı nové aukce, registrov´ an´ı na eBay, pˇrid´ an´ı koment´ aˇr˚ u nebo obrázk˚ u k aukci apod. eBay API vˇsechny zm´ınˇené funkce podporuje a pˇr´ımo se nab´ız´ı této podpory vyuˇz´ıt a implementovat kompletn´ı program pro správu aukc´ı na eBay. Vzhledem k tomu, ˇze m´ ym u ´kolem bylo naprogramovat pˇrihazovac´ı program, tak jsem data o aukc´ıch potˇreboval pouze z´ıskávat, a proto jsem se rozhodl implementovat dalˇs´ı funkce programu pouze smˇerem z eBay k uˇzivateli“. Pomoc´ı resource bundlu ” lze lokalizovat program do v´ıce jazykov´ ych verz´ı tak, jak jsem na tuto skuteˇcnost poukazoval v kapitole testov´ an´ı. D´ ale by bylo vhodné obohatit funkˇcnost programu o uloˇzen´ı monitorovan´ ych aukc´ı pˇred vypnut´ım programu a jejich naˇcten´ı pˇri startu programu.

31

32

´ ER ˇ KAPITOLA 6. ZAV

Literatura [1] eBay Web Services Overview. http://developer.ebay.com/products/overview, stav z 3. 5. 2010. [2] Online aplikace pro nakupován´ı pˇres eBay. http://www.auctionsniper.com, stav z 5. 3. 2010, http://www.esnipe.com, stav z 5. 3. 2010, http://www.bidnapper.com, stav z 5. 3. 2010. [3] Informace o nakupov´ an´ı na eBay. http://www.ebayaukce.cz, stav ze 5. 3. 2010. [4] eBay: Mezin´ arodn´ı obchodn´ı portál. http://www.eim.ebay.cz, stav z 2. 4. 2010. [5] eBay Developer Program homepage. http://developer.ebay.com, stav z 5. 3. 2010. [6] Ofici´ aln´ı str´ anky eBay. http://www.ebay.com, stav z 5. 3. 2010. [7] Rozˇs´ıˇren´ı do Mozilly Firefoxu. https://addons.mozilla.org/en-US/firefox/addon/5202, stav z 5. 3. 2010, https://addons.mozilla.org/en-US/firefox/addon/5571, stav z 5. 3. 2010. [8] eBay Developers Forum. http://dev-forums.ebay.com/thread.jspa?threadID=500005636&messageID= 500017584, stav z 11. 6. 2008. [9] UISpec4J: Java/Swing GUI testing. http://www.uispec4j.org, stav z 20. 5. 2010. [10] JBidwatcher: eBay sniping, bidding & monitoring software. http://www.jbidwatcher.com, stav z 20. 6. 2009. [11] Oracle Sun Developer Network (SDN). http://java.sun.com/javase/downloads/index.jsp, stav z 5. 3. 2010. ´ [12] Uvod do JSON. http://www.json.org, stav z 3. 5. 2010.

33

34

LITERATURA

[13] Oficiáln´ı str´ anky Paypalu, MoneyBookers a BidPay. https://www.paypal.com/cz, stav z 1. 5. 2009, http://www.moneybookers.com/app/index.pl?l=CZ, stav z 1. 5. 2009, http://www.authorize.net/bidpay, stav z 1. 5. 2009. [14] PlaceOffer - referenˇcn´ı pˇr´ıruˇcka. http://developer.ebay.com/devzone/xml/docs/reference/ebay/PlaceOffer. html, stav z 20. 5. 2010. [15] PlaceOffer Best Practices. http://developer.ebay.com/DevZone/XML/docs/WebHelp/wwhelp/wwhimplcommon/ html/wwhelp.htm?context=eBay_XML_API&file=PlaceOfferCall-PlaceOffer_ Best_Practices.html, stav z 20. 5. 2010. [16] Java Internationalization: Localization with ResourceBundles. http://java.sun.com/developer/technicalArticles/Intl/ResourceBundles, stav z 20. 5. 2010. [17] REST: architektura pro webové API. http://zdrojak.root.cz/clanky/rest-architektura-pro-webove-api, 3. 5. 2010.

stav

[18] ITBiz Sniffing: Odposlech datové komunikace. http://www.itbiz.cz/sniffing-odposlech-datove-komunikace, stav z 6. 3. 2009. [19] W3C: SOAP. http://www.w3.org/TR/soap, stav z 3. 5. 2010. [20] API Test Tool. https://developer.ebay.com/DevZone/build-test/test-tool/Default.aspx, stav z 20. 5. 2010.

z

Pˇ r´ıloha A

Seznam pouˇ zit´ ych zkratek API Application Programming Interface ASCII American Standard Code for Information Interchange CAPTCHA Completely Automated Public Turing test to tell Computers and Humans Apart CD Compact Disc DOM Document Object Model eIM eBay International Market GUI Graphical User Interface HTML HyperText Markup Language HTTP Hypertext Transfer Protocol HTTPS Hypertext Transfer Protocol ID Identification IDE Integrated Development Environment IP Internet Protocol JDK Java Development Kit JRE Java Runtime Environment JSON JavaScript Object Notation PHP Hypertext Preprocessor REST Representational State Transfer SAX Simple API for XML

35

36

SDK Software Development Kit SOAP Simple Object Access Protocol URL Uniform Resource Locator XML Extensible Markup Language .. .

ˇ ÍLOHA A. SEZNAM POUZIT ˇ YCH ´ PR ZKRATEK

Pˇ r´ıloha B

Instalaˇ cn´ı a uˇ zivatelsk´ a pˇ r´ıruˇ cka Poˇ zadavky programu na hardware a software Program ke svému bˇehu vyˇzaduje JRE[11], k v´ yvoji JDK[11] ve verzi 1.6 update 3 nebo vyˇsˇs´ı. Cel´ y program pracuje jako celek a autentizuje se v˚ uˇci eBay Trading Web Services. Tud´ıˇz je zapotˇreb´ı m´ıt registrovan´ y u ´ˇcet na eBay, ale také v eBay Developers Programu, ´ cet v eBay Developers Programu poskytuje Develjejichˇz u ´ˇcty jsou vz´ ajemnˇe propojeny. Uˇ operID, ApplicationID, CetrificateID a eBay token, jenˇz jsou pˇri prvn´ım pˇripojen´ı ovˇeˇrov´ any. Tyto u ´daje lze také plnˇe vyuˇz´ıt pro pˇripojen´ı do testovac´ıho prostˇred´ı eBay Developers Program Sandbox, kde je moˇzné virtuálnˇe spravovat sv˚ uj mini“ eBay t´ım, ˇze registrujete fiktivn´ı ” prodávaj´ıc´ı a nakupuj´ıc´ı. Dalˇs´ım poˇzadavkem je rozliˇsen´ı obrazovky - doporuˇcuji alespoˇ n 1024 x 768 - i kdyˇz program umoˇzn ˇuje zmˇenu velikosti oken. Program nen´ı nijak nároˇcn´ y na hardware. Postaˇc´ı bˇeˇzn´ y stoln´ı poˇc´ıtaˇc ˇci notebook. Aplikace vytváˇr´ı jen minimum nov´ ych soubor˚ u (pouze logy do souboru), proto nejsou velké nároky na pamˇet’ov´ y prostor na pevném disku - postaˇc´ı 20MB volného m´ısta. Nutnost´ı je stálé internetové pˇripojen´ı.

Prvn´ı spuˇ stˇ en´ı programu Nejdˇr´ıve je nutné m´ıt nainstalované JDK a JRE. Na pˇriloˇzeném CD v adresáˇri /data/java/ naleznete instalaˇcn´ı soubory pro operaˇcn´ı systémy Linux a Windows v 32 i 64 bitov´ ych verz´ıch. Pokud potˇrebujete st´ ahnout jinou verzi JDK ˇci JRE nebo zjistit v´ıce informac´ı o instalaci, naleznete ji ke staˇzen´ı zde[11]. V dobˇe psan´ı tohoto dokumentu byla aktuáln´ı verze 1.6 u20. V tomtéˇz adres´ aˇri se vyskytuj´ı i licence, s kter´ ymi mus´ıte souhlasit, abyste mohli JDK a JRE pouˇz´ıvat. V adres´ aˇri /data/jar program/ naleznete spustiteln´ y jar archiv s programem - Ebay.jar, soubor Config.xml, kter´ y obsahuje pˇrihlaˇsovac´ı u ´daje - URL k eBay. Pokud se tento soubor v adres´ aˇri nevyskytne nebo je jeho obsah nesprávn´ y, objev´ı se pˇri spuˇstˇen´ı varovné dialogové okno. Funkˇcnost programu vˇsak nijak neomez´ı. Dále se v adresáˇri vyskytuje soubor log4j.config, kter´ y slouˇz´ı k v´ ypis˚ um dat do souboru a taktéˇz nen´ı jeho existence nutná. Po nainstalov´ an´ı prostˇred´ı Javy by mˇelo b´ yt moˇzné program spustit podobnˇe jako bˇeˇzn´ y .exe soubor, tedy dvojit´ ym kliknut´ım levého tlaˇc´ıtka myˇsi. Nebo je moˇzné program spustit v

37

38

ˇ ÍLOHA B. INSTALACN ˇ Í A UZIVATELSK ˇ ´ PR ˇ ÍRUCKA ˇ PR A

terminálu pˇr´ıkazem: java -jar /cesta k souboru/Ebay.jar. Pokud vˇse probˇehlo bez chyb, mˇelo by se Vám zobrazit n´ asleduj´ıc´ı okno, viz Obrázek B.1.

Obr´ azek B.1: Hlavn´ı okno pˇrihazovac´ıho programu Kliknut´ım na tlaˇc´ıtko Config Account se Vám zobraz´ı okno s nastaven´ım pˇrihlaˇsovac´ıch u ´daj˚ u, viz Obr´ azek B.2. Nastavte pˇrihlaˇsovac´ı u ´daje dle bodu Moˇznosti nastaven´ı pˇripojen´ı 38. Program V´ as na to upozorn´ı v pˇr´ıpadˇe, ˇze budete cht´ıt vyvolat nˇejakou funkci z nab´ıdky a nebudete je m´ıt nastavené. Abyste nemuseli pˇri kaˇzdém spuˇstˇen´ı programu zadávat znova a znova veˇskeré pˇrihlaˇsovac´ı u ´daje, m˚ uˇzete tyto u ´daje uloˇzit do XML souboru a to vyvolán´ım nab´ıdky File - Save Account (Obr´ azek B.3). Pˇrihlaˇsovac´ı u ´daje se zapisuj´ı do souboru ˇsifrované, proto nen´ı vhodné vytv´ aˇret tento XML soubor ruˇcnˇe“. Pˇri dalˇs´ım pˇrihláˇsen´ı staˇc´ı ” jen vyvolat nab´ıdku File - Load Account (Obrázek B.3) a veˇskeré u ´daje z Vámi vybraného souboru se rozˇsifruj´ı a zap´ıˇs´ı do programu.

Moˇ znosti nastaven´ı pˇ ripojen´ı Program umoˇzn ˇuje se pˇripojit do produkˇcn´ı verze eBay a testovac´ı eBay Sandbox. Podle toho se liˇs´ı i pˇrihlaˇsovac´ı u ´daje1 . Pro eBay (produkˇcn´ı verze): 1 Je zˇrejmé, ˇze pˇri zadan´ı pˇrihlaˇsovac´ıch u ´daj˚ u pro produkˇcn´ı verzi eBay bude program pracovat pouze s poloˇzkami v produkˇcn´ı verzi eBay, nikoliv vˇsak s poloˇzkami v sandbox verzi. To samé intuitivnˇe plat´ı pˇri zad´ an´ı pˇrihlaˇsovac´ıch u ´daj˚ u pro sandbox verzi eBay.

39

Obr´ azek B.2: Okno zobrazuj´ıc´ı pˇrihlaˇsovac´ı u ´daje do eBay

• DeveloperID: vaˇse DevID • ApplicationID: vaˇse AppID • Certificate: vaˇse CertID • Token: v´ aˇs User token • EPS Server URL: https://api.ebay.com/ws/api.dll • API Server URL: https://api.ebay.com/wsapi • Sign-In URL: https://signin.ebay.com/ws/eBayISAPI.dll?SignIn Pro eBay Sandbox (sandbox verze): • DeveloperID: vaˇse DevID • ApplicationID: vaˇse AppID • Certificate: vaˇse CertID


40

Obr´ azek B.3: Okno zobrazuj´ıc´ı uloˇzen´ı nebo naˇcten´ı souboru

• Token: v´ aˇs User token • EPS Server URL: https://api.sandbox.ebay.com/ws/api.dll • API Server URL: https://api.sandbox.ebay.com/wsapi • Sign-In URL: https://signin.sandbox.ebay.com/ws/eBayISAPI.dll?SignIn Po vyplnˇen´ı pˇrihlaˇsovac´ıch u ´daj˚ u uˇz m˚ uˇzete, kliknut´ım na pˇr´ısluˇsné tlaˇc´ıtko z nab´ıdky, vyvolat jednotlivé funkce, jenˇz z´ısk´ avaj´ı informace z eBay. Ve vˇetˇsinˇe pˇr´ıpad˚ u je nutné zadat nejdˇr´ıve nˇejakou hodnotu jako napˇr. item ID, text pro vyhledáván´ı apod2 . Pokud se tak nestane, objev´ı se dialogové okno s varován´ım. Ovládán´ı je jinak jednoduché a veskrze intuitivn´ı. Pro ukonˇcen´ı aplikace kliknˇete na kˇr´ıˇzek nebo v menu File - Exit.

Popis funkce Snipe Jak bylo zm´ınˇeno v´ yˇse, je nejdˇr´ıve nutné zadat item ID k dané poloˇzce na eBay (Obrázek B.4). Poté program chv´ıli pracuje - zobraz´ı informativn´ı okno, které zámˇernˇe nelze zavˇr´ıt poté zobraz´ı z´ıskané u ´daje o poloˇzce. Podle zadaného item ID aplikace zjist´ı, jakého typu je daná aukce a podle toho V´ am zpˇr´ıstupn´ı dalˇs´ı moˇznosti resp. tlaˇc´ıtka3 , co lze s danou 2

Pro n´ azornost detailnˇe pop´ıˇsi n´ıˇze funkci Snipe N´ azvy tlaˇc´ıtek koresponduj´ı s n´ azvy typ˚ u aukc´ı v anglické verzi eBay, tedy Buy It Now, Best Offer a pro Chinese aukci je to tlaˇc´ıtko Snipe. 3

41

Obr´ azek B.4: Okno zobrazuj´ıc´ı pˇrihazovac´ı menu

aukc´ı provést a nastav´ı také omezen´ı na fináln´ı cenu a kvantitu. Tedy pro Snipe mus´ı b´ yt nastavena v´ yˇse fin´ aln´ı ˇc´ astky vˇetˇs´ı, neˇz je ta souˇcasná, pro Buy It Now mus´ı b´ yt nastaven´ a pˇresnˇe Buy It Now Price ˇc´ astka zjiˇstˇená pro danou poloˇzku a v Best Offer je na Vás, jakou ˇcástku nab´ıdnete. Kvantita mus´ı b´ yt vˇzdy menˇs´ı nebo rovna kvantitˇe daného zboˇz´ı na eBay. Tlaˇc´ıtkem Get IP se program pokus´ı z´ıskat Vaˇsi IP adresu, pokud se mu to nepodaˇr´ı, je nutné, abyste ji zadali ruˇcnˇe. Pokud jste vˇse nastavili spr´ avnˇe, aplikace danou poloˇzku koup´ı za fixn´ı cenu, vytvoˇr´ı nejlepˇs´ı nab´ıdku a nebo pˇrid´ a poloˇzku do seznamu monitorovan´ ych poloˇzek, coˇz se projev´ı zobrazen´ım nového okna (Obr´ azek B.5). V tomto oknˇe lze ono monitorován´ı sledovat, pˇr´ıpadnˇe pokud se rozhodnete poloˇzku ze seznamu odebrat, oznaˇcte ji a stisknˇete klávesu delete. Pokud byste chtˇeli zmˇenit fin´ aln´ı cenu pˇrihozen´ı nebo poˇcet kus˚ u daného zboˇz´ı ke koupi, mus´ıte tuto poloˇzku ze seznamu smazat a poté znova pˇridat jej´ı nové monitorován´ı. Chtˇel bych upozor-


42

nit na to, ˇze vˇsechna okna v celé aplikaci m˚ uˇzete bez problém˚ u zavˇr´ıt, aniˇz byste zruˇsili prob´ıhaj´ıc´ı monitorov´ an´ı poloˇzek. Aˇz ukonˇcen´ım programu, tedy hlavn´ıho okna, pˇrijdete o vˇsechny monitorované aukce, na coˇz budete upozornˇeni dialogov´ ym oknem. Proto program jako takov´ y mus´ı bˇeˇzet! Pokud byste chtˇeli jen zobrazit okno s právˇe prob´ıhaj´ıc´ım monitorován´ım, vyvolejte z nab´ıdky v hlavn´ım menu ViewSniffedItems. Pokud dojde k doˇcasné ztrátˇe internetového spojen´ı, program ˇceká, dokud nen´ı spojen´ı opˇet navázáno.

Obr´ azek B.5: Okno zobrazuj´ıc´ı tabulku monitorovan´ ych poloˇzek

D˚ uleˇ zit´ e upozornˇ en´ı: Program funguje bez omezen´ı v sandbox verzi eBay. Aby byl plnˇe funkˇcn´ı4 i v produkˇcn´ı verzi eBay, mus´ıte administrátora eBay poˇzádat emailem o povolen´ı aplikaci pouˇz´ıvat, coˇz je podm´ınˇeno seps´ an´ım smlouvy a dalˇs´ıch náleˇzitost´ı. Kaˇzdopádnˇe se mus´ıte stát partnerem eBay. Jinak se pˇri pˇrihozen´ı (ostatn´ı funkce programu nejsou omezeny) zobraz´ı dialogové okno s chybou This call, or certain logic flows within the call, are restricted to specific applications. Tato problematika se ˇreˇsila i na oficiáln´ım fóru eBay, a proto uvád´ım odkaz[8], kde se doˇctete v´ıce, pˇr´ıpadnˇe pˇr´ımo zde[15], kde jsou popsány detaily a podm´ınky.

4

T´ım m´ am na mysli, aby fungovalo pˇrihozen´ı.

Pˇ r´ıloha C

Obsah pˇ riloˇ zen´ eho CD

Obr´ azek C.1: Seznam pˇriloˇzeného CD

43

Navrhněte a implementujte automatický přihazovací program pro aukční portál e- bay.com

Recommend Documents