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

이번 아이템은 API 설계요령을 설명한다. 1. 메서드 이름을 신중히 짓자 항상 표준 명명 규칙을 따라야 한다. 이해할 수 있고, 같은 패키지에 속한 다른 이름들과 일관데게 짓는게 최우선 목표다. 긴 이름을 피하고 애매하면 자바 라이브러리의 API 가이드를 참조하자. 2. 편의 메서드를 너무 많이 만들지 말자 모든 메서드는 각각 자신의 소임을 다해야 한다. 메서드가 너무 많은 클래스는 익히고, 사용하고, 문서화하고, 테스트하고, 유지보수하기 어렵다. 아주 자주 쓰일 경우에만 별도의 약칭 메서드를 두자. 3. 매개변수 목록을 짧게 유지하자 4개 이하가 좋다. 4개가 넘어가면 매개변수를 전부 기억하기가 쉽지 않다. 같은 타입의 매개변수 여러 개가 연달아 나오는 경우가 특히 좋지 않다. 과하게 긴 매개변수 목..

2023.12.28