inflearn logo
강의

강의
N
챌린지

챌린지
멘토링

멘토링
N
클립

클립
로드맵

로드맵
지식공유

[워밍업 클럽 스터디 2기 - BE] (클린코드, 테스트코드) 2주차 발자국

김민성
0

인프런 워밍업 클럽 스터디 2기 - 백엔드 클린코드, 테스트 코드(Java, Spring Boot)

Readable Code : 읽기 좋은 코드를 작성하는 사고법

해당 강의를 학습하며 정리하는 내용입니다.

 

1주차 발자국에 이어서 이번주도 배운 내용을 정리하고 회고를 작성한다.

이번주는 지난주에 이어 Readable Code 나머지 모든 강의를 수강하는 한주였다.

키워드 형식으로 정리한다.

 

객체 지향 적용하기

상속과 조합

[객체지향 적용하기 - 상속과 조합 - 셀을 상속에서 조합으로 바꾸기](https://github.com/iamminseongKim/readable-code/commit/86a49db553a752eca745a0d462125ee0d0b4ad70)

Value Object

만원 지폐가 일렬번호(인스턴스)가 다르다고 가치가 다른 즉 다른 만원인가?

객체의 동등성을 보장해주자!

 

VO vs Entity

class UserAccount {
	private String userId; // 식별자
	private String 이름;
	private String 생년월일;
	private Address 집주소;
}

이건 Entity

class Address {
	private String 시도;
	private String 시군구;
	private String 도로명;
	private String 건물번호;
}

이건 VO이다.

 

[Value Object - Cell의 상태를 value object로 만들기.](https://github.com/iamminseongKim/readable-code/commit/b667b43de3dfa2fa78fc6a4baf24af570acf69d6)

 

일급 컬렉션

 

일급 시민

ex) 일급 함수

함수형 프로그래밍 언어에서, 함수는 일급 시민이다. 함수는 변수에 할당될 수 있고, 인자로 전달될 수 있고, 함수의 결과로 함수가 반환될 수 있다.

일급 컬렉션

 

Enum의 특성과 활용

다형성 활용하기

 변하는 것과 변하지 않는 것을 분리하여 추상화하고, OCP를 지키는 구조

[다형성 활용하기 - CellSign을 다형성을 가져서 개발해보기](https://github.com/iamminseongKim/readable-code/commit/83f472152ec7a4b82d5d92c17bdb742089b381f6)

 

숨겨져 있는 도메인 개념 도출하기

코드 다듬기

주석의 양면성

주석은 죄악이다! VS. 주석 좀 남겨줘라!

아니 그럼 주석은 언제 씁니까?

 

좋은 주석은 뭘까

우리가 가진 모든 표현 방법을 총동원해 코드에 의도를 녹여내고, 그럼에도 불구하고 전달해야 할 정보 남았을 때 사용하는 주석

[주석 제거 - gameStatus - 제거 후 책임 변경](https://github.com/iamminseongKim/readable-code/commit/5810a74a9cbfc41b2d2bc638f58a437f26bec2b5)

 

변수와 메서드의 나열 순서

중요한 것은, 나열 순서로도 의도와 정보를 전달할 수 있다는 것

[코드 다듬기 - 변수와 메서드의 나열 순서](https://github.com/iamminseongKim/readable-code/commit/c3fea40a581cfd0a418114473350fe430686a0d9)

 

패키지 나누기

대규모 패키지 변경은 팀원과의 합의를 이룬 시점에서 하자.

[코드 다듬기 - 패키지 나누기](https://github.com/iamminseongKim/readable-code/commit/8f650421839f7b68021dc1a983a2a1cf29a64b8f)

 

기능 유지보수하기 (1) - 버그 잡기

이전 코드에선 지뢰판에 깃발을 전부 꽂으면 승리했다. 이걸 수정해보는 과정인데 셀을 체크하는 과정의 핵심이 뭔지 파악하고 고치는 작업이었다.

 

[코드 다듬기 - 기능 유지보수하기 (1) - 버그 잡기 - 객체의 책임을 명확하게 했기 때문에 고치기 쉽다.](https://github.com/iamminseongKim/readable-code/commit/8654bb3d727a9bffe4f7b2b8ab06211446a3cae8)

객체의 책임을 명확하게 분리했기 때문에 고치기 매우 쉬웠다.

 

기능 유지보수하기 (2) - 알고리즘 교체하기

재귀함수를 Stack으로 변경해서 주변 셀을 여는 로직을 개선했다.

[코드 다듬기 - 기능 유지보수하기 (2) - 알고리즘 바꾸기. 재귀함수 -> stack](https://github.com/iamminseongKim/readable-code/commit/3bbcfe61b7f0dca6fcee51efc2f3adbfb298aa3d)

원리는 이해하겠는데, 솔직히 이걸 일상에서 떠올릴 수 있을지 내 실력이 부족하다는걸 또 한번 느끼는 시간이었다.

 

IDE의 도움 받기

[코드 다듬기 - IDE의 도움 받기, 코드 정렬, Sonarlint, .editorconfig](https://github.com/iamminseongKim/readable-code/commit/11469a97f84c4a2d04e6a499fdb5f37b106ebbff)

리팩토링 연습

 

리팩토링 (1) - 추상화 레벨

이 순서대로 리팩토링하면 좀 정리하기 쉽다.

리팩토링 (2) - 객체의 책임과 응집도

코드를 이해하고 도메인을 이해한다면 다음과 같이 로직을 수정할 수 있다. 이 기법들을 자유자재로 사용할 수 있다면 해당 도메인을 이해했다고 생각한다!

리팩토링 (3) - 관점의 차이로 달라지는 추상화

provider 인터페이스를 만들었는데, 구현체는 io에 provider 패키지를 만들어서 따로 분리 보관했다.

io에 만드는 구현체는 파일을 읽는, 그런 내용이 중요한것이기 때문에 따로 보관했고,

나중에 파일이 아니라 DB에서 읽는다면, 또 다른 패키지에서 인터페이스를 구현해서 갈아 끼우기만 하면된다.

 

핵사고날 아키텍쳐 - 포트(인터페이스)와 어댑터(구현체)

 

해당 챕터에선 추가적으로 개선할 방향을 찾고, 클린 아키텍쳐를 위한 새로운 사고를 열어 볼 수 있었다.

기억하면 좋은 조언들

능동적 읽기

오버 엔지니어링

은탄환은 없다

Day 7 미션

 

섹션 7에 나오는 StudyCafe를 이전 까지 배운 내용으로 스스로 리팩토링 하는 과제였다.

아쉬운점은 내가 기한을 착각하고 마감일에 리팩토링을 시작했다는 점이고, 다행인건 그날이 한글날이라 그래도 시간이 좀 있었다.

내가 이 미션을 하면서 중점적(순서)으로 생각한 점은 다음과 같다.

  1. 의미단위로 공백 끊기

  2. 큰 단위로 메서드 추출하기

  3. 의존성 주입을 할 수 있는 부분을 찾기 (DIP)

  4. 객체 단위로 추상화(추출)할게 있는지 찾기

  5. 메서드의 책임이 올바른 위치에 있는지 판단하기

  6. 일급 컬랙션 적용하기

  7. 도메인을 이해해서 추가적인 개념을 도출하기

해당 순서를 중요하게 생각하면서 리팩토링을 진행했다.

그리고 다음날 깨끗한 정신으로 다시한번 보니깐 진짜 좀 별로였다 ㅋㅋ ㅠ

 

그래서 다음날 내가 추가한 부분은 다음과 같다.

 

기존에는 OutputHandler 문자를 출력하는 부분에서 계산을 해서 콘솔에 출력하였다.

그래서 나는 PassCost라는 계산하는 객체를 만들어서 계산은 여기서 다 하고 출력할 때는 여기서 getter를 통해 값만 얻어 오도록 수정했다.

[PassCost 만들기](https://github.com/iamminseongKim/readable-code/commit/4c01ec8cf31203349d3ebacadf5fe4cdf0299bb2#diff-2a97fd57d1b72b30fddf91a8cb3453fff97b46bab75082461641cfe8b4a491ff)

전체 회고

이번주를 끝으로 Readable Code 읽기 좋은 코드를 작성하는 사고법 강의가 끝났다.

솔직히 시간이 좀 있었는데 TestCode강의를 시작하지 못한게 조금 아쉽긴 하다.

 

그래도 이번 강의를 통해 진짜 좋은 코드가 무엇인지, 물론 이 강의에서 나오는 개념들이 정답은 아닐지 몰라도

해당 강의를 통해 사고를 넓일 수 있는 계기가 되어서 너무 좋았다.

 

메서드를 추상화 하는 행위가 이 강의를 듣기 전까지는 명확하게 인지하진 못했다. 그냥 남들이 하니깐, 조금 하고 솔직히 많이 안했다.

하지만 내가 추상화를 해보면서도 코드가 더 읽기 쉬워지고 도메인을 이해하고 있다는걸 느껴서 적극적으로 적용해보려고 한다.

 

다음주에는 공휴일이 없으니깐 출 퇴근 후에 빡세게 들어야한다 ㅠㅠ. 그래도 좀 열심히 들어서 여유로운 주말을 맞이하고 싶다~

 

 

 


 

 

 

 

 

 

 

워밍업클럽 클린코드

답변 0