Skip to content

DOC: Update ConnectionFactoryBuilder docs#1053

Merged
jhpark816 merged 1 commit intonaver:developfrom
f1v3-dev:docs/cfb
Mar 6, 2026
Merged

DOC: Update ConnectionFactoryBuilder docs#1053
jhpark816 merged 1 commit intonaver:developfrom
f1v3-dev:docs/cfb

Conversation

@f1v3-dev
Copy link
Collaborator

@f1v3-dev f1v3-dev commented Mar 5, 2026

🔗 Related Issue

⌨️ What I did

변경 내용 미리보기 링크

  • ConnectionFactoryBuilder 인자에 대한 문서 개선 및 추가를 진행했습니다.
    • setShouldOptimize 개선
    • setDaemon 개선
    • useNagleAlgorithm 추가
    • setInitialObservers 추가
    • setReadPriority / setAPIReadPriority 추가

@f1v3-dev f1v3-dev requested a review from oliviarla March 5, 2026 09:27
@f1v3-dev f1v3-dev self-assigned this Mar 5, 2026
Copy link
Collaborator

@oliviarla oliviarla left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

리뷰 완료입니다.

Operation Queue 내 연속된 GET 요청을 최대 100개 단위로 조합하여 하나의 요청으로 처리하는 최적화 로직 사용 여부를 설정한다.

이 기능은 기존 spymemcached 호환을 위해 존재하며, cancel, replication 등의 시나리오에서 검증이 충분히 이루어지지 않았다.
따라서, 비활성화(false)를 권장한다.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

기본값인 비활성화(false) 사용을 권장한다. 이런 표현이면 좋겠습니다.

- 기본값은 true로 응용 종료 시 I/O 스레드가 함께 종료된다.
- 기본값을 유지하며, Graceful Shutdown이 필요한 경우 `shutdown(long timeout, TimeUnit unit)`을 명시적으로 호출하는 것을 권장한다.

`setDaemon(false)` 설정 후 명시적으로 `shutdown()`이 호출되지 않은 상태에서 프로세스 종료가 시도ㅗ디면, 정상적으로 종료되지 않을 수 있다.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

오타 있습니다.


`setInitialObservers`는 노드 연결 상태를 모니터링하기 위한 Observer를 등록하는 메서드이다.

ArcusClient 또는 ArcusClientPool 생성 시 내부 초기화 과정에서 사용되어 등록한 Observer가 정상적으로 동작하지 않을 수 있다.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

않을 수 있다. -> 않는다. 아닌가요?

@f1v3-dev
Copy link
Collaborator Author

f1v3-dev commented Mar 6, 2026

리뷰 완료입니다.

리뷰해주신 내용 반영하였습니다.

@jhpark816
Copy link
Collaborator

@oliviarla 최종 리뷰 바랍니다

@jhpark816 jhpark816 merged commit e61f3bb into naver:develop Mar 6, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants