欧美性猛交XXXX免费看蜜桃,成人网18免费韩国,亚洲国产成人精品区综合,欧美日韩一区二区三区高清不卡,亚洲综合一区二区精品久久

- 一個(gè)軟件的生命周期中，80%的花費在于維護
- 幾乎沒(méi)有任何一個(gè)軟件，在其整個(gè)生命周期中，均由最初的開(kāi)發(fā)人員來(lái)維護
- 編碼規范可以改善軟件的可讀性，可以讓程序員盡快而徹底地理解新的代碼
- 如果你將源碼作為產(chǎn)品發(fā)布，就需要確任它是否被很好的打包并且清晰無(wú)誤，一如你已構建的其它任何產(chǎn)品

為了執行規范，每個(gè)軟件開(kāi)發(fā)人員必須一致遵守編碼規范。每個(gè)人。

本文檔現由Scott Hommel維護，有關(guān)評論意見(jiàn)請發(fā)至shommel@eng.sun.com

Java源文件還遵循以下規則：

  /*                * Classname                *                * Version information                *                * Date                *                * Copyright notice                */                

  package java.awt;                import java.awt.peer.CanvasPeer;                

注意：用于文檔中的例子應該使用更短的行長(cháng)，長(cháng)度一般不超過(guò)70個(gè)字符。

- 在一個(gè)逗號后面斷開(kāi)
- 在一個(gè)操作符前面斷開(kāi)
- 寧可選擇較高級別(higher-level)的斷開(kāi)，而非較低級別(lower-level)的斷開(kāi)
- 新的一行應該與上一行同一級別表達式的開(kāi)頭處對齊
- 如果以上規則導致你的代碼混亂或者使你的代碼都堆擠在右邊，那就代之以縮進(jìn)8個(gè)空格。

以下是斷開(kāi)方法調用的一些例子：

  someMethod(longExpression1, longExpression2, longExpression3,                longExpression4, longExpression5);                var = someMethod1(longExpression1,                someMethod2(longExpression2,                longExpression3));                

以下是兩個(gè)斷開(kāi)算術(shù)表達式的例子。前者更好，因為斷開(kāi)處位于括號表達式的外邊，這是個(gè)較高級別的斷開(kāi)。

  longName1 = longName2 * (longName3 + longName4 - longName5)                + 4 * longname6; //PREFFER                longName1 = longName2 * (longName3 + longName4                - longName5) + 4 * longname6; //AVOID                

以下是兩個(gè)縮進(jìn)方法聲明的例子。前者是常規情形。后者若使用常規的縮進(jìn)方式將會(huì )使第二行和第三行移得很靠右，所以代之以縮進(jìn)8個(gè)空格

  //CONVENTIONAL INDENTATION                someMethod(int anArg, Object anotherArg, String yetAnotherArg,                Object andStillAnother) {                ...                }                //INDENT 8 SPACES TO AVOID VERY DEEP INDENTS                private static synchronized horkingLongMethodName(int anArg,                Object anotherArg, String yetAnotherArg,                Object andStillAnother) {                ...                }                

if語(yǔ)句的換行通常使用8個(gè)空格的規則，因為常規縮進(jìn)(4個(gè)空格)會(huì )使語(yǔ)句體看起來(lái)比較費勁。比如：

  //DON’T USE THIS INDENTATION                if ((condition1 && condition2)                || (condition3 && condition4)                ||!(condition5 && condition6)) { //BAD WRAPS                doSomethingAboutIt();             //MAKE THIS LINE EASY TO MISS                }                //USE THIS INDENTATION INSTEAD                if ((condition1 && condition2)                || (condition3 && condition4)                ||!(condition5 && condition6)) {                doSomethingAboutIt();                }                //OR USE THIS                if ((condition1 && condition2) || (condition3 && condition4)                ||!(condition5 && condition6)) {                doSomethingAboutIt();                }                

這里有三種可行的方法用于處理三元運算表達式：

  alpha = (aLongBooleanExpression) ? beta : gamma;                alpha = (aLongBooleanExpression) ? beta                : gamma;                alpha = (aLongBooleanExpression)                ? beta                : gamma;                

