gweb/gweb.h

   1 /*
   2  *
   3  *  Web service library with GLib integration
   4  *
   5  *  Copyright (C) 2009-2012  Intel Corporation. All rights reserved.
   6  *
   7  *  This program is free software; you can redistribute it and/or modify
   8  *  it under the terms of the GNU General Public License version 2 as
   9  *  published by the Free Software Foundation.
  10  *
  11  *  This program is distributed in the hope that it will be useful,
  12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  *  GNU General Public License for more details.
  15  *
  16  *  You should have received a copy of the GNU General Public License
  17  *  along with this program; if not, write to the Free Software
  18  *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  19  *
  20  */
  21
  22 #ifndef __G_WEB_H
  23 #define __G_WEB_H
  24
  25 #include <stdint.h>
  26
  27 #include <glib.h>
  28
  29 #ifdef __cplusplus
  30 extern "C" {
  31 #endif
  32
  33 struct _GWeb;
  34 struct _GWebResult;
  35 struct _GWebParser;
  36
  37 typedef struct _GWeb GWeb;
  38 typedef struct _GWebResult GWebResult;
  39 typedef struct _GWebParser GWebParser;
  40
  41 typedef gboolean (*GWebResultFunc)(GWebResult *result, gpointer user_data);
  42
  43 typedef gboolean (*GWebRouteFunc)(const char *addr, int ai_family,
  44                 int if_index, gpointer user_data);
  45
  46 typedef gboolean (*GWebInputFunc)(const guint8 **data, gsize *length,
  47                                                         gpointer user_data);
  48
  49 typedef void (*GWebDebugFunc)(const char *str, gpointer user_data);
  50
  51 GWeb *g_web_new(int index);
  52
  53 GWeb *g_web_ref(GWeb *web);
  54 void g_web_unref(GWeb *web);
  55
  56 void g_web_set_debug(GWeb *web, GWebDebugFunc func, gpointer user_data);
  57
  58 gboolean g_web_supports_tls(void);
  59
  60 gboolean g_web_set_proxy(GWeb *web, const char *proxy);
  61
  62 gboolean g_web_set_address_family(GWeb *web, int family);
  63
  64 gboolean g_web_add_nameserver(GWeb *web, const char *address);
  65
  66 gboolean g_web_set_accept(GWeb *web, const char *format, ...)
  67                                 __attribute__((format(printf, 2, 3)));
  68 gboolean g_web_set_user_agent(GWeb *web, const char *format, ...)
  69                                 __attribute__((format(printf, 2, 3)));
  70 gboolean g_web_set_ua_profile(GWeb *web, const char *profile);
  71
  72 gboolean g_web_set_http_version(GWeb *web, const char *version);
  73
  74 void g_web_set_close_connection(GWeb *web, gboolean enabled);
  75 gboolean g_web_get_close_connection(GWeb *web);
  76
  77 guint g_web_request_get(GWeb *web, const char *url,
  78                                 GWebResultFunc func, GWebRouteFunc route,
  79                                 gpointer user_data);
  80 guint g_web_request_post(GWeb *web, const char *url,
  81                                 const char *type, GWebInputFunc input,
  82                                 GWebResultFunc func, gpointer user_data);
  83 guint g_web_request_post_file(GWeb *web, const char *url,
  84                                 const char *type, const char *file,
  85                                 GWebResultFunc func, gpointer user_data);
  86
  87 gboolean g_web_cancel_request(GWeb *web, guint id);
  88
  89 guint16 g_web_result_get_status(GWebResult *result);
  90
  91 gboolean g_web_result_get_header(GWebResult *result,
  92                                 const char *header, const char **value);
  93 gboolean g_web_result_get_chunk(GWebResult *result,
  94                                 const guint8 **chunk, gsize *length);
  95
  96 typedef void (*GWebParserFunc)(const char *str, gpointer user_data);
  97
  98 GWebParser *g_web_parser_new(const char *begin, const char *end,
  99                                 GWebParserFunc func, gpointer user_data);
 100
 101 GWebParser *g_web_parser_ref(GWebParser *parser);
 102 void g_web_parser_unref(GWebParser *parser);
 103
 104 void g_web_parser_feed_data(GWebParser *parser,
 105                                 const guint8 *data, gsize length);
 106 void g_web_parser_end_data(GWebParser *parser);
 107
 108 #ifdef __cplusplus
 109 }
 110 #endif
 111
 112 #endif /* __G_WEB_H */