moko-network

В контексте форм нам нужно разобраться с классом ExceptionFactory, который отвечает за обработку ошибок запросов. Он позволяет установить парсеры для обработки различных ошибок, которые может вернуть сервер.
Для работы с формами ввода нас будет интересовать конкретная ошибка, с кодом 422 - ошибка валидации.

Используя библиотеку, мы легко сможем получить от сервера поле и текст ошибки валидации.

ExceptionFactory

Для создания объекта ExceptionFactory нам необходимо указать два параметра, а именно defaultParser и customParsers.

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

Например, для ошибки валидации и конкретного JSON объекта от сервера в библиотеке уже реализован ValidationExceptionParser.

Из его кода видно, что парсер подходит для JSON объектов, выглядящих следующим образом:

[
  {
    "message": "password used earlier",
    "field": "password"
  }
]

Если создавать новый проект, используя шаблон то там уже будет готовый httpClient, с настроенной ExceptionFactory, использующей как раз парсеры из библиотеки - дефолтный ErrorExceptionParser и ValidationExceptionParser для ошибок валидации.

Для создания собственного парсера необходимо:

• создать класс-наследник интерфейса HttpExceptionFactory.HttpExceptionParser
• реализовать метод parseException
• использовать ваш кастомный парсер при создании ExceptionFactory

Допустим, нам понадобилось обработать следующий объект:

{
  "validation": [
    {
      "message": "password used earlier",
      "field": "password"
    }
  ]
}

Вот как выглядел бы наш кастомный класс парсера:

class MyValidationExceptionParser(
    private val json: Json
) : HttpExceptionFactory.HttpExceptionParser {

    override fun parseException(
        request: HttpRequest,
        response: HttpResponse,
        responseBody: String?
    ): ResponseException? {
        return runCatching {
            val body: String = responseBody.orEmpty()
            val validationResponse: ValidationResponse =
                json.decodeFromString(ValidationResponse.serializer(), body)
            ValidationException(
                request = request,
                response = response,
                message = body,
                errors = validationResponse.validation.map { (field, message) ->
                    ValidationException.Error(
                        field = field,
                        message = message
                    )
                }
            )
        }.getOrNull()
    }

    @Serializable
    private data class ValidationResponse(
        val validation: List<Error>
    ) {
        @Serializable
        data class Error(
            val field: String,
            val message: String
        )
    }
}

Практическое задание

Добавьте свою реализацию парсера для обработки объекта, который приходит от GitHub REST API при ошибке валидации.