------
 Использование сортировки полученных данных
 ------
 Dmitry Samoshin aka gotty
 ------
 2017-01-27
 ------

~~ Copyright (c) 2017. Developed by Hedgecode.
~~
~~ Licensed under the Apache License, Version 2.0 (the "License");
~~ you may not use this file except in compliance with the License.
~~ You may obtain a copy of the License at
~~
~~   http://www.apache.org/licenses/LICENSE-2.0
~~
~~ Unless required by applicable law or agreed to in writing, software
~~ distributed under the License is distributed on an "AS IS" BASIS,
~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
~~ See the License for the specific language governing permissions and
~~ limitations under the License.

~~ NOTE: For help with the syntax of this file, see:
~~ http://maven.apache.org/doxia/references/apt-format.html

Использование сортировки полученных данных

  Данные, получаемые при вызовах API-методов основного интерфейса библиотеки, в большинстве своем
  представляют классы-коллекции (<<<Players>>>, <<<Events>>>, <<<Matches>>>), к которым для удобства
  дальнейшего использования в клиентских приложениях можно применять сортировку по определенным параметрам.

  Ниже перечислены виды возможных сортировок для конкретных классов-коллекций.

===

  <<<Players>>> - класс-сущность, в котором содержится выборка игроков по определенным параметрам.\
  Данный класс предоставляет два вида сортировки:

  <<1.>> Сортировка игроков по имени.

  <<2.>> Сортировка игроков по возрасту, как по убыванию, так и по возрастанию.

  Ниже представлен Java-код, демонстрирующий все вышеуказанные способы сортировки:

+-------
Players players = Snooker.API().getPlayers(...);
...
players.sortByName();
...
players.sortByAge();
players.sortByAgeDesc();
...
+-------

===

  <<<Events>>> - класс-сущность, в котором содержится выборка турниров по определенным параметрам.

  Ниже представлен Java-код, демонстрирующий сортировку турниров по дате:

+-------
Events events = Snooker.API().getSeasonEvents((...);
...
events.sortByDate();
...
+-------

===

  <<<Matches>>> - класс-сущность, в котором содержится выборка матчей по определенным параметрам.\
  Данный класс предоставляет два вида сортировки:

  <<1.>> Сортировка матчей по номеру.\
  Данный тип сортировки будет полезен тогда, когда выборка содержит все матчи отдельно взятого турнира.

  <<2.>> Сортировка матчей по турнирам.\
  Данный тип сортировки будет полезен тогда, когда выборка содержит все матчи отдельно взятого игрока за сезон в разных турнирах.

  Ниже представлен Java-код, демонстрирующий все вышеуказанные способы сортировки:

+-------
Matches matches = Snooker.API().getEventMatches((...);
...
matches.sortByNumber();
...
matches.sortByEvent();
...
+-------