/*
* e-mail-part.c
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) version 3.
*
* 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 the program; if not, see
*
*/
/**
* EMailPart:
*
* The #EMailPart is a wrapper around #CamelMimePart which holds additional
* information about the mime part, like it's ID, encryption type etc.
*
* Each #EMailPart must have a unique ID. The ID is a dot-separated
* hierarchical description of the location of the part within the email
* message.
*/
#include "e-mail-part.h"
#include
#define E_MAIL_PART_GET_PRIVATE(obj) \
(G_TYPE_INSTANCE_GET_PRIVATE \
((obj), E_TYPE_MAIL_PART, EMailPartPrivate))
struct _EMailPartPrivate {
CamelMimePart *mime_part;
gchar *id;
gchar *cid;
gchar *mime_type;
gboolean is_attachment;
};
enum {
PROP_0,
PROP_CID,
PROP_ID,
PROP_IS_ATTACHMENT,
PROP_MIME_PART,
PROP_MIME_TYPE
};
G_DEFINE_TYPE (
EMailPart,
e_mail_part,
G_TYPE_OBJECT)
static void
mail_part_validity_pair_free (gpointer ptr)
{
EMailPartValidityPair *pair = ptr;
if (!pair)
return;
camel_cipher_validity_free (pair->validity);
g_free (pair);
}
static void
mail_part_set_id (EMailPart *part,
const gchar *id)
{
g_return_if_fail (part->priv->id == NULL);
part->priv->id = g_strdup (id);
}
static void
mail_part_set_mime_part (EMailPart *part,
CamelMimePart *mime_part)
{
g_return_if_fail (part->priv->mime_part == NULL);
/* The CamelMimePart is optional. */
if (mime_part != NULL)
part->priv->mime_part = g_object_ref (mime_part);
}
static void
mail_part_set_property (GObject *object,
guint property_id,
const GValue *value,
GParamSpec *pspec)
{
switch (property_id) {
case PROP_CID:
e_mail_part_set_cid (
E_MAIL_PART (object),
g_value_get_string (value));
return;
case PROP_ID:
mail_part_set_id (
E_MAIL_PART (object),
g_value_get_string (value));
return;
case PROP_IS_ATTACHMENT:
e_mail_part_set_is_attachment (
E_MAIL_PART (object),
g_value_get_boolean (value));
return;
case PROP_MIME_PART:
mail_part_set_mime_part (
E_MAIL_PART (object),
g_value_get_object (value));
return;
case PROP_MIME_TYPE:
e_mail_part_set_mime_type (
E_MAIL_PART (object),
g_value_get_string (value));
return;
}
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
}
static void
mail_part_get_property (GObject *object,
guint property_id,
GValue *value,
GParamSpec *pspec)
{
switch (property_id) {
case PROP_CID:
g_value_set_string (
value,
e_mail_part_get_cid (
E_MAIL_PART (object)));
return;
case PROP_ID:
g_value_set_string (
value,
e_mail_part_get_id (
E_MAIL_PART (object)));
return;
case PROP_IS_ATTACHMENT:
g_value_set_boolean (
value,
e_mail_part_get_is_attachment (
E_MAIL_PART (object)));
return;
case PROP_MIME_PART:
g_value_take_object (
value,
e_mail_part_ref_mime_part (
E_MAIL_PART (object)));
return;
case PROP_MIME_TYPE:
g_value_set_string (
value,
e_mail_part_get_mime_type (
E_MAIL_PART (object)));
return;
}
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
}
static void
mail_part_dispose (GObject *object)
{
EMailPartPrivate *priv;
priv = E_MAIL_PART_GET_PRIVATE (object);
g_clear_object (&priv->mime_part);
/* Chain up to parent's dispose() method. */
G_OBJECT_CLASS (e_mail_part_parent_class)->dispose (object);
}
static void
mail_part_finalize (GObject *object)
{
EMailPart *part = E_MAIL_PART (object);
EMailPartValidityPair *pair;
g_free (part->priv->id);
g_free (part->priv->cid);
g_free (part->priv->mime_type);
while ((pair = g_queue_pop_head (&part->validities)) != NULL)
mail_part_validity_pair_free (pair);
/* Chain up to parent's finalize() method. */
G_OBJECT_CLASS (e_mail_part_parent_class)->finalize (object);
}
static void
e_mail_part_class_init (EMailPartClass *class)
{
GObjectClass *object_class;
g_type_class_add_private (class, sizeof (EMailPartPrivate));
object_class = G_OBJECT_CLASS (class);
object_class->set_property = mail_part_set_property;
object_class->get_property = mail_part_get_property;
object_class->dispose = mail_part_dispose;
object_class->finalize = mail_part_finalize;
g_object_class_install_property (
object_class,
PROP_CID,
g_param_spec_string (
"cid",
"Content ID",
"The MIME Content-ID",
NULL,
G_PARAM_READWRITE |
G_PARAM_STATIC_STRINGS));
g_object_class_install_property (
object_class,
PROP_ID,
g_param_spec_string (
"id",
"Part ID",
"The part ID",
NULL,
G_PARAM_READWRITE |
G_PARAM_CONSTRUCT_ONLY |
G_PARAM_STATIC_STRINGS));
g_object_class_install_property (
object_class,
PROP_IS_ATTACHMENT,
g_param_spec_boolean (
"is-attachment",
"Is Attachment",
"Format the part as an attachment",
FALSE,
G_PARAM_READWRITE |
G_PARAM_CONSTRUCT |
G_PARAM_STATIC_STRINGS));
g_object_class_install_property (
object_class,
PROP_MIME_PART,
g_param_spec_object (
"mime-part",
"MIME Part",
"The MIME part",
CAMEL_TYPE_MIME_PART,
G_PARAM_READWRITE |
G_PARAM_CONSTRUCT_ONLY |
G_PARAM_STATIC_STRINGS));
g_object_class_install_property (
object_class,
PROP_MIME_TYPE,
g_param_spec_string (
"mime-type",
"MIME Type",
"The MIME type",
NULL,
G_PARAM_READWRITE |
G_PARAM_STATIC_STRINGS));
}
static void
e_mail_part_init (EMailPart *part)
{
part->priv = E_MAIL_PART_GET_PRIVATE (part);
}
/**
* e_mail_part_new:
* @mime_part: (allow-none) a #CamelMimePart or %NULL
* @id: part ID
*
* Creates a new #EMailPart for the given @mime_part.
*
* Return value: a new #EMailPart
*/
EMailPart *
e_mail_part_new (CamelMimePart *mime_part,
const gchar *id)
{
g_return_val_if_fail (id != NULL, NULL);
return g_object_new (
E_TYPE_MAIL_PART,
"id", id, "mime-part", mime_part, NULL);
}
const gchar *
e_mail_part_get_id (EMailPart *part)
{
g_return_val_if_fail (E_IS_MAIL_PART (part), NULL);
return part->priv->id;
}
const gchar *
e_mail_part_get_cid (EMailPart *part)
{
g_return_val_if_fail (E_IS_MAIL_PART (part), NULL);
return part->priv->cid;
}
void
e_mail_part_set_cid (EMailPart *part,
const gchar *cid)
{
g_return_if_fail (E_IS_MAIL_PART (part));
g_free (part->priv->cid);
part->priv->cid = g_strdup (cid);
g_object_notify (G_OBJECT (part), "cid");
}
gboolean
e_mail_part_id_has_prefix (EMailPart *part,
const gchar *prefix)
{
g_return_val_if_fail (E_IS_MAIL_PART (part), FALSE);
g_return_val_if_fail (prefix != NULL, FALSE);
return g_str_has_prefix (part->priv->id, prefix);
}
gboolean
e_mail_part_id_has_suffix (EMailPart *part,
const gchar *suffix)
{
g_return_val_if_fail (E_IS_MAIL_PART (part), FALSE);
g_return_val_if_fail (suffix != NULL, FALSE);
return g_str_has_suffix (part->priv->id, suffix);
}
gboolean
e_mail_part_id_has_substr (EMailPart *part,
const gchar *substr)
{
g_return_val_if_fail (E_IS_MAIL_PART (part), FALSE);
g_return_val_if_fail (substr != NULL, FALSE);
return (strstr (part->priv->id, substr) != NULL);
}
CamelMimePart *
e_mail_part_ref_mime_part (EMailPart *part)
{
CamelMimePart *mime_part = NULL;
g_return_val_if_fail (E_IS_MAIL_PART (part), NULL);
if (part->priv->mime_part != NULL)
mime_part = g_object_ref (part->priv->mime_part);
return mime_part;
}
const gchar *
e_mail_part_get_mime_type (EMailPart *part)
{
g_return_val_if_fail (E_IS_MAIL_PART (part), NULL);
return part->priv->mime_type;
}
void
e_mail_part_set_mime_type (EMailPart *part,
const gchar *mime_type)
{
g_return_if_fail (E_IS_MAIL_PART (part));
if (g_strcmp0 (mime_type, part->priv->mime_type) == 0)
return;
g_free (part->priv->mime_type);
part->priv->mime_type = g_strdup (mime_type);
g_object_notify (G_OBJECT (part), "mime-type");
}
gboolean
e_mail_part_get_is_attachment (EMailPart *part)
{
g_return_val_if_fail (E_IS_MAIL_PART (part), FALSE);
return part->priv->is_attachment;
}
void
e_mail_part_set_is_attachment (EMailPart *part,
gboolean is_attachment)
{
g_return_if_fail (E_IS_MAIL_PART (part));
if (is_attachment == part->priv->is_attachment)
return;
part->priv->is_attachment = is_attachment;
g_object_notify (G_OBJECT (part), "is-attachment");
}
void
e_mail_part_bind_dom_element (EMailPart *part,
WebKitDOMElement *element)
{
EMailPartClass *class;
g_return_if_fail (E_IS_MAIL_PART (part));
g_return_if_fail (WEBKIT_DOM_IS_ELEMENT (element));
class = E_MAIL_PART_GET_CLASS (part);
if (class->bind_dom_element != NULL)
class->bind_dom_element (part, element);
}
static EMailPartValidityPair *
mail_part_find_validity_pair (EMailPart *part,
EMailPartValidityFlags validity_type)
{
GList *head, *link;
head = g_queue_peek_head_link (&part->validities);
for (link = head; link != NULL; link = g_list_next (link)) {
EMailPartValidityPair *pair = link->data;
if (pair == NULL)
continue;
if ((pair->validity_type & validity_type) == validity_type)
return pair;
}
return NULL;
}
/**
* e_mail_part_update_validity:
* @part: An #EMailPart
* @validity_type: E_MAIL_PART_VALIDITY_* flags
* @validity: a #CamelCipherValidity
*
* Updates validity of the @part. When the part already has some validity
* set, the new @validity and @validity_type are just appended, preserving
* the original validity. Validities of the same type (PGP or S/MIME) are
* merged together.
*/
void
e_mail_part_update_validity (EMailPart *part,
CamelCipherValidity *validity,
EMailPartValidityFlags validity_type)
{
EMailPartValidityPair *pair;
EMailPartValidityFlags mask;
g_return_if_fail (E_IS_MAIL_PART (part));
mask = E_MAIL_PART_VALIDITY_PGP | E_MAIL_PART_VALIDITY_SMIME;
pair = mail_part_find_validity_pair (part, validity_type & mask);
if (pair != NULL) {
pair->validity_type |= validity_type;
camel_cipher_validity_envelope (pair->validity, validity);
} else {
pair = g_new0 (EMailPartValidityPair, 1);
pair->validity_type = validity_type;
pair->validity = camel_cipher_validity_clone (validity);
g_queue_push_tail (&part->validities, pair);
}
}
/**
* e_mail_part_get_validity:
* @part: An #EMailPart
* @validity_type: E_MAIL_PART_VALIDITY_* flags
*
* Returns, validity of @part contains any validity with the same bits
* as @validity_type set. It should contain all bits of it.
*
* Returns: a #CamelCipherValidity of the given type, %NULL if not found
*
* Since: 3.8
*/
CamelCipherValidity *
e_mail_part_get_validity (EMailPart *part,
EMailPartValidityFlags validity_type)
{
EMailPartValidityPair *pair;
g_return_val_if_fail (E_IS_MAIL_PART (part), NULL);
pair = mail_part_find_validity_pair (part, validity_type);
return (pair != NULL) ? pair->validity : NULL;
}
gboolean
e_mail_part_has_validity (EMailPart *part)
{
g_return_val_if_fail (E_IS_MAIL_PART (part), FALSE);
return !g_queue_is_empty (&part->validities);
}
EMailPartValidityFlags
e_mail_part_get_validity_flags (EMailPart *part)
{
EMailPartValidityFlags flags = 0;
GList *head, *link;
g_return_val_if_fail (E_IS_MAIL_PART (part), 0);
head = g_queue_peek_head_link (&part->validities);
for (link = head; link != NULL; link = g_list_next (link)) {
EMailPartValidityPair *pair = link->data;
if (pair != NULL)
flags |= pair->validity_type;
}
return flags;
}