《Google的Java編碼規范》(Google Java Style)在線地址

2014-02-17 15:04:48來源:InfoQ作者:

Google最近發布了一份完整的Java編碼規范。規范的內容包括一些切實可行的硬性規定。Google內部均遵守此規范。該規范不僅涵蓋了代碼格式,還包括其他類型的約定和編碼標準。

Google最近發布了一份完整的Java編碼規范。規范的內容包括一些切實可行的硬性規定。Google內部均遵守此規范。該規范不僅涵蓋了代碼格式,還包括其他類型的約定和編碼標準。

該規范主要分為6大部分:源文件基本規范、源文件結構、代碼格式、命名、編程實踐和Javadoc。源文件基本規范說明文件名、文件編碼、空格和特殊字符等規范要求。源文件結構說明許可信息、package和import聲明、類成員順序等規范要求。代碼格式用于說明源代碼中大括號、縮進、換行、空格、括號、枚舉、數組、switch語句、注解、注釋和修飾符等格式要求。命名說明了標識符(包、類、方法、常量、屬性、局部變量和類變量)的命名規范和駝峰大小寫定義。編程實踐說明@Override、異常、靜態成員和終結器的用法。Javadoc說明哪些地方需要Javadoc,以及它的格式要求。

以下是從規范中摘錄的一些內容:

  • import中不能有通配符。
  • 重載方法應該放在一起連續出現。
  • 即使代碼塊中沒有內容,或者只有一行代碼,也必須使用大括號。
  • 2空格縮進。
  • 列寬是80或100個字符。
  • 不能使用類似C語言的數組變量聲明。
  • switch語句中,必須包含default語句。
  • 修飾符的順序應按照Java語言規范推薦的順序。
  • 常量命名應使用CONSTANT_CASE格式(譯注:所有字母大寫,單詞使用下劃線分隔)。注意,所有常量都必須是static final成員,但并不是所有的static final成員都是常量。

《Google的Java編碼規范》在線地址:http://google-styleguide.googlecode.com/svn/trunk/javaguide.html

《Oracle的Java編碼規范》在線地址:http://www.oracle.com/technetwork/java/javase/documentation/codeconvtoc-136057.html

贊助商鏈接:

牛牛视频