PDApiClient class
网络请求的高层客户端。
- 对外统一返回 BaseResponse,不向调用方抛出网络/解析异常。
- 通过 PDTransport 适配底层网络库(默认使用
PDDioTransport)。 - 支持全局配置 PDNetworkConfig 与单次请求覆盖 PDRequestConfig。
Constructors
- PDApiClient({PDTransport? transport, PDNetworkConfig config = const PDNetworkConfig(), PDResponseParser responseParser = const PDResponseParser(), PDErrorMapper errorMapper = const PDErrorMapper()})
- 创建一个 PDApiClient 实例。
Properties
- config → PDNetworkConfig
-
获取当前全局网络配置快照。
no setter
- hashCode → int
-
The hash code for this object.
no setterinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- transport → PDTransport
-
获取底层传输层。
no setter
Methods
-
delete<
T> (String path, {Map< String, dynamic> ? headers, Map<String, dynamic> ? queryParameters, dynamic data, PDRequestConfig? requestConfig, PDCancelToken? cancelToken, T? mapper(dynamic json)?}) → Future<BaseResponse< T> > - 发送 DELETE 请求。
-
get<
T> (String path, {Map< String, dynamic> ? headers, Map<String, dynamic> ? queryParameters, PDRequestConfig? requestConfig, PDCancelToken? cancelToken, T? mapper(dynamic json)?}) → Future<BaseResponse< T> > - 发送 GET 请求。
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
patch<
T> (String path, {Map< String, dynamic> ? headers, Map<String, dynamic> ? queryParameters, dynamic data, PDRequestConfig? requestConfig, PDCancelToken? cancelToken, T? mapper(dynamic json)?}) → Future<BaseResponse< T> > - 发送 PATCH 请求。
-
post<
T> (String path, {Map< String, dynamic> ? headers, Map<String, dynamic> ? queryParameters, dynamic data, PDRequestConfig? requestConfig, PDCancelToken? cancelToken, T? mapper(dynamic json)?}) → Future<BaseResponse< T> > - 发送 POST 请求。
-
put<
T> (String path, {Map< String, dynamic> ? headers, Map<String, dynamic> ? queryParameters, dynamic data, PDRequestConfig? requestConfig, PDCancelToken? cancelToken, T? mapper(dynamic json)?}) → Future<BaseResponse< T> > - 发送 PUT 请求。
-
request<
T> ({required String path, PDRequestMethod method = PDRequestMethod.get, Map< String, dynamic> ? headers, Map<String, dynamic> ? queryParameters, dynamic data, PDRequestConfig? requestConfig, PDCancelToken? cancelToken, T? mapper(dynamic json)?}) → Future<BaseResponse< T> > - 发送任意 HTTP 请求并返回统一的 BaseResponse。
-
toString(
) → String -
A string representation of this object.
inherited
-
updateBaseUrl(
String baseUrl) → void - 更新全局 baseUrl(等价于在当前 config 基础上 copyWith)。
-
updateConfig(
PDNetworkConfig config) → void - 更新全局网络配置快照。
-
updateHeaders(
Map< String, dynamic> headers, {bool merge = true}) → void - 更新全局请求头。
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited