sol-http-client.h

Go to the documentation of this file.

/*
 * This file is part of the Soletta (TM) Project
 *
 * Copyright (C) 2015 Intel Corporation. All rights reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#pragma once

#include <sol-http.h>

#ifdef __cplusplus
extern "C" {
#endif

struct sol_http_client_connection;
typedef struct sol_http_client_connection sol_http_client_connection;

typedef struct sol_http_request_interface {
#ifndef SOL_NO_API_VERSION
#define SOL_HTTP_REQUEST_INTERFACE_API_VERSION (1)

    uint16_t api_version;
#endif

    ssize_t (*on_data)(void *user_data, struct sol_http_client_connection *connection,
        const struct sol_buffer *buffer);
    ssize_t (*on_send)(void *user_data, struct sol_http_client_connection *connection,
        struct sol_buffer *buffer);
    void (*on_response)(void *user_data, struct sol_http_client_connection *connection,
        struct sol_http_response *response);

    size_t data_buffer_size;
} sol_http_request_interface;

struct sol_http_client_connection *sol_http_client_request(enum sol_http_method method,
    const char *url, const struct sol_http_params *params,
    void (*cb)(void *data, struct sol_http_client_connection *connection,
    struct sol_http_response *response),
    const void *data)
#ifndef DOXYGEN_RUN
SOL_ATTR_NON_NULL(2, 4) SOL_ATTR_WARN_UNUSED_RESULT
#endif
;

struct sol_http_client_connection *sol_http_client_request_with_interface(enum sol_http_method method,
    const char *url, const struct sol_http_params *params,
    const struct sol_http_request_interface *interface,
    const void *data)
#ifndef DOXYGEN_RUN
SOL_ATTR_NON_NULL(2, 4) SOL_ATTR_WARN_UNUSED_RESULT
#endif
;

void sol_http_client_connection_cancel(struct sol_http_client_connection *pending);

#ifdef __cplusplus
}
#endif