REST-архитектура и отправка данных на сервер #
REST-архитектура #
Презентацию по теме можно посмотреть по ссылке.
Видео-запись: Rutube
Отправка данных на сервер #
Презентацию по теме можно посмотреть по ссылке.
Видео-запись: Rutube
Документация #
- Перечисление
Method, http4k - Метод
Request.form, http4k - Класс
Parameters(псевдонимForm), http4k - Класс
ContentType, http4k - Класс
Statusи коды ответа, http4k - Метод
ObjectMapper.writeValueAsString, Jackson - Метод
Request.bodyString, http4k
Задание № 1. Использование POST-запроса для создания треугольника #
В занятии «Хранение и редактирование данных» создание треугольника выполнялось
GET-запросом по пути /v1/triangles/new-one. Измените тип запроса по этому
пути с GET на POST: добавьте запись вида
"/v1/triangles/new-one" bind Method.POST to newTriangleHandler() в
маршрутизатор приложения.
Выполните POST-запрос по данному пути и убедитесь, что приложение его обработало. HTTP-обработчик должен вернуть код 200 и тело с идентификатором созданного треугольника, как и прежде. Новый треугольник должен появиться в списке треугольников.
Выполните GET-запрос по данному пути. Приложение должно ответить кодом 404 на обращение к несуществующему маршруту, новый треугольник не должен был создан.
Задание № 2. Передача параметров по созданию пользователя в теле #
Реализуйте обработчик по добавлению нового пользователя по пути /v2/user.
На данный адрес клиент должен высылать POST-запрос с данными в формате
application/x-www-form-urlencoded. Должны передаваться 2 параметра:
Login, уникальное имя пользователя, не может быть пустым.Email, электронная почта пользователя, не может быть пустой.
Если были переданы не все требующиеся поля или хотя бы одно из полей передано не
корректно, то приложение должно вернуть ответ с кодом 400, заголовком
Content-Type: application/json и JSON-документом, в котором описаны ошибки
полей.
Ключом верхнего уровня является название поля с ошибкой. В документ попадают
только поля, для которых обнаружена ошибка. Свойство Value содержит значение,
переданное клиентом (для отсутствующего поля — пустую строку), свойство Error
— описание ошибки.
Пример документа для запроса, в котором передан только некорректный Login:
{
"Login": {
"Value": "user@name",
"Error": "Имя пользователя содержит запрещённые символы"
}
}Если данные были переданы верно, но пользователь с таким именем учётной записи (Login) уже существует, то приложение должно вернуть ответ с кодом 409.
Если данные верны и нет логических проблем, то приложение должно создать новую учётную запись. Для этого:
- создайте класс данных
Userсо свойствамиId(UUID),Login(String) иEmail(String),RegistrationDateTime(LocalDateTime); - создайте класс-хранилище
UserStorageпо образцу классаTriangleStorage(занятие «Хранение и редактирование данных») с функциямиlist,addи функцией поиска пользователя по логину; - заполните свойство
IdзначениемUUID.randomUUID(), свойствоRegistrationDateTime— текущими датой и временем; - сохраните созданного пользователя в хранилище. Сохранение пользователей в CSV-документ в рамках этой задачи не требуется.
В качестве успешного ответа приложение должно вернуть код 201, в качестве тела необходимо вернуть JSON-документ, который содержит идентификатор созданного пользователя
{
"Id":"de42a00f-7f43-4d10-808d-bee47fdeef49"
}