[evolution] Add e_web_view_request().

[Matthew Barnes <mbarnes src gnome org>]

commit 26e659aa334cfd17d30697af9efe7656ea5d4ba8
Author: Matthew Barnes <mbarnes redhat com>
Date:   Sat Jul 27 12:55:01 2013 -0400

    Add e_web_view_request().
    
    Asynchronously requests data at a URI by way of a SoupRequest to WebKit's
    default SoupSession, incorporating both e_web_view_redirect_uri() and the
    custom request handlers installed via e_web_view_install_request_handler().
    
    New functions:
    
      e_web_view_request()
      e_web_view_request_finish()

 .../evolution-util/evolution-util-sections.txt     |    2 +
 e-util/e-web-view.c                                |  152 ++++++++++++++++++++
 e-util/e-web-view.h                                |    8 +
 3 files changed, 162 insertions(+), 0 deletions(-)
---
diff --git a/doc/reference/evolution-util/evolution-util-sections.txt 
b/doc/reference/evolution-util/evolution-util-sections.txt
index 8643aed..2fbbaf8 100644
--- a/doc/reference/evolution-util/evolution-util-sections.txt
+++ b/doc/reference/evolution-util/evolution-util-sections.txt
@@ -4411,6 +4411,8 @@ e_web_view_stop_loading
 e_web_view_update_actions
 e_web_view_get_selection_html
 e_web_view_update_fonts
+e_web_view_request
+e_web_view_request_finish
 e_web_view_install_request_handler
 <SUBSECTION Standard>
 E_WEB_VIEW
diff --git a/e-util/e-web-view.c b/e-util/e-web-view.c
index 936781a..7ad17b6 100644
--- a/e-util/e-web-view.c
+++ b/e-util/e-web-view.c
@@ -47,6 +47,8 @@
        (G_TYPE_INSTANCE_GET_PRIVATE \
        ((obj), E_TYPE_WEB_VIEW, EWebViewPrivate))
 
