httpapi: форма провода читающих маршрутов объявлена транспортом
- доменные типы internal/catalog лишились json-тегов и MarshalJSON; типы metricWire/layerWire/aggregationWire и перевод catalogWire живут в транспорте, тело отказа тоже получило объявленный тип — байты ответа не изменились - заведён сторож: обход графа типов ответа утверждает, что домен не доезжает до сериализации, плюс требование json-тега на полях транспортных структур и заведомо красные случаи к обоим правилам - решение с ценой обеих сторон записано в architecture.md и ADR; шаг lint в гейте получил свой кеш — общий на машину красил прогон находками из чужого worktree
This commit is contained in:
@@ -158,6 +158,20 @@ func writeJSON(w http.ResponseWriter, status int, v any) {
|
||||
_ = json.NewEncoder(w).Encode(v)
|
||||
}
|
||||
|
||||
// errorWire — форма провода тела отказа, общая для всех маршрутов.
|
||||
//
|
||||
// Объявленный тип, а не `map[string]string`: у читающего маршрута тело отказа
|
||||
// такая же часть публичного контракта, как и успешный ответ, и клиент видит его
|
||||
// чаще. Карта же делает «два ответа совпадают побайтово» свойством библиотеки, а
|
||||
// не решения, и переименование ключа `error` не увидел бы ни один сторож — ни
|
||||
// обход графа типов (карта строк проходит как стандартный тип), ни байтовый
|
||||
// литерал (тел отказа он не закреплял).
|
||||
type errorWire struct {
|
||||
Error string `json:"error"`
|
||||
}
|
||||
|
||||
// writeError отдаёт человекочитаемое сообщение, а не текст ошибки: в тексте
|
||||
// имена колонок и форма запроса.
|
||||
func writeError(w http.ResponseWriter, status int, msg string) {
|
||||
writeJSON(w, status, map[string]string{"error": msg})
|
||||
writeJSON(w, status, errorWire{Error: msg})
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user