cfug/dio
Dio
Dio is a cross-platform HTTP client for Dart designed to manage network requests and data communication across mobile and desktop applications. It provides a comprehensive framework for executing standard web operations while handling complex tasks such as request lifecycles, connection security, and global configuration.
The library distinguishes itself through an extensible architecture that allows developers to hook into the request and response pipeline. By utilizing interceptors and custom network adapters, users can modify traffic, perform authentication, and swap underlying networking implementations to meet specific platform or proxy requirements.
Beyond basic request execution, the project supports advanced traffic management and data handling. This includes automatic payload transformation between formats, reliable multipart file uploading with progress tracking, and the ability to cancel active operations to optimize resource usage. It also incorporates security features such as server certificate verification to maintain secure connections.
Features
- Cross-Platform HTTP Clients - Acts as a cross-platform HTTP client for managing network requests across mobile and desktop applications.
- HTTP Request Customization - Executes standard HTTP operations with support for custom headers and request timeouts.
- HTTP Request Managers - Manages standard HTTP operations, timeouts, and global configurations for consistent application communication.
- HTTP Request Interceptors - Provides hooks for modifying, logging, or authenticating HTTP requests within the request lifecycle.
- Networking Libraries - Provides a robust communication library for managing network requests and connection security in Dart applications.
- HTTP Client Libraries - Supports advanced HTTP operations including multipart file uploads, automatic data transformation, and request lifecycle management.
- Request Interceptors - Provides a flexible pipeline for modifying network requests and responses through interceptors.
- Request Interception Utilities - Hooks into the request and response pipeline to modify traffic or log activity.
- Network Request Adapters - Decouples high-level request logic from platform-specific networking implementations through pluggable adapters.
- Request Lifecycle Managers - Orchestrates the request-response pipeline, including lifecycle management and global configuration.
- Cross-Platform Networking - Provides consistent network configuration and client swapping capabilities across multiple operating systems.
- Multipart Upload Utilities - Manages reliable multipart file transfers with boundary generation and progress tracking.
- Certificate Pinning - Validates server authenticity by restricting trusted certificates to prevent man-in-the-middle attacks.
- Certificate Trust Validation - Validates server security certificates against trusted authorities to ensure secure connections.
- Payload Converters - Automatically processes and converts incoming and outgoing data payloads into application-ready formats.
- Payload Serialization - Handles asynchronous parsing and serialization of data payloads between JSON and binary formats.
- Network Clients - Extends networking client functionality by injecting custom logic into the request lifecycle.
- Request Timeouts - Aborts active network requests using tokens to optimize resource usage.
- Remote Task Cancellation - Uses shared tokens to abort active network operations and free system resources.
- Stream Transformers - Automatically parses and transforms incoming data streams into usable application formats.
- HTTP/2 Protocol Implementations - Improves data transfer efficiency by enabling modern HTTP/2 protocol features.
- Network Connectivity Configurations - Configures network connectivity settings including proxy usage and platform-specific requirements.
