item51

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

메서드 이름을 신중히 짓자

항상 표준 명명 규칙을 따라야 한다. 이해할 수 있고, 같은 패키지에 속한 다른 이름들과 일관되게 짓는 게 최우선 목표다. 그 다음으로는 자바 라이브러리의 API 가이드를 참조해서 짓자. 너무 긴 이름은 피하자.

표준 명명 규칙

편의 메서드를 너무 많이 만들지 말자

모든 메서드는 각각 자신의 소임을 다해야 한다. 메서드가 너무 많은 클래스는 익히고, 사용하고, 문서화하고, 테스트하고, 유지보수하기 어렵다. 클래스나 인터페이스는 자신의 각 기능을 완벽히 수행하는 메서드로 제공해야 한다. 아주 자주 쓰일 경우에만 별도의 약칭 메서드를 두고, 확신이 서지 않으면 만들지 말자.

매개변수 목록은 짧게 유지하자

4개 이하가 좋다. 일단 4개가 넘어가면 매개변수를 전부 기억하기가 쉽지 않다.

같은 타입의 매개변수 여러 개가 연달아 나오는 경우가 특히 해롭다.

과하게 긴 매개변수 목록을 짧게 줄여주는 기술

1. 여러 메서드로 쪼갠다.
   • List 인터페이스가 좋은 예이다. 지정된 범위의 부분 리스트에서의 인덱스를 찾는 메서드를 만든다고 해보자. 그렇다면 (시작 인덱스, 끝 인덱스, 찾을 원소) 총 3가지의 매개변수가 필요하지만 List 에서는 subList 와 indexOf 두개의 메서드로 나누어져 있어 두 메서드를 조합해서 사용하면 된다.
2. 매개변수 여러 개를 묶어주는 도우미 클래스를 만든다.
   • 일반적으로 이런 도우미 클래스는 정적 멤버 클래스로 둔다.
   • 예시 코드
3. 객체 생성에 사용한 빌더 패턴을 메서드 호출에 응용한다.
   • 예시 코드