Files
ttstd_family_care/lib/features/contacts/data/contact_api.dart
T

92 lines
3.2 KiB
Dart
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import 'package:flutter/foundation.dart';
import 'package:ttstd_family_care/core/network/api_exception.dart';
import 'package:ttstd_family_care/core/network/dio_client.dart';
import 'package:ttstd_family_care/features/contacts/domain/contact_models.dart';
/// 客户端(家属端)联系人接口访问层。
///
/// 后端接口前缀为 `/api/v1/client/sn/contact`,Dio 在 path 不以 `/` 开头时会
/// 直接拼接 baseUrl 的 path 段,故此处使用相对路径 `v1/client/sn/contact/...`。
/// [DioClient.get/post/put/delete] 已统一解析为后台返回体中的 `data` 字段;
/// 业务失败时抛出 [ApiException],本层将其降级为「空数据/错误提示」以适配家属端展示。
class ContactApi {
const ContactApi();
/// 联系人列表(家属端)。
Future<List<Contact>> getContacts(String sn) async {
try {
final data = await DioClient.get(
'v1/client/sn/contact/list',
queryParameters: {'sn': sn},
);
return _parseList(data, Contact.fromJson);
} on ApiException {
return const [];
}
}
/// 新增联系人(家属端)。
///
/// 成功返回 null;失败返回后台错误提示。
Future<String?> addContact(String sn, Contact contact) async {
try {
await DioClient.post(
'v1/client/sn/contact/insert',
queryParameters: {'sn': sn},
data: contact.toFormJson(),
);
debugPrint('[ContactApi] addContact sn=$sn name=${contact.name} success');
return null;
} on ApiException catch (e) {
debugPrint('[ContactApi] addContact sn=$sn name=${contact.name} failed: ${e.message}');
return e.message;
}
}
/// 修改联系人(家属端)。
///
/// 成功返回 null;失败返回后台错误提示。
/// 注意:[DioClient.put] 无 queryParameters 参数,故 id/sn 直接拼入路径。
Future<String?> updateContact(String sn, Contact contact) async {
try {
final path =
'v1/client/sn/contact/update?id=${contact.id}&sn=${Uri.encodeQueryComponent(sn)}';
await DioClient.put(path, data: contact.toFormJson());
debugPrint('[ContactApi] updateContact sn=$sn id=${contact.id} success');
return null;
} on ApiException catch (e) {
debugPrint('[ContactApi] updateContact sn=$sn id=${contact.id} failed: ${e.message}');
return e.message;
}
}
/// 删除联系人(家属端)。
///
/// 成功返回 null;失败返回后台错误提示。
Future<String?> deleteContact(String sn, int id) async {
try {
await DioClient.delete(
'v1/client/sn/contact/delete?sn=${Uri.encodeQueryComponent(sn)}&id=$id',
);
debugPrint('[ContactApi] deleteContact sn=$sn id=$id success');
return null;
} on ApiException catch (e) {
debugPrint('[ContactApi] deleteContact sn=$sn id=$id failed: ${e.message}');
return e.message;
}
}
// ---------------------------------------------------------------------------
static List<T> _parseList<T>(
dynamic data,
T Function(Map<String, dynamic>) fromJson,
) {
if (data is! List) return const [];
return data
.whereType<Map<String, dynamic>>()
.map(fromJson)
.toList(growable: false);
}
}