ITI0011:Säuts draft

Allikas: Kursused
Mine navigeerimisribale Mine otsikasti

Põhiosa

Säuts

Põhiosa: käsurealt juhtimine

Programm peab olema juhitav käsurealt, näiteks 

 java Twitter Tallinn -count 50 -sort date desc -search tere

Minimaalne käivitamine toimub näiteks selliselt: 

 java Twitter Tallinn

kus

  • java on java programm ise, mis hakkab teie programmi jooksutama.
  • Twitter on klassi nimi, mida käivitatakse
  • Tallinn on asukoht, mida otsitakse.

Seega sellise käivitamise puhul antakse teie programmi ette üks argument: "Tallinn"

Kui programm pannakse käima ilma argumentideta, tuleb kasutajale kuvada juhised, kuidas programmi käima panna.

Argumendid, mida programm peab ära tundma:

  • -help (põhiosa) - kuvab kasutajale juhise, kuidas programmi käima panna. Peale juhiste kuvamist pannakse programm kinni, väljumiskood (exit code) peaks olema 1. Samad juhised näidatakse (ja sama väljumiskood tagastatakse) siis, kui:
    • programm pannakse ilma argumentideta käima või
    • sisestatud argumendid on valed
  • -count num (põhiosa) - määrab ära, mitu säutsu välja näidatakse. Kui see puudub, siis peab programmis olema määratud vaikimisi päritav säutsude kogus 15.
  • -sort field [asc|desc] (lisaosa) - määrab ära, kuidas säutsud järjestatakse väljaprintimiseks. Väli võib olla kas: author, date või tweet. Valikuliselt võib kaasa panna kas asc või desc. Esimesel juhul toimub järjestamine kasvavalt, teisel juhul kahanevalt. Kui pole määratud, siis vaikimisi järjestatakse kasvavalt. Vaata ka vastavat lisaosa kirjeldust. Näide: -sort author asc ja -sort author annavad sama tulemuse.
  • -search keyword (lisaosa) - kuvatakse vaid säutsud, milles esineb etteantud otsisõna.
  • ...

Argumendid võivad tulla suvalises järjekorras. Ehk siis kaks järgnevat käivitamist peaks andma sama tulemuse: 


 java Twitter Tallinn -count 50 -sort date desc -search tere

 java Twitter Tallinn -search tere -sort date desc -count 50

Lisaosa: Kohanimede puhverdamine faili (2p)

Kuna linnade/asukohtade koordinaadid ei ole ajas muutuvad, siis ei ole mõtet igal korral, kui kasutaja otsib "Tallinna" kohta säutse, uut koordinaatide päringut teha. Tulemus on väga suure tõenäosusega täpselt sama, mis eelmisel korral. Seoses sellega oleks mõistlik salvestada tulemused kuskile puhvrisse (faili) ning neid hiljem sealt lugeda.

Selle lisaosa funktsionaalsus on:

  • asukoha koordinaatide päringu tulemused salvestatakse faili, et järgmisel korral ei peaks neid uuesti küsima (kohalik cache)
  • nimetatud faili saab lisada alternatiivseid kohanimesid (näiteks "kodu", "TTÜ" jne)

Puhverdamiseks kasuta vaikimisi faili "kohad.csv", mis peab olema sinu programmile kättesaadav (soovitavalt paikneb samas kataloogis käivitatava klassiga) ja peab koosnema CSV kujul ridadest: 

   ametlik_nimi,latitude,longitude,raadius_km,alternatiivnenimi_1,..,alternatiivnenimi_N

või ridadest, kus koordinaadid ja raadius on puudu: 

   ametlik_nimi,,,,alternatiivnenimi_1,...,alternatiivnenimi_N

kus

  • ametlik_nimi on kohanimi, mida otsitakse API-st (näiteks tallinn)
  • alternatiivnimi_1, ..., alternatiivnimi_N on nimed, mida kasutaja saab sisestada. Näiteks saab kasutaja siin määrata "kodu". Kui vastav päring tehakse, otsitakse tegelikult ametlik_nimi asukohta (või kasutatakse juba olemasoelvaid koordinaate ja raadiust, kui need on olemas) (näiteks kodu,elupaik)
  • latitude, longitude ja raadius_km on standardse tähendusega. Need võivad puududa. (näiteks: 59.4,24.5,10)

