smart-doc 1.7.0 重磅发布，Java 零注解文档生成工具

2019-10-08 684

smart-doc是一个java restful api文档生成工具，smart-doc颠覆了传统类似swagger这种大量采用注解侵入来生成文档的实现方法。 smart-doc完全基于接口源码分析来生成接口文档，完全做到零注解侵入，你只需要按照java标准注释的写，smart-doc就能帮你生成一个简易明了的Markdown、Html、AsciiDoc文档。如果你已经厌倦了swagger等文档工具的无数注解和强侵入污染，那请拥抱smart-doc吧！

功能特性

零注解、零学习成本、只需要写标准java注释。
基于源代码接口定义自动推导，强大的返回结构推导。
支持Spring MVC,Spring Boot,Spring Boot Web Flux(controller书写方式)。
支持Callable,Future,CompletableFuture等异步接口返回的推导。
支持JavaBean上的JSR303参数校验规范。
对json请求参数的接口能够自动生成模拟json参数。
对一些常用字段定义能够生成有效的模拟值。
支持生成json返回值示例。
支持从项目外部加载源代码来生成字段注释(包括标准规范发布的jar包)。
支持生成多种格式文档：Markdown、HTML5、Asciidoctor。
轻易实现在Spring Boot服务上在线查看静态HTML5 api文档。
开放文档数据，可自由实现接入文档管理系统。

一款代码注释检测工具，不写注释的小伙伴逃不过法眼了。

Smart-doc vs Swagger

smart-doc不是对Swagger造轮子，这是一款用完全不同的理念重新开发的restful api接口文档生成工具。
smart-doc比swagger集成更简单，可以自由生成多种格式的api文档。
smart-doc完全不需要在侵入到业务代码中写任何注解。

更新内容

优化代码。
添加生成书签式HTML5和Asciidoctor文档的功能。
增加开放API数据接口功能。
支持Callable,Future,CompletableFuture等异步接口返回的推导。
支持Spring Boot Web Flux(Controller方式书写)。

升级建议

这个版本相对之前的版本做了很多推导优化和功能更新，增加很多用户期待的书签式html格式Api文档，强烈建议升级到最新版本。

DEMO

使用demo轻松玩转接口文档生成

相关文档

关于java web restful api文档的重新探索

smart-doc功能使用介绍

微信关注我们

原文链接：https://www.oschina.net/news/110397/smart-doc-1-7-0-released

转载内容版权归作者及来源网站所有！

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

TeaWeb v0.1.8 发布，支持 MySQL、PostgreSQL 数据库

TeaWeb是一个可视化的Web代理服务，目标是将代理服务、日志、统计、监控等集成在同一个服务中，让开发者简单地启动就可以使用。 v0.1.8 主要是在原有MongoDB的基础上，增加对MySQL和PostgreSQL两种数据库的支持，以及对细节的全面优化。完整的变更列表：基础框架除了现有支持的MongoDB，实现MySQL和PostgreSQL两种数据库支持 MongoDB下载增加预计剩余时间显示增加./teaweb sync命令用于主动通知集群同步源码增加 src/main/main.go 方便用户直接通过go build运行 TeaWeb界面HTTPS可以使用代理的证书代理代理服务增加通知设置，增加后端服务器自动上下线通知特殊页面也支持自定义的响应Header SSL页增加是否开启HTTP/2选项重写规则增加“是否终止向下匹配”和“是否持久重定向”两个选项，并在代理模式下支持自定义Host 看板和统计页添加手动刷新数据按钮优化匹配条件界面，增加整数相等、浮点数相等、IP范围、版本范围、扩展名、文件类型等多个操作符 WAF、日志存储策略、缓存策略都支持设置匹配条...

2019-10-08

662

过去的3个半月从 6月20日 Hyperf 1.0 发布以来，Hyperf 受到了非常多的关注，也获得了非常多的建议和帮助，截止至今， Hyperf 在 Github 上已经收获了1330+ stars，449+ 个 Pull Requests，51+ Contributors，3370+ commits，同时也出现了不少围绕或基于 Hyperf 的开源项目，在这段时间里，我们通过每周为 Hyperf 迭代一个无缝兼容的小版本，一共发布了 16 个小版本，此期间在 1.0 的基础上，增加了Translation 国际化,WebSocket,Snowflake 全局唯一 ID 生成器,Crontab 秒级计划任务,ETCD 配置中心,View 视图 (包括 Blade 和 Smarty 引擎),Task,Swoole Tracker共 8 个组件，同时也增加了连接池根据频率自动释放连接、自动动态代理 JSON RPC 客户端，Hyperf\Utils\Context::override()便捷的上下文变更方法，为 Response 增加xmldownload方法等主要功能。 Hype...

2019-10-08

728

资源下载

更多资源

优质分享App

近一个月的开发和优化，本站点的第一个app全新上线。该app采用极致压缩，本体才4.36MB。系统里面做了大量数据访问、缓存优化。方便用户在手机上查看文章。后续会推出HarmonyOS的适配版本。

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长，特征是大鼻子、头戴帽子、身穿背带裤，还留着胡子。与他的双胞胎兄弟路易基一起，长年担任任天堂的招牌角色。

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题，腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构，目前腾讯云软件源站支持公网访问和内网访问。

Nacos

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称，一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。