Java编码风格的资源?

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

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

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

查看Java TM编程语言的官方代码约定 。

JavaRanch Java编程风格指南

Java编程语言的代码约定

Java编程风格指南

我将从Sun / Oracle Java编码标准开始 。

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

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

  1. http://www.oracle.com/technetwork/java/codeconv-138413.html
  2. 包裹到80 – 110个字符
  3. 扔掉现有的很棒。 当现有exception与特殊情况(通常是业务规则)不完全匹配时,您应该只创建自定义

作为编码约定的简要介绍:

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 } } } 

等等

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

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

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

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

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

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

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