讀書心得 - Clean Code - Chapter 5

Chapter 5 - 編排

報紙的啟發

    希望原始檔要跟報紙一樣，從上而下閱讀。上方會有頭條的敘述，讓你理解這段報導在談論些什麼，讓你可以決定如何閱讀。第一段通常會是整篇報導的概要，細節資訊會被隱藏。然後你在持續往下閱讀才會發現所有細節。

    然後報紙本身也不會太長，所以原始檔盡量維持最多 200 ~ 500 行。

    垂直空白區隔

    每一個空白行會對眼睛下一個提示，讓其注意空白行後的第一行。通常用在一個概念接續另新的概念。

    垂直密度

    相依的函式盡量緊靠。

    垂直順序

    跟報紙一樣，應該是高層模組到低層模組。

    水平的空白間隔

    水平空白去強調運算子，下面是用空白強調加減法，以及乘法有較高的優先權所以沒有空白。

     public class Quadratic {
          public static double root1(double a, double b, double c) {
               double determinant = determinant(a, b , c);
               return (-b + Math.sqrt(determinant)) / (2*a);
          }
  
          public static double root2(double a, double b, double c) {
               double determinant = determinant(a, b , c);
               return (-b - Math.sqrt(determinant)) / (2*a);
          }
  
          private static double determinant(double a, double b, double c) {
               return b*b - 4*a*c;
          }
     }

上一篇：
讀書心得 - Clean Code - Chapter 4