安卓开发之JAVA注释

1.注释：对写的代码进行解释和说明的，提高了代码的阅读性，方便自己理解，也方便别人理解，也可以用于调试.注释是一个程序员必须有的良好习惯，先用注释将自己思路整理出来再用代码去实现.被注释的内容是不参与编译的,话句话说就是编译以后生成的.class结尾字节码文件中不包含注释掉的内容

2.JAVA中的注释类型：①单行注释 ②多行注释 ③文档注释(java特有)

        ①.单行注释写法：双斜线（//.........）,如图：

                      ②.多行注释的写法：斜线*被注释内容*斜线（/*.......*/),如图：

         ③：文档注释：

                1.写法：斜杠**注释内容*斜杠（/**@author  @version*/）

                        ①:  @author 指定java程序的作者

                        ②：@version 指定源文件的版本号

                2.文档注释的作用：被注释内容可以被JDK所提供的工具javadoc所解析，生成一套以网                     页文件形式体现的该程序的说明文档.

   

                3.注释写法如下图：

 

               4上图中用红色方块选中的部分就是注释部分，图中用椭圆圈起来的public这                                     是必须要写的（用JAVADOC解析注释文件时必须要有public）

               5.文档注释已写好，现在用JAVADOC解析文档注释

               6.javadoc的用法：javadoc -encoding utf-8 -d 文件夹名(这个文件夹名随意命名) -author -                   -version 文件名；为什么要写一个文件夹名因为用javadoc解析以后会生成一个以网页                      形式存在的文件，并且会自动生成你命名的这个文件夹，这个文件夹就是用于存放                          javadoc解析生成的文件；如下图：

               7.javadoc编译后生成的文档如下图：

              8.如何使用解析生成以后的文件，直接打开index.html文件即可，如图：