30 lines
1.1 KiB
Dart
30 lines
1.1 KiB
Dart
import 'package:dio/dio.dart';
|
|
|
|
import 'errors/marianumconnect_error.dart';
|
|
import 'marianumconnect_api.dart';
|
|
import 'marianumconnect_endpoint.dart';
|
|
|
|
/// Shared base for MarianumConnect API queries. Owns the [dio] client (the
|
|
/// shared authenticated singleton by default) and routes calls through [guard]
|
|
/// so every query maps a DioException to the app's typed AppExceptions the same
|
|
/// way instead of repeating the try/catch. Subclasses with bespoke error or
|
|
/// lifecycle handling (own dio, silent failure, custom status mapping) may skip
|
|
/// [guard] and still reuse [dio]/[endpoint].
|
|
abstract class MarianumConnectQuery {
|
|
final Dio dio;
|
|
|
|
MarianumConnectQuery({Dio? dio}) : dio = dio ?? MarianumConnectApi.dio();
|
|
|
|
/// Resolves [path] against the active mobile-API base URL.
|
|
String endpoint(String path) => MarianumConnectEndpoint.resolve(path);
|
|
|
|
/// Runs [body], converting any DioException into the matching AppException.
|
|
Future<T> guard<T>(Future<T> Function() body) async {
|
|
try {
|
|
return await body();
|
|
} on DioException catch (e) {
|
|
throw mapMarianumConnectError(e);
|
|
}
|
|
}
|
|
}
|