ITI0011:Säuts draft - Redigeerimiste ajalugu

Ago – 19. märts 2015, kell 02:15

2015-03-19T02:15:49Z

Ago: /* Lisaosa (keerulisem): trendid (2p) */

2015-03-19T02:09:02Z

Lisaosa (keerulisem): trendid (2p)

Ago – 19. märts 2015, kell 02:04

2015-03-19T02:04:24Z

Ago: /* Lisaosa: interaktiivne juhtimine (1p) */

2015-03-19T01:45:35Z

Lisaosa: interaktiivne juhtimine (1p)

Ago: /* Lisaosa: interaktiivne juhtimine (1p) */

2015-03-19T01:31:59Z

Lisaosa: interaktiivne juhtimine (1p)

Ago – 19. märts 2015, kell 01:30

2015-03-19T01:30:37Z

Ago: /* Põhiosa: käsurealt juhtimine */

2015-03-18T15:37:35Z

Põhiosa: käsurealt juhtimine

Ago – 18. märts 2015, kell 15:36

2015-03-18T15:36:35Z

Ago: /* Lisaosa: sortimine ja filtreerimine(otsimine) (1p) */

2015-03-18T15:26:30Z

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

Ago – 18. märts 2015, kell 15:23

2015-03-18T15:23:46Z

←Vanem redaktsioon		Redaktsioon: 19. märts 2015, kell 02:15
175. rida:		175. rida:

	Lisaosa jaoks tuleb täiendav muudatus malli, mis võimaldaks lisaosa funktsionaalsust testida.		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.
		+	* <code>null</code> 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>

@@ 156. rida: / 156. rida: @@
 == Lisaosa (keerulisem): trendid (2p) ==
-Lisaosa eesmärk on vastavalt määratud asukohale leida selle piirkonna trendid (ehk siis populaarsed märksõnad, teemad, ''hastag'''id). Seejärel kuvatakse välja vaid need säutsud, mis kuuluvad trendide hulka (sisaldavad mõnda märksõna, ''hashtag'''i vms).
+Lisaosa eesmärk on vastavalt määratud asukohale leida selle piirkonna trendid (ehk siis populaarsed märksõnad, teemad, ''hastag''id). Seejärel kuvatakse välja vaid need säutsud, mis kuuluvad trendide hulka (sisaldavad mõnda märksõna, ''hashtag''i vms).
 Realiseerimise kirjeldus ilmub lähiajal. Kuigi kui te lahendate selle mingil muul kujul, siis saate ka punktid kätte.

←Vanem redaktsioon		Redaktsioon: 19. märts 2015, kell 02:04
153. rida:		153. rida:

	Kui nii käsurealt kui interaktiivsest keskkonnast saadud käsud protsessitakse täpselt samamoodi, saab lisaosa eest täiendava 1p (ehk siis kokku 2p).		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, ''hastag'''id). Seejärel kuvatakse välja vaid need säutsud, mis kuuluvad trendide hulka (sisaldavad mõnda märksõna, ''hashtag'''i vms).
		+
		+	Realiseerimise kirjeldus ilmub lähiajal. Kuigi kui te lahendate selle mingil muul kujul, siis saate ka punktid kätte.
		+
		+	Üks võimalik lahendus:
		+	* kasutada sellist API-d nagu: https://dev.twitter.com/rest/reference/get/trends/place
		+	* twitter4j puhul tasub vaadata järgmist interface'i: TrendsResources (http://twitter4j.org/javadoc/twitter4j/api/TrendsResources.html)
		+
		+	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:
		+	* http://twitter4j.org/en/code-examples.html#streaming
		+	* http://twitter4j.org/javadoc/twitter4j/TwitterStream.html
		+
		+	Lisaosa jaoks tuleb täiendav muudatus malli, mis võimaldaks lisaosa funktsionaalsust testida.

@@ 120. rida: / 120. rida: @@
 Selle lisaosa täielik realiseerimine annab 1 punkti.
-== Lisaosa: interaktiivne juhtimine (1p) ==
+== Lisaosa: interaktiivne juhtimine (1-2p) ==
 Põhiosa nõue oli, et programm oleks juhitav käsurea argumentidega:
@@ 147. rida: / 147. rida: @@
 * <code>search ''keyword''</code> (lisaosa) - teostatakse viimane päring uuesti (ehk siis kõik see, mis viimase <code>query</code> käsuga tehti), seekord kasutatakse määratud märksõna ''keyword''. Seega, kui eelnevalt otsiti "Tallinn" ja nüüd tuleb käsk <code>search kevad</code>, tehakse uus päring Tallinna kohta, kus otsisõnaks on "kevad". Kui seejärel käivitatakse käsk <code>search suvi</code>, tehakse uus päring Tallina kohta, seekord otsitakse märksõna "suvi" jne.
 * <code>exit</code> (põhiosa) - väljub programmist.

