使用 KDoc 记录 Ktor 路由

Posted

技术标签:

【中文标题】使用 KDoc 记录 Ktor 路由【英文标题】:Documenting Ktor routes with KDoc 【发布时间】:2019-05-12 01:10:03 【问题描述】:

有谁知道记录 Ktor 路线的正确方法是什么,旨在将其显示在 KDoc 上? 示例:

route(DogoBot.data.API.ROUTE)
    route("token")
        route("add")
            get("fromdiscord")  ... 
            get  ... 
        
    
    route("user")
        route("id") 
            get  ... 
        
    
    route("guild")
        route("id") 
            get  ... 
        
     

好吧,如果可能的话,我该怎么做?我应该输入哪种类型的信息?如何在其他方面实现 Ktor 兼容性? (我有另一个自己做的路由器用于其他用途)

【问题讨论】:

【参考方案1】:

Dokka 不支持 Ktor 路由,而且我不知道有任何添加此类支持的计划,因此无法在生成的文档中包含有关路由的信息。

【讨论】:

以上是关于使用 KDoc 记录 Ktor 路由的主要内容,如果未能解决你的问题,请参考以下文章

Ktor 不记录异常

如何覆盖 logRequest/logResponse 以在 Ktor 客户端日志记录中记录自定义消息?

如何记录并响应来自 Ktor 中 JWT 授权失败的错误消息?

如果路由参数无效,则在 Ktor 位置捕获异常

Oauth2 授权路由在 Ktor 中不起作用

如何在 Ktor 中列出配置的路由