path: root/embed/ephy-embed-persist.c

/*
 *  Copyright (C) 2000-2003 Marco Pesenti Gritti
 *  Copyright (C) 2003 Christian Persch
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2, or (at your option)
 *  any later version.
 *
 *  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 General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 *
 *  $Id$
 */

#ifdef HAVE_CONFIG_H
#include "config.h"
#endif

#include "ephy-embed-persist.h"
#include "mozilla-embed-persist.h"
#include "ephy-debug.h"

enum
{
    PROP_0,
    PROP_DEST,
    PROP_EMBED,
    PROP_FILECHOOSER_TITLE,
    PROP_FILECHOOSER_PARENT,
    PROP_FLAGS,
    PROP_HANDLER,
    PROP_MAX_SIZE,
    PROP_PERSISTKEY,
    PROP_SOURCE,    
};

#define EPHY_EMBED_PERSIST_GET_PRIVATE(object)(G_TYPE_INSTANCE_GET_PRIVATE ((object), EPHY_TYPE_EMBED_PERSIST, EphyEmbedPersistPrivate))

struct EphyEmbedPersistPrivate
{
    char *dest;
    char *source;
    char *fc_title;
    char *persist_key;
    EphyEmbed *embed;
    long max_size;
    EmbedPersistFlags flags;
    GtkWindow *fc_parent;
};

static void ephy_embed_persist_class_init   (EphyEmbedPersistClass *klass);
static void ephy_embed_persist_init     (EphyEmbedPersist *ges);

static GObjectClass *parent_class = NULL;

GType
ephy_embed_persist_get_type (void)
{
       static GType type = 0;

    if (G_UNLIKELY (type == 0))
    {
        static const GTypeInfo our_info =
        {
            sizeof (EphyEmbedPersistClass),
            NULL, /* base_init */
            NULL, /* base_finalize */
            (GClassInitFunc) ephy_embed_persist_class_init,
            NULL, /* class_finalize */
            NULL, /* class_data */
            sizeof (EphyEmbedPersist),
            0,    /* n_preallocs */
            (GInstanceInitFunc) ephy_embed_persist_init
        };

        type = g_type_register_static (G_TYPE_OBJECT,
                           "EphyEmbedPersist",
                           &our_info, G_TYPE_FLAG_ABSTRACT);
    }

    return type;
}

/**
 * ephy_embed_persist_set_dest:
 * @persist: an #EphyEmbedPersist
 * @value: the path to which @persist should save data
 *
 * Sets the path to which @persist should save data.
 **/
void
ephy_embed_persist_set_dest (EphyEmbedPersist *persist,
                 const char *value)
{
    g_return_if_fail (EPHY_IS_EMBED_PERSIST (persist));

    persist->priv->dest = g_strdup (value);
}

/**
 * ephy_embed_persist_set_embed:
 * @persist: an #EphyEmbedPersist
 * @value: a parent #EphyEmbed
 *
 * Sets the #EphyEmbed from which @persist will download data.
 *
 * An #EphyEmbed is absolutely required to download if @persist's
 * #EmbedPersistFlags include %EMBED_PERSIST_COPY_PAGE. Regardless, an
 * #EphyEmbed should be set for <emphasis>every</emphasis> #EphyEmbedPersist,
 * since it determines request information such as the referring page.
 **/
void
ephy_embed_persist_set_embed (EphyEmbedPersist *persist,
                  EphyEmbed *value)
{
    g_return_if_fail (EPHY_IS_EMBED_PERSIST (persist));

    persist->priv->embed = value;
}

/**
 * ephy_embed_persist_set_fc_title:
 * @persist: an #EphyEmbedPersist
 * @value: the title to be displayed by the filechooser
 *
 * Sets the title of the filechooser window. The filechooser will only be
 * displayed if %EMBED_PERSIST_ASK_DESTINATION has been set with
 * ephy_embed_persist_set_flags().
 **/