實(shí)現注釋用以注釋代碼或者實(shí)現細節。文檔注釋從實(shí)現自由(implementation-free)的角度描述代碼的規范。它可以被那些手頭沒(méi)有源碼的開(kāi)發(fā)人員讀懂。

注釋?xiě)挥脕?lái)給出代碼的總括，并提供代碼自身沒(méi)有提供的附加信息。注釋?xiě)搩H包含與閱讀和理解程序有關(guān)的信息。例如，相應的包如何被建立或位于哪個(gè)目錄下之類(lèi)的信息不應包括在注釋中。

在注釋里，對設計決策中重要的或者不是顯而易見(jiàn)的地方進(jìn)行說(shuō)明是可以的，但應避免提供代碼中己清晰表達出來(lái)的重復信息。多余的的注釋很容易過(guò)時(shí)。通常應避免那些代碼更新就可能過(guò)時(shí)的注釋。

注意：頻繁的注釋有時(shí)反映出代碼的低質(zhì)量。當你覺(jué)得被迫要加注釋的時(shí)候，考慮一下重寫(xiě)代碼使其更清晰。

注釋不應寫(xiě)在用星號或其他字符畫(huà)出來(lái)的大框里。注釋不應包括諸如制表符和回退符之類(lèi)的特殊字符。

塊注釋之首應該有一個(gè)空行，用于把塊注釋和代碼分割開(kāi)來(lái)，比如：

  /*                * Here is a block comment.                */                

塊注釋可以以/*-開(kāi)頭，這樣indent(1)就可以將之識別為一個(gè)代碼塊的開(kāi)始，而不會(huì )重排它。

  /*-                * Here is a block comment with some very special                * formatting that I want indent(1) to ignore.                *                *    one                *        two                *            three                */                

