hongyangAndroid/okhttputils
Okhttputils
OkHttpUtils is a convenience wrapper for the OkHttp HTTP client that simplifies common networking operations on Android. It provides a straightforward interface for executing GET and POST requests, including sending form parameters and JSON payloads, as well as uploading files via multipart form data and downloading remote files to local storage.
The library distinguishes itself through a set of practical utilities built on top of OkHttp's core architecture. It wraps synchronous calls into an asynchronous callback pattern, includes an interceptor-based logging layer for request and response details, and offers a custom SSL trust manager for handling self-signed or custom certificates. Cookie persistence is handled via an interceptor that saves session and persistent cookies to disk, while file transfers are augmented with progress reporting that tracks upload and download progress as a decimal ratio. Request lifecycle control is provided through tag-based cancellation, allowing active HTTP requests to be grouped and cancelled together.
Additional capabilities include a JSON body serialization helper for POST requests, a multipart form data builder for constructing complex uploads, and the ability to fetch and display remote images as bitmaps. The library also supports configuring HTTPS connections with custom certificates and persisting cookies across application restarts to maintain session state.
Features
- Android Network Programming - Provides an Android HTTP networking wrapper for GET, POST, JSON, and multipart uploads.
- HTTP Client Wrappers - Ships a convenience wrapper that simplifies common HTTP operations like GET, POST, file upload, and download using OkHttp.
- GET Request Executions - Provides a primary interface for executing HTTP GET requests with query parameters.
- POST Request Executions - Provides a primary interface for executing HTTP POST requests with form parameters.
- Tag-Based Cancellations - Provides tag-based request cancellation to prevent network leaks when Android components are destroyed.
- JSON Request Serializers - Serializes Java objects into JSON request bodies for HTTP POST requests.
- Transfer Progress Reporters - Reports upload and download progress as a decimal ratio via stream wrappers.
- Request Cancellations - Cancels active HTTP requests grouped by a user-assigned tag for lifecycle management.
- Progress-Tracking File Downloads - Downloads files from URLs to local storage with progress tracking and cancellation.
- URL File Downloads - Downloads files from URLs to local storage with progress tracking and cancellation support.
- Decimal Progress Reports - Reports file upload and download progress as a decimal value between zero and one.
- Development SSL Certificates - Handles custom or self-signed SSL certificates for secure Android network connections.
- Session-Cookie Persistences - Persists session and persistent cookies to disk via an OkHttp interceptor.
- HTTP Cookie Persistence - Persists cookies across app restarts to maintain session state in Android HTTP clients.
- Custom Trust Managers - Configures HTTPS connections to accept self-signed or custom SSL certificates via a custom trust manager.
- SSL Certificate Validation Overrides - Overrides default SSL verification with a custom trust manager for self-signed certificates.
- Interceptor-Based Loggers - Logs HTTP request and response details using an interceptor-based logging layer.
- Multipart Form Uploads - Uploads files via multipart form POST requests with progress reporting.
- Request-Response Interceptors - Logs HTTP request and response details via a custom OkHttp interceptor.
