Router
Entenda como o DiscordKit resolve comandos, componentes, modais, autocomplete, middleware, grupos e parâmetros de rota.
O Router é o componente central de roteamento de interações do DiscordKit.
Ele conecta interações recebidas do Discord aos handlers da aplicação.
Um único Router pode tratar Application Commands, componentes, submissões de modais e autocomplete.
Criando um Router
Seção intitulada “Criando um Router”router := discordkit.NewRouter()Com middleware global:
router := discordkit.NewRouter( discordkit.Logging(nil), discordkit.RequireGuild(),)Conectando ao discordgo
Seção intitulada “Conectando ao discordgo”session.AddHandler(router.Handle)Rotas de comandos
Seção intitulada “Rotas de comandos”router.Command("ping", pingHandler)router.Command("admin ban", banHandler)router.Command("config channel set", setChannelHandler)Caminhos de comandos usam espaços.
Rotas de componentes
Seção intitulada “Rotas de componentes”Literal:
router.Component("settings:save", saveSettings)Parametrizada:
router.Component( "/jobs/:jobID/save", saveJob,)Para /jobs/42/save:
jobID := c.MustParam("jobID")Rotas de modais
Seção intitulada “Rotas de modais”router.Modal( "/jobs/:jobID/edit", updateJob,)Rotas de autocomplete
Seção intitulada “Rotas de autocomplete”router.Autocomplete( "jobs search", "query", autocompleteJobs,)Middleware por rota
Seção intitulada “Middleware por rota”router.Command( "admin ban", banUser, discordkit.RequireGuild(), discordkit.RequirePermissions( discordgo.PermissionBanMembers, ),)Adicionando middleware global depois
Seção intitulada “Adicionando middleware global depois”router.Use( discordkit.Logging(nil),)Middleware adicionado com Use se aplica às rotas registradas antes e depois dele.
admin := router.Group( "admin", discordkit.RequireGuild(),)
admin.Command( "ban", banHandler,)Groups compartilham prefixos e middleware, mas registram suas rotas no Router original.
Parâmetros de rota
Seção intitulada “Parâmetros de rota”/jobs/:jobID/saveAcesse com:
jobID, ok := c.Param("jobID")jobID, err := c.RequireParam("jobID")jobID := c.MustParam("jobID")Conflitos de rota
Seção intitulada “Conflitos de rota”DiscordKit retorna ErrRouteConflict quando rotas entram em conflito.
Estes padrões são estruturalmente equivalentes:
/jobs/:jobID/save/jobs/:id/saveSempre trate os erros de registro durante o startup.
Rotas não encontradas
Seção intitulada “Rotas não encontradas”Interações válidas sem rota correspondente retornam ErrRouteNotFound.
Tratamento de erros
Seção intitulada “Tratamento de erros”router.OnError(func( c *discordkit.Context, err error,) { slog.Error("interaction failed", "error", err)})Sem hook configurado, DiscordKit utiliza slog.
Recovery
Seção intitulada “Recovery”O dispatch do Router aplica Recovery() automaticamente.
Um panic vira *discordkit.PanicError.
Dispatch direto
Seção intitulada “Dispatch direto”Para testes ou integrações em baixo nível:
err := router.Dispatch(ctx)Dispatch não executa OnError; ele retorna o erro diretamente.
Próximo passo
Seção intitulada “Próximo passo”Continue com Context para aprender como handlers acessam dados das interações e parâmetros de rota.