New. An interface for objects that want to act on every message passing

[platform/upstream/libsoup.git] / libsoup / soup-session.h

diff --git a/libsoup/soup-session.h b/libsoup/soup-session.h
index 9b2e03a..8e5be50 100644 (file)
--- a/libsoup/soup-session.h
+++ b/libsoup/soup-session.h
@@ -8,6 +8,7 @@
 
 #include <libsoup/soup-types.h>
 #include <libsoup/soup-message.h>
+#include <libsoup/soup-message-queue.h>
 
 #define SOUP_TYPE_SESSION            (soup_session_get_type ())
 #define SOUP_SESSION(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), SOUP_TYPE_SESSION, SoupSession))
@@ -18,11 +19,14 @@
 
 typedef struct SoupSessionPrivate SoupSessionPrivate;
 
-typedef struct {
+struct SoupSession {
        GObject parent;
 
        SoupSessionPrivate *priv;
-} SoupSession;
+
+       /* protected */
+       SoupMessageQueue *queue;
+};
 
 typedef struct {
        GObjectClass parent_class;
@@ -35,6 +39,15 @@ typedef struct {
                                const char *auth_type, const char *auth_realm,
                                char **username, char **password);
 
+       /* methods */
+       void  (*queue_message)   (SoupSession *session, SoupMessage *msg,
+                                 SoupMessageCallbackFn callback,
+                                 gpointer user_data);
+       void  (*requeue_message) (SoupSession *session, SoupMessage *msg);
+       guint (*send_message)    (SoupSession *session, SoupMessage *msg);
+
+       void  (*cancel_message)  (SoupSession *session, SoupMessage *msg);
+
 } SoupSessionClass;
 
 GType soup_session_get_type (void);
@@ -43,22 +56,34 @@ GType soup_session_get_type (void);
 #define SOUP_SESSION_MAX_CONNS          "max-conns"
 #define SOUP_SESSION_MAX_CONNS_PER_HOST "max-conns-per-host"
 #define SOUP_SESSION_USE_NTLM           "use-ntlm"
+#define SOUP_SESSION_SSL_CA_FILE        "ssl-ca-file"
 
-SoupSession    *soup_session_new              (void);
-SoupSession    *soup_session_new_with_options (const char            *optname1,
-                                              ...);
+void            soup_session_add_filter       (SoupSession           *session,
+                                              SoupMessageFilter     *filter);
+void            soup_session_remove_filter    (SoupSession           *session,
+                                              SoupMessageFilter     *filter);
 
 void            soup_session_queue_message    (SoupSession           *session,
-                                              SoupMessage           *req,
+                                              SoupMessage           *msg,
                                               SoupMessageCallbackFn  callback,
                                               gpointer               user_data);
 void            soup_session_requeue_message  (SoupSession           *session,
-                                              SoupMessage           *req);
+                                              SoupMessage           *msg);
 
 guint           soup_session_send_message     (SoupSession           *session,
-                                              SoupMessage           *req);
+                                              SoupMessage           *msg);
 
+void            soup_session_cancel_message   (SoupSession           *session,
+                                              SoupMessage           *msg);
 void            soup_session_abort            (SoupSession           *session);
 
 
+/* Protected methods */
+SoupConnection *soup_session_get_connection       (SoupSession    *session,
+                                                  SoupMessage    *msg,
+                                                  gboolean       *try_pruning,
+                                                  gboolean       *is_new);
+gboolean        soup_session_try_prune_connection (SoupSession    *session);
+
+
 #endif /* SOUP_SESSION_H */