ITI0011-2015:harjutus 10 - Redigeerimiste ajalugu

Ago: Ago teisaldas lehekülje ITI0011:harjutus 10 pealkirja ITI0011-2015:harjutus 10 alla

2016-03-14T06:28:39Z

Ago teisaldas lehekülje ITI0011:harjutus 10 pealkirja ITI0011-2015:harjutus 10 alla

Ago: /* Kirjeldus */

2015-03-25T15:41:30Z

Kirjeldus

Ago: /* Kirjeldus */

2015-03-25T15:40:55Z

Kirjeldus

Ago: /* Kirjeldus */

2015-03-25T15:37:11Z

Kirjeldus

Ago: /* Testimine */

2015-03-25T15:18:12Z

Testimine

Ago – 25. märts 2015, kell 14:49

2015-03-25T14:49:06Z

Ago – 25. märts 2015, kell 02:50

2015-03-25T02:50:37Z

Ago – 24. märts 2015, kell 18:29

2015-03-24T18:29:15Z

Ago – 24. märts 2015, kell 18:24

2015-03-24T18:24:57Z

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

2015-03-24T18:23:13Z

@@ 10. rida: / 10. rida: @@
 Zip-fail sisaldab jar-faili. See paki kuskile lahti (põhimõtteliselt võib ka otse EX10/lib kausta pakkida). Nüüd parem klikk projekti nime peal vasakul package exploreris -> properties (või üleval menüüst project -> properties); sealt Java Build Path -> paremal tääb "Libraries". Sinna tuleb jar-fail lisada. Selleks "Add External JARs..." (kui fail ei ole workspace'i all) või "Add JARs..." (kui fail on workspace'i all, näiteks EX10/lib kaustas). Vastav jar-fail tuleb nüüd üles leida. Seejärel peaks Libraries tääbi all olema näha lisaks Java enda teegile ka BookStoreAPI jar.
