Васильев Андрей Михайлович, 2023
Версии презентации
Получение запроса, формирование ответа, отправка ответа клиенту
Вход — запрос от клиента, клиентом может выступать:
Выход — ответ серверного веб-приложения
Клиентское приложение должно всегда получать корректный ответ. Если был составлен некорректный запрос, то серверное приложение должно оповещать об этом
Для каждого случая необходимо подготовить разумную стратегию обработки данных с предоставлением информации об ошибках
fun interface Filter : (HttpHandler) -> HttpHandlerФильтры позволяют выполнить действия, общие для ряда запросов от пользователя:
Фильтр принимает в качестве аргумента HttpHandler и должен вернуть HttpHandler
val handler: HttpHandler = ...
val myFilter = Filter {
next: HttpHandler -> {
request: Request ->
val start = System.currentTimeMillis()
val response = next(request)
val latency = System.currentTimeMillis() - start
println("I took $latency ms")
response
}
}
val latencyAndBasicAuth: Filter = ServerFilters.BasicAuth(
"my realm", "user", "password")
.then(myFilter)
val app: HttpHandler = latencyAndBasicAuth.then(handler)Пакет org.http4k.filter содержит описание фильтров, поставляемых с помощью http4k
Статус NOT_FOUND используется для оповещения пользователя о том, что по указанному запросу данные не были найдены
На уровне фильтра при возникновении ошибки 404 можно сформировать страницу с информацией для пользователя
Подход к реализации:
Рассмотрим наивный подход к реализации такого фильтра
val errorFilter = Filter { next: HttpHandler ->
{ request: Request ->
val response = next(request)
if (response.status.successfull) {
response
} else {
response.body(renderer(ErrorMessage(request)))
}
}
}
val application = errorFilter.then(router)Рассмотрим порядок обработки маршрута с переменной внутри. Стратегия решения проблемы — отображение страниц с деталями информации по ошибкам
class Handler(renderer: TemplateRenderer,
getEntityByData: (Int) -> Entity?) : HttpHandler {
override fun invoke(request: Request) {
val paramemter: String? = request.path("parameter")?.toIntOrNull()
if (parameter == null) {
return Response(UNSATISFIABLE_PARAMETERS).body(
renderer(EmptyParameterRequestFoundVM())
)
}
val entity: Entity? = getEntityByData(parameter)
if (entity == null) {
return Response(NOT_FOUND).body(
renderer(EntityNotFoundVM())
)
}
Response(OK).body(renderer(ShowEntityVM(entity)))
}
}Упростим обработчик, чтобы он выдавал один вид ошибки при разных конкретных деталях ошибки:
class Handler(renderer: TemplateRenderer,
getEntityByData: (Int) -> Entity?) : HttpHandler {
override fun invoke(request: Request) {
return request
.path("parameter")
?.let { parameter ->
getEntityByParameter(parameter)
}?.let { entity ->
Response(OK).body(renderer(ShowEntityVM(entity)))
} ?: Response(NOT_FOUND).body(renderer(EntityNotFoundVM()))
}
}Выполним следующее упрощение: будем возвращать только код 404, а обработку ошибочной ситуации доверим общему фильтру приложения
class Handler(renderer: TemplateRenderer,
getEntityByData: (Int) -> Entity?) : HttpHandler {
override fun invoke(request: Request) {
return request
.path("parameter")
?.let { parameter ->
getEntityByParameter(parameter)
}?.let { entity ->
Response(OK).body(renderer(ShowEntityVM(entity)))
} ?: Response(NOT_FOUND)
}
}Или путём обработки данной ситуации на уровне шаблона Pebble
Разрешаем null-состояние для модели
data class ShowEntityVM(entity: Entity?)Передаём неопределённое состояние в модель
class Handler(renderer: TemplateRenderer,
getEntityByData: (Int) -> Entity?) : HttpHandler {
override fun invoke(request: Request) {
val entity = request
.path("parameter")
?.let { parameter ->
parameter.toIntOrNull()
}?.let { number ->
getEntityByParameter(parameter)
}
return Response(OK).body(renderer(ShowEntityVM(entity)))
}
}Проверка на null в шаблоне Pebble:
{% if model.entity is null %}
...
{% else %}
...
{% endif %}Однако такой подход не следует активно использовать:
В рамках курса такой подход запрещён
Структура URI
[ схема ":" ] [ // источник ] путь [ "?" запрос ] [ "#" фрагмент ]=&http://some.domain/some/path?key1=value1&key2=value2&key3=value3На первый взгляд параметры очень напоминают структуру данных словарь, т.к. состоят из пар ключ-значение
Однако есть важное отличие: клиент может передать несколько параметров с одинаковыми ключами
Для всех данных, которые передаёт пользователь необходимо выполнить две базовые проверки:
Подходы к обработке данной ситуации:
uri, содержащее объект класса Uriquery содержит строку запроса полностьюfun query(query: String): Uri позволяет создать новый объект Uri с новым значением запросаfun queries(): Parameters возвращает набор пар ключ-значенияfun Uri.query(name: String, value: String?): Uri позволяет добавить новый параметр к новому Uri-объектуfun Uri.removeQuery(name: String): Uri позволяет удалить все параметры с указанным ключом, новое состояние сохраняется в возвращаемом объекте типа UriДля установки нового значения для параметра надо сначала удалить старые, а после добавить один новый
val newUri = request.uri.removeQuery("data").query("data", "value")Формы являются частью языка HTML, для их описания используются следующие элементы:
<form method="POST">
<input type="text" name="start">
<textarea name="description">
<input type="submit" value="Отправить">
</form>