より良いコードを書く


こんにちは、この記事では重要なトピックに光を当てるつもりです.
すべてのプログラマは、配列の並べ替え方法、木のバランス方法、複雑なデータ構造の作成と使用の仕方、またはビジネス仕様を作業コードに変換する方法を知っています.
でも.
すべてのプログラマは、読みやすいコードを書くことの重要性を認識していますか?答えは大きいです.
私が同僚によって提出されたマージ要求を検討していたとき、私が以前に遭遇したコードの例を挙げましょう:
 public static int get(Person p) {
        return Period.between(p.getBirthDate(), LocalDate.now()).getYears();
    }
上記のコードは、与えられた人の年齢を計算します、それは完璧です、そして、正しく結果を得ます、しかし、それを理解するために、それはより多くの努力を必要とします、そして、多分、あなたはより詳細に掘り出さなければならないでしょう、あるいは、多分、そのようなコード断片の意図についてあなたの友人に尋ねなければなりません.
同じコードを書き直す提案を以下に示します.
public static int calculateAgeOfAPerson(Person person) {
        LocalDate now = LocalDate.now();
        Period difference = Period.between(person.getBirthDate(), now);
        return difference.getYears();
    }
今では、この断片の意図は、コード自体によって記述されているように明確であり、ドキュメントは必要ありませんし、アイデアは詳細にさらに進む必要がなく明確になります.