API 설계 요령

1. 메서드 이름을 신중히 짓기

   • 같은 패키지에 속한 다른 이름들과 인관되게 짓자
   • 개발자 커뮤니티에서 널리 받아들여지는 이름 사용
   • 긴 이름 피하자

2. 편의 메서드를 너무 많이 만들지 말기

   • 아주 자주 쓰일 경우에만 별도의 약칭 메서드를 두자

3. 매개변수 목록은 짧게 유지하기

   • 긴 매개변수 목록 줄이는 기술

     • 여러 메서드로 쪼갠다

     • 매개변수 여러 개를 묶어주는 도우미 클래스를 만들자

       (ex. 매개변수 여러개를 독립된 하나의 개념으로 볼 수 있을 때 추천)

     • 객체 생성에 사용한 빌더 패턴 응용

       (모둔 매개변수를 하나로 추상화한 객체를 정의하고, 클라이언트에서 객체의 세터를 호출해 필요한 값을 설정. → 이후 execute 메서드를 호출해 유효성 검사 후 계산 수행)

4. 매개변수 타입으로는 클래스보다는 인터페이스가 더 낫다

   • 인터페이스 대신 클래스를 사용하면 클라이언트에게 특정 구현체만 사용하도록 제한하는 것임

5. boolean보다는 원소 2개짜리 열거 타입이 낫다

   • 열거 타입은 코드를 읽고 쓰기가 더 쉬워지고, 선택지를 추가하기도 쉬움

     Thermometer.newInstance(true);
     
     // 읽기 쉽고 선택지 추가 시 열거 타입에 추가하면 됨 
     Thermometer.newInstance(TemperatureScale.CELSIUS);
     

   • 각 열거 타입에 대한 의존성을 개별 열거 타입 상수의 메서드 안으로 넣을 수 있음