ITI0011:Säuts (2014) - Redigeerimiste ajalugu

Ago: Ago teisaldas lehekülje ITI0011:Säuts pealkirja ITI0011:Säuts (2014) alla

2015-03-03T02:05:29Z

Ago teisaldas lehekülje ITI0011:Säuts pealkirja ITI0011:Säuts (2014) alla

Ago – 8. oktoober 2014, kell 11:15

2014-10-08T11:15:51Z

Ago: /* Üldine */

2014-10-01T19:25:29Z

Üldine

Ago: /* Üldine */

2014-10-01T19:25:15Z

Üldine

Ago: /* Üldine */

2014-09-29T01:16:30Z

Üldine

Ago – 26. september 2014, kell 03:14

2014-09-26T03:14:44Z

Ago – 24. september 2014, kell 19:02

2014-09-24T19:02:30Z

Ago: /* Lisaosa: testitav kood (1p) */

2014-09-24T13:25:25Z

Lisaosa: testitav kood (1p)

Ago – 19. september 2014, kell 04:55

2014-09-19T04:55:27Z

Ago – 19. september 2014, kell 04:49

2014-09-19T04:49:46Z

@@ 117. rida: / 117. rida: @@
 Üleval näites TWITTER_CUSTOMER_KEY ja TWITTER_CUSTOMER_SECRET on konstandid ja nende väärtused on võetud twitteri lehel loodud rakenduse lehelt (application key ja application secret vastavalt). Loomulikult võite seadistamise teha ka konfiguratsioonifailiga või muudmoodi (selle kohta leiate rohkem infot teegi kodulehelt).
-Seda, kuidas nüüd teegiga vajalik päring teha, peate ise uurima. Aga selle kohta on veebilehel olemas ka paar näidet.
+Seda, kuidas nüüd teegiga vajalik päring teha, peate ise uurima. Aga selle kohta on veebilehel olemas ka paar näidet. Siin on ka üks näide: https://github.com/yusuke/twitter4j/blob/master/twitter4j-core/src/test/java/twitter4j/SearchAPITest.java (see on võetud testide kaustast. tihti sisaldavad testid palju rohkem koodinäiteid kui tegelikud koodinäited.)
 Kui teil on Twitteri konto olemas, saate olemasoleva konto alla luua rakenduse. Kuigi üldiselt on ülesande eesmärk pärida avalikke säutse, võite teha rakenduse, mis pärib teie kasutajaga seotud säutse (ehk siis nende omasid, keda jälgite ja/või kes on sõbrad). Jällegi, üldjuhul see lisapunkte ei anna. Tähelepanu, kui teete päringuid oma sõbrade kohta, on teil lisaks rakenduse võtmele lisada juurde ka teie enda võtmed. Selle kohta leiate näiteid siit: http://twitter4j.org/en/configuration.html . Kõik sealsed näited käivadki selle olukorra kohta, kus on vaja teha päringuid konkreetselt teie kasutaja alt. Kui te oma kasutaja infot ei lisa, saab teostada vaid avalikke päringuid.

@@ 15. rida: / 15. rida: @@
 Programmi funktsionaalsus:
-* programmi käivitamisel on võimalik kogu funktsionaalsust juhtida käsurea parameetritega (nt. java Twitter -location Tallinn -c 40 -w tweets.txt)
+* programmi käivitamisel on võimalik kogu funktsionaalsust juhtida käsurea parameetritega (nt. java Twitter -location Tallinn -c 40)
 * kui programm käivitatakse ilma käsurea parameetriteta, avaneb interaktiivne keskkond, kuhu saab käske kirjutada
 * programmil peab olema loetav juhis (nii käsurealt käivitades kui ka interaktiivses keskkonnas)

←Vanem redaktsioon		Redaktsioon: 1. oktoober 2014, kell 19:25
4. rida:		4. rida:

	== Üldine ==		== Üldine ==
−
−	~~<div style="color: red;">Ülesande tekst on poolik (ehk siis detailid võivad veel muutuda)!</div>~~

	Tähtaeg: '''21. või 23. oktoober (vastavalt rühma tunnile)'''<br>		Tähtaeg: '''21. või 23. oktoober (vastavalt rühma tunnile)'''<br>

@@ 22. rida: / 22. rida: @@
 * kasutaja saab sisestada asukoha nimetuse (võib olla linn, objekti nimi vms), programm leiab viimased avalikud säutsud, mis on selle objekti või linna läheduses tehtud
 * programm võimaldab määrata, mitu säutsu tulemuses väljastatakse
 * programm võimaldab tulemusi sorteerida ettemääratud parameetri järgi
 == Lisaosa: testitav kood (1p) ==

