Praktikumitöö:võrgurakendus

Taustaks võid vaadata veidi sarnast ülesannet eelmisest aastast: Praktikumitöö:võrgurakendus 2005

Ülesandeks on teha käsurealt käivitatav rakendus, mis arvutab statistikat ja esitab graafiliselt infot müügisolevate maatükkide kohta. Müügisolevate maatükkide infot (html lehti) tõmbab rakendus ise lehelt http://www.kv.ee/ . Saadud html stringist otsib rakendus automaatselt vajaliku info välja, samuti liigub automaatselt järgmistele lehtedele, kuni kõik lehed on sisse loetud.

Kõige lihtsama urli näitena katseta seda:

http://www.kv.ee/?act=search.simple&deal_type=5&county=2&page_size=100

Kasutajaliides

Kasutajaliides peab koosnema vähemalt järgmistest komponentidest:

• nupupaneel, kus on neli valikuboksi, kolm tekstivälja ja "Otsi!" nupp:
  • Valikuboks: sorteerimine (suurus, hind, ruutmeetri hind)
  • Valikuboks: maakond
  • Valikuboks: otstarve
  • Valikuboks: veekogu
  • Tekstivali: otsisonad
  • Tekstivali: Maks hind
  • Tekstivali: Min hind
• joonistamispaneel, kuhu rakendus kasutaja valitud andmete saamise järel statistikat kirjutab ja illustratiivset infot annab.

Vigade korral kuvatakse veatekst joonistamispaneelile.

Mida tuleb graafiliselt kujutada:

Kõigepealt tuleb leitud kinnisvaratükid sorteerida vastavalt valikuboksile: kas suuruse, hinna või ruutmeetri järgi. Seda võid teha ise või siis panna kokku vastav url, mis kohe selliselt küsib.

Seejärel tuleb saadud loetelu kuvada järjest graafikuna niimoodi, et oleks korraga näha (nö kõrvuti ja paralleelselt) maatüki suurus, hind ja keskmine hind. Igaüks nendest määrab vastava joone koordinaadi.

Olulist urli kokkupaneku kohta

Data lugemiseks peab sinu programm kõigepealt koostama urli, millelt datat lugeda. Selleks peab ta kasutama valikuboksides ja tekstivaljades antut: igaüks määrab ühe cgi-parameetri-paari urlist, näiteks maakonna valik määrab paari county=N kus N on maakonna number http://www.kv.ee/? saidis.

Kuidas leida, mis nimed/vaartused seal saidis kasutusel: tee lihtsalt sait lahti, tee ise sealt otsinguid/valikuid ja vaata, mis urli ta kokku paneb. Samuti saad vaadata otse selle saidi html sourcest, et mis on valikuboksi/valja nimi, voi mis on valikutele vastavad vaartused.

Kuidas liikuda automaatselt järgmistele lehtedele? Kaks varianti, üks põnev, teine triviaalne teha:

• Põnev variant: otsi html sourcest teksti next, siis tead, et järgmine leht on olemas, ja suurenda vastavat cgi parameetrit urlis
• Triviaalne variant: pane urli mitte page_size=100 vaid page_size=10000, siis tulevad kõik maatükid korraga ühel lehel välja.

Kuidas graafik võiks välja näha

Iga graafik peaks olema joon, soovitavalt iga joon kolmest eri värvi. Kindlasti tee koordinaatide rehkendus nii, et jooned mahuks ekraanile ära ja ei jääks liiga väikeseks (ideaalis jookseks maks punkt joonistamisruumi ääreni).

Soovitusi

Alustamiseks

Alustamiseks võid kasutada seda näiterakendust, mida loengus oleme arendanud: guiexample.java.

NB! guiexample.java kasutamise korral on mõttekas panna buttonpanel akna alläärde (SOUTH), muidu peab hakkama lahendama küsimust comboboxi kuvamisest Canvas'e peale.

