Sprint 9 solution http api by DokPlay · Pull Request #9 · DokPlay/java-kanban

DokPlay · 2025-08-18T00:33:22Z

Fix

Почистил комментарии по проекту: упростил формулировки, убрал «украшения», оставил только смысл.
Вынес общие хелперы HTTP: HttpUtil.isNewId, HttpUtil.parseIdOrNull; удалил дубли приватных методов в хендлерах.
Хендлеры (TasksHandler, SubtasksHandler, EpicsHandler):
- убраны локальные get/post/delete/firstId.../client,
- перешёл на import static http.TestHttpUtils.* в тестах,
- ловим NotFoundException → возвращаем 404, пересечения времени → 406.
Менеджер (InMemoryTaskManager):
- get*/update*/remove* кидают NotFoundException,
- addNewSubtask кидает NotFoundException("epic X not found"),
- фиксы приоритезации: переиндексация и удаление по id.
FileBackedTaskManager:
- CSV расширен: durationMinutes, startTime (ISO),
- восстановление через put*PreserveId + setNextIdAfterRestore(maxId+1).
Тесты:
- перенёс всё в src/test/java, удалил старые пути,
- обновил HTTP-тесты под новые хелперы и 404/406,
- базовый тест BaseHttpTest поддерживает внешний сервер через -DBASE_URL.

TestHttpUtils (тестовые хелперы)

Единая обёртка над HttpClient для тестов: меньше шума и дублирования.
Методы (static, импортируются через import static http.TestHttpUtils.*):
- get(baseUrl, path)
- post(baseUrl, path, json) — ставит Content-Type: application/json
- delete(baseUrl, path)
- firstIdFromArray(jsonArrayString) — быстрый парс первого id из JSON-массива.
Не завязан на сервере/менеджере, работает только по HTTP; baseUrl берётся из BaseHttpTest.
Результат — компактные и читаемые тесты без локальных дубликатов get/post/delete.

Поведение API (кратко)

404 Not Found — если сущность с {id} не существует (для GET/POST(обновление)/DELETE на /tasks|/epics|/subtasks/{id}).
406 Not Acceptable — при пересечении по времени для POST/обновления tasks|subtasks.
Формат данных:
startTime — ISO yyyy-MM-dd'T'HH:mm[:ss],
duration — минуты (целое число).

Проверка “пересечения” (Windows `cmd.exe`)

REM 10:00–10:10
curl -i -X POST http://localhost:8080/tasks ^
 -H "Content-Type: application/json" ^
 -d "{\"title\":\"T1\",\"description\":\"\",\"status\":\"NEW\",\"startTime\":\"2035-01-01T10:00:00\",\"duration\":10}"

REM попытка наложиться 10:05–10:20 → ожидаем 406
curl -i -X POST http://localhost:8080/tasks ^
 -H "Content-Type: application/json" ^
 -d "{\"title\":\"Clash\",\"description\":\"\",\"status\":\"NEW\",\"startTime\":\"2035-01-01T10:05:00\",\"duration\":15}"

полезно для контроля:

curl -s http://localhost:8080/prioritized
curl -s http://localhost:8080/tasks

Зачем

меньше дублирования кода,
явная семантика ошибок на уровне менеджера,
чище и короче тесты, единый стиль комментариев.

Sprint 9: HTTP API for Kanban Tracker

Цель: открыть функциональность TaskManager по HTTP. Пользователь может работать с задачами, подзадачами, эпиками, историей и приоритезированным списком через REST.

Что сделано

