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> getContacts(String sn) async { try { final data = await DioClient.get( 'v1/client/sn/contact/list', allowStale: true, queryParameters: {'sn': sn}, ); return _parseList(data, Contact.fromJson); } on ApiException { return const []; } } /// 新增联系人(家属端)。 /// /// 成功返回 null;失败返回后台错误提示。 Future 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 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 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 _parseList( dynamic data, T Function(Map) fromJson, ) { if (data is! List) return const []; return data .whereType>() .map(fromJson) .toList(growable: false); } }