Aleksandr: Uus lehekülg: 'Срок сдачи упражнения '''15-е занятие (26 марта)'''. Общая информация об упражнениях: ITI0011RUS_Practice.
...'

2015-03-24T21:47:02Z

Uus lehekülg: 'Срок сдачи упражнения '''15-е занятие (26 марта)'''. Общая информация об упражнениях: ITI0011RUS_Practice.<br/> ...'

Uus lehekülg

Срок сдачи упражнения '''15-е занятие (26 марта)'''.

Общая информация об упражнениях: [[ITI0011RUS_Practice]].<br/>
Обратно на [[ITI0011RUS|страницу предмета]].

== Описание ==

Создать класс <code>BookStore</code>, который зависит от библиотеки <code>BookShopApi</code>, которую можно скачать здесь: [[Meedia:ITI0011-2015-BookStoreApiV02.zip]].
Библиотека BookStoreApi позволяет искать информацию о книгах по их названию или его части.

Например:
<code><BookStoreInstance>.getBookByTitle("Tõde ja Õigus") </code>

возвращает xml документ http://pastebin.com/dSfNCHH8

<code>BookStore</code> должен наследовать класс <code>SimpleBookStore</code>, для использования которого следует подключить <code>BookShopApi</code>.

<code>BookStore</code> должен быть классом, чей конструктор должен принимать в качестве аргумента объект <code>BookShopApi</code>. В классе <code>BookShop</code> должны быть определены 5 методов: <code>getTotalRecordsInResponse</code>, <code>getPossibleBookTitles</code>, <code>getBookWithMostPagesTitle</code>, <code>getPossbileAuthors</code>, <code>query</code>.

* '''getTotalRecordsInResponse''' возвращает из XML результата <code><totalItems>X</totalItems></code> значение X. Если значение отсутствует или getBookByTitle выкинет исключение, следует вернуть значение 0.
* '''getPossibleBookTitles''' возвращает названия всех книг (все значения, находящиеся внутри элементов <code><title></code>). Несколько одинаковых значений разрешается получать. Если значение отсутствует, или <code>getBookByTitle</code> выкидывает исключение, следует вернуть пустой список.
* '''getBookWithMostPagesTitle''', возвращает название книги(<code><title></code>), у которой наибольшее число страниц. Если метод <code>getBookByTitle</code> выкинет исключение, следует вернуть пустую строку (<code>""</code>)
* '''getPossbileAuthors''', возвращает всех авторов найденных книг, при этом следует учитывать, что один и тот же автор может присутствовать в списке только однократно. Автора книги сможете найти между элементами <code><authors></code> . Внимание, элемент <code><authors></code> содержит запись только об одном авторе, в случае, если авторов несколько, в xml будут присутствовать несколько элементов <code><authors></code>. В случае исключения следует вернуть пустой список.
* '''getBookWithLessThanNPagesTitles''' возвращает список названий книг, число страниц которых не превышает значения n. В случае исключения вернуть пустой список.
* '''query''' делает запрос к <code>BookShopApi</code> и и сохраняет результат в поле класса <code>lastResult</code>. В случае исключения значение этого поля должно быть пустой строкой (<code>""</code>).

Полезные материалы:
* http://www.freeformatter.com/xml-formatter.html - для повышения читабельности xml кода.
* http://dom4j.sourceforge.net/dom4j-1.6.1/ - для удобного парсинга xml
* http://en.wikipedia.org/wiki/Regular_expression - при помощи регулярных выражений можно удобно найти необходимые элементы
* http://www.freeformatter.com/xpath-tester.html - позвляет быстро найти все искомые элементы, например <code>//title</code> сразу находит все названия

Создать методы

* <code>public int getTotalRecordsInResponse()</code>
* <code>public ArrayList<String> getPossibleBookTitles()</code>
* <code>public String getBookWithMostPagesTitle()</code>
* <code>public ArrayList<String> getPossibleAuthors()</code>
* <code>public ArrayList<String> getBookWithLessThanNPagesTitles()</code>
* <code>public void query(String search)</code>

Пример вызова BookShopApi:
http://pastebin.com/9DcpBHe7

== Шаблон ==

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>

ITI0011RUS:task 10 - Redigeerimiste ajalugu

Aleksandr: Uus lehekülg: 'Срок сдачи упражнения '''15-е занятие (26 марта)'''. Общая информация об упражнениях: ITI0011RUS_Practice. ...'

Aleksandr: Uus lehekülg: 'Срок сдачи упражнения '''15-е занятие (26 марта)'''. Общая информация об упражнениях: ITI0011RUS_Practice.
...'