qqq-android
Android client library for QQQ applications.
For: Developers building native Android apps that connect to QQQ backends
Status: Experimental
Why This Exists
QQQ applications expose REST APIs that any client can consume. For Android apps that need to interact with QQQ backends, this library provides typed clients and UI components that understand QQQ's metadata model.
Features
- API Client - Typed client for QQQ REST endpoints
- Metadata Loading - Fetch table and field definitions
- Record Operations - Query, insert, update, delete records
- Process Execution - Run backend processes from Android
Quick Start
Prerequisites
- Android Studio
- Android SDK 26+
- QQQ backend running
Installation
Add to build.gradle:
dependencies {
implementation 'io.qrun:qqq-android:0.1.0'
}
Configuration
val client = QqqClient.Builder()
.baseUrl("https://your-qqq-app.com")
.build()
Basic Usage
// Fetch records
val orders = client.query("order")
.filter("status", "pending")
.limit(20)
.execute()
// Create record
val newOrder = client.insert("order", mapOf(
"customerName" to "Acme Corp",
"total" to 100.00
))
// Run process
client.runProcess("orderSync")
Usage
Authentication
val client = QqqClient.Builder()
.baseUrl("https://your-qqq-app.com")
.authToken("your-api-token")
.build()
Querying Records
// With filters
val results = client.query("customer")
.filter("status", Operator.EQUALS, "active")
.filter("createdDate", Operator.GREATER_THAN, "2024-01-01")
.orderBy("name", SortOrder.ASC)
.execute()
// Get single record
val customer = client.get("customer", 123)
Modifying Records
// Update
client.update("order", 123, mapOf(
"status" to "shipped"
))
// Delete
client.delete("order", 123)
Project Status
Experimental. Core functionality is being developed.
Roadmap
- Offline caching
- Background sync
- UI components for common patterns
- Kotlin coroutines support
Contributing
- Fork the repository
- Create a feature branch
- Submit a pull request
License
Apache-2.0 - See LICENSE for details.