requestPOST method

Future<HttpResponse> requestPOST(HttpClient client, String url, { Map<String, String>? headers, Authorization? authorization, Map<String, String?>? queryParameters, bool noQueryString = false, Object? body, String? contentType, String? accept, String? responseType, ProgressListener? progressListener, })

Implementation

Future<HttpResponse> requestPOST(
  HttpClient client,
  String url, {
  Map<String, String>? headers,
  Authorization? authorization,
  Map<String, String?>? queryParameters,
  bool noQueryString = false,
  Object? body,
  String? contentType,
  String? accept,
  String? responseType,
  ProgressListener? progressListener,
}) async {
  var httpBody = HttpRequestBody(body, contentType, queryParameters);
  var requestBody = buildRequestBody(client, httpBody, authorization);

  if (queryParameters != null &&
      queryParameters.isNotEmpty &&
      requestBody.isNull) {
    var requestHeaders = buildRequestHeaders(
      client,
      HttpMethod.POST,
      url,
      headers: headers,
      authorization: authorization,
      contentType: requestBody.contentType,
      accept: accept,
    );

    var formData = buildPOSTFormData(queryParameters, requestHeaders);

    var requestURL = buildRequestURL(
      client,
      url,
      authorization: authorization,
      noQueryString: noQueryString,
    );

    var requestURLOr = client._interceptRequest(
      HttpMethod.POST,
      requestURL,
      requestHeaders,
    );

    // Awaited only with an interceptor (no asynchronous step without it).
    requestURL = requestURLOr is Future<String>
        ? await requestURLOr
        : requestURLOr;

    return submitHttpRequest(
      client,
      HttpRequest(
        HttpMethod.POST,
        url,
        requestURL,
        authorization: authorization,
        queryParameters: queryParameters,
        noQueryString: noQueryString,
        withCredentials: _withCredentials(client, authorization),
        requestHeaders: requestHeaders,
        sendData: formData,
        responseType: responseType,
      ).._queryParametersAsBody = true,
      progressListener,
      client.logRequests,
    );
  } else {
    var requestHeaders = buildRequestHeaders(
      client,
      HttpMethod.POST,
      url,
      headers: headers,
      authorization: authorization,
      contentType: requestBody.contentType,
      accept: accept,
    );

    var requestURL = buildRequestURL(
      client,
      url,
      authorization: authorization,
      queryParameters: queryParameters,
      noQueryString: noQueryString,
    );

    var requestURLOr = client._interceptRequest(
      HttpMethod.POST,
      requestURL,
      requestHeaders,
    );

    // Awaited only with an interceptor (no asynchronous step without it).
    requestURL = requestURLOr is Future<String>
        ? await requestURLOr
        : requestURLOr;

    return submitHttpRequest(
      client,
      HttpRequest(
        HttpMethod.POST,
        url,
        requestURL,
        authorization: authorization,
        queryParameters: queryParameters,
        noQueryString: noQueryString,
        withCredentials: _withCredentials(client, authorization),
        requestHeaders: requestHeaders,
        sendData: requestBody.contentAsSendData,
        responseType: responseType,
      ),
      progressListener,
      client.logRequests,
    );
  }
}