이펙티브자바 아이템51
-
아이템 51. 메서드 시그니처를 신중히 설계하라책/이펙티브자바 2021. 9. 16. 15:32
API 설계 요령들을 알아보자. 메서드 이름을 신중히 짓자. 항상 표준 명명 규칙 (Item68)을 따르자. 이해할 수 있고, 같은 패키지에 속한 다른 이름들과 일관되게 짓는게 우선 목표다. 개발자 커뮤니티에서 널리 받아들여지는 이름을 사용하자. 긴 이름은 피하자. 자바 라이브러리의 API 가이드를 참조하자. 편의 메서드를 너무 많이 만들지 말자. 모든 메서드는 각각 자신의 소임을 다해야 한다. 메서드가 너무 많은 클래스는 익히고, 사용하고, 문서화하고, 테스트하고, 유지보수하기 어렵다. 아주 자주 쓰일 경우에만 별도의 약칭 메서드를 두자. 확신이 서지 않으면 만들지 말자. 매개변수 목록은 짧게 유지하자. 4개 이하로 만들자. 같은 타입 매개변수 여러 개가 연달아 나오는 경우는 특히 해롭다. 매개변수 목..