2 Использование сортировки полученных данных
4 Dmitry Samoshin aka gotty
9 ~~ Copyright (c) 2017-2020. Developed by Hedgecode.
11 ~~ Licensed under the Apache License, Version 2.0 (the "License");
12 ~~ you may not use this file except in compliance with the License.
13 ~~ You may obtain a copy of the License at
15 ~~ http://www.apache.org/licenses/LICENSE-2.0
17 ~~ Unless required by applicable law or agreed to in writing, software
18 ~~ distributed under the License is distributed on an "AS IS" BASIS,
19 ~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
20 ~~ See the License for the specific language governing permissions and
21 ~~ limitations under the License.
23 ~~ NOTE: For help with the syntax of this file, see:
24 ~~ http://maven.apache.org/doxia/references/apt-format.html
26 Использование сортировки полученных данных
28 Данные, получаемые при вызовах API-методов основного интерфейса библиотеки, в большинстве своем
29 представляют классы-коллекции (<<<Players>>>, <<<Events>>>, <<<Matches>>>), к которым для удобства
30 дальнейшего использования в клиентских приложениях можно применять сортировку по определенным параметрам.
32 Ниже перечислены виды возможных сортировок для конкретных классов-коллекций.
36 <<<Players>>> - класс-сущность, в котором содержится выборка игроков по определенным параметрам.\
37 Данный класс предоставляет два вида сортировки:
39 <<1.>> Сортировка игроков по имени.
41 <<2.>> Сортировка игроков по возрасту, как по убыванию, так и по возрастанию.
43 Ниже представлен Java-код, демонстрирующий все вышеуказанные способы сортировки:
46 Players players = Snooker.API().getPlayers(...);
51 players.sortByAgeDesc();
57 <<<Events>>> - класс-сущность, в котором содержится выборка турниров по определенным параметрам.
59 Ниже представлен Java-код, демонстрирующий сортировку турниров по дате:
62 Events events = Snooker.API().getSeasonEvents((...);
70 <<<Matches>>> - класс-сущность, в котором содержится выборка матчей по определенным параметрам.\
71 Данный класс предоставляет два вида сортировки:
73 <<1.>> Сортировка матчей по номеру.\
74 Данный тип сортировки будет полезен тогда, когда выборка содержит все матчи отдельно взятого турнира.
76 <<2.>> Сортировка матчей по турнирам.\
77 Данный тип сортировки будет полезен тогда, когда выборка содержит все матчи отдельно взятого игрока за сезон в разных турнирах.
79 Ниже представлен Java-код, демонстрирующий все вышеуказанные способы сортировки:
82 Matches matches = Snooker.API().getEventMatches((...);
84 matches.sortByNumber();
86 matches.sortByEvent();