良好习惯,编写自己的JAVADOC

JavaDoc 可以根据我们写的代码,直接生成 api 的帮助文档,我们天天看的 JDK帮助文档就是用 JavaDoc 生成的,各大开源软件里面的 Api文档也都是 Javadoc。

只要写代码的时候注意点,多留点心写下代码的说明,那么自己的项目中也可以生成出漂亮的JavaDoc来。

使用javadoc 命令行,和 eclipse 的工具都可以给快速生成一个项目的API帮助文档。

  1. 包的javadoc:在所在包的下面建立一个package.html文件,进行描述。通常进行简单描述包的功能和一些注意事项。
    如果有必要就在包上加上这个html文件,javadoc工具会自动生成package-summary.html文件。虽然是HTML文件 ,但也不一定要写成HTML,如果喜欢可以直接写文字,但一般还是保留最基本结构,如:

    1
    2
    3
    4
    5
    6
    <h3>com.xdnote</h3>
    <ul>
    <li>com.xdnote包说明一</li>
    <li>com.xdnote包说明二</li>
    </ul>
          com.xdnote注意事项
  2. 类的javadoc
    类的javadoc估计都见得不少了,在eclipsenew一个class或是interface时都会有杂七杂八的注释,或是开源代码每份上面都会有lisene什么的。
    一般工具都会对javadoc自动识别,开发过程中也会有不少帮助,比如
    javadoc
    类的javadoc一般格式

    1
    2
    3
    4
    5
    /**
    * {Description}
    *
    * {Tags}
    */
阅读更多

避免JS调试代码在页面上报错

避免JS调试代码在页面上报错

阅读更多