干擾型註解

干擾型註解

干擾型註解

干擾型註解

有時會發現某些註解毫無用處,只會干擾。它們重新
陳述很明顯的事實,又沒有提供任何新的資訊。

/**

  • Default constructor
    */
    protected AnnualDateRule() {
    }

/** The day of the month. */
private int dayOfMonth;

/**

  • Returns the day of the month.
  • @return the day of the month.
    */
    public int getDayOfMonth() {
    return dayOfMonth;
    }

以上這些註解是如此地干擾我們的閱讀,所以我們
學會要忽略它們。當我們閱讀程式碼時,我們會單純
地略過這些註解。最後,當註解周邊的程式碼被修改
之後,註解會變成謊言。