+typedef struct _AsyncContext AsyncContext;
+
 struct _EWebViewPrivate {
        GtkUIManager *ui_manager;
        gchar *selected_uri;
@@ -73,6 +75,10 @@ struct _EWebViewPrivate {
        gulong antialiasing_changed_handler_id;
 };
 
+struct _AsyncContext {
+       GInputStream *input_stream;
+};
+
 enum {
        PROP_0,
        PROP_CARET_MODE,
@@ -144,6 +150,14 @@ G_DEFINE_TYPE_WITH_CODE (
                e_web_view_selectable_init))
 
 static void
+async_context_free (AsyncContext *async_context)
+{
+       g_clear_object (&async_context->input_stream);
+
+       g_slice_free (AsyncContext, async_context);
+}
+
+static void
 action_copy_clipboard_cb (GtkAction *action,
                           EWebView *web_view)
 {
@@ -2767,6 +2781,144 @@ e_web_view_update_fonts (EWebView *web_view)
        pango_font_description_free (vw);
 }
 
+/* Helper for e_web_view_request() */
+static void
+web_view_request_send_cb (GObject *source_object,
+                          GAsyncResult *result,
+                          gpointer user_data)
+{
+       GSimpleAsyncResult *simple;
+       AsyncContext *async_context;
+       GError *local_error = NULL;
+
+       simple = G_SIMPLE_ASYNC_RESULT (user_data);
+       async_context = g_simple_async_result_get_op_res_gpointer (simple);
+
+       async_context->input_stream = soup_request_send_finish (
+               SOUP_REQUEST (source_object), result, &local_error);
+
+       if (local_error != NULL)
+               g_simple_async_result_take_error (simple, local_error);
+
+       g_simple_async_result_complete (simple);
+
+       g_object_unref (simple);
+}
+
+/**
+ * e_web_view_request:
+ * @web_view: an #EWebView
+ * @uri: the URI to load
+ * @cancellable: optional #GCancellable object, or %NULL
+ * @callback: a #GAsyncReadyCallback to call when the request is satisfied
+ * @user_data: data to pass to the callback function
+ *
+ * Asynchronously requests data at @uri by way of a #SoupRequest to WebKit's
+ * default #SoupSession, incorporating both e_web_view_redirect_uri() and the
+ * custom request handlers installed via e_web_view_install_request_handler().
+ *
+ * When the operation is finished, @callback will be called.  You can then
+ * call e_web_view_request_finish() to get the result of the operation.
+ **/
+void
+e_web_view_request (EWebView *web_view,
+                    const gchar *uri,
+                    GCancellable *cancellable,
+                    GAsyncReadyCallback callback,
+                    gpointer user_data)
+{
+       SoupSession *session;
+       SoupSessionFeature *feature;
+       SoupRequester *requester;
+       SoupRequest *request;
+       gchar *real_uri;
+       GSimpleAsyncResult *simple;
+       AsyncContext *async_context;
+       GError *local_error = NULL;
+
+       g_return_if_fail (E_IS_WEB_VIEW (web_view));
+       g_return_if_fail (uri != NULL);
+
+       session = webkit_get_default_session ();
+
+       /* SoupRequester feature should have already been added. */
+       feature = soup_session_get_feature (session, SOUP_TYPE_REQUESTER);
+       g_return_if_fail (feature != NULL);
+
+       async_context = g_slice_new0 (AsyncContext);
+
+       simple = g_simple_async_result_new (
+               G_OBJECT (web_view), callback,
+               user_data, e_web_view_request);
+
+       g_simple_async_result_set_check_cancellable (simple, cancellable);
+
+       g_simple_async_result_set_op_res_gpointer (
+               simple, async_context, (GDestroyNotify) async_context_free);
+
+       requester = SOUP_REQUESTER (feature);
+       real_uri = e_web_view_redirect_uri (web_view, uri);
+       request = soup_requester_request (requester, real_uri, &local_error);
+       g_free (real_uri);
+
+       /* Sanity check. */
+       g_return_if_fail (
+               ((request != NULL) && (local_error == NULL)) ||
+               ((request == NULL) && (local_error != NULL)));
+
+       if (request != NULL) {
+               soup_request_send_async (
+                       request, cancellable,
+                       web_view_request_send_cb,
+                       g_object_ref (simple));
+
+               g_object_unref (request);
+
+       } else {
+               g_simple_async_result_take_error (simple, local_error);
+               g_simple_async_result_complete_in_idle (simple);
+       }
+
+       g_object_unref (simple);
+}
+
+/**
+ * e_web_view_request_finish:
+ * @web_view: an #EWebView
+ * @result: a #GAsyncResult
+ * @error: return location for a #GError, or %NULL
+ *
+ * Finishes the operation started with e_web_view_request().
+ *
+ * Unreference the returned #GInputStream with g_object_unref() when finished
+ * with it.  If an error occurred, the function will set @error and return
+ * %NULL.
+ *
+ * Returns: a #GInputStream, or %NULL
+ **/
+GInputStream *
+e_web_view_request_finish (EWebView *web_view,
+                           GAsyncResult *result,
+                           GError **error)
+{
+       GSimpleAsyncResult *simple;
+       AsyncContext *async_context;
+
+       g_return_val_if_fail (
+               g_simple_async_result_is_valid (
+               result, G_OBJECT (web_view), e_web_view_request), NULL);
+
+       simple = G_SIMPLE_ASYNC_RESULT (result);
+       async_context = g_simple_async_result_get_op_res_gpointer (simple);
+
+       if (g_simple_async_result_propagate_error (simple, error))
+               return NULL;
+
+       g_return_val_if_fail (async_context->input_stream != NULL, NULL);
+
+       return g_object_ref (async_context->input_stream);
+}
+
 void
 e_web_view_install_request_handler (EWebView *web_view,
                                     GType handler_type)
diff --git a/e-util/e-web-view.h b/e-util/e-web-view.h
index df338ab..5071e36 100644
--- a/e-util/e-web-view.h
+++ b/e-util/e-web-view.h
@@ -185,6 +185,14 @@ void               e_web_view_stop_loading         (EWebView *web_view);
 void           e_web_view_update_actions       (EWebView *web_view);
 gchar *                e_web_view_get_selection_html   (EWebView *web_view);
 void           e_web_view_update_fonts         (EWebView *web_view);
+void           e_web_view_request              (EWebView *web_view,
+                                                const gchar *uri,
+                                                GCancellable *cancellable,
+                                                GAsyncReadyCallback callback,
+                                                gpointer user_data);
+GInputStream * e_web_view_request_finish       (EWebView *web_view,
+                                                GAsyncResult *result,
+                                                GError **error);
 
 void           e_web_view_install_request_handler
                                                (EWebView *web_view,