Sinu programm kasutab puhvrifaili järgmiselt:

  • Enne asukoha API poole pöördumist vaatab programm, kas vastav kohanimi on selles failis olemas
    • Kui jah, ja koordinaadid-raadius on antud, kasutab ta koordinaate ja raadiust Twitteri päringu tegemiseks. Asukoha päringut ei tehta
    • Kui jah, aga koordinaadid on puudu, siis
      • teeb uue asukoha API päringu ametliku kohanime järgi, leiab koordinaadid ja arvutab raadiuse
      • kirjutab saadud koordinaadid ja raadiuse vastava rea juurde. Järgmisel korral sama päringu puhul pole vaja asukoha API-t enam kasutada.
    • Kui ei, siis tehakse uus päring ning puhverdatakse tulemused faili (kirjutatakse uus rida, kus on ametlik_nimi, koordinaadid ja raadius: pärnu,58.3800572,24.5200466,5).

Näited:

1) kohad.csv: 

   tallinn,59.4,24.5,10,kodu,ttü

Kui tehakse otsing "tallinn", siis kasutatakse koordinaate 59.4 ja 24.5, raadius = 10km. Sama juhtub, kui teha päring "ttü", "kodu". kohad.csv fail ei muutu.


2) kohad.csv: 

   pärnu,,,,vanaema,suvila

Kui tehakse otsing "pärnu" või "vanaema" või "suvila", siis otsitakse asukoha API-ga üles "pärnu", loetakse välja koordinaadid ja arvutatakse välja raadius. Tulemuseks on sama rida failis: 

   pärnu,58.3,24.5,5,vanaema,suvila

3) kohad.csv: 

   tallinn,59.4,24.5,10,kodu,ttü

Kui tehakse otsing "pärnu", siis tehakse asukoha otsing "pärnu" ja salvestatakse koordinaadid ja raadius faili. Tulemuseks on fail: 

   tallinn,59.4,24.5,10,kodu,ttü
   pärnu,58.3,24.5,5

4) kohad.csv 

   tallinn,59.4,24.5,10,kodu,pärnu
   pärnu,58.3,24.5,5

Kui tehakse otsing "pärnu", siis kasutatakse infot teiselt realt. Ehk siis ametlik nimi on prioriteetsem kui alternatiivsed nimed. Kui sellist ametlikku nime ei leidu, otsitakse alternatiivsete nimede seast.

Faili sisu ei tohi olla tõstutundlik, ehk siis otsingud jm toimub case-insensitive printsiibil, kus suur- ja väiketäht on võrdsed ("Pärnu", "pärnu" ja "PÄRNU" on kõik samad).

Teie programmis mingeid muid operatsioone ei pea failiga tegema (näiteks kustuta rida või muuda vms). Faili muutmine toimub käsitsi. Samuti ei pea te otseselt tegelema valesti formaaditud failiga. Samas, kui tekib viga andmete lugemisel, ei tohiks see programmi kinni panna. Pigem kui cache'i ei suudega lugeda, siis arvestada olukorraga nagu cache puudub (kõik päringud tehakse veebist).

See lisaosa täielikult realiseerituna annab 2 punkti.


Lisaosa: sortimine ja filtreerimine(otsimine) (1p)

Võimaldab säutse sorteerida vastavalt etteantud väljale. Sorteerida saab järgmiste väljade järgi:

  • autor
  • postituse kuupäev
  • postitus (ehk siis säutsu tekst)

Sorteerida saab nii kasvavas (väiksemad ees, näiteks: a, b, c, ... või 1, 3, 5, ...) kui kahanevas (suuremad ees, näiteks: ü, ö, ä, ... või 9, 8, 4, ...) järjekorras.

Samuti on võimalik anda ette otsisõna. Näidatakse välja vaid neid säutse, kus otsisõna esineb. Vihjeks: teie kasutada olev teek võimaldab otsingut suhteliselt lihtsalt teha.

Selle lisaosa täielik realiseerimine annab 1 punkti.

Lisaosa: interaktiivne juhtimine (1-2p)

Põhiosa nõue oli, et programm oleks juhitav käsurea argumentidega: 

 java Twitter Tallinn -count 50 -sort date desc -search tere

