xr-http.h

Go to the documentation of this file.

/* 
 * Copyright 2006-2008 Ondrej Jirman <ondrej.jirman@zonio.net>
 * 
 * This file is part of libxr.
 *
 * Libxr is free software: you can redistribute it and/or modify it under the
 * terms of the GNU Lesser General Public License as published by the Free
 * Software Foundation, either version 2 of the License, or (at your option) any
 * later version.
 *
 * Libxr is distributed in the hope that it will be useful, but WITHOUT ANY
 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
 * A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more
 * details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with libxr.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef __XR_HTTP_H__
#define __XR_HTTP_H__

#include <glib.h>
#include <openssl/bio.h>

typedef struct _xr_http xr_http;

typedef enum {
  XR_HTTP_NONE,
  XR_HTTP_REQUEST,
  XR_HTTP_RESPONSE
} xr_http_message_type;

#define XR_HTTP_ERROR xr_http_error_quark()

typedef enum
{
  XR_HTTP_ERROR_FAILED = 1
} XRHttpError;

G_BEGIN_DECLS

void xr_http_init();

xr_http* xr_http_new(BIO* bio);

void xr_http_free(xr_http* http);

/* receive API */

gboolean xr_http_read_header(xr_http* http, GError** err);

const char* xr_http_get_header(xr_http* http, const char* name);

void xr_http_set_basic_auth(xr_http* http, const char* username, const char* password);

gboolean xr_http_get_basic_auth(xr_http* http, char** username, char** password);

const char* xr_http_get_method(xr_http* http);

int xr_http_get_code(xr_http* http);

const char* xr_http_get_resource(xr_http* http);

int xr_http_get_version(xr_http* http);

xr_http_message_type xr_http_get_message_type(xr_http* http);

gssize xr_http_get_message_length(xr_http* http);

gssize xr_http_read(xr_http* http, char* buffer, gsize length, GError** err);

GString* xr_http_read_all(xr_http* http, GError** err);

/* transmit API */

void xr_http_set_header(xr_http* http, const char* name, const char* value);

void xr_http_set_message_type(xr_http* http, xr_http_message_type type);

void xr_http_set_message_length(xr_http* http, gsize length);

void xr_http_setup_request(xr_http* http, const char* method, const char* resource, const char* host);

void xr_http_setup_response(xr_http* http, int code);

gboolean xr_http_write_header(xr_http* http, GError** err);

gboolean xr_http_write(xr_http* http, const char* buffer, gsize length, GError** err);

gboolean xr_http_write_complete(xr_http* http, GError** err);

gboolean xr_http_write_all(xr_http* http, const char* buffer, gssize length, GError** err);

gboolean xr_http_is_ready(xr_http* http);

gboolean xr_http_has_pending_request(xr_http* http, time_t timeout);

GQuark xr_http_error_quark();

G_END_DECLS

#endif