如何解决是否有标准方法来记录Groovy地图属性?
-
ignore
-
dir
-
tags
def publish(Map config) {
config.ignore ?= true
// ...
}
我看着What is the standard way to use JavaDoc to document a Map?;但是,这不适用于动态地图。理想情况下,我正在寻找JSDoc的@typedef
或@property
之类的东西。
解决方法
除了将选项添加到您的方法的某些JavaDoc之外,没有真正的方法来记录这些内容...
如果这是需要文档的公共API,则可以转到传递实际参数,也可以创建用于传递这些选项的类,即:
import groovy.transform.ToString
import groovy.transform.Immutable
@ToString
@Immutable
class Options {
boolean debug = false
File dir = new File('.')
List<String> tags = []
}
println new Options()
println new Options(debug: true,dir: new File("/tmp"))
println new Options(tags: ['a','b'])
哪些印刷品
Options(false,.,[])
Options(true,/tmp,[])
Options(false,[a,b])
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。