더북(TheBook)

3.4 주석을 유틸리티 메서드로 대체

class FuelSystem {

    List<Double> tanks = new ArrayList<>();

    int getAverageTankFillingPercent() {
        double sum = 0;
        for (double tankFilling : tanks) { 
            sum += tankFilling;
        }
        double averageFuel = sum / tanks.size();
        // 정수 백분율로 반올림
        return Math.toIntExact(Math.round(averageFuel * 100));
    }
}

주석을 상수로 반환하는 방법은 사용 가능한 여러 수단 중 하나입니다. 하지만 코드가 더 복잡해지면 어쩌죠? 모든 값이 고정된 값일 수는 없으니까요.

위 예제는 평균을 계산하고 변환하기 전에 그 값을 조작하는 코드입니다. 마지막 명령문이 무엇을 하려는지 바로 알아차렸나요? 만약 그렇다면 작성자가 마지막 줄을 주석으로 설명한 덕분이죠.

앞 절에서 우리가 주석을 싫어한다는 점을 어느 정도 눈치챘을 텐데요. 그러면 도대체 어떡해야 할까요?

신간 소식 구독하기
뉴스레터에 가입하시고 이메일로 신간 소식을 받아 보세요.