void
ephy_embed_persist_set_fc_title (EphyEmbedPersist *persist,
                 const char *value)
{
    g_return_if_fail (EPHY_IS_EMBED_PERSIST (persist));

    persist->priv->fc_title = g_strdup (value);
}

/**
 * ephy_embed_persist_set_fc_parent:
 * @persist: an #EphyEmbedPersist
 * @value: the #EphyWindow which should be the filechooser's parent
 *
 * Sets the #EphyWindow which should be @persist's filechooser's parent. The
 * filechooser will only be displayed if %EMBED_PERSIST_ASK_DESTINATION has been
 * set with ephy_embed_persist_set_flags().
 **/
void
ephy_embed_persist_set_fc_parent (EphyEmbedPersist *persist,
                  GtkWindow *value)
{
    g_return_if_fail (EPHY_IS_EMBED_PERSIST (persist));

    persist->priv->fc_parent = value;
}

/**
 * ephy_embed_persist_set_flags:
 * @persist: an #EphyEmbedPersist
 * @value: the desired #EmbedPersistFlags
 *
 * Sets the flags to be used for @persist's download.
 **/
void
ephy_embed_persist_set_flags (EphyEmbedPersist *persist,
                  EmbedPersistFlags value)
{
    g_return_if_fail (EPHY_IS_EMBED_PERSIST (persist));

    persist->priv->flags = value;
}

/**
 * ephy_embed_persist_set_max_size:
 * @persist: an #EphyEmbedPersist
 * @value: maximum size of requested download, in bytes
 *
 * Sets the maximum size of @persist's download.
 *
 * If the requested file is discovered to be larger than @value, the download
 * will be aborted. Note that @persist will have to actually begin downloading
 * before it can abort, since it doesn't know the filesize before the download
 * starts.
 **/
void
ephy_embed_persist_set_max_size (EphyEmbedPersist *persist,
                 long value)
{
    g_return_if_fail (EPHY_IS_EMBED_PERSIST (persist));

    persist->priv->max_size = value;
}

/**
 * ephy_embed_persist_set_persist_key:
 * @persist: an #EphyEmbedPersist
 * @value: a GConf key
 *
 * Sets the GConf key from which @persist will determine the default download
 * directory.
 **/
void
ephy_embed_persist_set_persist_key (EphyEmbedPersist *persist,
                    const char *value)
{
    g_return_if_fail (EPHY_IS_EMBED_PERSIST (persist));

    persist->priv->persist_key = g_strdup (value);
}

/**
 * ephy_embed_persist_set_source:
 * @persist: an #EphyEmbedPersist
 * @value: the URL from which @persist should download
 *
 * Sets the URL from which @persist should download. This should be used in
 * conjunction with ephy_embed_persist_set_embed().
 **/
void
ephy_embed_persist_set_source (EphyEmbedPersist *persist,
                   const char *value)
{
    g_return_if_fail (EPHY_IS_EMBED_PERSIST (persist));

    persist->priv->source = g_strdup (value);
}

/**
 * ephy_embed_persist_get_dest:
 * @persist: an #EphyEmbedPersist
 *
 * Returns the destination filename to which @persist will save its download.
 *
 * Return value: @persist's destination filename
 **/
const char *
ephy_embed_persist_get_dest (EphyEmbedPersist *persist)
{
    g_return_val_if_fail (EPHY_IS_EMBED_PERSIST (persist), NULL);

    return persist->priv->dest;
}

/**
 * ephy_embed_persist_get_embed:
 * @persist: an #EphyEmbedPersist
 *
 * Returns the #EphyEmbed from which @persist will download.
 *
 * Return value: the #EphyEmbed from which @persist will download
 **/
EphyEmbed *
ephy_embed_persist_get_embed (EphyEmbedPersist *persist)
{
    g_return_val_if_fail (EPHY_IS_EMBED_PERSIST (persist), NULL);

    return persist->priv->embed;
}

/**
 * ephy_embed_persist_get_fc_title:
 * @persist: an #EphyEmbedPersist
 *
 * Returns the title to be displayed in @persist's filechooser.
 *
 * Return value: the title to be displayed in @persist's filechooser
 **/
