loudmouth/lm-message.c
author Mikael Hallendal <micke@imendio.com>
Sun, 29 Apr 2007 22:09:44 +0200
changeset 265 ebfc8419758d
parent 99 81e9d035de02
child 215 9d68d8a77e7b
permissions -rw-r--r--
Bumped the version to 1.2.2
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
     1
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
     2
/*
99
81e9d035de02 2004-10-05 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 84
diff changeset
     3
 * Copyright (C) 2003 Imendio AB
1
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
     4
 *
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
     5
 * This program is free software; you can redistribute it and/or
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
     6
 * modify it under the terms of the GNU Lesser General Public License as
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
     7
 * published by the Free Software Foundation; either version 2 of the
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
     8
 * License, or (at your option) any later version.
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
     9
 *
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    10
 * This program is distributed in the hope that it will be useful,
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    11
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    12
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    13
 * Lesser General Public License for more details.
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    14
 *
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    15
 * You should have received a copy of the GNU Lesser General Public
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    16
 * License along with this program; if not, write to the
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    17
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    18
 * Boston, MA 02111-1307, USA.
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    19
 */
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    20
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    21
#include <config.h>
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    22
#include <string.h>
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    23
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    24
#include "lm-internals.h"
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    25
#include "lm-message.h"
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    26
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    27
#define PRIV(o) ((LmMessage *)o)->priv
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    28
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    29
static struct TypeNames 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    30
{
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    31
        LmMessageType  type;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    32
        const gchar   *name;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    33
} type_names[] = {
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    34
	{ LM_MESSAGE_TYPE_MESSAGE,       "message"       },
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    35
	{ LM_MESSAGE_TYPE_PRESENCE,      "presence"      },
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    36
	{ LM_MESSAGE_TYPE_IQ,            "iq"            },
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    37
	{ LM_MESSAGE_TYPE_STREAM,        "stream:stream" },
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    38
	{ LM_MESSAGE_TYPE_STREAM_ERROR,  "stream:error"  }
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    39
};
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    40
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    41
static struct SubTypeNames 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    42
{
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    43
        LmMessageSubType  type;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    44
        const gchar      *name;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    45
} sub_type_names[] = {
23
b8a56b77da30 2003-07-29 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 8
diff changeset
    46
	{ LM_MESSAGE_SUB_TYPE_NORMAL,          "normal"        },
1
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    47
        { LM_MESSAGE_SUB_TYPE_CHAT,            "chat"          },
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    48
	{ LM_MESSAGE_SUB_TYPE_GROUPCHAT,       "groupchat"     },
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    49
	{ LM_MESSAGE_SUB_TYPE_HEADLINE,        "headline"      },
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    50
	{ LM_MESSAGE_SUB_TYPE_UNAVAILABLE,     "unavailable"   },
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    51
        { LM_MESSAGE_SUB_TYPE_PROBE,           "probe"         },
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    52
	{ LM_MESSAGE_SUB_TYPE_SUBSCRIBE,       "subscribe"     },
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    53
	{ LM_MESSAGE_SUB_TYPE_UNSUBSCRIBE,     "unsubscribe"   },
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    54
	{ LM_MESSAGE_SUB_TYPE_SUBSCRIBED,      "subscribed"    },
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    55
	{ LM_MESSAGE_SUB_TYPE_UNSUBSCRIBED,    "unsubscribed"  },
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    56
	{ LM_MESSAGE_SUB_TYPE_GET,             "get"           },
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    57
	{ LM_MESSAGE_SUB_TYPE_SET,             "set"           },
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    58
	{ LM_MESSAGE_SUB_TYPE_RESULT,          "result"        }, 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    59
	{ LM_MESSAGE_SUB_TYPE_ERROR,           "error"         }
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    60
};
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    61
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    62
struct LmMessagePriv {
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    63
	LmMessageType    type;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    64
	LmMessageSubType sub_type;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    65
	gint             ref_count;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    66
};
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    67
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    68
static LmMessageType
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    69
message_type_from_string (const gchar *type_str)
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    70
{
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    71
        gint i;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    72
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    73
        if (!type_str) {
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    74
                return LM_MESSAGE_TYPE_UNKNOWN;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    75
        }
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    76
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    77
        for (i = LM_MESSAGE_TYPE_MESSAGE;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    78
	     i <= LM_MESSAGE_TYPE_STREAM_ERROR;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    79
	     ++i) {
7
d8eae83450ac 2003-06-13 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 4
diff changeset
    80
                if (strcmp (type_str, type_names[i].name) == 0) {
1
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    81
                        return i;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    82
                }
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    83
        }
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    84
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    85
        return LM_MESSAGE_TYPE_UNKNOWN;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    86
}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    87
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    88
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    89
const gchar *
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    90
_lm_message_type_to_string (LmMessageType type)
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    91
{
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    92
        if (type < LM_MESSAGE_TYPE_MESSAGE ||
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    93
            type > LM_MESSAGE_TYPE_STREAM_ERROR) {
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    94
                type = LM_MESSAGE_TYPE_UNKNOWN;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    95
        }
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    96
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    97
        return type_names[type].name;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    98
}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    99
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   100
static LmMessageSubType
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   101
message_sub_type_from_string (const gchar *type_str)
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   102
{
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   103
        gint i;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   104
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   105
        if (!type_str) {
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   106
                return LM_MESSAGE_SUB_TYPE_NOT_SET;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   107
        }
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   108
23
b8a56b77da30 2003-07-29 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 8
diff changeset
   109
        for (i = LM_MESSAGE_SUB_TYPE_NORMAL;
1
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   110
	     i <= LM_MESSAGE_SUB_TYPE_ERROR;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   111
	     ++i) {
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   112
                if (g_ascii_strcasecmp (type_str, 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   113
					sub_type_names[i].name) == 0) {
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   114
                        return i;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   115
                }
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   116
        }
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   117
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   118
        return LM_MESSAGE_SUB_TYPE_NOT_SET;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   119
}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   120
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   121
const gchar *
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   122
_lm_message_sub_type_to_string (LmMessageSubType type)
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   123
{
23
b8a56b77da30 2003-07-29 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 8
diff changeset
   124
        if (type < LM_MESSAGE_SUB_TYPE_NORMAL ||
1
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   125
            type > LM_MESSAGE_SUB_TYPE_ERROR) {
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   126
		return NULL;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   127
        }
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   128
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   129
        return sub_type_names[type].name;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   130
}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   131
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   132
static LmMessageSubType
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   133
message_sub_type_when_unset (LmMessageType type) {
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   134
	LmMessageSubType sub_type = LM_MESSAGE_SUB_TYPE_NORMAL;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   135
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   136
	switch (type) {
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   137
	case LM_MESSAGE_TYPE_MESSAGE:
23
b8a56b77da30 2003-07-29 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 8
diff changeset
   138
		/* A message without type should be handled like a message with
b8a56b77da30 2003-07-29 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 8
diff changeset
   139
		 * type=normal, but we won't set it to that since then the user
b8a56b77da30 2003-07-29 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 8
diff changeset
   140
		 * will not know if it's set or not.
b8a56b77da30 2003-07-29 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 8
diff changeset
   141
		 */
b8a56b77da30 2003-07-29 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 8
diff changeset
   142
		sub_type = LM_MESSAGE_SUB_TYPE_NOT_SET;
1
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   143
		break;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   144
	case LM_MESSAGE_TYPE_PRESENCE:
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   145
		sub_type = LM_MESSAGE_SUB_TYPE_AVAILABLE;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   146
		break;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   147
	case LM_MESSAGE_TYPE_IQ:
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   148
		sub_type = LM_MESSAGE_SUB_TYPE_GET;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   149
		break;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   150
	default:
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   151
		break;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   152
	}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   153
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   154
	return sub_type;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   155
}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   156
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   157
LmMessage *
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   158
_lm_message_new_from_node (LmMessageNode *node)
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   159
{
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   160
	LmMessage        *m;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   161
	LmMessageType     type;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   162
	LmMessageSubType  sub_type;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   163
	const gchar      *sub_type_str;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   164
	
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   165
	type = message_type_from_string (node->name);
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   166
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   167
	if (type == LM_MESSAGE_TYPE_UNKNOWN) {
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   168
		return NULL;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   169
	}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   170
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   171
	sub_type_str = lm_message_node_get_attribute (node, "type");
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   172
	if (sub_type_str) {
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   173
		sub_type = message_sub_type_from_string (sub_type_str);
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   174
	} else {
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   175
		sub_type = message_sub_type_when_unset (type);
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   176
	}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   177
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   178
	m = g_new0 (LmMessage, 1);
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   179
	m->priv = g_new0 (LmMessagePriv, 1);
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   180
	
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   181
	PRIV(m)->ref_count = 1;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   182
	PRIV(m)->type = type;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   183
	PRIV(m)->sub_type = sub_type;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   184
	
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   185
	m->node = lm_message_node_ref (node);
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   186
	
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   187
	return m;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   188
}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   189
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   190
/**
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   191
 * lm_message_new:
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   192
 * @to: receipient jid
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   193
 * @type: message type
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   194
 * 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   195
 * Creates a new #LmMessage which can be sent with lm_connection_send() or 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   196
 * lm_connection_send_with_reply(). If @to is %NULL the message is sent to the
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   197
 * server. The returned message should be unreferenced with lm_message_unref() 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   198
 * when caller is finished with it.
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   199
 * 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   200
 * Return value: a newly created #LmMessage
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   201
 **/
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   202
LmMessage *
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   203
lm_message_new (const gchar *to, LmMessageType type)
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   204
{
79
63971f168ce6 2004-01-29 Richard Hult <richard@imendio.com>
rhult <rhult>
parents: 57
diff changeset
   205
	LmMessage *m;
63971f168ce6 2004-01-29 Richard Hult <richard@imendio.com>
rhult <rhult>
parents: 57
diff changeset
   206
	gchar     *id;
63971f168ce6 2004-01-29 Richard Hult <richard@imendio.com>
rhult <rhult>
parents: 57
diff changeset
   207
63971f168ce6 2004-01-29 Richard Hult <richard@imendio.com>
rhult <rhult>
parents: 57
diff changeset
   208
	m       = g_new0 (LmMessage, 1);
1
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   209
	m->priv = g_new0 (LmMessagePriv, 1);
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   210
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   211
	PRIV(m)->ref_count = 1;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   212
	PRIV(m)->type      = type;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   213
	PRIV(m)->sub_type  = message_sub_type_when_unset (type);
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   214
	
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   215
	m->node = _lm_message_node_new (_lm_message_type_to_string (type));
49
66fd32fc225e 2003-10-13 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 24
diff changeset
   216
79
63971f168ce6 2004-01-29 Richard Hult <richard@imendio.com>
rhult <rhult>
parents: 57
diff changeset
   217
	id = _lm_utils_generate_id ();
63971f168ce6 2004-01-29 Richard Hult <richard@imendio.com>
rhult <rhult>
parents: 57
diff changeset
   218
	lm_message_node_set_attribute (m->node, "id", id);
63971f168ce6 2004-01-29 Richard Hult <richard@imendio.com>
rhult <rhult>
parents: 57
diff changeset
   219
	g_free (id);
1
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   220
	
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   221
	if (to) {
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   222
		lm_message_node_set_attribute (m->node, "to", to);
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   223
	}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   224
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   225
	if (type == LM_MESSAGE_TYPE_IQ) {
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   226
		lm_message_node_set_attribute (m->node, "type", "get");
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   227
	}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   228
	
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   229
	return m;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   230
}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   231
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   232
/**
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   233
 * lm_message_new_with_sub_type:
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   234
 * @to: receipient jid
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   235
 * @type: message type
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   236
 * @sub_type: message sub type
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   237
 * 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   238
 * Creates a new #LmMessage with sub type set. See lm_message_new() for more 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   239
 * information.
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   240
 * 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   241
 * Return value: a newly created #LmMessage
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   242
 **/
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   243
LmMessage *
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   244
lm_message_new_with_sub_type (const gchar      *to,
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   245
			      LmMessageType     type, 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   246
			      LmMessageSubType  sub_type)
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   247
{
79
63971f168ce6 2004-01-29 Richard Hult <richard@imendio.com>
rhult <rhult>
parents: 57
diff changeset
   248
	LmMessage   *m;
1
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   249
	const gchar *type_str;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   250
79
63971f168ce6 2004-01-29 Richard Hult <richard@imendio.com>
rhult <rhult>
parents: 57
diff changeset
   251
	m = lm_message_new (to, type);
63971f168ce6 2004-01-29 Richard Hult <richard@imendio.com>
rhult <rhult>
parents: 57
diff changeset
   252
1
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   253
	type_str = _lm_message_sub_type_to_string (sub_type);
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   254
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   255
	if (type_str) {
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   256
		lm_message_node_set_attributes (m->node,
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   257
						"type", type_str, NULL);
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   258
		PRIV(m)->sub_type = sub_type;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   259
	}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   260
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   261
	return m;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   262
}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   263
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   264
/**
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   265
 * lm_message_get_type:
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   266
 * @message: an #LmMessage
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   267
 * 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   268
 * Fetches the type of @message.
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   269
 * 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   270
 * Return value: the message type
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   271
 **/
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   272
LmMessageType
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   273
lm_message_get_type (LmMessage *message)
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   274
{
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   275
	g_return_val_if_fail (message != NULL, LM_MESSAGE_TYPE_UNKNOWN);
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   276
	
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   277
	return PRIV(message)->type;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   278
}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   279
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   280
/**
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   281
 * lm_message_get_sub_type:
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   282
 * @message: 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   283
 * 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   284
 * Fetches the sub type of @message.
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   285
 * 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   286
 * Return value: the message sub type
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   287
 **/
