Фоновая служба

Фоновая служба#

GsForegroundService выполняет периодическую работу с отдельной GsSession и постоянным системным уведомлением Она не создаёт StateManager, состояние, контроллер представления или навигатор Жизненный цикл службы не зависит от окна приложения

Ответственность базового класса#

  • Вызывает startForeground до чтения настроек и сетевых запросов, в том числе при повторном запуске

  • При повторном запуске не создаёт второй рабочий поток и сессию

  • При восстановлении с intent == null заново начинает работу

  • Создаёт собственную сессию на выделенном потоке, реестр зависимостей получает из GsRegistryBootstrap

  • Последовательно вызывает doWork(session) и awaitNextIteration(session)

  • После успешного прохода вызывает commit(), при ошибке или отмене - rollback()

  • Отменяет работу через InterruptingLock и закрывает сессию на её рабочем потоке

  • В onDestroy и onTimeout останавливается без ожидания рабочего потока на главном

Прикладная служба#

Наследник задаёт системное уведомление, его тип и интервал проверки Хранилище настроек предоставляет через provideDataStore(), работу описывает в doWork(session) Возврат false завершает службу, true продолжает цикл

По умолчанию awaitNextIteration ждёт intervalMillis Наследник может переопределить ожидание, например чтобы изменение интервала в настройках сразу вступало в силу

В EAM PushService проверяет настройку serviceState в начале прохода Для получения уведомлений использует EamPushTransportPkg из собственной сессии После системного показа передаёт данные экрану через внешнее событие

Сессия и потоки#

doWork допускает приостановку выполнения для работы с хранилищем настроек Базовый класс вызывает его через runBlocking на выделенном потоке После приостановки продолжение возвращается на этот же поток, сессия и её транзакции не меняют владельца

Нельзя запускать параллельные задачи с доступом к этой сессии Нельзя подставлять сессию окна приложения или основного StateManager Доступ к контроллерам экранов и навигации из службы не предоставляется В EAM показ системных уведомлений выполняется на главном потоке

Доступ к БД#

По умолчанию БД не подключена к сессии службы provideDatabase() нужен только службам с собственным сценарием работы с БД

Служба уведомлений EAM не записывает историю в БД и не подключает Room к своей сессии Она отдельно читает зафиксированные отметки прочтения через EamNotificationDao, чтобы не показывать прочитанное повторно Сохранение уведомлений выполняется задачей состояния через его сессию

Общая RoomDatabase сама по себе не согласует транзакции службы и основного StateManager Совместная работа с БД и FileManager требует отдельного согласования транзакций и файловых операций

Остановка и отмена запросов#

Остановку отправляют через Context.stopService, а не через startForegroundService с командой остановки

При отмене BaseRestGate отменяет сетевой запрос OkHttp Call и закрывает ответ, пришедший после отмены Подписка на отмену сохраняется до закрытия тела ответа При получении ответа Response напрямую вызывающий код обязан закрыть его через use

См также: сессия, хранение данных

Содержание