az_http_transport.h

Go to the documentation of this file.

// Copyright (c) Microsoft Corporation. All rights reserved.
// SPDX-License-Identifier: MIT
 
#ifndef _az_HTTP_TRANSPORT_H
#define _az_HTTP_TRANSPORT_H
 
#include <azure/core/az_http.h>
#include <azure/core/az_span.h>
 
#include <azure/core/_az_cfg_prefix.h>
 
typedef az_span az_http_method;
 
AZ_INLINE az_http_method az_http_method_get() { return AZ_SPAN_FROM_STR("GET"); }
 
AZ_INLINE az_http_method az_http_method_head() { return AZ_SPAN_FROM_STR("HEAD"); }
 
AZ_INLINE az_http_method az_http_method_post() { return AZ_SPAN_FROM_STR("POST"); }
 
AZ_INLINE az_http_method az_http_method_put() { return AZ_SPAN_FROM_STR("PUT"); }
 
AZ_INLINE az_http_method az_http_method_delete() { return AZ_SPAN_FROM_STR("DELETE"); }
 
AZ_INLINE az_http_method az_http_method_patch() { return AZ_SPAN_FROM_STR("PATCH"); }
 
typedef struct
{
  az_span name; 
  az_span value; 
} _az_http_request_header;
 
typedef az_span _az_http_request_headers;
 
typedef struct
{
  struct
  {
    az_context* context;
    az_http_method method;
    az_span url;
    int32_t url_length;
    int32_t query_start;
    _az_http_request_headers headers; // Contains instances of _az_http_request_header
    int32_t headers_length;
    int32_t max_headers;
    int32_t retry_headers_start_byte_offset;
    az_span body;
  } _internal;
} az_http_request;
 
// Definition is below.
typedef struct _az_http_policy _az_http_policy;
 
typedef AZ_NODISCARD az_result (*_az_http_policy_process_fn)(
    _az_http_policy* ref_policies,
    void* ref_options,
    az_http_request* ref_request,
    az_http_response* ref_response);
 
struct _az_http_policy
{
  struct
  {
    _az_http_policy_process_fn process;
    void* options;
  } _internal;
};
 
AZ_NODISCARD az_result az_http_request_get_header(
    az_http_request const* request,
    int32_t index,
    az_span* out_name,
    az_span* out_value);
 
AZ_NODISCARD az_result
az_http_request_get_method(az_http_request const* request, az_http_method* out_method);
 
AZ_NODISCARD az_result az_http_request_get_url(az_http_request const* request, az_span* out_url);
 
AZ_NODISCARD az_result az_http_request_get_body(az_http_request const* request, az_span* out_body);
 
AZ_NODISCARD az_result az_http_response_append(az_http_response* ref_response, az_span source);
 
AZ_NODISCARD int32_t az_http_request_headers_count(az_http_request const* request);
 
AZ_NODISCARD az_result
az_http_client_send_request(az_http_request const* request, az_http_response* ref_response);
 
#include <azure/core/_az_cfg_suffix.h>
 
#endif // _az_HTTP_TRANSPORT_H