const char *
ephy_embed_persist_get_fc_title (EphyEmbedPersist *persist)
{
    g_return_val_if_fail (EPHY_IS_EMBED_PERSIST (persist), NULL);

    return persist->priv->fc_title;
}

/**
 * ephy_embed_persist_get_fc_parent:
 * @persist: an #EphyEmbedPersist
 *
 * Returns the #EphyWindow which should serve as a parent for @persist's
 * filechooser.
 *
 * Return value: the #EphyWindow parent for @persist's filechooser
 **/
GtkWindow *
ephy_embed_persist_get_fc_parent (EphyEmbedPersist *persist)
{
    g_return_val_if_fail (EPHY_IS_EMBED_PERSIST (persist), NULL);

    return persist->priv->fc_parent;
}

/**
 * ephy_embed_persist_get_flags:
 * @persist: an #EphyEmbedPersist
 *
 * Returns @persist's #EmbedPersistFlags.
 *
 * Return value: @persist's #EmbedPersistFlags
 **/
EmbedPersistFlags
ephy_embed_persist_get_flags (EphyEmbedPersist *persist)
{
    g_return_val_if_fail (EPHY_IS_EMBED_PERSIST (persist), 0);

    return persist->priv->flags;
}

/**
 * ephy_embed_persist_get_max_size:
 * @persist: an #EphyEmbedPersist
 *
 * Returns the maximum size of @persist's requested download, in bytes.
 *
 * Return value: the maximum size of @persist's requested download, in bytes
 **/
long
ephy_embed_persist_get_max_size (EphyEmbedPersist *persist)
{
    g_return_val_if_fail (EPHY_IS_EMBED_PERSIST (persist), 0);

    return persist->priv->max_size;
}

/**
 * ephy_embed_persist_get_persist_key:
 * @persist: an #EphyEmbedPersist
 *
 * Returns the GConf key which determines Epiphany's default download directory.
 *
 * Return value: the GConf key to the default download directory
 **/
const char *
ephy_embed_persist_get_persist_key (EphyEmbedPersist *persist)
{
    g_return_val_if_fail (EPHY_IS_EMBED_PERSIST (persist), NULL);

    return persist->priv->persist_key;
}

/**
 * ephy_embed_persist_get_source:
 * @persist: an #EphyEmbedPersist
 *
 * Returns the source URL of the file to download.
 *
 * Return value: a source URL
 **/
const char *
ephy_embed_persist_get_source (EphyEmbedPersist *persist)
{
    g_return_val_if_fail (EPHY_IS_EMBED_PERSIST (persist), NULL);

    return persist->priv->source;
}

static void
ephy_embed_persist_set_property (GObject *object,
                 guint prop_id,
                 const GValue *value,
                 GParamSpec *pspec)
{
    EphyEmbedPersist *persist = EPHY_EMBED_PERSIST (object);

    switch (prop_id)
    {
        case PROP_DEST:
            ephy_embed_persist_set_dest (persist, g_value_get_string (value));
            break;
        case PROP_EMBED:
            ephy_embed_persist_set_embed (persist, g_value_get_object (value));
            break;
        case PROP_FILECHOOSER_TITLE:
            ephy_embed_persist_set_fc_title (persist, g_value_get_string (value));
            break;
        case PROP_FILECHOOSER_PARENT:
            ephy_embed_persist_set_fc_parent (persist, g_value_get_object (value));
            break;
        case PROP_FLAGS:
            ephy_embed_persist_set_flags (persist, g_value_get_int (value));
            break;
        case PROP_MAX_SIZE:
            ephy_embed_persist_set_max_size (persist, g_value_get_long (value));
            break;
        case PROP_PERSISTKEY:
            ephy_embed_persist_set_persist_key (persist, g_value_get_string (value));
            break;
        case PROP_SOURCE:
            ephy_embed_persist_set_source (persist, g_value_get_string (value));
            break;
    }
}

