BAEKJH BE Developer

명시적 API vs 암묵적 API

2021-01-24
BAEKJungHo
OOP

logo

서론

명시적 API 제공과 암묵적 API 제공에 대해서 배워보겠습니다.

명시적 API vs 암묵적 API

예를들어 회원이라는 도메인이 있고 회원을 찾는 기능을 만들어야할 때 명시적 API 와 암묵적 API 는 다음과 같습니다.

  • 암묵적 API
    • findUsers();
  • 명시적 API
    • findUsersGreaterThanEqual();

양측 모두 장단점이 있습니다. 명시적 API 의 경우 어떤 동작을 수행하는지 명확하게 알 수 있고, 메서드 이름이 갖는 추상화와 메서드 안의 코드가 정확히 일치할 가능성이 높습니다. 단점은 특정상황에 대해 알맞은 메서드를 새로만들어야하는 상황이 발생합니다.

반면, 암묵적 API 는 문서화를 잘해놔야합니다. 하지만 회원을 찾는 모든 상황을 단순한 API 로 처리할 수 있습니다.

어떤것이 좋은지는 정해져 있지 않고 상황에 따라 적절하게 판단해서 사용해야합니다.

만약, 명시적 API 가 흔히 사용되는 기능이라면 사용자가 쉽게 이해하도록 명시적 API 를 사용하는 것이 낫습니다.

참고

Real-world Software Development


Comments

Index