[Feat] LivithNetworking Plugin 및 ETag 캐시 구현

[JinUng41]

PULL REQUEST

📄 작업 내용

• LivithNetworking에 요청/응답 생명주기를 확장할 수 있는 NetworkPlugin 구조를 추가했습니다.
• 특정 GET endpoint만 가능한 ETag 메모리 캐시를 구현했습니다.

flowchart LR
    Endpoint[NetworkEndpoint] --> Builder[RequestBuilder]
    Builder --> PluginPrepare[Plugin.prepare]
    PluginPrepare --> Auth[Interceptor.adapt]
    Auth --> ETag[ETag 적용]
    ETag --> Send[Transport 전송]
    Send --> PluginReceive[Plugin.didReceive]
    PluginReceive --> Decision{응답 처리}

    Decision -->|401| Retry[refresh 후 1회 retry]
    Decision -->|200 + ETag| Save[메모리 캐시 저장]
    Decision -->|200 without ETag| Remove[기존 캐시 삭제]
    Decision -->|304 cache hit| Cached[캐시 body 반환]
    Decision -->|304 cache miss| Fallback[조건 없이 1회 fallback]

    Retry --> PluginPrepare
    Fallback --> PluginPrepare

Loading

💻 주요 코드 설명

NetworkPlugin

• 인증/재시도 책임은 RequestInterceptor에 유지하고, 로깅 등 범용 확장은 NetworkPlugin으로 분리했습니다.
• DebugNetworkPlugin은 query, body, header 원문을 출력하지 않는 안전한 요약 로그만 제공합니다.

classDiagram
    class NetworkClient
    class RequestInterceptor {
        <<protocol>>
        adapt()
        retry()
    }
    class NetworkPlugin {
        <<protocol>>
        prepare()
        willSend()
        didReceive()
    }
    class DebugNetworkPlugin

    NetworkClient --> RequestInterceptor : auth / retry
    NetworkClient --> NetworkPlugin : lifecycle
    DebugNetworkPlugin ..|> NetworkPlugin

Loading

ETag 캐시

• NetworkEndpoint(etagCacheEnabled: true)인 GET 요청만 캐시 대상입니다.
• 캐시 키는 adapted request 기준의 HTTP method + absolute URL입니다.
• URLCache와 디스크 저장소는 사용하지 않고, NetworkClient 인스턴스 단위 메모리 캐시만 사용합니다.

flowchart TD
    Response[HTTP Response] --> Status{Status}
    Status -->|200| HasETag{ETag 있음?}
    HasETag -->|Yes| Store[etag + body + 2xx status 저장]
    HasETag -->|No| Delete[해당 key 캐시 삭제]

    Status -->|304| HasCache{캐시 있음?}
    HasCache -->|Yes| ReturnCache[캐시 body + 2xx metadata 반환]
    HasCache -->|No| Fallback[If-None-Match 없이 1회 재요청]

    Status -->|기타| Pass[기존 응답 흐름 유지]

Loading

NetworkClient 구조 정리

• ETag 세부 정책은 ETagCacheHandler로 분리했습니다.
• retry/fallback 상태는 RequestAttempt로 묶어 NetworkClient.load의 파라미터와 분기를 줄였습니다.
• public API는 유지했습니다.

classDiagram
    class NetworkClient {
        request()
        removeAllETagCache()
    }
    class ETagCacheHandler {
        key()
        apply()
        handle()
        removeAll()
    }
    class MemoryETagCacheStore
    class RequestAttempt {
        retryCount
        fallbackCount
        skipsETag
    }

    NetworkClient --> ETagCacheHandler
    NetworkClient --> RequestAttempt
    ETagCacheHandler --> MemoryETagCacheStore

Loading

👀 기타 더 이야기해볼 점

• 로그아웃 또는 사용자 전환 시에는 await client.removeAllETagCache() 호출이 필요합니다.
• 다음 작업으로는 팩토리 구현과 앱 진입점 구성을 이어나갈 예정입니다.

🔗 연결된 이슈

• Resolved: LIVD-399

[linear]

LIVD-399