ITI0011RUS:task 10

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

Общая информация об упражнениях: ITI0011RUS_Practice.
Обратно на страницу предмета.

Описание

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

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

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

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

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

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

Полезные материалы:

• 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 - позвляет быстро найти все искомые элементы, например //title сразу находит все названия

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

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

Пример вызова 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>