@@ 145. rida: / 145. rida: @@
 * <code>setcount ''num''</code> (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. <code>query</code>). Näiteks: <code>setcount 30</code> - edaspidi <code>query</code> päringus küsitakse ja <code>print</code> käsuga kuvatakse vaikimisi 30 säutsu.
 * <code>sort ''field'' [asc|desc]</code> (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 <code>author</code>, <code>date</code> või <code>tweet</code>. Lisaks võib juurde määrata järjestamise suuna: <code>asc</code> - kasvav, <code>desc</code> - kahanev. Vt rohkem [[#Lisaosa: sortimine ja filtreerimine(otsimine) (1p)]].
-* <code>search ''keyword''</code> (lisaosa) - teostatakse viimane päring uuesti, seekord kasutatakse määratud märksõna ''keyword''. Seega, kui eelnevalt otsiti "Tallinn" ja nüüd tuleb käsk <code>search kevad</code>, tehakse uus päring Tallinna kohta, kus otsisõnaks on "kevad". Kui seejärel käivitatakse käsk <code>search suvi</code>, tehakse uus päring Tallina kohta, seekord otsitakse märksõna "suvi" jne.
+* <code>search ''keyword''</code> (lisaosa) - teostatakse viimane päring uuesti (ehk siis kõik see, mis viimase <code>query</code> käsuga tehti), seekord kasutatakse määratud märksõna ''keyword''. Seega, kui eelnevalt otsiti "Tallinn" ja nüüd tuleb käsk <code>search kevad</code>, tehakse uus päring Tallinna kohta, kus otsisõnaks on "kevad". Kui seejärel käivitatakse käsk <code>search suvi</code>, tehakse uus päring Tallina kohta, seekord otsitakse märksõna "suvi" jne.
 * <code>exit</code> (põhiosa) - väljub programmist.

@@ 20. rida: / 20. rida: @@
 Seega sellise käivitamise puhul antakse teie programmi ette üks argument: "Tallinn"
-Kui programm pannakse käima ilma argumentideta, tuleb kasutajala kuvada juhised, kuidas programmi käima panna.
+Kui programm pannakse käima ilma argumentideta, tuleb kasutajale kuvada juhised, kuidas programmi käima panna.
 Argumendid, mida programm peab ära tundma:
@@ 26. rida: / 26. rida: @@
 ** programm pannakse ilma argumentideta käima või
 ** sisestatud argumendid on valed
-* <code>-count ''num''</code> (põhiosa) - määrab ära, mitu säutsu välja näidatakse. Kui see puudub, siis praks programmis olema määratud vaikimisi säutsude kogus 15.
+* <code>-count ''num''</code> (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.
-* <code>-sort ''field'' [asc|desc]</code> (lisaosa) - määrab ära, kuidas säutsud järjestatakse väljaprintimiseks. Väli võib olla kas: <code>author</code>, <code>date</code> või <code>tweet</code>. Valikuliselt võib kaasa panna kas <code>asc</code> või <code>desc</code>. Esimesel juhul toimub järjestamine kasvavalt, teisel juhul kahanevalt. Kui pole määratud, siis vaikimisi järjestatakse kasvavalt. Vaata ka vastavat lisaosa kirjeldust.
+* <code>-sort ''field'' [asc|desc]</code> (lisaosa) - määrab ära, kuidas säutsud järjestatakse väljaprintimiseks. Väli võib olla kas: <code>author</code>, <code>date</code> või <code>tweet</code>. Valikuliselt võib kaasa panna kas <code>asc</code> või <code>desc</code>. 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: <code>-sort author asc</code> ja <code>-sort author</code> annavad sama tulemuse.
 * <code>-search ''keyword''</code> (lisaosa) - kuvatakse vaid säutsud, milles esineb etteantud otsisõna.
 * ...
@@ 40. rida: / 40. rida: @@
 == 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 kuskilt puhvrisse (faili) ning neid hiljem sealt lugeda.
+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 ise uusi asukohti (näiteks "kodu", "TTÜ" jne)
+* 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:
@@ 120. rida: / 120. rida: @@
 Selle lisaosa täielik realiseerimine annab 1 punkti.
-== Lisaosa: interaktiivne juhtimine ==
+== Lisaosa: interaktiivne juhtimine (1p) ==

←Vanem redaktsioon		Redaktsioon: 18. märts 2015, kell 15:37
31. rida:		31. rida:
	* ...		* ...

		+	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) ==		== Lisaosa: Kohanimede puhverdamine faili (2p) ==

@@ 2. rida: / 2. rida: @@
 [[Säuts]]
 == Lisaosa: Kohanimede puhverdamine faili (2p) ==
@@ 84. rida: / 113. rida: @@
 Selle lisaosa täielik realiseerimine annab 1 punkti.

←Vanem redaktsioon		Redaktsioon: 18. märts 2015, kell 15:26
80. rida:		80. rida:

	Sorteerida saab nii kasvavas (väiksemad ees, näiteks: <code>a, b, c, ...</code> või <code>1, 3, 5, ...</code>) kui kahanevas (suuremad ees, näiteks: <code>ü, ö, ä, ...</code> või <code>9, 8, 4, ...</code>) järjekorras.		Sorteerida saab nii kasvavas (väiksemad ees, näiteks: <code>a, b, c, ...</code> või <code>1, 3, 5, ...</code>) kui kahanevas (suuremad ees, näiteks: <code>ü, ö, ä, ...</code> või <code>9, 8, 4, ...</code>) 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.

@@ 30. rida: / 30. rida: @@
 *** 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: <code>pärnu,58.3800572,24.5200466,5).
+** Kui ei, siis tehakse uus päring ning puhverdatakse tulemused faili (kirjutatakse uus rida, kus on ametlik_nimi, koordinaadid ja raadius: <code>pärnu,58.3800572,24.5200466,5)</code>.
 Näited: