도서 요약

[클린 코드] 9. 단위 테스트

클린 코드 도서 요약 내용입니다. 9장 단위 테스트 TDD 법칙 세 가지 첫째 법칙: 실패하는 단위 테스트를 작성할 때까지 실제 코드를 작성하지 않는다. 둘째 법칙: 컴파일은 실패하지 않으면서 실행이 실패하는 정도로만 단위 테스트를 작성한다. 셋째 법칙: 현재 실패하는 테스트를 통과할 정도로만 실제 코드를 작성한다. 이렇게 일하면 매일 수십 개, 매달 수백 개, 매년 수천 개에 달하는 테스트케이스가 나온다. 하지만 실제 코드와 맞먹을 정도로 방대한 테스트 코드는 심각한 관리 문제를 유발하기도 한다. 깨끗한 테스트 코드 유지하기 테스트 코드가 지저분할수록 변경하기 어려워진다. 테스트 코드가 복잡할수록 실제 코드를 짜는 시간보다 테스트 케이스를 추가하는 시간이 더 걸리기 십상이다. 새 버전이 출시할 때마다 ..

2022. 12. 19. 10:15

도서 요약

[클린 코드] 8. 경계

클린 코드 도서 요약 내용입니다. 8장 경계 시스템에 들어가는 모든 소프트웨어를 직접 개발하는 경우는 드물다. 때로는 패키지도 사고, 때로는 오픈 소스를 이용한다. 때로는 사내 다른 팀이 제공하는 컴포넌트를 사용한다. 어떤 식으로든 이 외부 코드를 우리 코드에 깔끔하게 통합해야만 한다. 외부 코드 사용하기 Map은 굉장히 다양한 인터페이스로 수많은 기능을 제공한다. 하지만 그만큼 위험도 크다. Map 사용자라면 누구나 Map 내용을 지울 권한이 있다는 말이다. 객체 유형을 제한하지 않는다. Map sensors = new HashMap(); Sensor s = (Sensor) sensors.get(sensorId); 이 코드를 다음 처럼 제네릭을 사용하면 코드 가독성이 크게 높아진다. Map sensor..

2022. 12. 19. 10:14

도서 요약

[클린 코드] 7. 오류 처리