Добавлен HTTP-сервер HttpTaskServer (порт по умолчанию 8080, поддержка запуска на произвольном порту в тестах).
Хендлеры:
- /tasks — GET, POST, DELETE /{id}
- /subtasks — GET, POST, DELETE /{id}
- /epics — GET, POST, DELETE /{id}, а также GET /epics/{id}/subtasks
- /history — GET
- /prioritized — GET
Базовый класс хендлеров BaseHttpHandler с единообразной отправкой ответов: 200/201/404/406/500.
JSON через Gson (library/gson-2.11.0.jar в репозитории). Адаптеры:
- LocalDateTime ↔ ISO-строка (yyyy-MM-dd'T'HH:mm:ss)
- Duration ↔ миллисекунды
Улучшения менеджера:
- устранены дубли в /prioritized при add/update/remove;
- корректная очистка при удалении задач/сабов/эпиков; пересчёт эпиков.
Модели:
- Epic — безопасная работа со списком сабтасков, пересчёт статуса/времени/длительности;
- Subtask — удобные конструкторы с Duration и LocalDateTime.
Тестовая инфраструктура:
- BaseHttpTest — автоподнятие локального сервера на свободном порту (0) + поддержка -DBASE_URL=http://localhost:8080 для прогона против внешнего инстанса.
- Интеграционные тесты для всех эндпоинтов, включая проверку 406 на пересечения и уникальность в /prioritized.

Карта API

Задачи
- GET /tasks — список
- GET /tasks/{id} — по id
- POST /tasks — создать/обновить (если id отсутствует — create; иначе update)
- DELETE /tasks/{id} — удалить
Подзадачи
- GET /subtasks
- GET /subtasks/{id}
- POST /subtasks
- DELETE /subtasks/{id}
Эпики
- GET /epics
- GET /epics/{id}
- POST /epics
- DELETE /epics/{id}
- GET /epics/{id}/subtasks — все сабтаски эпика
История/приоритет
- GET /history
- GET /prioritized

Коды ответа

200 OK — успешный запрос с телом
201 Created — успешный POST без сущности в ответе
404 Not Found — объект или путь не найдены
406 Not Acceptable — пересечение по времени
500 Internal Server Error — иные ошибки обработки

Примеры запросов (curl)

# создать задачу
curl -X POST http://localhost:8080/tasks \
  -H "Content-Type: application/json" \
  -d '{"name":"Demo","description":"via HTTP","status":"NEW","duration":600000,"startTime":"2035-01-01T10:00:00"}'

# получить все эпики
curl http://localhost:8080/epics

# сабтаски эпика 1
curl http://localhost:8080/epics/1/subtasks

Как запускать

Из IDE: http.HttpTaskServer.main().
Файл tasks.csv создаётся при первом изменении данных и пишется в Working directory.
Тесты:
- по умолчанию поднимается временный сервер на порту 0 (чистое окружение);
- для прогона против запущенного инстанса добавь VM-опцию:
```
-DBASE_URL=http://localhost:8080
```

Замечания по совместимости

Изменений, ломающих формат CSV, нет; FileBackedTaskManager продолжает работать.
Авторизация/конкурентный доступ не реализованы — планируется отдельно.

Проверено

Ручные проверки curl/Postman.
Интеграционные тесты для всех эндпоинтов: CRUD-сценарии, ошибки 404/406, сортировка /prioritized, заполнение /history.

…history,/prioritized (sprint 9)

…ектно чистить по id (sprint 9)

…ackedTaskManager(...)

…безопасная работа с сабами/пересчёт; Task — косметика

…держка -DBASE_URL

…роверка 201/200/404/406 и уникальности в prioritized

LexLippi

Привет!

Неплохая работа!

Есть некоторое количество замечаний, которые необходимо исправить!

Желаю удачи!

LexLippi · 2025-08-18T14:14:24Z

+  /* ===== helpers ===== */
+
+  private HttpResponse<String> get(String path) throws IOException, InterruptedException {
+    return client()
+        .send(
+            HttpRequest.newBuilder(URI.create(baseUrl + path)).GET().build(),
+            HttpResponse.BodyHandlers.ofString());
+  }
+
+  private HttpResponse<String> post(String path, String body)
+      throws IOException, InterruptedException {
+    return client()
+        .send(
+            HttpRequest.newBuilder(URI.create(baseUrl + path))
+                .header("Content-Type", "application/json")
+                .POST(HttpRequest.BodyPublishers.ofString(body))
+                .build(),
+            HttpResponse.BodyHandlers.ofString());
+  }
+
+  private HttpResponse<String> delete(String path) throws IOException, InterruptedException {
+    return client()
+        .send(
+            HttpRequest.newBuilder(URI.create(baseUrl + path)).DELETE().build(),
+            HttpResponse.BodyHandlers.ofString());
+  }


