代码规范

今天看了《代码整洁之道》一书，做笔记如下：

 

1.名副其实、见名知意

public List<int[]> getThem() {

        List<int[]> list1 = new ArrayList<int[]>();

        for (int[] x : theList) {
            if (x[0] == 4) {
                list1.add(x);
            }
        }

        return list1;
    }

看此方法，方法、变量定义的让人蛋疼，不是你自己写的你根本不知道这段代码是干什么的，就算是你自己写的你恐怕也不一定知道！

下面优化一下：

public List<int[]> getFlaggedCells() {

        List<int[]> flaggedCell = new ArrayList<int[]>();

        for (int[] cell : gameBoard) {
            if (cell[STATUS_VALUE]==FLAGGED) {
                flaggedCell.add(cell);
            }
        }

        return flaggedCell;
    }

看看现在就好多了吧，变量和方法名起的有声有色，估计能看懂英文的就该知道这个方法里面的意思了，一目了然都不用加注释了。

现在已经比原来直观多了，but...不急，咱接着优化：

public List<Cell> getFlaggedCells() {

        List<Cell> flaggedCell = new ArrayList<int[]>();

        for (Cell cell : gameBoard) {
            if (cell.isFlagged()) {
                flaggedCell.add(cell);
            }
        }

        return flaggedCell;
    }

看看现在， 新建一个Cell类，把cell[STATUS_VALUE]==FLAGGED写成它的方法isFlagged（），现在才是真正的一目了然啊，亲！

 

未完待续...