클린 코드 도서 요약 내용입니다. 7장 오류 처리 여기 저기 흩어진 오류 처리 코드 때문에 실제 코드가 하는 일을 파악하기가 거의 불가능하다는 의미다. 오류 처리는 중요하다. 하지만 오류 처리 코드로 인해 프로그램 논리를 이해하기 어려워진다면 깨끗한 코드라 부르기 어렵다. 오류 코드보다 예외를 사용하라 public class DeviceController { public void sendShutDown() { DeviceHandle handle = getHandle(DEV1); // 디바이스 상태를 점검한다 if (handle != DeviceHandle.INVALID) { // 레코드 필드에 디바이스 상태를 저장한다. retrieveDeviceRecord(handle); // 디바이스가 일시정지 상태가..

2022. 12. 19. 10:14

도서 요약

[클린 코드] 6. 객체와 자료 구조

클린 코드 도서 요약 내용입니다. 6장 객체와 자료 구조 변수를 비공개(private)로 정의하는 이유가 있다. 남들이 변수에 의존하지 않게 만들고 싶어서다. 자료 추상화 두 클래스 모두 2차원 점을 표현한다. 그런데 한 클래스는 구현을 외부로 노출하고 다른 클래스는 구현을 완전히 숨긴다. public class Point { public double x; public double y; } public interface Point { double getX(); double getY(); void setCatesian(double x, double y); double getR(); double getTheta(); void setPolar(double r, double theta); } 추상 인터페이스를 ..

2022. 12. 19. 09:56

도서 요약

[클린 코드] 4. 주석

클린 코드 도서 요약 내용입니다. 4장 주석 나쁜 코드에 주석을 달지 마라. 새로 짜라. 브라이언 W. 커니핸, P.J.플라우거 잘 달린 주석은 그 어떤 정보보다 유용하다. 경솔하고 근거 없는 주석은 코드를 이해하기 어렵게 만든다. 오래되고 조잡한 주석은 거짓과 잘못된 정보를 퍼뜨려 해악을 미친다. 주석은 '순수하게 선하지' 못하다. 사실상 주석은 기껏해야 필요악이다. 프로그래밍 언어 자체가 표현력이 풍부하다면, 아니 우리에게 프로그래밍 언어를 치밀하게 사용해 의도를 표현할 능력이 있다면, 주석은 거의 필요하지 않으리라. 아니, 전혀 필요하지 않으리라. 우리는 코드로 의도를 표현하지 못해, 그러니깐 실패를 만회하기 위해 주석을 사용한다. 주석은 언제나 실패를 의미한다. 때때로 주석 없이는 자신을 표현할 ..

2022. 12. 19. 09:55

도서 요약

[클린 코드] 5. 형식 맞추기

클린 코드 도서 요약 내용입니다. 5장 형식 맞추기 뚜껑을 열었을 때 독자들은 코드가 깔끔하고 일관적이며 꼼꼼하다고 감탄하면 좋겠다. 질서 정연하다고 탄복하면 좋겠다. 모듈을 읽으며 두 눈이 휘둥그래 놀라면 좋겠다. 전문가가 짰다는 인상을 심어주면 좋겠다. 프로그래머라면 형식을 깔깜하게 맞춰 코드를 짜야 한다. 팀으로 일한다면 팀이 합의해 규칙을 정하고 모두가 그 규칙을 따라야 한다. 형식을 맞추는 목적 코드 형식은 중요하다! 너무 중요해서 무시하기 어렵다. 코드 형식은 의사소통의 일환이다. 의사소통은 전문 개발자의 일차적인 의무다. 어쩌면 '돌아가는 코드'가 전문 개발자의 일차적인 의무라 여길지도 모르겠다. 오늘 구현한 기능이 다음 버전에서 바뀔 확률은 아주 높다. 코드가 바뀌어도 맨 처음 잡아놓은 구..

2022. 12. 19. 09:55

도서 요약

[클린 코드] 3. 함수

클린 코드 도서 요약 내용입니다. 3장 함수 작게 만들어라! 함수를 만드는 첫째 규칙은 '작게!'다. 둘째 규칙은 '더 작게'다. 얼마나 짧아야 하느냐고? public static String renderPageWithSetupsAndTeardowns(PageData pageData, boolean isSuite) { if (isTestPage(pageData)) includeSetupAndTeardownPages(pageData, isSuite); return pageData.getHtml(); ) 블록과 들여쓰기 if문/else문/while 문 등에 들어가는 블록은 한 줄이어야 한다는 의미다. 함수에서 들여쓰기 수준은 1단이나 2단을 넘어서면 안된다. 한 가지만 해라! 함..

2022. 12. 19. 09:54

도서 요약

[클린 코드] 2. 의미 있는 이름

클린 코드 도서 요약 내용입니다. 2장 의미 있는 이름 들어가면서 소프트웨어에서 이름은 어디나 쓰인다. 변수, 함수, 인수와 클래스, 패키지, 소스파일, 디렉토리, jar파일, war파일, ear 파일 이 장에서는 이름을 잘 짓는 간단한 규칙을 몇가지 소개한다. 의도를 분명히 밝혀라 의도가 분명한 이름이 정말로 중요하다는 사실을 거듭 강조한다. 좋은 이름을 지으려면 시간이 걸리지만 좋은 이름으로 절약하는 시간이 훨씬 더 많다. 주석이 필요하다면 의도를 분명히 드러내지 못했다는 말이다. int d; // 경과 시간(단위: 날짜) 이름 d는 아무 의미도 드러나지 않는다. 경과시간이나 날짜라는 느낌이 안든다. 측정하려는 값과 단위를 표현하는 이름이 필요하다. int elapsedTimeInDays; int d..

2022. 12. 19. 09:54

도서 요약

[클린 코드] 1. 깨끗한 코드

클린 코드 도서 요약 내용입니다. 1장 깨끗한 코드 이 책을 읽고 있다면 이유는 두 가지다. 프로그래머라서 더 나은 프로그래머가 되려고 이 책은 좋은 프로그램 작성 요령을 설명하는 책이다. 코드를 최대한 다양한 각도에서 살펴본다. 이 책을 읽고 나면 코드에 대한 많은 사실을 배운다. 좋은 코드와 나쁜 코드를 구분하는 능력도 생긴다. 좋은 코드를 작성하는 방법도 익힌다. 나쁜 코드를 좋은 코드로 바꾸는 실력도 쌓인다. 코드가 존재하리라 코드를 자동으로 생성하는 시대가 다가온다? 헛소리! 앞으로 코드가 사라질 가망은 전혀 없다. 왜? 코드는 요구사항을 상세히 표현하는 수단이니까! 어느 정도 수준이 되면 코드의 도움없이 요구사항을 표현하기란 불가능하다. 요구사항을 명시하는 수밖에 없다. 기계가 실행할 정도로 ..

2022. 12. 19. 09:54

도서 요약

[클린 코드] 1. 들어가면서

클린 코드 도서 요약 내용입니다. 0장 들어가면서 돌아간다고 생각했던 코드를 허겁지겁 디버깅하는가? 고객이 무더기로 이탈하고, 관리자가 압박을 가하는가? 어떻게 해야 하나? 답은 장인 정신이다. 장인 정신을 익히는 과정은 두 단계로 나뉜다. 바로 이론과 실전이다. 장인에게 필요한 원칙, 패턴, 기법, 경험이라는 지식을 습득해야 한다. 열심히 일하고 연습해 지식을 몸과 마음으로 체득해야 한다. 자전거 타기 물리적인 지식을 가르칠 수 있다. (중력, 마찰력, 각 운동량, 질량 중심) 그래도 자전거를 처음 타는 사람이라면 100% 넘어진다. 구현도 마찬가지다 깨끗한 코드를 만드는 "그럴듯한" 원칙을 모두 적어주고 알아서 하라고 버려둔다면?? 깨끗한 코드를 작성하는 방법은 배우기 어렵다. 고생을 해야 한다. 스..

2022. 12. 19. 09:53

도서 요약

[클린 아키텍처] 9. 리스코프 치환 원칙

클린 아키텍처 도서 요약 내용입니다. 9장 LSP: 리스코프 치환 원칙 1988년 바바라 리스코프는 하위 타입을 아래와 같이 정의했다. 여기에서 필요한 것은 다음과 같은 치환원칙이다. S 타입의 객체 o1 각각에 대응하는 T타입 객체 o2가 있고, T타입을 이용해서 정의한 모든 프로그램 P에서 o2의 자리에 o1을 치환하더라도 P의 행위가 변하지 않는다면, S는 T의 하위 타입이다. 상속을 사용하도록 가이드하기 License라는 클래스가 있다. 이 클래스는 calcFee()라는 메서드를 가지며, Billing 애플리케이션에서 이 메서드를 호출한다. License에는 PersonalLicense와 BusinessLicense라는 두가지 '하위 타입'이 존재한다. 이 설계는 LSP를 준수하는데, Billin..

2022. 12. 19. 09:45

도서 요약

[클린 아키텍처] 34. 빠져 있는 장

클린 아키텍처 도서 요약 내용입니다. 34장 빠져 있는 장 소프트웨어는 올바르게 정의된 경계, 명확한 책임, 그리고 통제된 의존성을 가진 클래스와 컴포넌트로 구성될 것이다. 하지만 악마는 디테일(구현 세부사항)에 있는 법이며, 이점을 심사숙고 하지 않는다면 마지막 고비에 걸려 넘어지기 십상일 것이다. 예를 들어 온라인 서점을 구축하고 있으며, 고객이 주문 상태를 조회할 수 있어야 한다는 유스케이스를 구현해야 한다고 해보자. 계층 기반 패키지 가장 단순한 설계 방식은 전통적인 수평 계층형 아키텍처다. 기술적인 관점에서 해당 코드가 하는 일에 기반해 그 코드를 분할한다. 이 방식을 '계층 기반 패키지'라고 부른다. 이 전형적인 계층형 아키텍처에는 웹, '업무 규칙', 영속성 코드를 위해 계층이 각각 하나씩 ..

2022. 12. 19. 09:44

도서 요약

[클린 아키텍처] 32. 프레임워크는 세부사항이다

클린 아키텍처 도서 요약 내용입니다. 32장 프레임워크는 세부사항이다 프레임워크 제작자 대다수의 프레임워크 제작자는 커뮤니티에 도움이 되기를 바라는 마음에 자신의 작업물을 무료로 제공한다. 칭찬 받을 일이다. 하지만 이들은 당신이 풀어야 할 특별한 관심사를 염두에 두지 않는다. 프레임워크 제작자는 당신을 알지 못하며, 당신이 풀어야 할 문제도 알지 못하기 때문이다. 프레임워크 제작자는 자신이 해결해야 할 고유한 문제나 자신의 동료와 친구들의 문제를 알고 있다. 그리고 그러한 문제들을 해결하기 위해 프레임워크를 만든다. 당신의 문제를 해결하기 위해서가 아니다. 물론 당신의 문제는 프레임워크가 풀려는 문제와 꽤 많이 겹칠 것이다. 혼인 관계의 비대칭성 당신은 프레임워크를 위해 대단히 큰 헌신을 해야 하지만,..

2022. 12. 19. 09:44

도서 요약

[클린 아키텍처] 31. 웹은 세부사항이다

클린 아키텍처 도서 요약 내용입니다. 31장 웹은 세부사항이다. 끝없이 반복하는 추 IT 역사 전체로 시야를 넓히면 웹은 아무것도 바꾸지 않았다. 웹은 우리가 발버둥치면서 생기는 여느 수많은 진동 중 하나에 불과하다. 이 진동은 우리가 태어나기 전에도 있어 왔고, 우리가 은퇴한 뒤에도 지속될 것이다. 아키텍트로서 우리는 멀리 내다봐야 한다. 이 진동은 그저 핵심 업무 규칙의 중심에서 밀어내고 싶은 단기적인 문제일 뿐이다. Q 회사 이야기를 한번 보자. Q사는 상당히 인기를 끈 개인용 재무 시스템을 개발했다. 이어서 출시된 버전에서 웹 브라우저에서 보이고 동작하도록 변경했다. 도대체 어떤 마케팅 천재가 데스크톱에서 실행되는 개인용 재무 소프트웨어가 웹브라우저와 같은 룩앤필을 제공해야만 한다고 결정했단 말인..

2022. 12. 19. 09:43

도서 요약

[클린 아키텍처] 30. 데이터베이스는 세부사항이다.

클린 아키텍처 도서 요약 내용입니다. 30장 데이터베이스는 세부사항이다. 아키텍처 관점에서 데이터베이스는 엔티티가 아니다. 즉, 데이터베이스는 세부사항이라서 아키텍처의 구성요소 수준으로 끌어올릴 수 없다. 소프트웨어 시스템의 아키텍처와 데이터베이스의 관계를 건물로 비교하면 건물의 아키텍처와 문 손잡이의 관계와 같다. 데이터베이스는 데이터에 접근할 방법을 제공하는 유틸리티다. 아키텍처 관점에서 보면 이러한 유틸리티는 저수준의 세부사항(매커니즘)일 뿐이라서 아키텍처와는 관련이 없다. 관계형 데이터베이스 관계형 데이터베이스의 기술이 얼마나 뛰어나든, 유용하든, 아니면 수학적으로 견고하든, 결국은 그저 기술일 뿐이다. 그리고 이는 관계형 데이터베이스가 세부사항임을 뜻한다. 관계형 테이블은 특정한 형식의 데이터에..

2022. 12. 19. 09:43