Эти хелперы очень похожи лучше выгести их в отдельный утилитарный класс, чтобы не копипастить

LexLippi · 2025-08-18T14:14:48Z

+  private static int firstIdFromArray(String json) {
+    JsonArray arr = JsonParser.parseString(json).getAsJsonArray();
+    JsonObject o = arr.get(0).getAsJsonObject();
+    return o.get("id").getAsInt();
+  }
+
+  private static HttpClient client() {
+    return HttpClient.newHttpClient();
+  }


Аналогично эти методы тоже хочется куда-то вынести, чтобы не копипастить

LexLippi · 2025-08-18T14:16:36Z

-                dur,
-                st,
-                "" // epic
+  protected int id;


Лучше не совмещать такие коммиты в одном PR.
Часто в рабочих проектах есть отдельные задачи на форматирование кода и их не объединяют с другими, чтобы не захламлять осмысленные PR украшательствами всех файлов проекта, потому что в случае необходимости откатить изменения нам придется откатывать много чего лишнего (что может сказаться на скорости)

LexLippi · 2025-08-18T14:20:21Z

+    return id == null || id == 0;
+  }
+
+  private Integer parseId(String s) {


Этот метод может быть статическим и лучше вынести его в отдельный класс с утилитами

Стоит назвать его поконкретнее, например parseIdWithoutException

LexLippi · 2025-08-18T14:20:38Z

+    sendOk(exchange, "\"deleted\"");
+  }
+
+  private boolean isNewId(Integer id) {


Аналогичное замечание, как и к методу ниже

LexLippi · 2025-08-18T14:22:19Z

+        manager.addNewTask(incoming);
+        sendCreated(exchange);
+      } else {
+        // sprint9: обновляем ТОЛЬКО существующую задачу — иначе 404


Эту логику лучше не накладывать на хэндлер, а имплементировать ее внутри менеджера. Например, выбрасывать исключение, если не нашли обновляемую задачу, а здесь это исключение перебрасывать в sendNotFound

LexLippi · 2025-08-18T14:23:05Z

+      if (task == null) {
+        sendNotFound(exchange, "task " + id + " not found");
+      } else {
+        sendOk(exchange, gson.toJson(task));
+      }


Аналогично, лучше такую логику реализовывать на уровне менеджера

LexLippi · 2025-08-18T14:23:23Z

+  private boolean isNewId(Integer id) {
+    return id == null || id == 0;
+  }
+
+  private Integer parseId(String s) {
+    try {
+      return Integer.parseInt(s);
+    } catch (NumberFormatException e) {
+      return null;
+    }
+  }


про это уже писал

LexLippi

Привет!

Хорошая работа!

Желаю удачи в следующих спринтах!

Sergey added 8 commits August 18, 2025 03:21

chore(deps): add Gson 2.11.0 jar to library/ for JSON in HTTP API

684a8f1

feat(http): HttpTaskServer + REST эндпоинты /tasks,/subtasks,/epics,/…

8191c72

…history,/prioritized (sprint 9)

fix(manager): убрать дубли в prioritized при апдейтах/удалениях; корр…

8c7b27b

…ектно чистить по id (sprint 9)

feat(manager): фабрика getDefault()/getInMemoryTaskManager()/getFileB…

afa6bb0

…ackedTaskManager(...)

feat(model): Subtask — конструкторы c Duration/LocalDateTime; Epic — …

c96d390

…безопасная работа с сабами/пересчёт; Task — косметика

test: BaseHttpTest — автоподнятие локального сервера на порту 0 + под…

16d28fb

…держка -DBASE_URL

test(http): покрытие /tasks,/subtasks,/epics,/history,/prioritized; п…

8fcc5b9

…роверка 201/200/404/406 и уникальности в prioritized

chore(style): add .editorconfig

44f6f5c

LexLippi suggested changes Aug 18, 2025

View reviewed changes

Sergey added 21 commits August 19, 2025 00:05

add: NotFoundException

4b66339

add: HttpUtil

5d76c96

add: InMemoryTaskManagerTest

5fc74e6

rename: BaseHttpTest

b5170dc

test: add HttpTaskServerEpicsTest

2518c65

test: add HttpTaskServerHistoryPrioritizedTest

f533336

test: add HttpTaskServerSubtasksTest

ff1c46d

test: add HttpTaskServerTasksTest

f1dd37a

test: add PrioritizedUniquenessTest

7347ac2

test: add TestHttpUtils

fd58de5

test: add EpicStatusTest

fcd0a42

test: add FileBackedLegacyFormatTest

47ea2f7

test: add FileBackedRoundTripTest

4b880cb

test: add FileBackedTaskManagerTest

93e0507

test: add InMemoryHistoryManagerTest

5582cef

test: add PrioritizedViewTest

22203a2

test: add TaskManagerTest

9f29198

test: rm HttpTaskServerEpicsTest(old)

6e8245e

test: rm HttpTaskServerHistoryPrioritizedTest(old)

854a7d1

test: rm HttpTaskServerSubtasksTest(old)

6762b16

test: rm HttpTaskServerTasksTest(old)

82da53a

Sergey added 24 commits August 19, 2025 00:05

test: rm PrioritizedUniquenessTest(old)

0915d16

test: rm EpicStatusTest(old)

6876e44

test: rm FileBackedLegacyFormatTest(old)

58b6191

test: rm FileBackedRoundTripTest(old)

6934811

test: rm FileBackedTaskManagerTest(old)

1f1ffea

test: rm InMemoryHistoryManagerTest(old)

16c91be

test: rm InMemoryTaskManagerTest(old)

65ad3fc

test: rm PrioritizedViewTest(old)

3b2e83f

test: rm TaskManagerTest(old)

9093612

mod: Main

83bb0e5

mod: TaskValidationException

1340fa8

mod: EpicsHandler

27c577a

mod: SubtasksHandler

5c27ee2

mod: TasksHandler

67c86e3

mod: FileBackedTaskManager

562db7b

mod: HistoryManager

1a48913

mod: InMemoryHistoryManager

f923aa8

mod: InMemoryTaskManager

9935346

mod: ManagerSaveException

a06808c

mod: TaskManager

7663e14

mod: Status

d9c1a78

mod: TaskType

ea7c9ec

mod: CsvUtils

bf603eb

tests: move to src/test/java

016b52b

LexLippi approved these changes Aug 19, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Sprint 9 solution http api#9

Sprint 9 solution http api#9
DokPlay wants to merge 53 commits intosprint_8-solution-time-and-durationfrom
sprint_9-solution-http-api

DokPlay commented Aug 18, 2025 •

edited

Loading

Uh oh!

LexLippi left a comment

Uh oh!

LexLippi Aug 18, 2025

Uh oh!

LexLippi Aug 18, 2025

Uh oh!

LexLippi Aug 18, 2025

Uh oh!

LexLippi Aug 18, 2025

Uh oh!

LexLippi Aug 18, 2025

Uh oh!

LexLippi Aug 18, 2025

Uh oh!

LexLippi Aug 18, 2025

Uh oh!

LexLippi Aug 18, 2025

Uh oh!

LexLippi left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

DokPlay commented Aug 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Fix

TestHttpUtils (тестовые хелперы)

Поведение API (кратко)

Проверка “пересечения” (Windows cmd.exe)

Зачем

Sprint 9: HTTP API for Kanban Tracker

Что сделано

Карта API

Коды ответа

Примеры запросов (curl)

Как запускать

Замечания по совместимости

Проверено

Uh oh!

LexLippi left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

LexLippi left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

DokPlay commented Aug 18, 2025 •

edited

Loading

Проверка “пересечения” (Windows `cmd.exe`)