item 51. 메서드 시그니처를 신중히 설계하라

API 설계 요령들

 

1. 메서드 이름을 신중히 짓자.
   • 항상 표준 명명 규칙을 따라야 한다.
2. 편의 메서드를 너무 많이 만들지 말자.
   • 메서드가 너무 많은 클래스는 익히고, 사용하고, 문서화하고, 테스트하고, 유지보수하기 어렵다.
   • 클래스나 인터페이스는 자신의 각 기능을 완벽히 수행하는 메서드로 제공해야 한다.
   • 확신이 서지 않으면 만들지 말아라
3. 매개변수 목록은 짧게 유지하자.
   • 4개 이하가 좋다.
   • 같은 타입의 매개변수 여러개가 연달아 나오는 경우는 해롭다.
   • 과하게 긴 매개변수 목록을 짧게 줄여주는 기술 3가지
     1. 여러 메서드로 쪼개기
     2. 매개변수 여러 개를 묶어주는 도우미 클래스를 만들기(일반적으로 정적 멤버 클래스)
     3. 객체 생성에 사용한 빌더 패턴을 메서드 호출에 응용한다. (매개변수가 많고 그 중 일부를 생략해도 괜찮을 때 많이 사용)
4. 매개변수의 타입으로는 클래스보다 인터페이스가 낫다.
   • 매개변수로 적합한 인터페이스가 있다면 그 인터페이스를 직접 사용하자.
5. boolean보다는 원소 두개짜리 열거 타입이 낫다.
   • 코드를 읽고 쓰기가 더 쉬워지기 때문이다.

 

와~ 짧다.. 좋다