Использование

• Cache
• CallAdapter
• Error
• Etag
• Response
• Маппинг сущностей
• Прочее

Cache

Предусмотрена возможность использовать URL-кеш. Также есть возможность реализовать кеширование объектов с сохранением в файловое хранилище.

CallAdapter

Конвертирует ответы сервера в Observable а также оборачивает ошибки в соответветствующий инстанс иерархии NetworkException

BaseCallAdapterFactory - кроме конвертирования запроса в Observable, выполняет следующие функции: - Конвертирует IOException в NoConnectionException - Конвертирует EOFException в NoContentException - Конвертирует HttpException в HttpError

Для использования в проекте необходимо создать класс-наследник. И передать его в Retrofit.Builder.

Для пробрасывания своих типов исключений можно переопределить onHttpException().

Error

Предоставляет набор исключений для часто возникабщих ошибок при работе с сетью. Все ошибки имеют общего предка - NetworkException

• ConversionException
• CacheEmptyException
• HttpError
  • NotModifiedException
• NoInternetException

Etag

Предоставляет поддержку механизма Etag. Служит признаком того, что данные на сервере изменились.

Response

BaseResponse маркерный интерфейс который обозначает классы, которые используются для парсинга корневой сущности ответа.

Маппинг сущностей

Transformable и TransformableUtil, ObservableExtension - Интерфейс и набор утилит для конвертации объекта/потока одного класса в другой. Основное применение маппинг серверных ответов.

Прочее

• BaseNetworkInteractor - Интерактор для работы с сетью. Основная задача упростить взаимодействие с закешированными ответами и ответами сервера, путем создания гибридных запросов.