注意：如果你不使用indent(1)，就不必在代碼中使用/*-，或為他人可能對你的代碼運行indent(1)作讓步。

以下是一個(gè)Java代碼中尾端注釋的例子：

  if (a == 2) {                return TRUE;              /* special case */                } else {                return isPrime(a);         /* works only for odd a */                }                

  if (foo > 1) {                // Do a double-flip.                ...                }                else {                return false;          // Explain why here.                }                //if (bar > 1) {                //                //    // Do a triple-flip.                //    ...                //}                //else {                //    return false;                //}                

  int level;  // indentation level                int size;   // size of table                

要優(yōu)于，

int level, size;

不要將不同類(lèi)型變量的聲明放在同一行，例如：

  int foo,  fooarray[];   //WRONG!                

注意：上面的例子中，在類(lèi)型和標識符之間放了一個(gè)空格，另一種被允許的替代方式是使用制表符：

  int		level;         // indentation level                int		size;          // size of table                Object	currentEntry;  // currently selected table entry                

  void myMethod() {                int int1 = 0;         // beginning of method block                if (condition) {                int int2 = 0;     // beginning of "if" block                ...                }                }                

該規則的一個(gè)例外是for循環(huán)的索引變量

  for (int i = 0; i < maxLoops; i++) { ... }                

避免聲明的局部變量覆蓋上一級聲明的變量。例如，不要在內部代碼塊中聲明相同的變量名：

  int count;                ...                myMethod() {                if (condition) {                int count = 0;     // AVOID!                ...                }                ...                }                

- 在方法名與其參數列表之前的左括號"("間不要有空格
- 左大括號"{"位于聲明語(yǔ)句同行的末尾
- 右大括號"}"另起一行，與相應的聲明語(yǔ)句對齊，除非是一個(gè)空語(yǔ)句，"}"應緊跟在"{"之后

  class Sample extends Object {                int ivar1;                int ivar2;                Sample(int i, int j) {                ivar1 = i;                ivar2 = j;                }                int emptyMethod() {}                ...                }                

  argv++;       // Correct                argc--;       // Correct                argv++; argc--;       // AVOID!                

- 被括其中的語(yǔ)句應該較之復合語(yǔ)句縮進(jìn)一個(gè)層次
- 左大括號"{"應位于復合語(yǔ)句起始行的行尾；右大括號"}"應另起一行并與復合語(yǔ)句首行對齊。
- 大括號可以被用于所有語(yǔ)句，包括單個(gè)語(yǔ)句，只要這些語(yǔ)句是諸如if-else或for控制結構的一部分。這樣便于添加語(yǔ)句而無(wú)需擔心由于忘了加括號而引入bug。

  return;                return myDisk.size();                return (size ? size : defaultSize);                

  if (condition) {                statements;                }                if (condition) {                statements;                } else {                statements;                }                if (condition) {                statements;                } else if (condition) {                statements;                } else{                statements;                }                

注意：if語(yǔ)句總是用"{"和"}"括起來(lái)，避免使用如下容易引起錯誤的格式：

  if (condition) //AVOID! THIS OMITS THE BRACES {}!                statement;                

  for (initialization; condition; update) {                statements;                }                

一個(gè)空的for語(yǔ)句(所有工作都在初始化，條件判斷，更新子句中完成）應該具有如下格式：

  for (initialization; condition; update);                

當在for語(yǔ)句的初始化或更新子句中使用逗號時(shí)，避免因使用三個(gè)以上變量，而導致復雜度提高。若需要，可以在for循環(huán)之前(為初始化子句)或for循環(huán)末尾(為更新子句)使用單獨的語(yǔ)句。

  while (condition) {                statements;                }                

一個(gè)空的while語(yǔ)句應該具有如下格式：

  while (condition);                

  do {                statements;                } while (condition);                

  switch (condition) {                case ABC:                statements;                /* falls through */                case DEF:                statements;                break;                case XYZ:                statements;                break;                default:                statements;                break;                }                

每當一個(gè)case順著(zhù)往下執行時(shí)(因為沒(méi)有break語(yǔ)句)，通常應在break語(yǔ)句的位置添加注釋。上面的示例代碼中就包含注釋/* falls through */。

  try {                statements;                } catch (ExceptionClass e) {                statements;                }                

一個(gè)try-catch語(yǔ)句后面也可能跟著(zhù)一個(gè)finally語(yǔ)句，不論try代碼塊是否順利執行完，它都會(huì )被執行。

  try {                statements;                } catch (ExceptionClass e) {                statements;                } finally {                statements;                }                

下列情況應該總是使用兩個(gè)空行：

- 一個(gè)源文件的兩個(gè)片段(section)之間
- 類(lèi)聲明和接口聲明之間

下列情況應該總是使用一個(gè)空行：

- 一個(gè)緊跟著(zhù)括號的關(guān)鍵字應該被空格分開(kāi)，例如：

  while (true) {                ...                }                

    a += c + d;                a = (a + b) / (c * d);                while (d++ = s++) {                n++;                }                printSize("size is " + foo + "\n");                

    for (expr1; expr2; expr3)                

    myMethod((byte) aNum, (Object) x);                myMethod((int) (cp + 5), ((int) (i + 3)) + 1);                

一個(gè)具有公有實(shí)例變量的恰當例子，是類(lèi)僅作為數據結構，沒(méi)有行為。亦即，若你要使用一個(gè)結構(struct)而非一個(gè)類(lèi)(如果java支持結構的話(huà))，那么把類(lèi)的實(shí)例變量聲明為公有是合適的。

  classMethod();             //OK                AClass.classMethod();      //OK                anObject.classMethod();    //AVOID!                

  fooBar.fChar = barFoo.lchar = ‘c‘; // AVOID!                

不要將賦值運算符用在容易與相等關(guān)系運算符混淆的地方。例如：

  if (c++ = d++) {        // AVOID! (Java disallows)                ...                }                

應該寫(xiě)成

  if ((c++ = d++) != 0) {                ...                }                

不要使用內嵌(embedded)賦值運算符試圖提高運行時(shí)的效率，這是編譯器的工作。例如：

  d = (a = b + c) + r;        // AVOID!                

應該寫(xiě)成

  a = b + c;                d = a + r;                

  if (a == b && c == d)     // AVOID!                if ((a == b) && (c == d))  // RIGHT                

  if (booleanExpression) {                return true;                } else {                return false;                }                

應該代之以如下方法：

  return booleanExpression;                

類(lèi)似地：

  if (condition) {                return x;                }                return y;                

應該寫(xiě)做：

  return (condition ? x : y);                

  (x >= 0) ? x : -x;