apollographql/apollo-android
Apollo Android
Apollo Android ist eine typsichere GraphQL-Client-Bibliothek für die Ausführung von Queries und Mutations über JVM, Android und Kotlin Multiplatform hinweg. Sie enthält ein Codegenerierungstool, das unveränderliche Klassen und Parser aus GraphQL-Schemas und Operationsdateien erstellt, um Typsicherheit zur Kompilierzeit zu gewährleisten.
Das Projekt verfügt über einen normalisierten Cache, der Antworten in eine Lookup-Tabelle flacht, um eine einzige Quelle der Wahrheit beizubehalten. Es bietet zudem einen Subscription-Client für Echtzeit-Updates serverseitiger Daten via WebSocket- oder SSE-Verbindungen sowie ein Mocking-Framework zur Simulation von Serverantworten und zur Generierung gefälschter typsicherer Daten für Tests.
Die Bibliothek deckt ein breites Spektrum an Funktionen ab, einschließlich Netzwerkoptimierung durch Request-Batching und persistente Queries sowie die Verwaltung des lokalen Datenzustands mit optimistischen Updates und Paginierung. Sie unterstützt die Integration benutzerdefinierter HTTP-Engines und das Mapping benutzerdefinierter Skalartypen auf native Sprachklassen.
Das Tool integriert sich in Entwicklungs-IDEs, um automatische Codegenerierung und Navigation vom Editor zu Definitionen bereitzustellen.
Features
- Operation Execution - Manages the full lifecycle of executing GraphQL queries and mutations from request to response parsing.
- GraphQL Clients - Provides a strongly-typed GraphQL client for Android, JVM, and Kotlin Multiplatform.
- GraphQL Model Generators - Generates immutable native classes and parsers from GraphQL schemas to ensure compile-time type safety.
- Normalized Caches - Implements a normalized client-side cache that flattens server responses to maintain a single source of truth.
- GraphQL Normalized Caches - Implements a client-side cache that normalizes GraphQL query results by unique identifiers to ensure referential consistency.
- GraphQL Query Performance Optimizations - Provides specialized GraphQL performance optimizations including request batching and persisted queries.
- GraphQL Query Caches - Caches the results of GraphQL queries in memory or local storage to accelerate subsequent data requests.
- WebSocket Subscriptions - Provides a specialized subscription client for real-time updates via WebSockets and Server-Sent Events.
- GraphQL API Mocking - Provides a mocking framework to simulate GraphQL server responses and generate fake type-safe data.
- Type-Safe Data Class Generation - Generates immutable, strongly-typed classes and parsers from GraphQL schemas at compile time.
- GraphQL Subscriptions - Maintains persistent connections to a server to receive automatic real-time data updates.
- Real-time Data Subscriptions - Manages persistent connections for delivering real-time data updates across multiple services.
- Real-Time Data Synchronization - Synchronizes real-time data via GraphQL subscriptions over WebSockets and Server-Sent Events.
- Compile-Time Code Generation - Provides compile-time generation of immutable classes and parsers from GraphQL schemas to ensure type safety.
- Type-Safe Response Simulation - Simulates server responses using fake type-safe models to verify application logic without a backend.
- GraphQL Data Fetching - Executes declarative GraphQL queries and mutations to retrieve or modify remote server information.
- Type-Safe Model Mapping - Generates strongly-typed language models from schemas to prevent runtime data access errors.
- Persisted Queries - Reduces network overhead by utilizing persisted queries and identifiers instead of full strings.
- Client-Side Caching - Implements a normalized client-side cache to maintain a single source of truth.
- GraphQL Query Cost Limiters - Protects backend services by limiting the computed cost of GraphQL operations.
- Query Batching - Groups multiple GraphQL operations into a single network request to reduce round-trip latency.
- Persisted Query Execution - Supports sending unique operation identifiers instead of full query strings to reduce network bandwidth.
- Response Caching - Implements caching of GraphQL responses to improve performance and reduce network load.
- Local Persistence - Stores a normalized version of the cache in a local database to maintain state across restarts.
- GraphQL Subscription Clients - Implements a specialized client for handling real-time server updates via WebSockets or Server-Sent Events.
- GraphQL Custom Scalars - Maps custom GraphQL scalars, such as dates and big decimals, into native language types.
- Persisted Query Whitelists - Restricts API execution to a pre-approved list of persisted query hashes for security.
- GraphQL Query Safelisting - Limits execution to pre-approved queries to enhance security and reduce server latency.
- Request Batching - Combines multiple GraphQL operations into a single network request to minimize round-trip latency.
- GraphQL Performance Monitors - Analyzes request metrics and execution data specifically for GraphQL operations to optimize performance.
- API Simulation and Mocking - Includes a mocking framework to simulate server responses and generate fake type-safe data for testing.
- Single-Request Data Fetchers - Allows fetching complex, nested data structures in a single network round-trip to minimize sequential API calls.
- Request Orchestration - Orchestrates asynchronous GraphQL requests across multiple backend services to minimize latency.
- Mobile GraphQL Tools - Strongly-typed GraphQL client for Android.
