java中我们如何制作我们自己的API帮助文档

什么叫做API帮助文档?

Application Programming Interface应用编程适配器,语言、框架以及类库对外提供的编码的适配器。

API帮助文档有什么用?

java有自己的官方的API帮助文档,就是很多官方的介绍和类、方法、变量的解释。一般很系统,涉及所有的方面,如果开发人员对正在使用的类不熟悉,想查看类里面的变量或者方法,就可以打开JavaAPI文档进行阅读和查看。可以让开发人员迅速的得到自己想要的系统的方法。

为什么定义帮助文档?

当我们写了一个功能给别的开发者使用的话。我们定义帮助文档就会让别人更好的了解你写的代码。这样可以帮助别人使用的我们写的功能的时候可以快速的提升他写代码的能力。

怎样定义帮助文档?


图1

首先我们定义一个我们需要的功能点的类,我们对这个类的每一个属性和方法写了注释,向图1我们对方法写的注释我们在调用的时候,会提示我们这个方法的作用和参数以及返回值。那我们要如何将这个类转化为API帮助文档呢?分为以下几步:


第一步

1、进入文件所在位置


第二步


第二步:利用javadoc 文件名或者是文件夹的名生成有关的html文件。


第三步

这样生成了一个HTML文件


图二

这就是我们生成API文档了。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 135,147评论 19 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 174,089评论 25 709
  • 现在开始,做好眼前的事。永远不要逃避,照顾好自己,做自己。 永远不要把工作与自己的兴趣爱好重合,就像永远不要把自己...
    磨石阅读 273评论 0 1
  • 9月13日,我们离开鸣沙山的露营地,在一家名为“五色沙”的站点安顿下来。一处很温馨的家庭式客栈。 因莫高窟的游览要...
    九月雪落阅读 343评论 0 0
  • 匆匆行走二十载, 沿途的风景, 相识的伙伴, 弄丢的朋友。 转身,擦肩 或许再见, 或许再也不见。 来不及的告别,...
    董世萍阅读 352评论 0 0