Java编码风格的资源?

时间:2011-01-03 00:08:59

标签: java coding-style

我发现阅读编码风格指南是了解语言及其特点的最佳方式。我一直在努力为Java找到一份好的文档,并立即回答一些问题。

首先,很长线的惯例是什么?用Java和C / C ++编写文章会让我在这一点上产生很大的困惑。

其次,创建自定义异常类的准则是什么?我通常最终会抛出一个现有的异常,而不是创建自己的异常。是否通常强制执行自定义异常创建?

7 个答案:

答案 0 :(得分:5)

答案 1 :(得分:2)

答案 2 :(得分:2)

我从Sun / Oracle Java coding standards开始。

行的字符宽度没有100%的硬性和快速性标准。我会说80-120个字符之间。更大,更宽的屏幕会让我不那么担心。

我同意标准例外通常对我来说足够好。我可能是一个特殊业务意义的自定义异常子类,但这些很少见。我会说Java的最新风格是更喜欢未经检查的异常,更像是C#。

答案 3 :(得分:2)

  1. http://www.oracle.com/technetwork/java/codeconv-138413.html
  2. 包裹到80 - 110个字符
  3. 扔掉现有的很棒。您应该只创建自定义时间 现有的异常并不完全 匹配特殊情况( 通常是商业规则)
  4. 作为编码惯例的简要说明:

    class SomeClassName { //<-- Class with upper case, camel case
       public static final int CONSTANT_SOMETIHNG = 0x2A; // constants all upper case
       private int secretVariable; // variables start with lowercase
       public void someMethod() {  // methods too 
    
           // opening brace goes in the same line 
    
           if( cond ) { 
               ...
           } else { 
               ...
           }
           for( .. ) {
           }
           while( ... ) { 
           }
           try { 
           } catch() { 
           } finally {
           }
           // closing brace aligned to the element start 
    
        }
      }
    }
    

    等。等。

答案 4 :(得分:2)

约书亚布洛赫的“有效Java”是重要的阅读材料。它超越了Oracle提供的语法指南。

第60项是“赞成使用标准例外”,但第61项是“抛出适用于抽象的例外”。有时会调用自定义异常,有时不会。

答案 5 :(得分:1)

可能重复的问题。你可以在这里找到答案:https://stackoverflow.com/questions/1334204/official-java-code-guidelines-conventions

但是,Sun / Oracle网站上的文档超过12年。虽然核心语言没有改变,但技术变化很快,这意味着我们使用该技术的方式发生了变化。

我建议使用最适合您和您的团队的方法。只要您的组织中有一些被认为是主流的商定标准,您应该没问题。

答案 6 :(得分:0)

  1. 当人们使用80个字符宽的文本编辑器时,线路长度曾经是一个问题。今天,大多数开发人员都拥有大型高分辨率宽屏幕,因此如果强制其他人向下滚动并在右侧有空白,那么用Java封装80个字符实际上可能是一种损害。请注意谁可能正在查看您编写的代码并将其包装在适当的长度。

  2. 我对自定义异常类的看法是使用已经存在的任何内容,只要它有意义。但是,有时您需要一个不存在的异常类,所以如果它有意义,请不要犹豫,创建一个。