smart-doc/RELEASE.md

5.1 KiB
Raw Blame History

smart-doc版本

版本小于1.0都属于试用正式1.0起始发布将会等到文中提到的问题解决后才发布。

版本号0.1

  • 更新日期2018-06-25
  • 更新内容:
    1. 手册将api-doc发布到中央仓库

版本号0.2

  • 更新日期2018-07-07
  • 更新内容:
    1. 修改api-doc泛型推导的bug.

版本号0.3

  • 更新日期2018-07-10
  • 更新内容:
    1. api-doc增加对jackson和fastjson注解的支持可根据注解定义来生成返回信息。

版本号0.4

  • 更新日期2018-07-11
  • 更新内容:
    1. 修改api-doc对类继承属性的支持。

版本号0.5

  • 更新日期2018-08-04
  • 更新内容:
    1. 修改api-doc对各种字段的解析错误bug。

版本号0.5

  • 更新日期2018-08-23
  • 更新内容:
    1. 将api-doc重命名为smart-doc并发布到中央仓库

版本号1.0

  • 更新日期2018-08-25
  • 更新内容:
    1. smart-doc增加将所有文档导出归档到一个markdown中件的功能
    2. 参考阿里开发手册将直接提升到1.0,之前的版本主要是个人内部测试

版本号1.1

  • 更新日期2018-08-30
  • 更新内容:
    1. 修改PostMapping和GetMapping value为空报错的bug
    2. 增强时间字段的mock数据创建
    3. 修改smart-doc解析自引用对象出错的bug

版本号1.2

  • 更新日期2018-09-04
  • 更新内容:
    1. 根据用户反馈增加controller报名过滤功能该功能为可选项

版本号1.3

  • 更新日期2018-09-15
  • 更新内容:
    1. 增加PutMapping和DeleteMapping支持
    2. 添加字符串date和Date类型时间的模拟值生成

版本号1.6.2

  • 更新日期2019-09-13
  • 更新内容:
    1. 修改字段注释多行显示错误bug
    2. 字段描述文档增加@Since tag的支持
    3. 解析代码忽略WebRequest类防止生产过多信息
    4. 升级基础库依赖版本

版本号1.6.4

  • 更新日期2019-09-23
  • 更新内容:
    1. 优化代码
    2. 增加对普通的get请求参数拼装示例的生成
    3. 增加spring mvc占位符restful url请求示例生成

版本号1.7.0

  • 更新日期2019-09-30
  • 更新内容:
    1. 优化代码。
    2. 添加生成HTML5和Asciidoctor文档的功能。
    3. 增加开放API数据接口功能。
    4. 支持Callable,Future,CompletableFuture等异步接口返回的推导。
    5. 支持Spring Boot Web Flux(Controller方式书写)。

版本号1.7.1

  • 更新日期:已废弃
  • 更新内容:
    1. 优化注释换行\n\r问题。
    2. 修改bug #I135PG
    3. 添加requestHeader功能

版本号1.7.2

  • 更新日期2019-10-19
  • 更新内容:
    1. 优化注释换行\n\r问题依赖common-util 1.8.7。
    2. 修改gitee上bug #I135PG、#I13NR1。
    3. 添加@requestHeader注解的支持文档自定将参数绑定到请求头列表中。
    4. 增加javadoc apiNote tag的支持。
    5. 解决扫描分析controller中private方法的问题。
    6. 添加支持@RequestParam注解重写参数名和设置默认值的文档解析。
    7. 支持使用@PostMapping和@PutMapping请求自定义注解接收单个json参数场景下生成json请求实例。
    8. 新增对Spring ResponseEntity的解析。
    9. 增加内部类返回结构解析。
    10. 修改文档中显示的字段类型float、double等由原来的number直接变成具体类型。

版本号1.7.3

  • 更新日期2019-10-24
  • 更新内容:
    1. 优化html5模板左侧文档目录展示能够展开和收缩。
    2. 修改gitee上bug #I13R3K。
    3. 修改gitee上bug #I13NR1。
    4. 开放的文档数据获取接口添加返回方法的唯一id和方法名称方便一些企业自己做对接。

版本号1.7.4

  • 更新日期2019-10-29
  • 更新内容:
    1. 修改gitee上bug #I1426C。
    2. 修改gitee上bug #I13ZAL,1.7.0~1.7.3 结构优化后产生的bug建议用户升级。
    3. 修改gitee上bug #I13U4C。
    4. 修改设置中文语言环境(默认中文)下错误码列表title显示英文的问题。
    5. 优化AllInOne的markdown展示生成时带上自动产生的序号。

版本号1.7.5

  • 更新日期2019-11-06
  • 更新内容:
    1. 优化文档中错误列表的标题,可根据语言环境变化显示中文或因为。
    2. 解决项目外jar中内部类生成文档错误的bug。
    3. 支持环形依赖分析。只要你敢写!
    4. 修改使用SpringMvc或者SpringBoot上传时接口的Content-Type显示错误。
    5. 支持设置项目作为markdown的一级标题。
    6. 修改方法注释相同引起的html链接跳转错误。
    7. 添加生成AllInOne的覆盖配置项默认自动加版本号不覆盖。
    8. 新增枚举字典码导出到文档的功能。

版本号1.7.6

  • 更新日期2019-11-13
  • 更新内容:
    1. fix #I14PT5 header重复渲染到文档
    2. fix #I14MV7 不设置dataDictionaries出现空指针错误
    3. 增加请求参数枚举字段解析(试用功能)

版本号1.7.7

  • 更新日期:待定
  • 更新内容:
    1. 修改timestamp类型字段创建json示例错误bug。
    2. fix #I1545A 单接口多路径bug。
    3. 修改部分url生成部署空格问题。
    4. 优化对java.util.concurrent.ConcurrentMap的解析。