-Kui te veel ei kopeerinud jar-faili EX10/lib alla, siis peate seda nüüd tegema (seda on vaja giti jaoks, Eclipse'is asi võib juba korrektselt tööle minna). Parem klikk projekti peal -> new folder -> lib. Nüüd võite oma operatsioonisüsteemi mingis rakenduses (näiteks Windows Explorer) kopeerida jar-faili [workspace]EX10/lib kausta. Tähelepanu, et projekt asub peale git'i panemist mitte enam workspace'i all, vaid pigem teie git kaustas. Vaikimisi on vastav lib kaust: home/git/kasutaja.nimi/EX10/lib.
+Kui te veel ei kopeerinud jar-faili EX10/lib alla, siis peate seda nüüd tegema (seda on vaja giti jaoks, Eclipse'is asi võib juba korrektselt tööle minna). Parem klikk projekti peal -> new folder -> lib. Nüüd võite oma operatsioonisüsteemi mingis rakenduses (näiteks Windows Explorer) kopeerida jar-faili <code>[workspace]EX10/lib</code> kausta. Tähelepanu, et projekt asub peale git'i panemist mitte enam workspace'i all, vaid pigem teie git kaustas. Vaikimisi on vastav lib kaust: <code>[user home]/git/kasutaja.nimi/EX10/lib</code>.
 Tulemus võib olla selline (kui lisasite external jar'i):

←Vanem redaktsioon		Redaktsioon: 25. märts 2015, kell 15:40
9. rida:		9. rida:

	Zip-fail sisaldab jar-faili. See paki kuskile lahti (põhimõtteliselt võib ka otse EX10/lib kausta pakkida). Nüüd parem klikk projekti nime peal vasakul package exploreris -> properties (või üleval menüüst project -> properties); sealt Java Build Path -> paremal tääb "Libraries". Sinna tuleb jar-fail lisada. Selleks "Add External JARs..." (kui fail ei ole workspace'i all) või "Add JARs..." (kui fail on workspace'i all, näiteks EX10/lib kaustas). Vastav jar-fail tuleb nüüd üles leida. Seejärel peaks Libraries tääbi all olema näha lisaks Java enda teegile ka BookStoreAPI jar.		Zip-fail sisaldab jar-faili. See paki kuskile lahti (põhimõtteliselt võib ka otse EX10/lib kausta pakkida). Nüüd parem klikk projekti nime peal vasakul package exploreris -> properties (või üleval menüüst project -> properties); sealt Java Build Path -> paremal tääb "Libraries". Sinna tuleb jar-fail lisada. Selleks "Add External JARs..." (kui fail ei ole workspace'i all) või "Add JARs..." (kui fail on workspace'i all, näiteks EX10/lib kaustas). Vastav jar-fail tuleb nüüd üles leida. Seejärel peaks Libraries tääbi all olema näha lisaks Java enda teegile ka BookStoreAPI jar.
		+
		+	Kui te veel ei kopeerinud jar-faili EX10/lib alla, siis peate seda nüüd tegema (seda on vaja giti jaoks, Eclipse'is asi võib juba korrektselt tööle minna). Parem klikk projekti peal -> new folder -> lib. Nüüd võite oma operatsioonisüsteemi mingis rakenduses (näiteks Windows Explorer) kopeerida jar-faili [workspace]EX10/lib kausta. Tähelepanu, et projekt asub peale git'i panemist mitte enam workspace'i all, vaid pigem teie git kaustas. Vaikimisi on vastav lib kaust: home/git/kasutaja.nimi/EX10/lib.

	Tulemus võib olla selline (kui lisasite external jar'i):		Tulemus võib olla selline (kui lisasite external jar'i):

@@ 7. rida: / 7. rida: @@
 Tuleb realiseerida klass <code>BookShop</code>, mis sõltub <code>BookShopApi</code> library'st, mille saab tõmmata [[Meedia:ITI0011-2015-BookStoreApiV02.zip]].
 BookStoreApi library võimaldab pealkirjade (või pealkirja osa) järgi pärida infot raamatu(te) kohta.
 Näiteks:

@@ 49. rida: / 49. rida: @@
 Testsüsteem nõuab kõiki kasutatavaid teeke (jar-failid) projekti lib kausta. Ehk siis näiteks EX10/lib/BookStoreApiV02.jar
-Eclipse'is saad teha parem klikk projekti peal ja "new folder". Nimeks määrata "lib". Nüüd tuleb see ka edaspidi
+Eclipse'is saad teha parem klikk projekti peal ja "new folder". Nimeks määrata "lib".
 == Mall ==

@@ 5. rida: / 5. rida: @@
 == Kirjeldus ==
-Tuleb realiseerida klass <code>BookStore</code>, mis sõltub <code>BookShopApi</code> library'st, mille saab tõmmata [[Meedia:ITI0011-2015-BookStoreApiV02.zip]].
+Tuleb realiseerida klass <code>BookShop</code>, mis sõltub <code>BookShopApi</code> library'st, mille saab tõmmata [[Meedia:ITI0011-2015-BookStoreApiV02.zip]].
 BookStoreApi library võimaldab pealkirjade (või pealkirja osa) järgi pärida infot raamatu(te) kohta.
 Näiteks:
-<code><BookStoreInstance>.getBookByTitle("Tõde ja Õigus") </code>
+<code><BookShopInstance>.getBookByTitle("Tõde ja Õigus") </code>
 tagastab xml dokumendi http://pastebin.com/dSfNCHH8
-<code>BookStore</code> peab laiendama <code>SimpleBookStore</code> klassi, mis tuleb kaasa <code>BookShopApi</code> teegiga.
+<code>BookShop</code> peab laiendama <code>SimpleBookShop</code> klassi, mis tuleb kaasa <code>BookShopApi</code> teegiga.
-<code>BookStore</code> peab olema eraldi defineeritud klass, mille konstruktor võtab argumendina ette <code>BookShopApi</code> objekti. <code>BookShop</code> klassis peab olema
+<code>BookShop</code> peab olema eraldi defineeritud klass, mille konstruktor võtab argumendina ette <code>BookShopApi</code> objekti. <code>BookShop</code> klassis peab olema
 defineeritud 5 meetodit: <code>getTotalRecordsInResponse</code>, <code>getPossibleBookTitles</code>, <code>getBookWithMostPagesTitle</code>, <code>getPossbileAuthors</code>, <code>query</code>.
@@ 84. rida: / 84. rida: @@
 	/**
 	 * Make api query.
-	 * Uses BookStoreApi functionality to get XML response from Google Books
+	 * Uses BookShopApi functionality to get XML response from Google Books
 	 * Every time this function is called, latest XML state is saved.
 	 * If previous query failed lastResponse equals to empty string.

←Vanem redaktsioon	Redaktsioon: 14. märts 2016, kell 06:28
(Erinevus puudub)

@@ 1. rida: / 1. rida: @@
 Harjutuse tähtaeg on '''26.-27. märts'''.
@@ 46. rida: / 44. rida: @@
 Example BookShopApi call:
 http://pastebin.com/9DcpBHe7
 == Mall ==

@@ 21. rida: / 21. rida: @@
 * '''getTotalRecordsInResponse''' tagastab XML tulemusest <code><totalItems>X</totalItems></code> X väärtuse. Kui tulemus puudub või getBookByTitle viskab erindi, siis tagastada 0.
-* '''getPossibleBookTitles''' tagastab kõik raamatute nimed (see tähendab kõik väärtused, mis on <title> tagide vahel). Duplikaadid lubatud. Kui tulemus puudub võib getBookByTitle viskab erindi, siis tagatada tühi list.
+* '''getPossibleBookTitles''' tagastab kõik raamatute nimed (see tähendab kõik väärtused, mis on <code><title></code> tagide vahel). Duplikaadid lubatud. Kui tulemus puudub võib <code>getBookByTitle</code> viskab erindi, siis tagatada tühi list.
-* '''getBookWithMostPagesTitle''',  tagastab raamatu pealkirja(<title>), millel on antud XML korral kõige rohkem lehekülgi. Kui getBookByTitle viskab erindi, siis tagastada tühi string ("")
+* '''getBookWithMostPagesTitle''',  tagastab raamatu pealkirja(<code><title></code>), millel on antud XML korral kõige rohkem lehekülgi. Kui <code>getBookByTitle</code> viskab erindi, siis tagastada tühi string (<code>""</code>)
-* '''getPossbileAuthors''', tagastab kõik leitud raamatute autorid,  seejuures tuleb arvestada, et ühte autorit ei tohi olla listis rohkem kui 1 kord. Raamatu autori leiab <authors> tagide vahelt. Tähelepanu <authors> tag sisaldab tegelikult ainulte ühte autorit, mitme autori puhul on lisatud <authors> tage mitu korda. Erindi korral tagastada tühi list.
+* '''getPossbileAuthors''', tagastab kõik leitud raamatute autorid,  seejuures tuleb arvestada, et ühte autorit ei tohi olla listis rohkem kui 1 kord. Raamatu autori leiab <code><authors></code> tagide vahelt. Tähelepanu <code><authors></code> tag sisaldab tegelikult ainult ühte autorit, mitme autori puhul on lisatud <code><authors></code> tage mitu korda. Erindi korral tagastada tühi list.
 * '''getBookWithLessThanNPagesTitles''' tagastab listi pealkirjadest, mille puhul on lehekülgi vähem kui n. Erindi puhul tagastada tühi list.
-* '''query''' teeb päringu BookShopApi abiga ja salvestab viimase tulemuse klassimuutujasse lastResult. Kui tekib erind, siis viimane tulemus on võrdne tühja stringiga ("").
+* '''query''' teeb päringu <code>BookShopApi</code> abiga ja salvestab viimase tulemuse klassimuutujasse <code>lastResult</code>. Kui tekib erind, siis viimane tulemus on võrdne tühja stringiga (<code>""</code>).
 Kasulikke materjale:
 * http://www.freeformatter.com/xml-formatter.html - väljundi loetavamaks muutmiseks võib arenduse käigus kasutada järgnevat XML ilustajat.
 * http://dom4j.sourceforge.net/dom4j-1.6.1/ - xml väljundi mugavamaks parsimiseks
-* http://en.wikipedia.org/wiki/Regular_expression - regulaaravalidstega on võimalik mugavalt matchida konkreetseid elemente
+* http://en.wikipedia.org/wiki/Regular_expression - regulaaravaldistega on võimalik mugavalt leida konkreetseid elemente
-* http://www.freeformatter.com/xpath-tester.html - võimaldab kiiresti leida kõik otsitavad elem endid, näiteks //title leiab kohe kõik pealkirjad
+* http://www.freeformatter.com/xpath-tester.html - võimaldab kiiresti leida kõik otsitavad elem endid, näiteks <code>//title</code> leiab kohe kõik pealkirjad
 Loodavat funktsioonid
-* public int getTotalRecordsInResponse()
+* <code>public int getTotalRecordsInResponse()</code>
-* public ArrayList<String> getPossibleBookTitles()
+* <code>public ArrayList<String> getPossibleBookTitles()</code>
-* public String getBookWithMostPagesTitle()
+* <code>public String getBookWithMostPagesTitle()</code>
-* public ArrayList<String> getPossibleAuthors()
+* <code>public ArrayList<String> getPossibleAuthors()</code>
-* public ArrayList<String> getBookWithLessThanNPagesTitles()
+* <code>public ArrayList<String> getBookWithLessThanNPagesTitles()</code>
-* public void query(String search)
+* <code>public void query(String search)</code>

←Vanem redaktsioon		Redaktsioon: 24. märts 2015, kell 18:24
48. rida:		48. rida:

	== Mall ==		== Mall ==
		+
		+	BookShop.java
		+	<source lang="java">
		+	import java.util.ArrayList;
		+	import cs.ttu.ee.BookShopApi;
		+	import cs.ttu.ee.SimpleBookShop;
		+
		+
		+	/**
		+	* BookShop class.
		+	* Simplified implementation of BookShop
		+	* Does filtering and basic queries.
		+	*/
		+	public class BookShop extends SimpleBookShop {
		+
		+	/**
		+	* Instance of BookShopApi, used to access
		+	* Google Books
		+	*/
		+	private BookShopApi bookShopApi;
		+
		+	/**
		+	* Last api query result.
		+	*/
		+	private String lastResponse = "";
		+
		+	public BookShop(BookShopApi _bookShopApi) {
		+	bookShopApi = _bookShopApi;
		+	}
		+
		+	/**
		+	* Make api query.
		+	* Uses BookStoreApi functionality to get XML response from Google Books
		+	* Every time this function is called, latest XML state is saved.
		+	* If previous query failed lastResponse equals to empty string.
		+	* Otherwise lastResult is
		+	* @param search title of book
		+	*/
		+	public void query(String searchString) {
		+	// TODO: implement
		+	}
		+
		+	/**
		+	* Find total items matched by searchString.
		+	* Api uses paging, not all results are
		+	* displayed under result, however, total
		+	* results is displayed inside <totalItems> element
		+	*
		+	* If last query was unsuccessful, 0 is returned.
		+	*
		+	* @return Total items matched by query.
		+	*/
		+	public int getTotalRecordsInResponse() {
		+	// TODO: implement
		+	return Integer.MIN_VALUE;
		+	}
		+
		+
		+	/**
		+	* Finds all possbile book titles.
		+	* Duplicates may occur.
		+	*
		+	* Title can be found inside <title> tag.
		+	* If last query was unsuccessful, empty ArrayList is returned.
		+	*
		+	* @return All possible book names matched by searchString
		+	*/
		+	public ArrayList<String> getPossibleBookTitles() {
		+	// TODO: implement
		+	return null;
		+	}
		+
		+	/**
		+	* Finds all authors found in last response.
		+	* Does not include duplicate authors.
		+	* If last query was unsuccessful, empty ArrayList is returned.
		+	*
		+	* Author can be found inside <authors> element. (Notice non plural form)
		+	* NB! Multiple <authors> element may occur.
		+	*
		+	* @return List of authors found in last response
		+	*/
		+	public ArrayList<String> getPossibleAuthors() {
		+	// TODO: implement
		+	return null;
		+	}
		+
		+	/**
		+	* Finds book with the most number of pages
		+	*
		+	* Page count can be found inside <pageCount> element
		+	* @return Title of book.
		+	*/
		+	public String getBookWithMostPagesTitle() {
		+	// TODO: implement
		+	return null;
		+	}
		+
		+	/**
		+	* Finds all book titles where pageCount < n
		+	*
		+	* Page count can be found inside <pageCount> element
		+	* @param n maximum amount of pages
		+	* @return list of books with less than n pages
		+	*/
		+	public ArrayList<String> getBookWithLessThanNPagesTitles(int n) {
		+	// TODO: implement
		+	return null;
		+	}
		+
		+
		+	}
		+
		+
		+	</source>
		+
		+	Main.java:
		+	<source lang="java">
		+	import java.util.ArrayList;
		+
		+	import cs.ttu.ee.BookShopApi;
		+
		+	public class Main {
		+
		+	public static void main(String args[]) {
		+	BookShopApi bookShopApi = new BookShopApi();
		+	BookShop studentBookShop = new BookShop(bookShopApi);
		+
		+	// Test your code here
		+	studentBookShop.query("Intermediate Java programming");
		+	System.out.println(studentBookShop.getTotalRecordsInResponse());
		+	System.out.println(studentBookShop.getPossibleBookTitles());
		+	System.out.println(studentBookShop.getPossibleAuthors());
		+	System.out.println(studentBookShop.getBookWithMostPagesTitle());
		+	ArrayList<String> result = studentBookShop.getBookWithLessThanNPagesTitles(100);
		+	System.out.println(result);
		+	// etc ...
		+
		+
		+
		+	}
		+	}
		+	</source>