Java之路（三）：注释、API和Java开发工具

注释

• 用于注解说明解释程序的文字就是注释

• Java中的注释类型

  • 单行注释
  • 多行注释
  • 文档注释（java特有）

• 提高了代码的阅读性；调试程序的重要方法；

• 注释是一个程序员必须要具有的良好编程习惯；

• 将自己的思想通过注释先整理出来，再用代码去体现。

• 单行注释

  • 格式  //注释内容

• 多行注释

  • 格式   /* 注释内容 */

• 注意
  • 对于单行和多行注释，被注释的文字，不会被JVM解释执行。编译以后生成的.class结尾的字节码文件中不包含注释掉的信息；
  • 多行注释里面不允许有多行注释嵌套。

• 文档注释
  • 格式   /**
        注释内容
        */
• 文档注释的注释内容可以被JDK提供的工具javadoc所解析，生成一套以网页文件形式体现的该程序的说明文档。
• 操作方式
  

Java API的文档

• API（Application Programming Interface，应用程序编程接口）是Java提供的基本编程接口。
• Java语言提供了大量的基础类。
• 下载API:
  • http://www.oracle.com/technetwork/java/javase/downloads/index.html

良好的编程风格

• 正确地注释和注释风格
  • 使用文档注释来注释整个类或整个方法。
  • 如果注释方法中的某一个步骤，使用单行或多行注释。
• 正确地缩进和空白
  • 使用一次tab操作，实现缩进。
  • 运算符两边习惯性各加一个空格。
• 块的风格
  • Java API源代码选择了行尾风格。

Java开发工具

• 文本编辑工具
  • 记事本
  • UltraEdit
  • EditPlus
  • TextPad
  • NotePad
• Java集成开发环境（IDE）
  • JBuilder
  • NetBeans
  • Eclipse
  • MyEclipse
  • Intellij IDEA