Mõttekas on lugeda läbi ka Ecki õpiku GUI-komponentide peatükk http://math.hws.edu/javanotes/c7/s3.html ja selle jätk http://math.hws.edu/javanotes/c7/s4.html.

Põhjaliku comboboxide kasutusjuhendi leiad siit: http://java.sun.com/docs/books/tutorial/uiswing/components/combobox.html Muuhulgas soovitab juhend sellist struktuuri:

public class ComboBoxDemo ... implements ActionListener {
    . . .
        petList.addActionListener(this) {
    . . .
    public void actionPerformed(ActionEvent e) {
        JComboBox cb = (JComboBox)e.getSource();
        String petName = (String)cb.getSelectedItem();
        updateLabel(petName);
    }
    . . .
}

kus ComboBoxDemo rolli sobiks meie juhul guiexampleFrame klass, mille sees olev keeruline nupu külge pandav addActionListener

  button.addActionListener(new ActionListener() { ....
  });

tuleks asendada lihtsamaga:

  button.addActionListener(this);

Samuti soovitan teha guiexampleFrame ümber nii, et comboboxid oleks guiexampleFrame klassis (kus on ka äsjakirjeldatud handler nupule) klassi jaoks globaalsed muutujad. Hoiatus äsjatoodud ComboBoxDemo jaoks: see näide eeldab, et ActionEvent e tuleb comboboxi muutmisest, meie juhul tuleb ta aga hoopis nupust. Seega (JComboBox)e.getSource() ei ole meie jaoks mõttekas, pigem tuleb lihtsalt lugeda comboboxide kui guiexampleFrame jaoks globaalsete muutujate väärtust.

Lähiajal tuleb siis veidi lisa-näpunäiteid, vastavalt loengus toimunud etteprogrammeerimisele.

Võrgust lugemine

Kõigepealt soovitan teha eraldi katse selle http://java.sun.com/docs/books/tutorial/networking/urls/readingURL.html näiteprogrammiga.

Kui ta ei suuda võrgust lugeda, siis on tõenäoline põhjus selles, et Sinu arvuti ei saa otse internetti ühendust, vaid peab töötama läbi nn proxy.

NB! On võimalik (kuid mitte kindel: proovi järgi!) et kõik AK arvutiklasside arvutid peavad töötama läbi proxy. Siis viidatud näiteprogramm arvutiklassides võrgust lugeda otse ei suuda. Loe TTÜ AK proxy kohta: mida TTÜ AK arvutiklassides töötades vaja teha, KUI proxy osutub vajalikuks.

Tõenäoliselt aga Sinu koduarvutis või kusagil mujal arvutis sellist piirangut ei ole ja näiteprogramm suudab otse võrgust lugeda.

Kui sa ülaltoodud näiteprogrammi järgi url-i avamise ja sealt lugemise oma programmi sisse paned, siis tuleb nende operatsioonide ümber tingimata panna try { ... } catch (..) { ... }, täpselt nagu failioperatsioonidegi ümber.

Kuidas www.kv.ee html-lehelt vajalikku infot saada?

Vaata kõigepealt lehe source ja uuri, mille järgi vastav info leida.

Üks variant selline:

• otsi tekstilõiku ....

• leitud lõigust otsi lõiku ....

• seejärel loe sisse arv, mis tuleb kohe selle lõigu ....

Sama põhimõtte järel õnnestub leida teistegi parameetrite info. Pane oma programmi sisse iga boksist valitava parameetri jaoks sobiv meetod: kas siis eraldi koodijupp, vastavalt otsitavad tekstid massiivis vms. Kõige lihtsam on tõenäoliselt teha iga parameetri jaoks eraldi koodijupp.

Kasulikke tutoriale (lisaks Ecki raamatule)

• Sun-i tutorial võrgu kasutamiseks
• Sun-i tutorial GUI tegemiseks Swing teegi abil, sh ülalviidatud comboboxide kasutusjuhend: http://java.sun.com/docs/books/tutorial/uiswing/components/combobox.html