REST-архитектура, отправка данных на сервер

REST-архитектура и отправка данных на сервер #

REST-архитектура #

Презентацию по теме можно посмотреть по ссылке.

Видео-запись: Rutube

Отправка данных на сервер #

Презентацию по теме можно посмотреть по ссылке.

Видео-запись: Rutube

Документация #

Задание № 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"
}

© A. M. Васильев, 2026, CC BY-SA 4.0, andrey@crafted.su