8
33d64cf345be 2003-06-15 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 7
diff changeset
   288
LmMessageSubType
1
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   289
lm_message_get_sub_type (LmMessage *message)
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   290
{
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   291
	g_return_val_if_fail (message != NULL, LM_MESSAGE_TYPE_UNKNOWN);
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   292
	
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   293
	return PRIV(message)->sub_type;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   294
}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   295
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   296
/**
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   297
 * lm_message_get_node:
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   298
 * @message: an #LmMessage
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   299
 * 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   300
 * Retrieves the root node from @message.
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   301
 * 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   302
 * Return value: an #LmMessageNode
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   303
 **/
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   304
LmMessageNode *
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   305
lm_message_get_node (LmMessage *message)
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   306
{
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   307
	g_return_val_if_fail (message != NULL, NULL);
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   308
	
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   309
	return message->node;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   310
}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   311
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   312
/**
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   313
 * lm_message_ref:
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   314
 * @message: an #LmMessage
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   315
 * 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   316
 * Adds a reference to @message.
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   317
 * 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   318
 * Return value: the message
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   319
 **/
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   320
LmMessage *
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   321
lm_message_ref (LmMessage *message)
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   322
{
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   323
	g_return_val_if_fail (message != NULL, NULL);
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   324
	
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   325
	PRIV(message)->ref_count++;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   326
	
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   327
	return message;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   328
}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   329
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   330
/**
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   331
 * lm_message_unref:
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   332
 * @message: an #LmMessage
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   333
 * 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   334
 * Removes a reference from @message. When no more references are present the 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   335
 * message is freed.
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   336
 **/
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   337
void
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   338
lm_message_unref (LmMessage *message)
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   339
{
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   340
	g_return_if_fail (message != NULL);
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   341
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   342
	PRIV(message)->ref_count--;
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   343
	
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   344
	if (PRIV(message)->ref_count == 0) {
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   345
		lm_message_node_unref (message->node);
79
63971f168ce6 2004-01-29 Richard Hult <richard@imendio.com>
rhult <rhult>
parents: 57
diff changeset
   346
		g_free (message->priv);
1
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   347
		g_free (message);
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   348
	}
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
   349
}