Grupos
kori.Group cria um sub-router com um prefixo de URL compartilhado e middlewares opcionais.
Criando grupos
Seção intitulada “Criando grupos”func Group(r chi.Router, prefix string, middlewares ...Middleware) *kori.RouterPasse um chi.Router e um prefixo. O *kori.Router retornado incorpora chi.Router, portanto é um router válido para registros e aninhamentos posteriores.
api := kori.Group(r, "/api")
kori.GET(api, "/users", listUsers) // GET /api/userskori.POST(api, "/users", createUser) // POST /api/usersPrefixos compartilhados
Seção intitulada “Prefixos compartilhados”Rotas registradas em um grupo herdam seu prefixo automaticamente:
r := chi.NewRouter()
api := kori.Group(r, "/api")users := kori.Group(api, "/users")products := kori.Group(api, "/products")
kori.GET(users, "", listUsers) // GET /api/userskori.GET(users, "/{id}", getUser) // GET /api/users/{id}kori.POST(users, "", createUser) // POST /api/users
kori.GET(products, "", listProducts) // GET /api/productskori.GET(products, "/{id}", getProduct) // GET /api/products/{id}Middlewares compartilhados
Seção intitulada “Middlewares compartilhados”Middlewares passados para Group se aplicam a todas as rotas registradas naquele grupo, e são herdados por qualquer grupo aninhado:
api := kori.Group(r, "/api", authMiddleware, logMiddleware)
kori.GET(api, "/users", listUsers) // authMiddleware + logMiddleware aplicadoskori.POST(api, "/users", createUser) // authMiddleware + logMiddleware aplicadosOrganizando APIs
Seção intitulada “Organizando APIs”Grupos se compõem naturalmente com aninhamento. Um padrão comum é uma API pública ao lado de uma seção administrativa protegida:
r := chi.NewRouter()r.Use(middleware.Logger)r.Use(middleware.Recoverer)
// Rotas públicaskori.GET(r, "/health", healthCheck)
// API autenticadaapi := kori.Group(r, "/api", authMiddleware)
kori.GET(api, "/todos", listTodos)kori.POST(api, "/todos", createTodo)kori.GET(api, "/todos/{id}", getTodo)kori.PUT(api, "/todos/{id}", updateTodo)kori.DELETE(api, "/todos/{id}", deleteTodo)
// Sub-grupo admin com middleware adicionaladmin := kori.Group(api, "/admin", adminOnlyMiddleware)
kori.GET(admin, "/stats", statsHandler)kori.DELETE(admin, "/users/{id}", deleteUser)Resultado:
GET /api/todos → authMiddlewarePOST /api/todos → authMiddlewareGET /api/todos/{id} → authMiddlewarePUT /api/todos/{id} → authMiddlewareDELETE /api/todos/{id} → authMiddlewareGET /api/admin/stats → authMiddleware + adminOnlyMiddlewareDELETE /api/admin/users/{id} → authMiddleware + adminOnlyMiddlewareMiddleware por rota
Seção intitulada “Middleware por rota”Middlewares também podem ser anexados a rotas individuais com kori.Use. Veja Middleware para mais detalhes.