Напишите HTTP-обработчик, который вернет книгу по id в JSON или 404, и проверьте его через httptest без запуска сервера
Проверила команда Сопровод · Обновлено
Короткий ответ
Зарегистрируйте обработчик на http.ServeMux с шаблоном GET /books/{id} и достаньте id через r.PathValue("id"). Нечисловой id — ответ 400 через http.Error, книги нет — 404, иначе поставьте Content-Type и закодируйте книгу через json.NewEncoder. В тесте создайте httptest.NewRecorder() и запрос httptest.NewRequest и вызовите mux.ServeHTTP: сеть не нужна.
Почему этот вопрос задают
Почти каждый Go-сервис отдает JSON по HTTP, и Junior пишет такие обработчики с первой недели. Задача показывает, знает ли кандидат коды ответа и порядок записи ответа и умеет ли он тестировать обработчик без сервера.
Условие задачи
Городская библиотека открывает каталог через API. Книги лежат в map[int]string: id и название. Напишите обработчик GET /books/{id}: книга есть — код 200 и JSON с полями id и title, книги нет — 404, id не число — 400. Проверьте обработчик через httptest без запуска сервера на трех запросах: книга 2, книга 9 и id abc.
Как подойти к решению
- Зарегистрируйте обработчик на своем
http.ServeMuxс методом и шаблоном пути - Достаньте id через
r.PathValueи переведите его в число черезstrconv.Atoi - Разведите ответы: 400 для нечислового id, 404 для неизвестной книги, 200 для найденной
- Поставьте заголовок
Content-Typeдо записи тела, иначе он не попадет в ответ - Прогоните запросы через
httptest.NewRecorderи проверьте код и тело ответа
Решение
Шаблоны с методом и {id} появились в ServeMux в Go 1.22, сторонний роутер для них не нужен. http.Error сам ставит текстовый Content-Type и код ответа, а в ветке успеха код 200 выставит первая запись тела. Рекордер хранит код и тело в памяти, поэтому тест не открывает порт. Каталог для краткости лежит в обработчике, в сервисе его передают снаружи.
func getBook(w http.ResponseWriter, r *http.Request) {
books := map[int]string{1: "Мастер и Маргарита", 2: "Тихий Дон", 3: "Обломов"}
if id, err := strconv.Atoi(r.PathValue("id")); err != nil {
http.Error(w, "id должен быть числом", http.StatusBadRequest)
} else if title, ok := books[id]; !ok {
http.Error(w, "книга не найдена", http.StatusNotFound)
} else {
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(map[string]any{"id": id, "title": title})
}
}
func main() {
mux := http.NewServeMux()
mux.HandleFunc("GET /books/{id}", getBook)
for _, path := range []string{"/books/2", "/books/9", "/books/abc"} {
rec := httptest.NewRecorder()
mux.ServeHTTP(rec, httptest.NewRequest(http.MethodGet, path, nil))
fmt.Print(rec.Code, " ", rec.Body)
}
}200 {"id":2,"title":"Тихий Дон"}
404 книга не найдена
400 id должен быть числомЧто спросят следом
Что ответит сервер на
POST /books/2?Как проверить заголовки и тело ответа надежнее, чем сравнением строки?
Как отдавать ошибки тоже в JSON?
Доступно по подписке
Ответы на эти вопросы
Частые ошибки
«Сначала запишу JSON, а если что, потом вызову
WriteHeader(404)»Первая запись тела сама отправляет код 200, и поздний
WriteHeaderуже ничего не меняет. Решите, какой будет код, до того как писать тело«На
abcотвечу 404: такой книги ведь нет»Нечисловой id — ошибка в запросе клиента, и ему поможет 400 с понятным текстом. 404 оставьте для правильного id, по которому книги нет. Так клиент поймет, нужно ли ему исправлять запрос
«Для теста подниму сервер на
:8080и схожу в него клиентом»Порт может быть занят, тест медленнее и зависит от окружения. Для логики обработчика хватит
httptest.NewRecorder, вызовServeHTTPидет в памяти.httptest.NewServerберите, когда проверяете клиента или транспорт«Зарегистрирую обработчик через
http.HandleFunc, так короче»Так он попадет в общий
http.DefaultServeMux, куда регистрируют обработчики и сторонние пакеты, напримерnet/http/pprof. Создайте свойhttp.NewServeMux()и передайте его серверу и тестам
Сигналы для интервьюера
Сильный ответ
Разводит 400 и 404 еще до того, как пишет код, держит обработчик отдельно от регистрации и сам предлагает табличный тест на все три случая
Тревожный сигнал
Разбирает путь вручную через strings.Split(r.URL.Path, "/") и не знает, что ServeMux с Go 1.22 понимает шаблоны
Красный флаг
Отвечает кодом 200 с полем error в теле на любую ошибку и не понимает, зачем клиенту коды ответа
Как еще могут спросить
- Как написать REST-обработчик на стандартной библиотеке Go?
- Как протестировать HTTP-обработчик в Go без запуска сервера?
- Как достать параметр из пути запроса в
net/http? - Напишите метод API, который отдает запись по id в JSON











