[#9] 선언형 요청 DSL 기본 구조를 구현한다

[opficdev]

🔗 연관된 이슈

• closed 선언형 요청 DSL 기본 구조를 구현한다 #9

📝 작업 내용

📌 요약

• 엔드포인트 프로토콜 구현
• 요청 진입 클라이언트 구현
• 요청 빌더 기본 체이닝 구현
• DSL 기본 구조 테스트 구현

🔍 상세

• 엔드포인트 프로토콜 구조 구현
  • NXEndpoint
  • 기본 configure extension
• 요청 진입 클라이언트 구조 구현
  • NXAPIClient
  • get/post/put/patch/delete
  • request(_ endpoint:)
• 요청 빌더 기본 체이닝 구조 구현
  • NXRequestBuilder
  • query, header, headers, accept, authorized, timeout
  • immutable 패턴(modifying) 기반으로 새 인스턴스 반환
• 테스트 추가
  • NXDeclarativeRequestDSLTests
  • HTTP 메서드 진입점 설정 검증
  • Endpoint configure 적용 검증
  • Builder value semantics 검증
  • header/accept 누적 동작 검증

테스트

• swift test 통과

📸 영상 / 이미지 (Optional)

[gemini-code-assist]

Code Review

이 풀 리퀘스트는 선언형 네트워크 요청 DSL 구성을 위한 핵심 컴포넌트들을 추가합니다. NXRequestBuilder에 제네릭을 도입하여 응답 타입 정보를 유지하고, Dictionary.merge를 활용해 헤더 설정 로직을 개선할 것을 권장합니다.

[gemini-code-assist]

forEach를 통한 개별 할당 대신 Dictionary.merge를 사용하면 코드가 더 간결해지고 의도가 명확해집니다.

            requestSpec.headers.merge(values) { _, new in new }

References

1. RequestSpec should remain internal as a separate public DSL is planned for external use.

[gemini-code-assist]

Code Review

이번 풀 리퀘스트는 NXAPIClient, NXEndpoint, NXRequestBuilder를 도입하여 선언형 네트워크 요청을 위한 DSL 기초 구조를 구축했습니다. 리뷰를 통해 NXEndpoint의 Response 타입을 NXRequestBuilder에 반영하여 타입 안정성을 강화하는 설계 개선과, 헤더 설정 시 merge 메서드를 활용하여 코드를 더 간결하고 선언적으로 작성하는 방안이 제안되었습니다.