koush/ion
Ion
Ion is an asynchronous HTTP client library for Android that handles network requests, JSON parsing, image loading, and file downloads. It provides a fluent builder pattern for constructing requests and supports automatic JSON deserialization into Java objects using Gson, along with in-memory image caching and multipart form-data encoding.
The library distinguishes itself through its support for request cancellation via Future objects, allowing individual or bulk cancellation of in-flight requests to avoid wasted bandwidth and stale callbacks. It also includes proxy-aware request routing for debugging or network isolation, progress callbacks for file downloads, and request timing logging for performance monitoring.
Ion covers the full lifecycle of network communication on Android, from fetching data asynchronously and posting data to servers to loading remote images into views with placeholders and error states. The library is distributed as a Java library with documentation covering its API surface.
Features
- Android - Making HTTP requests from Android apps with support for JSON, file downloads, and image loading.
- HTTP Client Libraries - An asynchronous HTTP client for Android that supports request cancellation, JSON parsing, image loading, and file downloads with progress tracking.
- Image Loading and Caching - Fetch an image from a URL and display it in a view with caching, placeholders, error states, and animations.
- Asynchronous Data Fetching - Fetch HTTP resources in the background without blocking the user interface thread.
- JSON Fetching Libraries - Download JSON from a remote server and parse it into a JsonObject or a custom Java type using Gson.
- Android Image Loading - Fetching and displaying remote images in Android views with caching, placeholders, and error handling.
- API Data Consumption - Downloading and parsing JSON from REST APIs into Java objects using Gson on Android.
- JSON Deserializers - Incoming JSON responses are automatically parsed into Java objects using the Gson library.
- Background Thread Dispatchers - Network I/O runs on a separate thread pool, keeping the UI thread free from blocking operations.
- Builder Patterns - Requests are constructed by chaining method calls on a builder object, enabling readable sequential configuration.
- Multipart Uploads - POST requests support multipart/form-data bodies for file uploads and complex form submissions.
- Android - An image loading component that fetches remote images with caching, placeholders, error states, and fade-in animations.
- Fluent Builder Chains - Build HTTP requests and image loads using a sequential method-call syntax for readability.
- Image Caches - Downloaded images are stored in a memory cache with configurable size limits and automatic eviction.
- Download Progress Tracking - File downloads expose a callback that reports bytes transferred and total size for progress tracking.
- Request Cancellations - Cancel one or more in-flight network requests by calling cancel on a Future or by cancelling all requests in a group.
- Future-Based Cancellations - Each HTTP request returns a Future object that can be cancelled individually or grouped for bulk cancellation.
- Remote File Downloads - Write a remote file to local storage while reporting download progress through a callback or UI widget.
- Download Progress Tracking - Downloading remote files to local storage on Android while tracking and displaying download progress.
- Progress-Tracking File Downloads - A file download utility that writes remote files to local storage while reporting progress through callbacks or UI widgets.
- Form Data Submission - Send HTTP POST requests with text, JSON, form-encoded, or multipart/form-data bodies and read the response.
- Networking - Asynchronous networking and image loading.
- Networking and API - Networking library for android.
- Bibliothèques réseau - Facilitates asynchronous networking and image loading tasks.
