[evolution-ews] Add EWS create folder operation files

[Pavel Ocheretny <pocheretny src gnome org>]

commit 856ea8f3329566e4ccbf0c98c975fe70db1f025a
Author: Pavel Ocheretny <pocheretny git gnome org>
Date:   Tue May 3 09:56:28 2011 +0300

    Add EWS create folder operation files

 src/server/e-ews-create-folder-operation.c |  274 ++++++++++++++++++++++++++++
 src/server/e-ews-create-folder-operation.h |   73 ++++++++
 2 files changed, 347 insertions(+), 0 deletions(-)
---
diff --git a/src/server/e-ews-create-folder-operation.c b/src/server/e-ews-create-folder-operation.c
new file mode 100644
index 0000000..b76fbe7
--- /dev/null
+++ b/src/server/e-ews-create-folder-operation.c
@@ -0,0 +1,274 @@
+/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
+/*
+ * Authors : Or Goshen, Pavel Ocheretny
+ *
+ * Copyright (C) 1999-2011 Intel, Inc. (www.intel.com)
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of version 2 of the GNU Lesser General Public
+ * License as published by the Free Software Foundation.
+ *
+ * This program 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 this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301
+ * USA
+ */
+
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+#include "e-ews-create-folder-operation.h"
+#include <stdarg.h>
+
+G_DEFINE_TYPE (EEwsCreateFolderOperation, e_ews_create_folder_operation, E_TYPE_EWS_OPERATION)
+
+struct _EEwsCreateFolderOperationPrivate {
+	e_ews_create_folder_operation_cb cb;
+	gpointer user_data;
+};
+
+#define E_EWS_CREATE_FOLDER_OPERATION_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), E_TYPE_EWS_CREATE_FOLDER_OPERATION, EEwsCreateFolderOperationPrivate))
+
+static EEwsOperationClass *parent_class = NULL;
+
+/*
+ * Callback for synchroneous invocation
+ */
+struct e_ews_create_folder_operation_data {
+	GError *error;
+	EwsFolderId *folder_id;
+};
+
+static void
+e_ews_create_folder_operation_callback (const EwsFolderId *folder_id, gpointer user_data, const GError *error)
+{
+	struct e_ews_create_folder_operation_data *data = user_data;
+
+	if (error == NULL) {
+		data->error = NULL;
+		data->folder_id = e_ews_folder_fid_copy(folder_id);
+	}
+	else {
+		data->error = g_error_copy (error);
+		data->folder_id = NULL;
+	}
+}
+
+/* Class private implementation
+ */
+static void
+create_folder_operation_parse (EEwsOperation *op, ESoapParameter *response, GError *conn_error)
+{
+	ESoapParameter *subparam, *node, *param;
+	EwsFolderId *folder_id = NULL;
+	GError *error = NULL;
+
+	subparam = e_soap_parameter_get_first_child (response);
+
+	// check for connection or response error
+	if (conn_error)
+	{
+		g_propagate_error (&error, conn_error);
+
+		goto finish;
+	}
+
+	// make sure we got a "CreateFolderResponseMessage"
+	if (g_strcmp0((const char *)subparam->name, "CreateFolderResponseMessage") != 0)
+	{
+		g_set_error	(&error,
+					 EWS_CONNECTION_ERROR,
+					 EWS_CONNECTION_ERROR_CORRUPTDATA,
+					 "Expected 'CreateFolderResponseMessage' in response, but got '%s'", subparam->name);
+
+		goto finish;
+	}
+	
+	node = e_soap_parameter_get_first_child_by_name (subparam, "Folders");
+	node = e_soap_parameter_get_first_child_by_name (node, "Folder");
+	param = e_soap_parameter_get_first_child_by_name (node, "FolderId");
+
+	folder_id = g_new0 (EwsFolderId, 1);
+	folder_id->id = e_soap_parameter_get_property (param, "Id");
+	folder_id->change_key = e_soap_parameter_get_property (param, "ChangeKey");
+
+finish:
+	if (E_EWS_CREATE_FOLDER_OPERATION (op)->priv->cb != NULL)
+			E_EWS_CREATE_FOLDER_OPERATION (op)->priv->cb (folder_id, E_EWS_CREATE_FOLDER_OPERATION (op)->priv->user_data, error);
+
+	// cleanup
+	if (folder_id != NULL)
+		e_ews_folder_free_fid (folder_id);
+
+	g_clear_error (&error);
+}
+
+/* Class and instances handling
+ */
+static void
+e_ews_create_folder_operation_dispose (GObject *self)
+{
+	EEwsCreateFolderOperation *create_folder_operation = E_EWS_CREATE_FOLDER_OPERATION(self);
+	EEwsCreateFolderOperationPrivate *priv;
+
+	g_return_if_fail (E_IS_EWS_CREATE_FOLDER_OPERATION (create_folder_operation));
+	
+	priv = create_folder_operation->priv;
+	
+	/* Chain up to the parent class */
+	G_OBJECT_CLASS (e_ews_create_folder_operation_parent_class)->dispose (self);
+}
+
+static void
+e_ews_create_folder_operation_finalize (GObject *self)
+{
+	EEwsCreateFolderOperation *create_folder_operation = E_EWS_CREATE_FOLDER_OPERATION(self);
+	EEwsCreateFolderOperationPrivate *priv;
+
+	g_return_if_fail (E_IS_EWS_CREATE_FOLDER_OPERATION (create_folder_operation));
+
+	priv = create_folder_operation->priv;
+
+	/* Chain up to the parent class */
+	G_OBJECT_CLASS (e_ews_create_folder_operation_parent_class)->finalize (self);
+}
+
+static void
+e_ews_create_folder_operation_class_init (EEwsCreateFolderOperationClass *klass)
+{
+	GObjectClass *object_class = G_OBJECT_CLASS (klass);
+
+	parent_class = g_type_class_peek_parent (klass);
+
+	object_class->dispose = e_ews_create_folder_operation_dispose;
+	object_class->finalize = e_ews_create_folder_operation_finalize;
+	
+	g_type_class_add_private (klass, sizeof (EEwsCreateFolderOperationPrivate));
+
+	E_EWS_OPERATION_CLASS(klass)->parse = create_folder_operation_parse;
+}
+
+static void
+e_ews_create_folder_operation_init (EEwsCreateFolderOperation *create_folder_operation)
+{
+	create_folder_operation->priv = E_EWS_CREATE_FOLDER_OPERATION_GET_PRIVATE(create_folder_operation);
+}
+
+/*
+ * Class interface
+ */
+EEwsCreateFolderOperation *
+e_ews_create_folder_operation_new(EEwsConnection *cnc)
+{
+	EEwsCreateFolderOperation *op = g_object_new (E_TYPE_EWS_CREATE_FOLDER_OPERATION, NULL);
+	e_ews_operation_set_connection (E_EWS_OPERATION (op), cnc);
+
+	return op;
+}
+
+void
+e_ews_create_folder_operation_prepare (EEwsCreateFolderOperation *op,
+				const gchar *parent_folder_id,
+				gboolean is_distinguished_id,
+				const gchar *folder_name)
+{
+	EEwsConnection *cnc;
+	ESoapMessage *msg;
+	const gchar *uri, *email;
+
+	g_return_if_fail (E_IS_EWS_CREATE_FOLDER_OPERATION (op));
+
+	cnc = e_ews_operation_get_connection (E_EWS_OPERATION (op));
+	uri = e_ews_connection_get_uri (cnc);
+	email = e_ews_connection_get_email (cnc);
+	/* Prepare soap message
+	 */
+	msg = e_ews_message_new_with_header (uri, "CreateFolder", NULL, NULL, EWS_EXCHANGE_2007);
+
+	e_soap_message_start_element (msg, "ParentFolderId", "messages", NULL);
+
+	/* If NULL passed for parent_folder_id, use "msgfolderroot" */
+	if (is_distinguished_id || !parent_folder_id)
+		e_ews_message_write_string_parameter_with_attribute (msg, "DistinguishedFolderId", NULL, NULL, "Id",
+								     parent_folder_id?:"msgfolderroot");
+	else
+		e_ews_message_write_string_parameter_with_attribute (msg, "FolderId", NULL, NULL, "Id", parent_folder_id);
+
+	if (is_distinguished_id && email)
+		e_ews_message_write_string_parameter (msg, "Mailbox", NULL, email);
+
+	e_soap_message_end_element (msg);
+
+	e_soap_message_start_element (msg, "Folders", "messages", NULL);
+	e_soap_message_start_element(msg, "Folder", NULL, NULL);
+
+	e_ews_message_write_string_parameter (msg, "DisplayName", NULL, folder_name);
+
+	e_soap_message_end_element (msg); // "Folders"
+	e_soap_message_end_element (msg); // "Folder"
+
+	e_ews_message_write_footer (msg);
+
+	/* Set operation message
+	 */
+	e_ews_operation_set_message(E_EWS_OPERATION (op), msg);
+
+	// cleanup
+	g_object_unref(msg);
+}
+
+void
+e_ews_create_folder_operation_submit_async (EEwsCreateFolderOperation *op,
+			e_ews_create_folder_operation_cb cb,
+			GCancellable *cancellable,
+			gpointer user_data)
+{
+	g_return_if_fail (E_IS_EWS_CREATE_FOLDER_OPERATION (op));
+
+	op->priv->cb = cb;
+	op->priv->user_data = user_data;
+
+	e_ews_operation_submit (E_EWS_OPERATION (op), cancellable, EWS_PRIORITY_MEDIUM, NULL);
+}
+
+/*
+ * e_ews_create_folder_operation_sync()
+ * Convenience function.
+ * Does everything for you synchroneously.
+ * 
+ * returns TRUE/FALSE based on success.
+ */
+gboolean
+e_ews_create_folder_operation_sync (EEwsConnection *cnc,
+				 const gchar *parent_folder_id,
+				 gboolean is_distinguished_id,
+				 const gchar *folder_name,
+				 EwsFolderId **folder_id,
+				 GError **error)
+{
+	EEwsCreateFolderOperation *op;
+	struct e_ews_create_folder_operation_data data;
+
+	op = e_ews_create_folder_operation_new(cnc);
+
+	e_ews_create_folder_operation_prepare (op, parent_folder_id, is_distinguished_id, folder_name);
+
+	op->priv->cb = e_ews_create_folder_operation_callback;
+	op->priv->user_data = &data;
+
+	e_ews_operation_submit (E_EWS_OPERATION (op), NULL, EWS_PRIORITY_MEDIUM, e_flag_new ());
+
+	if (data.error)
+	{
+		g_propagate_error (error, data.error);
+		g_clear_error (&data.error);
+	}
+
+	*folder_id = data.folder_id;
+	return (*error == NULL);
+}
diff --git a/src/server/e-ews-create-folder-operation.h b/src/server/e-ews-create-folder-operation.h
new file mode 100644
index 0000000..4f0eef3
--- /dev/null
+++ b/src/server/e-ews-create-folder-operation.h
@@ -0,0 +1,73 @@
+/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
+/*
+ * Authors : Or Goshen, Pavel Ocheretny
+ *
+ * Copyright (C) 1999-2011 Intel, Inc. (www.intel.com)
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of version 2 of the GNU Lesser General Public
+ * License as published by the Free Software Foundation.
+ *
+ * This program 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 this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301
+ * USA
+ */
+
+#ifndef E_EWS_CREATE_FOLDER_OPERATION_H
+#define E_EWS_CREATE_FOLDER_OPERATION_H
+
+#include <glib-object.h>
+#include <glib.h>
+#include "e-ews-operation.h"
+
+G_BEGIN_DECLS
+
+#define E_TYPE_EWS_CREATE_FOLDER_OPERATION            (e_ews_create_folder_operation_get_type ())
+#define E_EWS_CREATE_FOLDER_OPERATION(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), E_TYPE_EWS_CREATE_FOLDER_OPERATION, EEwsCreateFolderOperation))
+#define E_EWS_CREATE_FOLDER_OPERATION_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), E_TYPE_EWS_CREATE_FOLDER_OPERATION, EEwsCreateFolderOperationClass))
+#define E_IS_EWS_CREATE_FOLDER_OPERATION(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), E_TYPE_EWS_CREATE_FOLDER_OPERATION))
+#define E_IS_EWS_CREATE_FOLDER_OPERATION_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), E_TYPE_EWS_CREATE_FOLDER_OPERATION))
+
+typedef struct _EEwsCreateFolderOperation        EEwsCreateFolderOperation;
+typedef struct _EEwsCreateFolderOperationClass   EEwsCreateFolderOperationClass;
+typedef struct _EEwsCreateFolderOperationPrivate EEwsCreateFolderOperationPrivate;
+
+struct _EEwsCreateFolderOperation {
+	EEwsOperation parent;
+	
+	EEwsCreateFolderOperationPrivate *priv;
+};
+
+struct _EEwsCreateFolderOperationClass {
+	EEwsOperationClass parent_class;
+};
+
+GType e_ews_create_folder_operation_get_type (void);
+
+EEwsCreateFolderOperation *e_ews_create_folder_operation_new(EEwsConnection *cnc);
+
+void e_ews_create_folder_operation_prepare (EEwsCreateFolderOperation *op, const gchar *parent_folder_id, gboolean is_distinguished_id, const gchar *folder_name);
+
+typedef void (*e_ews_create_folder_operation_cb) (const EwsFolderId *folder_id, gpointer user_data, const GError *error);
+void e_ews_create_folder_operation_submit_async (EEwsCreateFolderOperation *op,
+		e_ews_create_folder_operation_cb cb,
+		GCancellable *cancellable,
+		gpointer user_data);
+
+gboolean
+e_ews_create_folder_operation_sync (EEwsConnection *cnc,
+				 const gchar *parent_folder_id,
+				 gboolean is_distinguished_id,
+				 const gchar *folder_name,
+				 EwsFolderId **folder_id,
+				 GError **error);
+
+G_END_DECLS
+
+#endif