static void
ephy_embed_persist_get_property (GObject *object,
                 guint prop_id,
                 GValue *value,
                 GParamSpec *pspec)
{
    EphyEmbedPersist *persist = EPHY_EMBED_PERSIST (object);

    switch (prop_id)
    {
        case PROP_DEST:
            g_value_set_string (value, ephy_embed_persist_get_dest (persist));
            break;
        case PROP_EMBED:
            g_value_set_object (value, ephy_embed_persist_get_embed (persist));
            break;
        case PROP_FILECHOOSER_TITLE:
            g_value_set_string (value, ephy_embed_persist_get_fc_title (persist));
            break;
        case PROP_FILECHOOSER_PARENT:
            g_value_set_object (value, ephy_embed_persist_get_fc_parent (persist));
            break;
        case PROP_FLAGS:
            g_value_set_int (value, ephy_embed_persist_get_flags (persist));
            break;
        case PROP_MAX_SIZE:
            g_value_set_long (value, ephy_embed_persist_get_max_size (persist));
            break;
        case PROP_PERSISTKEY:
            g_value_set_string (value, ephy_embed_persist_get_persist_key (persist));
            break;
        case PROP_SOURCE:
            g_value_set_string (value, ephy_embed_persist_get_source (persist));
            break;
    }
}

static void
ephy_embed_persist_init (EphyEmbedPersist *persist)
{
    persist->priv = EPHY_EMBED_PERSIST_GET_PRIVATE (persist);

    LOG ("EphyEmbedPersist initialising %p", persist)

    persist->priv->dest = NULL;
    persist->priv->source = NULL;
    persist->priv->fc_title = NULL;
    persist->priv->fc_parent = NULL;
    persist->priv->flags = 0;
    persist->priv->max_size = -1;
    persist->priv->persist_key = NULL;
}

static void
ephy_embed_persist_finalize (GObject *object)
{
    EphyEmbedPersist *persist = EPHY_EMBED_PERSIST (object);

    g_free (persist->priv->dest);
    g_free (persist->priv->source);
    g_free (persist->priv->fc_title);
    g_free (persist->priv->persist_key);

    LOG ("EphyEmbedPersist finalised %p", object)

    G_OBJECT_CLASS (parent_class)->finalize (object);
}