Selle lisaosa eesmärk on luua interaktiivne keskkond, mille kaudu saab programmi juhtida. Põhiosas pandi programm käima ning see lõpetas töö ilma, et oleks kasutajalt mingit sisendit oodanud. Interaktiivne keskkond tähendab seda, et programm ootab kasutajalt sisendit ja täidab etteantud käsud. Peale käsu täitmist ootab programm järgmist käsku jne (nagu command prompt või terminal). Näiteks: 

> setcount 50
> query Tallinn
> print
> query Pärnu 10
> sort date desc
> print
> search tere
> print
> exit

Programm peab tundma järgmisi käske:

  • query location [count] (põhiosa) - tehakse uus päring vastavalt etteantud asukohaga location. Päringuga on võimalik kohe kaasa anda ka tulemuste kogus. Päring ei kuva automaatselt säutse välja (vt. print. Näiteks query Tallinn teeb päringu "Tallinn", säutsude kogus on see, mis viimati programmis määratud või vaikimisi 15. query Pärnu 10 teeb päringu "Pärnu" ja kasutab säutuse kogusena 10. See päring ei muuda mälus hoitavat säutsude kogust (vt setcount)
  • print [count] (põhiosa) - prindib viimase päringu tulemuse välja. print prindib kõik säutsud, mis viimase päringuga on saadud. print 10 prindib viimasest päringust 10 esimest säutsu (sorteeritud tulemuse puhul on oluline, et määratud kogus võetakse algusest järjest). Kui säutse tuli viimase päringuga vähem, siis tuleb kõik tulemused printida.
  • setcount num (põhiosa) - määrab päritavate säutsude arvu. Määratud arv jääb meelde ja kasutatakse kõikide järgmiste päringute korral (kui päringus eraldi kogust ei määrata, vt. query). Näiteks: setcount 30 - edaspidi query päringus küsitakse ja print käsuga kuvatakse vaikimisi 30 säutsu.
  • sort field [asc|desc] (lisaosa) - tulemuste sorteerimine. Käsku rakendatakse viimase päringu kohta. Kui peale sorteerimist tehakse uus päring, siis uue päringu puhul enam seda sama järjestamist rakendama ei pea. Seega selle käsu tulemusel järjestatakse viimane tulemus. Väli (field) võib olla kas author, date või tweet. Lisaks võib juurde määrata järjestamise suuna: asc - kasvav, desc - kahanev. Vt rohkem #Lisaosa: sortimine ja filtreerimine(otsimine) (1p).
  • search keyword (lisaosa) - teostatakse viimane päring uuesti (ehk siis kõik see, mis viimase query käsuga tehti), seekord kasutatakse määratud märksõna keyword. Seega, kui eelnevalt otsiti "Tallinn" ja nüüd tuleb käsk search kevad, tehakse uus päring Tallinna kohta, kus otsisõnaks on "kevad". Kui seejärel käivitatakse käsk search suvi, tehakse uus päring Tallina kohta, seekord otsitakse märksõna "suvi" jne.
  • exit (põhiosa) - väljub programmist.

Eelnevate käskude korrektne realiseerimine annab 1p.

Täiendava punkti saab siis, kui nii käsurealt saadavad argumendid kui ka siin määratud käsud käivitatakse täpselt sama loogikaga. Mõlemast kohast saadud käsud teisendatakse samale kujule ning seejärel need käivitatakse. Programmi jaoks ei ole vahet, kas käsk tuli käsurealt või kasutaja poolt standardsisendist (või failist - pole antud ülesandes vajalik). Kui kunagi on teil soov täiendada programmi sedasi, et rakendust saab juhtida ka näiteks väljaspoolt üle veebi, siis piisab sellest, kui realiseerite selle osa, mis käsud vastu võtab ja tõlgendab nad juba siin mainitud ühtsele kujule. Käskude täitmise osa on teil juba realiseeritud.

Kui nii käsurealt kui interaktiivsest keskkonnast saadud käsud protsessitakse täpselt samamoodi, saab lisaosa eest täiendava 1p (ehk siis kokku 2p).

Lisaosa (keerulisem): trendid (2p)

Lisaosa eesmärk on vastavalt määratud asukohale leida selle piirkonna trendid (ehk siis populaarsed märksõnad, teemad, hastagid). Seejärel kuvatakse välja vaid need säutsud, mis kuuluvad trendide hulka (sisaldavad mõnda märksõna, hashtagi vms).

Realiseerimise kirjeldus ilmub lähiajal. Kuigi kui te lahendate selle mingil muul kujul, siis saate ka punktid kätte.

Üks võimalik lahendus:

Lisaosa jaoks tuleb täiendav muudatus malli, mis võimaldaks lisaosa funktsionaalsust testida.

Lisaosa (keerulisem): streaming (2p)

Lisaosa eesmärk on kuulata Twitteri voogu (stream) ning salvestada saadud säutsud faili. Hiljem on võimalik salvestatud failiga opereerida: vaadata kõiki säutse, vaadata statistikat (mitu säutsu, mitme erineva kasutaja poolt, kõige rohkem säutse teinud kasutaja), otsing.

Võimalik lahendus:

Lisaosa jaoks tuleb täiendav muudatus malli, mis võimaldaks lisaosa funktsionaalsust testida.


Mall

TwitterApplication.java: <source lang="java">


import java.util.List;

/** 

* The core interface for your application.
* @author Ago
*
*/

public interface TwitterApplication { /** * Given a command as a String (in interactive mode), * this method should parse the input and return * a list of Action instances. * Usually one command should create one action, this * method gives the opportunity to have combined actions * for one command line ("query tallinn search kala"). * If you don't use combined actions, just return a list * with one element in it - the Action instance to be * executed. * @param action Command string from interactive mode * @return List of actions to be executed */ public List<Action> getActionsFromInput(String action);

/** * Given command line arguments this method parses * the arguments and returns a list of Action instances. * As the command line can accept several different actions * (for example query, sort and search), this method * return a list of all the actions. * @param args Command line arguments (from main method) * @return List of actions to be executed */ public List<Action> getActionsFromArguments(String[] args);

/** * Given an instance of Action, it will be executed. * @param action */ public void executeAction(Action action);

/** * Executes all the actions given as a list. * The default implementation just iterates over * all the actions and calls executeAction. * @param actions A list of actions */ default public void executeActions(List<Action> actions) { for (Action action : actions) { executeAction(action); } }

/** * Executes a location search using location search set with * setLocationSearch(). * Returns a query object which holds all the values for Twitter search. * Note that this method has a default implementation which * just executes a method from local location search and * returns its return value. * Use this default implementation if you don't have caching implemented. * If you need caching, you need to override this method. * @param location The location which is to be searched for * @return Query object which holds all the necessary information * about Twitter query * @see TwitterApplication#setLocationSearch(LocationSearch) */ default public TwitterQuery getQueryFromLocation(String location) { LocationSearch locationSearch = getLocationSearch(); return locationSearch.getQueryFromLocation(location); }

/** * Executes a search of tweets on TwitterSearch object which * is stored via setTwitterSearch(). * Returns a list of received tweets. * @param query Query object which holds all the necessary values * @return List of Tweet objects received from Twitter search. * null if nothing received. * @see TwitterApplication#setTwitterSearch(TwitterSearch) */ default public List<? extends Tweet> getTweets(TwitterQuery query) { TwitterSearch twitterSearch = getTwitterSearch(); return twitterSearch.getTweets(query); }

/** * Stores location search object which will * be used to make queries to location search API. * @param locationSearch Implementation of LocationSearch, which * can find information about location (city, country etc.). */ public void setLocationSearch(LocationSearch locationSearch);

/** * Returns currently stored location search object. * @return Implementation of LocationSeach * which will be used for location search. */ public LocationSearch getLocationSearch();

/** * Stores Twitter search object which will be used * to query tweets from Twitter API. * @param twitterSearch Implementation of TwitterSearch */ public void setTwitterSearch(TwitterSearch twitterSearch);

/** * Returns currently stored Twitter search object. * @return Implementation of TwitterSearch * which will be used for queries. */ public TwitterSearch getTwitterSearch();

/** * Stores cache object which will be used * to cache locations in the file. * @param cache Implementation of Cache */ public void setCache(Cache cache);

/** * Returns currently stored cache object. * @return Implementation of Cache * which will be used for location caching. */

public Cache getCache();

/** * Stores the latest state of tweets list. * You should store your tweets using this * method after querying, sorting, searching. * @param tweets A list of tweets */ public void setTweets(List<? extends Tweet> tweets);

/** * Get the latest state of tweets list. * This method should be used for printing * and when applying sorting or searching. * @return A list of tweets */ public List<? extends Tweet> getTweets();

}

</source>

Pärit leheküljelt "http://courses.cs.taltech.ee/w/index.php?title=ITI0011:Säuts_draft&oldid=2129"