Fresh Dio는 Dio 위에 구축된 가벼운 HTTP 인터셉터로, API 요청 중 토큰 갱신을 자동화합니다. 인증 토큰을 투명하게 처리하여 보호된 엔드포인트에 안전하고 끊김 없는 접근을 보장합니다. 요청을 가로채고 만료된 토큰을 원활하게 갱신함으로써 반복 코드를 줄이고 사용자 경험을 향상시킵니다. 최소한의 설정으로 강력한 인증 워크플로우가 필요한 앱에 이상적입니다.
사용 사례
API 호출 중 자동 토큰 갱신
만료된 JWT 토큰 처리
인증된 API 엔드포인트 보호
수동 토큰 관리 감소
로그인 세션 지속성 향상
인증 상태 처리 간소화
주요 기능
Dio 위에 구축됨
투명한 토큰 갱신
JWT 및 유사 토큰을 지원합니다
필요한 최소 구성
요청을 자동으로 가로챕니다
401 오류에 대한 재시도 로직 처리
적합한 대상
JWT 인증을 사용하는 앱
자주 API 상호작용이 있는 프로젝트
인증 보일러플레이트를 줄이려는 개발자
세션 관리가 있는 모바일 및 웹 애플리케이션
깨끗하고 유지보수 가능한 인증 코드를 우선시하는 팀
고려 사항
기존 Dio 설정과의 통합이 필요합니다
토큰 기반 인증 흐름에 한정
비표준 토큰 형식에 맞는 사용자 정의 로직이 필요할 수 있습니다
새로 고침을 위해 외부 네트워크의 가용성에 의존합니다
상태 없는 또는 토큰 없는 API에는 적합하지 않습니다
원본 README
연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.
Fresh 🍋
A collection of packages for automatic token refresh in Dart and Flutter. Fresh handles refreshing, caching, and attaching authentication tokens transparently so your API calls just work.
Why Fresh?
Token-based authentication seems simple until you handle the edge cases: tokens expire mid-session, multiple requests fail at the same time triggering duplicate refreshes, refresh tokens get revoked, and you need to route users to login when auth is lost. Fresh handles all of this so you don't have to.
No more manual 401 handling scattered across your codebase
No more race conditions when concurrent requests trigger simultaneous refreshes
No more stale tokens causing request failures - expired tokens are refreshed proactively before the request is even sent