다른 사용자 및 제어 수준에 맞게 API를 설계하는 방법은 무엇입니까?

Question

나는 많은 JDBC 또는 액티브처럼 키 값을 저장하는 추상화 계층을 개발하고, 내가 가장 기본적인에서이되도록 API의 다양한 수준, 제공하고자 그러나

get Key 
set Key, Value 
exists Key 
delete Key 

을, 나는 또한 원하는

get Key, Number_of_nodes_to_read_from 
set Key, Value, Number_of_nodes_to_write_to 
exists Key, Number_of_nodes_to_check 
delete Key, Number_of_nodes_to_check, timeout_in_milliseconds 

: 같은 CAP 정리의 데이터 저장소로 사용할 수있는 낮은 수준의 세부 정보를 제공하는 다른 API를 제공하고 정말 나는 또한 값이 일을 추가 한 API처럼 맵 등을 추가 할 수 있습니다 할 일을 복잡하게 만들 감속기, 색인, 필드가있는 레코드, 검색.

어쨌든, 내 질문에 내가 기능 중 하나 개 거대한 목록을 작성해야하는지, 또는 나는 향후 API에 추가 할 수 있습니다 명심 API를 분할한다.

감사

쥬 바이 르

참고 : 내가 가진 원래 질문은 여기에 있습니다 :

Is this API too simple?

Answer 1

장황한 대답 대신에, 난 강력하게 당신이 구글을 시청하는 것이 좋습니다 Techtalk은 "How To Design A Good API and Why it Matters"이라고 제목을 붙였습니다. 이 제어의 높은 수준을 사용자에게 제공 할 필요가로

내 자신의 추천 때까지 만 내장지도 나 언어가 제공하는 사전 인터페이스를 통해 API를 노출하는 것입니다. 당신이 처음부터 너무 많이 노출되면, 당신은 추상화를 제공하기 위해 ... 즉,하는 API의 목적에 완전히 반대되는 특정 구현에 자신을 고정됩니다.

Answer 2

어째서 get Key, Map_of_params
두 번째 매개 변수는 키 - 값의 간단한 맵일 수 있습니다.