DAY 6

🔖 오늘 읽은 범위 : 3. 함수 (40~54p)

---

🤓 책에서 기억하고 싶은 내용

• 함수는 프로그래밍의 가장 기본적인 단위

블록과 들여쓰기

• if문/else문/while문 등에 들어가는 블록은 한줄이어야 한다.
• 함수에서 들여쓰기 수준은 1단이나 2단을 넘어서면 안된다. 1단에서 바로 함수 호출

  public static String renderPageWithSetupsAndTeardowns(
  	PageData pageData, boolean isSuite) throws Exception {
  	if (isTestPage(pageData))
  		includeSetupAndTeardownPages(pageData, isSuite); 
  	return pageData.getHtml();
  }

한 가지만 해라!

• 한가지: 지정된 함수 이름 아래에서 추상화 수준이 하나인 단계만 수행
• 의미 있는 이름으로 다른 함수로 분개될 수 있다면 그 함수는 여러 작업을 하고 있는 것

함수 당 추상화 수준은 하나로

• 한 가지 작업만 하려면 함수 내 모든 문장의 추상화 수준이 동일해야한다

위에서 아래로 코드 읽기: 내려가기 규칙

• 위에서 아래로 이야기처럼 코드를 읽으면 함수 추상화 수준이 한번에 한 단계씩 낮아져야한다.

  TO 설정 페이지와 해제 페이지를 포함하려면, 설정 페이지를 포함하고, 테스트 페이지 내용을 포함하고, 해제 페이지를 포함한다.
  	TO 설정 페이지를 포함하려면, 슈트이면 슈트 설정 페이지를 포함한 후 일반 설정 페이지를 포함한다.
  	TO 슈트 설정 페이지를 포함하려면, 부모 계층에서 “SuiteSetUp” 페이지를 찾 아 include 문과 페이지 경로를 추가한다.
  	TO 부모 계층을 검색하려면, ......

Switch문

• Switch는 N 가지를 처리 → 저차원 클래스에 숨기고 반복하지 않기

  문제

  // 잘못된 switch 사용
  public Money calculatePay(Employee e) 
  throws InvalidEmployeeType {
  	switch (e.type) { 
  		case COMMISSIONED:
  			return calculateCommissionedPay(e); 
  		case HOURLY:
  			return calculateHourlyPay(e);
  		case SALARIED:
  			return calculateSalariedPay(e); 
  		default:
  			throw new InvalidEmployeeType(e.type); 
  	}
  }

  1. 함수가 길다

  2. 한가지 작업만 수행하지를 않는다

  3. SingleResponsibilityPrinciple을 위반 (코드를 변경할 가능성 존재)

  4. OpenClosedPrinciple 위반 (새 직원 유형 추가시마다 코드 변경필요)

  5. 동일 구조의 함수가 무한정 존재

     ```java
     isPayday(Employee e, Date date);
     deliverPay(Employee e, Money pay);
     ```

     해결

     public abstract class Employee {
         public abstract boolean isPayday();
         public abstract Money calculatePay();
         public abstract void deliverPay(Money pay);
     }
     -----------------
     public interface EmployeeFactory {
         public Employee makeEmployee(EmployeeRecord r) throws InvalidEmployeeType; 
     }
     -----------------
     public class EmployeeFactoryImpl implements EmployeeFactory {
         public Employee makeEmployee(EmployeeRecord r) throws InvalidEmployeeType {
             switch (r.type) {
                 case COMMISSIONED:
                     return new CommissionedEmployee(r) ;
                 case HOURLY:
                     return new HourlyEmployee(r);
                 case SALARIED:
                     return new SalariedEmployee(r); default:
                     throw new InvalidEmployeeType(r.type); 
             }
         } 
     }

     switch 문을 Abstract factory에 숨긴다

     factory는 switch 통해 적절한 Employee 파생 클래스의 인스턴스 생성

     calculatePay, isPayday, deliverPay 같은 함수는 Employee 인터페이스 거쳐 호출

     → 다형성으로 실제 파생 클래스 함수 실행

서술적인 이름을 사용하라!

• 이름이 길어도 괜찮다. 긴 이름이 긴 주석보다 좋다.
• 모듈 내에서 함수 이름은 같은 문구, 명사, 동사를 사용

  includeSetupAndTeardownPages
  includeSetupPages
  includeSuiteSetupPage
  includeSetupPage

함수 인수

• 이상적인 인수 개수는 0개
• 3개는 가능한 피한다
• 4개 이상은 특별한 이유 가 있어도 사용 ❌
• 인수는 어렵다. 함수와 인수사이에 추상화 수준이 다르다.
• 인수는 현 시점에서 별로 중요하지 않은 세부사항도 알아야하게만든다.
• 테스트 관점에서도 어렵다
• 출력 인수는 입력 인수보다 더 이해하기 어렵다

많이 쓰는 단항 형식

• 인수에 질문을 던지는 경우

  boolean fileExists("MyFile")

• 인수를 뭔가로 변환해 결과를 반환하는 경우

  InputStream fileOpen("MyFile")

• 이벤트: 입력 인수로 시스템 상태를 바꿈

  passwordAttemptFailedNtimes(int attempts)

플래그 인수

• 플래그 인수는 추하다. 함수가 여러 가지를 처리한다고 대놓고 공표하는 것 → 나눠야 마땅

이항 함수

• 인수가 2개면 이해 어렵다 → 일부 무시한다 → 오류 발생 eg) assertEquals(expected, actual) → 순서 외우지 않으면 헷갈린다
  

삼항 함수

• 순서, 주춤, 무시 → 문제

  assertEquals(message, expected, actual)

인수 객체

• 인수가 2~3개 필요하다면 일부를 독자적인 클래스 변수로 선억 → 하나의 개념을 표현

Circle makeCircle(double x, double y, double radius);
Circle makeCircle(Point center, double radius);

인수 목록

• 가변 인수를 List 형 인수 하나로 취급

String.format("%s worked %.2f" hours.", name, hours);
public String format(String format, Object... args)

void monad(Integer... args);
void dyad(String name, Integer... args);
void triad(String name, int count, Integer... args);

동사와 키워드

• 단항 함수는 인수가 동사/명사 쌍을 이뤄야한다. writeField(name)
  
• 키워드추가 assertEquals < assertExpectedEqualsActual(expected, actual)
  

🤔 떠오르는 생각

• 내용이 조금 씩 어려워져 간다.
• 깊은 이해를 위해서는 클래스에 대한 공부와 실습이 필요하겠다.

🔎 질문

• void includeSetupPageInto(StringBuffer pageText)는 피한다. 변환 함수에서 출력 인수를 사용하면 혼란을 일으킨다?

📝 소감 3줄 요약

• 함수에서 들여쓰기 수준은 1단이나 2단을 넘어서면 안된다.
• 한가지(지정된 함수 이름 아래에서 추상화 수준이 하나인 단계만 수행) 만 해라
• 함수 인수는 적을 수록 좋다.