几条关于java程序设计风格的指导性建议

• 正确的注释和注释风格

      在程序的开头写一个总结，介绍每一个主要步骤并解释每个难以读懂之处。注释写得简明扼要是很重要的，不能让整个程序都充满注释而使程序很难读懂。
      使用javadoc注释（/**……*/）来注释整个类，或整个方法。为了将这些注释提取出来放在一个javadoc Html文件中，这些注释必须放在类或者方法头的前面。要注释方法中的某个步骤，使用行注释（//）。
  
  
  

• 正确的缩进和空白

      保持一致的缩进风格会使程序更加清晰、易读、易于调试和维护。
      在嵌套结构中，每个内层的组成部分或语句应该比外层缩进两格。二元操作符应该各加一个空格，例如：

System.out.println(3 + 4 * 4);

• 块的风格

      块是由花括号围起来的一组语句。块的写法有两种常用方式：次行风格和行尾风格。
  例如：

next-line:

public class Test
{
  public static void main(String[] args)
  {
    System.out.println("Block Styles");
  }
}


end-of-line:

public class Test{
  public static void main(String[] args){
    System.out.println("Block Styles");
  }
}

    次行风格将花括号垂直对齐，因而使程序容易阅读，而行尾风格更节省空间，并有助于避免犯一些细小的程序设计错误。
    代码内应统一采用一种风格，建议不要将两种风格混合使用。

——《java语言程序设计基础篇》