jjzjj

java - 使用自上而下的方法在 Java 中设计 API - 编写 Javadoc 是最好的起点吗?

每当我需要用Java设计API时,我通常会先打开我的IDE,然后创建包、类和接口(interface)。方法实现都是虚拟的,但javadoc很详细。这是解决问题的最佳方式吗?我开始觉得API文档应该是第一个被搅动出来的——甚至在第一个.java文件被编写之前。这有几个优点:API设计者可以完成设计和规范,然后将实现拆分给几个实现者。更灵活-设计更改不需要在java文件中来回寻找编辑javadoc注释的位置。还有其他人同意这个观点吗?如果是这样,您如何着手进行API设计?此外,是否有任何可能有用的工具?甚至可能是某种基于注释的工具生成文档然后生成骨架源代码(有点像模型到代码生成器)?我遇