static void
ephy_embed_persist_class_init (EphyEmbedPersistClass *klass)
{
    GObjectClass *object_class = G_OBJECT_CLASS (klass);

    parent_class = g_type_class_peek_parent (klass);

    object_class->finalize = ephy_embed_persist_finalize;
    object_class->set_property = ephy_embed_persist_set_property;
    object_class->get_property = ephy_embed_persist_get_property;

    /* init signals */
/**
 * EphyEmbedPersist::completed:
 *
 * The ::completed signal is emitted when @persist has finished downloading. The
 * download must have started with ephy_embed_persist_save().
 **/
    g_signal_new ("completed",
              G_OBJECT_CLASS_TYPE (object_class),
              G_SIGNAL_RUN_LAST,
              G_STRUCT_OFFSET (EphyEmbedPersistClass, completed),
              NULL, NULL,
              g_cclosure_marshal_VOID__VOID,
              G_TYPE_NONE,
              0);
/**
 * EphyEmbedPersist::cancelled:
 *
 * The ::cancelled signal is emitted when @persist's download has been
 * cancelled with ephy_embed_persist_cancel().
 **/
    g_signal_new ("cancelled",
              G_OBJECT_CLASS_TYPE (object_class),
              G_SIGNAL_RUN_LAST,
              G_STRUCT_OFFSET (EphyEmbedPersistClass, cancelled),
              NULL, NULL,
              g_cclosure_marshal_VOID__VOID,
              G_TYPE_NONE,
              0);

    g_object_class_install_property (object_class,
                     PROP_DEST,
                     g_param_spec_string ("dest",
                                  "Destination",
                                  "Destination file path",
                                  NULL,
                                  G_PARAM_READWRITE));

    g_object_class_install_property (object_class,
                     PROP_EMBED,
                     g_param_spec_object ("embed",
                                  "Embed",
                                  "The embed containing the document",
                                  G_TYPE_OBJECT,
                                  G_PARAM_READWRITE |
                                  G_PARAM_CONSTRUCT_ONLY));

    g_object_class_install_property (object_class,
                     PROP_FILECHOOSER_TITLE,
                     g_param_spec_string  ("filechooser-title",
                                   "Filechooser title",
                                   "Title to use if showing filechooser",
                                   NULL,
                                   G_PARAM_READWRITE));

    g_object_class_install_property (object_class,
                     PROP_FILECHOOSER_PARENT,
                     g_param_spec_object ("filechooser-parent",
                                  "Filechooser parent",
                                  "The parent window for the filechooser",
                                  GTK_TYPE_WINDOW,
                                  G_PARAM_READWRITE));

    g_object_class_install_property (object_class,
                     PROP_FLAGS,
                     g_param_spec_int    ("flags",
                                  "Flags",
                                  "Flags",
                                  0,
                                  G_MAXINT,
                                  0,
                                  G_PARAM_READWRITE));

    g_object_class_install_property (object_class,
                     PROP_MAX_SIZE,
                     g_param_spec_long   ("max_size",
                                  "Maxsize",
                                  "Maximum size of the file",
                                  0,
                                  G_MAXLONG,
                                  0,
                                  G_PARAM_READWRITE));

    g_object_class_install_property (object_class,
                     PROP_PERSISTKEY,
                     g_param_spec_string  ("persist-key",
                                   "persist key",
                                   "Path persistence gconf key",
                                   NULL,
                                   G_PARAM_READWRITE));

    g_object_class_install_property (object_class,
                     PROP_SOURCE,
                     g_param_spec_string  ("source",
                                   "Source",
                                   "Url of the document to save",
                                   NULL,
                                   G_PARAM_READWRITE));

    g_type_class_add_private (object_class, sizeof(EphyEmbedPersistPrivate));
}

/**
 * ephy_embed_persist_cancel:
 * @persist: an #EphyEmbedPersist
 *
 * Cancels @persist's download. This will not delete the partially downloaded
 * file.
 **/
void
ephy_embed_persist_cancel (EphyEmbedPersist *persist)
{
    EphyEmbedPersistClass *klass = EPHY_EMBED_PERSIST_GET_CLASS (persist);
    klass->cancel (persist);
}

/**
 * ephy_embed_persist_save:
 * @persist: an #EphyEmbedPersist
 *
 * Begins saving the file specified in @persist.
 *
 * If @persist's #EmbedPersistFlags include %EMBED_PERSIST_ASK_DESTINATION, a
 * filechooser dialog will be shown first.
 *
 * The file will continue to download in the background until either the
 * ::completed or the ::cancelled signals are emitted by @persist.
 *
 * Return value: %TRUE if the download began successfully
 **/
gboolean
ephy_embed_persist_save (EphyEmbedPersist *persist)
{
    EphyEmbedPersistClass *klass = EPHY_EMBED_PERSIST_GET_CLASS (persist);
    return klass->save (persist);
}

/**
 * ephy_embed_persist_to_string:
 * @persist: an #EphyEmbedPersist
 *
 * Returns the download specified by @persist as a string instead of downloading
 * it to a file.
 *
 * The download is synchronous. An #EphyEmbed must be specified with
 * ephy_embed_persist_set_embed(). The function implicitly assumes that
 * @persist's #EmbedPersistFlags include %EMBED_PERSIST_COPY_PAGE. If @persist's
 * #EphyEmbed has not finished downloading, this function will only return the
 * portion of data which has already been downloaded.
 *
 * The document will be modified: it will only include absolute links and it
 * will be encoded as UTF-8.
 *
 * Return value: The contents of @persist's #EphyEmbed's web page
 **/
char *
ephy_embed_persist_to_string (EphyEmbedPersist *persist)
{
       EphyEmbedPersistClass *klass = EPHY_EMBED_PERSIST_GET_CLASS (persist);
       return klass->to_string (persist);
}