@@ 9. rida: / 9. rida: @@
 Tähtaeg: '''21. või 23. oktoober (vastavalt rühma tunnile)'''<br>
 Enne seda nädalat esitamine annab +1 lisapunkti.
 Ülesande eesmärk on luua interaktiivne programm, millega saab hallata avalikke säutse (i.k. ''tweets'')
@@ 21. rida: / 25. rida: @@
 * programm võimaldab juba alla tõmmatud tulemused failist lugeda
 * programm võimaldab tulemusi sorteerida ettemääratud parameetri järgi
 == Põhiosa - 5p ==
@@ 32. rida: / 44. rida: @@
 * Twitteri API-sse saadetakse päring vastavalt määratud keskpunkti ja raadiusega
 * Twitteri API vastusest loetakse välja vajalikud andmed ja kuvatakse ekraanile.
-* programmile saab kohanime ette anda kas käsurealt või programmi käivitamisel küsib programm asukohta
+* programmile saab kohanime ette anda käsurealt
 === Kohanimele vastavad koordinaadid ===
-Kasutame [http://www.openstreetmap.org OpenStreetMap] kommuuni tööriista Nominatim ([http://wiki.openstreetmap.org/wiki/Nominatim Nominatim wiki leht]). Te saadate sellele tööriistale päringu soovitud kohanimega ja vastusest loete välja kohanimele vastava piirkonna ümbritseva ala piirmised punktid (bounding box).
+Kasutame [http://www.openstreetmap.org OpenStreetMap] kommuuni tööriista Nominatim ([http://wiki.openstreetmap.org/wiki/Nominatim Nominatim wiki leht]). Te saadate sellele tööriistale päringu soovitud kohanimega ja vastusest loete välja kohanimele vastavad koordinaadid (latitude ja longitude) ning ümbritseva ala piirmised punktid (bounding box).
 Näitepäring: http://nominatim.openstreetmap.org/search?q=Tallinn&format=xml
@@ 59. rida: / 71. rida: @@
 Tulemuseks saate mitu erinevat kohta, mille nimi on Tallinn (või nimes sisaldub selline sõna). Kõige esimene vaste meie programmi jaoks sobib. Seega loete välja esimese "place" elemendi. Kuna Twitteri päringu jaoks on meil vaja koordinaati ning raadiust (kui suure ala pealt tulemusi otsitakse), siis huvitavad meid atribuudid "lat" ja "lon" (latitude ja longitude), mis määravad ära keskpunkti, ning atribuut "boundingbox", mis näitab antud asukoha ümbritseva ala piirjooni. Antud näite näite puhul lat="59.4372155", lon="24.7453688", boundingbox="59.351806640625,59.5915794372559,24.5501689910889,24.9262847900391".
-Twitteri päringus otsitav piirkond on märgitud keskpunkti ning raadiusega. Keskpunktiks võib kasutada otse eelnevalt saadud "lat" ja "lon" väärtusi. Raadiuse leidmiseks võib kasutada "boundingbox" väärtust. Kuna raadius peab olema esitatud näiteks kilomeetrites, siis tuleks boundingbox argumentide järgi leida mõistlik raadius. Tähelepanu, erinevas maakera piirkonnas on näiteks latitude 0.1 ühikuline erinevus oluliselt erineva pikkusega. Antud ülesande jaoks ei pea te arvutama väga täpse raadiuse, mis piiratud alasse sisse jääb. Piisab, kui te suurusjärgu panete paika. Siin ülesande kirjelduses konkreetset valemit või näidet toodud ei ole - selle võrra tulevad loodetavasti esitatud kodused ülesanded võimalikult erinevad. Väga täpseks ja põhjalikuks ei tasu ka minna - boonuspunkte selle arvutuse eest üldjuhul ei saa.
+Twitteri päringus otsitav piirkond on märgitud keskpunkti ning raadiusega. Keskpunktiks võib kasutada otse eelnevalt saadud "lat" ja "lon" väärtusi. Raadiuse leidmiseks võib kasutada "boundingbox" väärtust. Kuna raadius peab olema esitatud näiteks kilomeetrites, siis tuleks boundingbox argumentide järgi leida mõistlik raadius. Tähelepanu, erinevas maakera piirkonnas on näiteks longitude 0.1 ühikuline erinevus oluliselt erineva pikkusega. Antud ülesande jaoks ei pea te arvutama väga täpse raadiuse, mis piiratud alasse sisse jääb. Piisab, kui te suurusjärgu panete paika. Siin ülesande kirjelduses konkreetset valemit või näidet toodud ei ole - selle võrra tulevad loodetavasti esitatud kodused ülesanded võimalikult erinevad. Väga täpseks ja põhjalikuks ei tasu ka minna - boonuspunkte selle arvutuse eest üldjuhul ei saa. Oluline on, et oluliselt erineva suurusega linnad annaksid erineva raadiuse (New York > > Tallinn > Haapsalu).
 Seega teil on oluline, et oskate vajalikud andmed välja lugeda ning need teisendada keskpunktiks ja raadiuseks.
@@ 218. rida: / 230. rida: @@
 See lisaosa annab 1 punkti.

←Vanem redaktsioon	Redaktsioon: 3. märts 2015, kell 02:05
(Erinevus puudub)

←Vanem redaktsioon		Redaktsioon: 24. september 2014, kell 19:02
1. rida:		1. rida:
	Tagasi [[ITI0011]] lehele.		Tagasi [[ITI0011]] lehele.
		+
		+	English version of this homework: [[ITI0011:Twitter homework]].

	== Üldine ==		== Üldine ==

←Vanem redaktsioon		Redaktsioon: 24. september 2014, kell 13:25
223. rida:		223. rida:
	'''Tähelepanu''' Kui te olete oma koodi juba valmis teinud ja tahate seda lisaosa sooritada, võib see tähendada, et peate suurema osa koodist ringi kirjutama. Seega, kui seda lisaosa jahite, peaksite algusest peale oma koodi vastavalt üles ehitama. Kuna antud ülesande puhul on testitavuse võimaldamiseks vaja suhteliselt palju täiendavat tööd teha (mida te muidu tegema ei peaks), siis on ka selle eest lisapunkt pakutud.		'''Tähelepanu''' Kui te olete oma koodi juba valmis teinud ja tahate seda lisaosa sooritada, võib see tähendada, et peate suurema osa koodist ringi kirjutama. Seega, kui seda lisaosa jahite, peaksite algusest peale oma koodi vastavalt üles ehitama. Kuna antud ülesande puhul on testitavuse võimaldamiseks vaja suhteliselt palju täiendavat tööd teha (mida te muidu tegema ei peaks), siis on ka selle eest lisapunkt pakutud.

−	~~<div style="color~~: ~~red;">Testitavuse osa täieneb</div>~~	+	Loe lähemalt siit: [[ITI0011:Säuts lisaülesanne]]

←Vanem redaktsioon		Redaktsioon: 19. september 2014, kell 04:55
216. rida:		216. rida:

	See lisaosa annab 1 punkti.		See lisaosa annab 1 punkti.
		+
		+	== Lisaosa: testitav kood (1p) ==
		+
		+	Antud ülesanne ei ole väga rangelt kirjeldatud, mis jätab tudengitele vabaduse loovuse näitamiseks. Küll aga pärsib selline vabadus testimise võimalust. Siin pakutakse välja teenida täiendab lisapunkt (kokku siis võimalik saada 11 punkti, kui kõik lisad ära teete) juhul, kui te teete oma koodi testitavaks. Sellejaoks anname ette päris mitu interface'i, mida teie peate implementeerima oma programmis. Interface'id võimaldavad meil kirjeldada ära, millised meetodid milliste argumentidega teie koodis olema - seega, me saame neid välja kutsuda ja ka testida.
		+
		+	'''Tähelepanu''' Kui te olete oma koodi juba valmis teinud ja tahate seda lisaosa sooritada, võib see tähendada, et peate suurema osa koodist ringi kirjutama. Seega, kui seda lisaosa jahite, peaksite algusest peale oma koodi vastavalt üles ehitama. Kuna antud ülesande puhul on testitavuse võimaldamiseks vaja suhteliselt palju täiendavat tööd teha (mida te muidu tegema ei peaks), siis on ka selle eest lisapunkt pakutud.
		+
		+	<div style="color: red;">Testitavuse osa täieneb</div>

←Vanem redaktsioon		Redaktsioon: 19. september 2014, kell 04:49
163. rida:		163. rida:

	See lisaosa täielikult realiseerituna annab 2 punkti.		See lisaosa täielikult realiseerituna annab 2 punkti.
		+
		+	== Lisaosa: sorteerimine (1p) ==
		+
		+	Tweet'id väljastatakse sorteeritult vastavalt etteantud väljale. Sorteerida saab järgmiste väljade järgi: autor, postituse kuupäev, postitus (ehk siis tweet ise).
		+
		+	Sorteerimine peab toimima nii kasvavas kui kahanevad järjekorras.
		+
		+	Näiteks käivitatakse programm:
		+	* java Twitter Tallinn -sort author
		+	* java Twitter Tallinn -sort date
		+	* java Twitter Tallinn -sort date desc
		+	* java Twitter Tallinn -sort content
		+
		+	See lisaosa täielikult realiseerituna annab 1 punkti.
		+
		+	== Lisaosa: filtreerimine (1p) ==
		+
		+	Lisaks kohanimele saab ette anda: otsingusõna ja väljastavate tweetide arvu. Tweetide arv tuleb kaasa anda päringu tegemisel. Otsingusõna tuleb rakendada aga saadud tulemuste peale.
		+
		+	Kui realiseeritud on nii tweetide arvu piiramine kui ka otsingusõna rakendamine saab 1 punkti.
		+
		+	== Lisaosa: interaktiivne ja käsurealt juhtimine (1p) ==
		+
		+	Lisaosa mõte on võimaldada programmi käivitada nii käsurealt:
		+
		+
		+	java Twitter Tallinn -count 50 -sort date desc -search tere
		+
		+	kui ka luua interaktiivne keskkond, kus saab käske edasi anda. Interaktiivne keskkond tähendab seda, et programmi käivitamisel küsitakse kasutajalt sisendit ehk käsku. Käsk täidetakse ning seejärel saab kasutaja sisestada uue käsu (nagu command prompt või terminal). Näiteks:
		+
		+	> setcount 50
		+	> query Tallinn
		+	> print
		+	> query Pärnu 10
		+	> sort date desc
		+	> print
		+	> search tere
		+	> print
		+
		+	Kui programm käivitatakse käsurea argumentidega (esimene näide), siis programm teeb vajalikud sammud ära ja lõpetab töö. Kui käsurealt argumente ei antud, käivitub interaktiivne keskkond.
		+
		+	Programm peab tundma järgmisi käske (interaktiivses keskkonnas peaks olema need käsud eraldi):
		+	* päringu tegemine (näites "query"). Päringu tegemisel saab kaasa anda tweetide koguse (kui see lisaosa on tehtud; näites "query Pärnu 10"). Võib teha piirangu määramise ka eraldi (näites "setcount 50", see jääb siis kehtima järgmiste päringute puhul).
		+	* Ainult interaktiivses: tulemuste printimine (näites "print"). Te võite tulemused printida ka kohe peale päringu tegemist. Aga muude operatsioonide puhul on mugav, kui print on eraldi. Käsurea käivitamise puhul prinditakse tulemused alati välja (peale muude operatsioonide tegemist).
		+	* sorteerimine (näites "sort date desc"), kui vastav lisaosa on tehtud
		+	* otsimine (näites "search tere"), kui vastav lisaosa on tehtud
		+	* abi saamine (näiteks "help"). Kui sisestatakse vale argument (käsurealt käivitamisel) või käsk (interaktiivne käivitamine), siis peaks ka näitama abiteksti.
		+
		+	Selle lisaosa tegemisel on lisaks nõue see, et nii käsurealt saadud argumendid kui ka interaktiivselt edastatud käsud käivitatakse ühte moodi. Ehk siis mõlemal juhul töödeldakse nad samale kujule ja seejärel käivitatakse. Selle mõte on see, et teie programm oskab operereerida erinevate käskudega. See, kuidas programm need käsud kasutaja käest teada saab, pole käivitamise jaoks oluline. Kui te hiljem kunagi tahate lisada võimaluse käske saata üle veebi API, siis peate lisama lihtsalt käskude vastuvõtmise ja teisendamise ühtsele kujule (nagu ka käsurealt ja interaktiivsest keskkonnast) - ülejäänud juba töötab.
		+
		+	Kuigi see lisaosa tundub justkui väga mahukas 1 punkti kohta, siis tegelikult see väga keeruline pole. Niiehknaa on teil vaja realiseerida üks kahest: kas interaktiivne või käsurea variant. Vastasel korral te ei saa muid lisapunkte ka saada. Kui te kohe oma programmi loomise käigus arvestate võimalusega käivitada käske kahest erinvast kohast, siis hiljem mingeid täiendavaid arendusi teha pole vaja. Kui te olete teinud käsurealt käivitamise koos lisaülesannetega valmis ja hakkate seda lisaülesannet tegema, võib selle realiseerimine olla mõnevõrra keerulisem.
		+
		+	See lisaosa annab 1 punkti.