클린코드 2022-04-24 Day2 (2장 의미 있는 이름)

TIL (2022.04.24)

 

Day 2

※오늘 읽은 범위

2장, 의미 있는 이름

 

※책에서 기억하고 싶은 내용을 써보세요.

1. 그릇된 정보를 피하라 (p.24)

• 실제 리스트가 아니라면, accountLiost라 명명하지 않는다. 실제 List가 아니라면 그릇된 정보를 제공하는 셈이다. 그러므로 accountGroup, buncheOfAccounts, 아니면 단순히 Accounts라 명명한다.

2. 검색하기 쉬운 이름을 사용하라 (p.28)

• 이름 길이는 범위 크기에 비례해야 한다. 변수나 상수를 코드 여러 곳에서 사용한다면 검색하기 쉬운 이름이 바람직하다.  EX) 일하는 날을 사용할 경우 WORKING_DAY = 5; 이런식으로 상수를 이용하자.

 

3. 자신의 기억력을 자랑하지 마라 (p.31)

• 클래스 이름: Customer, WikiPage, Account, AddressParser 이런식으로 작성한다.
※ 클래스 이름과 객체 이름은 명사나 명사구가 적합하다.

• 메서드 이름: postPayment, deletePAge, save 이런식으로 작성한다.
※ 메서드 이름은 동사나 동사구가 적합하다.

4. 한 개념에 한 단어를 사용하라 (p.33)

• 추상적인 개념 하나에 단어 하나를 선택해 이를 고수한다. 에를 들어, 똑같은 메서드를 클래스마다 fetch, retrieve, get으로 제각각 부르면 혼란스럽다.

 

※오늘 읽은 소감은? 떠오르는 생각을 가볍게 적어보세요.

평소 자바 개발을 하면서 의미 있는 이름을 짓는걸 항상 고민해 왔지만 나름대로의 규칙을 갖고 변수명, 클래스명을 작명하여 사용하였는데 이번 챕터를 읽으며 느낀점이 많았다 예를 들어 엔티티의 경우 다른 엔티티에서 컬렉션 형태로 가져온다고 할때 항상 XXXInfo 이런식으로 이름을 지었는데 클린코드를 읽어보니 이건 바람직하지 않은 방법이라는 것에 깊이 와닿았다. 어찌보면 Product, ProductInfo 둘다 같은 의미나 다름 없는데 쓸떼 없이 글자 수를 늘렸던 것 같다.

 

또 한가지로 복수형태의 변수의 경우 항상 List를 붙였는데 이건 자바의 LIST형태를 나타내는 느낌이 있으니 바람직하지 않는 방법이라는 것에 깨달음을 얻었다. 앞으론 복수의 경우 무조껀적인 XXXList 이런식으로 변수명을 작성하는 방법은 피하도록 노력을 해야 할 것 같다. 일단.. 개인프로젝트들 부터 리팩토링을 시작해봐야겠다.

 

 

※궁금한 내용이 있거나, 잘 이해되지 않는 내용이 있다면 적어보세요.

이번에 읽은 2장의 내용들은 궁금하다기보단 바뀌어야 할 부분들에 대해서 느낀바가 많은 것 같다.

그러므로 이번장은 없음!