[클린코드#2.5] 의미있는 이름

2022.01.25

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

 

클래스 이름

- 클래스, 객체 이름은 명사나 명사구가 적당하다.

 

메서드 이름

- 메서드 이름은 동사나 동사구가 적당하다.

 

한 개념에 한 단어

- 똑같은 기능의 메서드가 있는데 클래스마다 retrieve, get, fetch 처럼 서로 다른 이름의 메서드를 사용하면 헷갈린다. 한 개념에는 하나의 이름만 사용하자.                                                                                                                                                                               

 

말장난을 하지 마라

- 다른 클래스에 add 라는 메서드가 기존에 존재하고 있는데, 새로운 기능 중 리스트에 값을 하나 추가하는 메서드를 만들었다고 할때 add 라는 명으로 짓지 말아라. 

 

의미 있는 맥락을 추가하라

- firstName, lastName, street, houseNumber, city, state.. 라는 변수 명을 보면 주소 클래스 라는것을 알 수 있다. 하지만 state 라는 변수명만을 본다면 의미가 분명한가? 아니다. 변수명 앞에 addr 를 추가해서 addrState로 변수명을 짓는다면 의미가 더 분명하다.

 

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

- 변수명이 길어지는것에 개의치 말자. 나는 그게 참 뭐랄까 찝찝했었는데 책을 읽어보니 변수명이 조금 길어지더라도 명료하게 작성한다면 좋은 변수명이다.

- 클래스나 객체 이름에는 명사, 명사구 / 메서드 이름에는 동사, 동사구 . . 메서드나 클래스 이름을 지으면서 구분지어서 생각해본적이 없었는데 각자 역할을 생각해서 이름을 짓자

- 그리고 코드에 줄임말 쓰지 말자...