FEATURE: Add CompletableFuture BTree insert/get API

[oliviarla]

🔗 Related Issue

• bopCreate/bopInsert/bopInsertAndGetTrimmed/bopGet/bopMultiGet/bopSortMergeGet API 구현에 대한 커밋을 추가해두었습니다.

⌨️ What I did

• 구현 관점 특이 사항

  • GenericTranscoder 대신 CFB로부터 Transcoder<Object> 타입을 가져와 Transcoder<T> 타입으로 형변환합니다.
  • Collection 타입의 경우 Decode하는 로직을 별도 스레드에 위임하지 않습니다.

• SMGet 관련 사항

  • 기존에 없던 SMGet에서 하나의 BKey를 입력받는 API를 추가하느라, 기존 타입 생성자에 대한 변경사항이 있습니다.
  • SMGetResult#mergeSMGetResults 정적 메서드에 값들을 합치는 로직을 위임합니다.
  • 기본적으로 사용자가 설정한 bkey range의 범위에 따라 bkey -> btree item key 순으로 정렬됩니다. 다만 하나의 BKey를 입력받는 API의 경우 btree item key가 항상 ascending 순으로 정렬됩니다.

• 새로 추가된 VO 클래스들과 각 메서드의 서버 응답 별 반환 값은 New Interface 설계(Notion 문서)에 정리되어 있습니다.

• 가장 기본적인 메서드들만 추가하였고, bop update, bop incr 등의 API는 다음 PR로 추가할 예정입니다.

[brido4125]

btree api PR에 전체적으로 아래와 같은 설명 덧붙여 주세요

• as-is 상태에서의 반환값 / to-be 상태에서의 반환값
• as-is 상태에서의 예외 시 반환 값 / to-be 상태에서의 예외 시 반환값

위 부분이 나중에 해당 기능 릴리즈 할 때, 어차피 사용자에게도 가이드 되어야 할 내용입니다.
번거롭더라도 지금 미리 작성한다고 생각하고 해주시면 감사하겠습니다

[oliviarla]

@brido4125
API 메서드마다 javadoc에 반환 타입에 대한 내용을 자세히 추가해두었습니다.
as-is가 ArcusClient#asyncBop... 말씀하시는게 맞다면, 저는 이 둘을 비교하면 오히려 더 헷갈릴 것이라고 생각합니다.
따라서 현재 형태에서 반환 값이 적절한지 리뷰해주시면 감사하겠습니다. (exception이 발생하는 상황은 노션에 정리되어 있습니다.)

[oliviarla]

@brido4125 @uhm0311
리뷰 모두 반영해두었습니다.

[uhm0311]

질문입니다.

[jhpark816]

리뷰 완료

[uhm0311]

리뷰입니다.

[jhpark816]

일부 리뷰

[jhpark816]

default 값 50은 어떤 기준으로 설정한 것인가요?

bop get/mget/smget 연산마다 달라질 것 같은데요.
bop get에서는 default가 0이어야 하고,
그 외는 count 값이 설정되어야 할 것 같습니다.

따라서, default 값 0이 맞을 것 같습니다.

[oliviarla]

bop get/mget/smget 에서 모두 오류 없이 사용 가능한 최대 값을 설정해둔 것 뿐입니다.
default 값을 0으로 두면 mget 시에 항상 50으로 재정의해두어야 하기 때문에 사용할 때 불편하지 않을까 싶었는데,
0으로 두는게 더 낫다면 변경하겠습니다.

[oliviarla]

@jhpark816 리뷰 반영했습니다. resolve하지 않은 코멘트에 대해서는 의견 주시거나 일단 resolve 상태로 변경해주시면 됩니다.

[jhpark816]

@uhm0311
리뷰 바랍니다.