DioClient class abstract

An abstract base class for making network requests using the Dio package.

Provides standardized methods for common HTTP verbs (GET, POST, PUT, DELETE) and specialized methods like fetch (for raw bytes) and download (to file). Includes built-in error handling that converts DioExceptions into custom NetworkExceptions, and integrates with dio_cache_interceptor for caching (except for download).

Extend this class to create concrete API client implementations.

Error Handling: All request methods catch DioException and translate them into specific NetworkException subtypes based on the error type and response status. Unexpected non-Dio errors are wrapped in UnknownNetworkErrorException.

Caching: Caching behavior can be controlled globally via globalCacheOptions passed to the constructor, or per-request via the cacheOptions parameter on methods like get, post, put, delete, and fetch. The download method does not support caching.

Retry Logic: This client does not implement automatic retry logic. Retries should be handled externally, preferably by adding a retry interceptor (e.g., from the dio_smart_retry package) to the Dio instance before passing it to this client's constructor.