httpClientWrap.dart 6.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225
  1. import 'dart:async';
  2. import 'dart:convert';
  3. import 'dart:io';
  4. enum HttpClientStatus { idle, connecting, connected, disconnected, error }
  5. typedef HttpClientStatusHandler = void Function(HttpClientStatus status);
  6. /// 单次请求的 HTTP 状态与解码正文,不共享并发请求状态。
  7. class HttpClientWrapResponse {
  8. final int statusCode;
  9. final dynamic data;
  10. const HttpClientWrapResponse({required this.statusCode, required this.data});
  11. }
  12. class HttpClientWrap {
  13. final Duration retryInterval;
  14. final Duration? connectionTimeout;
  15. final Duration? receiveTimeout;
  16. final Map<String, String>? defaultHeaders;
  17. HttpClient? _httpClient;
  18. bool _disposed = false;
  19. HttpClientStatus _status = HttpClientStatus.idle;
  20. HttpClientStatus get status => _status;
  21. final List<HttpClientStatusHandler> _statusHandlers = [];
  22. HttpClientWrap({
  23. this.retryInterval = const Duration(seconds: 5),
  24. this.defaultHeaders,
  25. this.connectionTimeout,
  26. this.receiveTimeout,
  27. });
  28. /// 发送 GET 请求
  29. Future<dynamic> get(
  30. String url, {
  31. Map<String, String>? headers,
  32. dynamic body,
  33. }) async {
  34. return _sendRequest(url, 'GET', headers: headers, body: body);
  35. }
  36. /// 发送 POST 请求
  37. Future<dynamic> post(
  38. String url, {
  39. Map<String, String>? headers,
  40. dynamic body,
  41. }) async {
  42. return _sendRequest(url, 'POST', headers: headers, body: body);
  43. }
  44. /// 发送 PUT 请求
  45. Future<dynamic> put(
  46. String url, {
  47. Map<String, String>? headers,
  48. dynamic body,
  49. }) async {
  50. return _sendRequest(url, 'PUT', headers: headers, body: body);
  51. }
  52. /// 发送 DELETE 请求
  53. Future<dynamic> delete(String url, {Map<String, String>? headers}) async {
  54. return _sendRequest(url, 'DELETE', headers: headers);
  55. }
  56. Future<dynamic> _sendRequest(
  57. String url,
  58. String method, {
  59. Map<String, String>? headers,
  60. dynamic body,
  61. }) async {
  62. return (await request(url, method, headers: headers, body: body)).data;
  63. }
  64. /// 返回 HTTP 状态与正文;旧 get/post/put/delete 仍仅返回正文。
  65. Future<HttpClientWrapResponse> request(
  66. String url,
  67. String method, {
  68. Map<String, String>? headers,
  69. dynamic body,
  70. }) async {
  71. if (_disposed) {
  72. throw StateError('HTTP Client has been disposed');
  73. }
  74. _updateStatus(HttpClientStatus.connecting);
  75. _httpClient ??= HttpClient()..connectionTimeout = connectionTimeout;
  76. try {
  77. late final Uri uri;
  78. if ((method == 'GET') && (body != null)) {
  79. // queryParameters Map value 只接受 String 和 List<String> 两种类型
  80. // final queryParams = body.map((key, value) {
  81. // if (value is Iterable) {
  82. // // 多值:转成 List<String>
  83. // return MapEntry(key, value.map((v) => v.toString()).toList());
  84. // } else {
  85. // // 单值:转成 String
  86. // return MapEntry(key, value.toString());
  87. // }
  88. // });
  89. final queryParams = <String, dynamic>{};
  90. if (body is Map) {
  91. body.forEach((key, value) {
  92. if (value is Iterable) {
  93. // 多值:转成 List<String>
  94. queryParams[key.toString()] = value
  95. .map((v) => v.toString())
  96. .toList();
  97. } else {
  98. // 单值:转成 String
  99. queryParams[key.toString()] = value.toString();
  100. }
  101. });
  102. }
  103. uri = Uri.parse(url).replace(queryParameters: queryParams);
  104. // uri = Uri.parse(url).replace(
  105. // queryParameters: body,
  106. // );
  107. } else {
  108. uri = Uri.parse(url);
  109. }
  110. final request = await _httpClient!.openUrl(method, uri);
  111. // 设置请求头
  112. final mergedHeaders = {...?defaultHeaders, ...?headers};
  113. mergedHeaders.forEach((key, value) {
  114. request.headers.set(key, value);
  115. });
  116. // 添加请求体(如果是POST/PUT)
  117. if (body != null && (method == 'POST' || method == 'PUT')) {
  118. if (body is Map || body is List) {
  119. request.write(jsonEncode(body));
  120. } else {
  121. request.write(body.toString());
  122. }
  123. }
  124. final responseFuture = request.close();
  125. final timeout = receiveTimeout;
  126. final response = await (timeout == null
  127. ? responseFuture
  128. : responseFuture.timeout(timeout));
  129. _updateStatus(HttpClientStatus.connected);
  130. // 处理响应
  131. final responseStream = response.transform(utf8.decoder);
  132. final responseBody =
  133. await (timeout == null
  134. ? responseStream
  135. : responseStream.timeout(timeout))
  136. .join();
  137. dynamic decodedResponse;
  138. try {
  139. decodedResponse = jsonDecode(responseBody);
  140. } catch (e) {
  141. decodedResponse = responseBody;
  142. }
  143. // Log.d('get response: $decodedResponse');
  144. _updateStatus(HttpClientStatus.idle);
  145. return HttpClientWrapResponse(
  146. statusCode: response.statusCode,
  147. data: decodedResponse,
  148. );
  149. } catch (e) {
  150. _handleError(e);
  151. // _scheduleRetry();
  152. _resetClient();
  153. rethrow; // 抛出异常以便调用方捕获
  154. }
  155. }
  156. /// 添加状态监听器
  157. void addStatusListener(HttpClientStatusHandler handler) {
  158. _statusHandlers.add(handler);
  159. }
  160. /// 移除状态监听器
  161. void removeStatusListener(HttpClientStatusHandler handler) {
  162. _statusHandlers.remove(handler);
  163. }
  164. void _resetClient() {
  165. _httpClient?.close(force: true);
  166. _httpClient = null;
  167. }
  168. /// 释放资源
  169. Future<void> dispose() async {
  170. _disposed = true;
  171. _httpClient?.close();
  172. _httpClient = null;
  173. _statusHandlers.clear();
  174. _updateStatus(HttpClientStatus.disconnected);
  175. }
  176. void _handleError(dynamic error) {
  177. _updateStatus(HttpClientStatus.error);
  178. }
  179. void _scheduleRetry() {
  180. if (_disposed) return;
  181. Timer(retryInterval, () {
  182. _updateStatus(HttpClientStatus.idle);
  183. });
  184. }
  185. void _updateStatus(HttpClientStatus status) {
  186. _status = status;
  187. for (final handler in _statusHandlers) {
  188. handler(status);
  189. }
  190. }
  191. }