Gin

Gin предлагает набор возможностей, ориентированных на скорость разработки и производительность готовых приложений^[3].

• Маршрутизация — фреймворк использует древовидную структуру Radix (задействованную в httprouter) для быстрой обработки URL-путей, поддерживает параметры, подстановки и группировку маршрутов^[2].
• Промежуточное ПО (middleware) — встроенные модули для логирования, восстановления после паники, обработки ошибок, аутентификации и CORS; разработчик может подключать собственные middleware-функции^[1].
• Обработка ошибок — централизованный механизм позволяет задавать единообразные ответы и коды состояния HTTP при возникновении ошибок^[1].
• Валидация запросов — поддержка валидации через теги структур Go; правила проверяются автоматически до входа обработчика^[1]
• Рендеринг ответов — штатная сериализация в JSON, XML, HTML и обычный текст без внешних зависимостей^[1]
• Группировка маршрутов — вложенные группы помогают организовывать API по версиям или назначению, не влияя на производительность.^[2]..
• Crash-free безопасность — встроённое middleware Recovery перехватывает паники и предотвращает прекращение работы сервера^[3].
• Высокая производительность — низкие накладные расходы памяти и активное использование возможностей параллелизма Go обеспечивают высокую пропускную способность и малую задержку обработки запросов^[1]

Ниже приведён минимальный пример приложения, возвращающего JSON-ответ «Hello, World!» при обращении к корневому маршруту:

package main
import (
	"github.com/gin-gonic/gin"
	"net/http"
)
func main() {
	router := gin.Default()          // включает Logger и Recovery middleware
	router.GET("/", func(c *gin.Context) {
		c.JSON(http.StatusOK, gin.H{
			"message": "Hello, World!",
		})
	})
	router.Run(":8080")              // запускает сервер на порту 8080
}

^[4]. Для запуска достаточно установить Gin командой go get -u github.com/gin-gonic/gin, затем выполнить go run main.go и перейти по адресу http://localhost:8080.

Следующий пример демонстрирует реализацию простого in-memory CRUD API для сущности Item. Проект включает модель, обработчики и настройку маршрутов:

your-project/
├── main.go            // точка входа
├── models/            // структуры данных
│   └── item.go
├── handlers/          // HTTP-обработчики
│   └── item_handler.go
└── go.mod

Основные шаги:

1. Инициализация проекта

go mod init your-module-name

1. Установка Gin

go get github.com/gin-gonic/gin

1. Определение модели — структура Item с полями ID и Name.
2. Реализация обработчиков GET, POST, PUT, DELETE в пакете handlers.
3. Настройка маршрутов в main.go с помощью группировки /items и запуск сервера

router.Run(":8080") После запуска к API можно обращаться, например, командой curl http://localhost:8080/items — список всех элементов^[5][6].