luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-12-25 15:06:14 +01:00
Code Issues Packages Projects Releases Wiki Activity

Add GMenuProxy

Browse Source 
GMenuProxy can be used as a client-side wrapper
for the a menu model that has been exported on D-Bus.
This commit is contained in:
Ryan Lortie 2011-10-21 22:49:54 -04:00
parent 66e089f086
commit d110fd9202
8 changed files with 923 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
docs/reference/gio/gio-docs.xml
View File

@ -204,6 +204,7 @@
<xi:include href="xml/gmenu.xml"/>
<xi:include href="xml/gmenumarkup.xml"/>
<xi:include href="xml/gmenuexporter.xml"/>
<xi:include href="xml/gmenuproxy.xml"/>
</chapter>
<chapter id="extending">
<title>Extending GIO</title>

14
docs/reference/gio/gio-sections.txt
View File

@ -3548,6 +3548,20 @@ g_menu_exporter_stop
g_menu_exporter_query
</SECTION>
<SECTION>
<FILE>gmenuproxy</FILE>
GMenuProxy
g_menu_proxy_get
<SUBSECTION Standard>
G_TYPE_MENU_PROXY
G_MENU_PROXY
G_IS_MENU_PROXY
<SUBSECTION Private>
g_menu_proxy_get_type
</SECTION>
<SECTION>
<FILE>gmenu</FILE>
GMenu

1
docs/reference/gio/gio.types
View File

@ -50,6 +50,7 @@ g_menu_attribute_iter_get_type
g_menu_get_type
g_menu_link_iter_get_type
g_menu_model_get_type
g_menu_proxy_get_type
g_mount_get_type
g_mount_operation_get_type
g_native_volume_monitor_get_type

2
gio/Makefile.am
View File

@ -134,6 +134,7 @@ application_headers = \
gapplicationcommandline.h \
gapplication.h \
gmenumodel.h \
gmenuproxy.h \
gmenu.h \
gmenumarkup.h \
gmenuexporter.h \
@ -151,6 +152,7 @@ application_sources = \
gapplicationimpl-dbus.c \
gapplication.c \
gmenumodel.c \
gmenuproxy.c \
gmenu.c \
gmenumarkup.c \
gmenuexporter.c \

1
gio/gio.h
View File

@ -150,6 +150,7 @@
#include <gio/gmenu.h>
#include <gio/gmenuexporter.h>
#include <gio/gmenumarkup.h>
#include <gio/gmenuproxy.h>
#undef __GIO_GIO_H_INSIDE__

2
gio/gio.symbols
View File

@ -1663,3 +1663,5 @@ g_menu_prepend_item
g_menu_prepend_section
g_menu_prepend_submenu
g_menu_remove
g_menu_proxy_get_type
g_menu_proxy_get

858
gio/gmenuproxy.c Normal file
View File

@ -0,0 +1,858 @@
/*
* Copyright © 2011 Canonical Ltd.
*
* This library 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
* licence, or (at your option) any later version.
*
* This library 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 library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
* USA.
*
* Author: Ryan Lortie <desrt@desrt.ca>
*/
#include "gmenuproxy.h"
#include "gmenumodel.h"
/* Prelude {{{1 */
/**
* SECTION:gmenuproxy
* @title: GMenuProxy
* @short_description: A D-Bus GMenuModel implementation
* @see_also: <link linkend="gio-GMenuModel-exporter">GMenuModel Exporter</link>
*
* #GMenuProxy is an implementation of #GMenuModel that can be used
* as a proxy for a menu model that is exported over D-Bus with
* g_menu_exporter_export().
*/
/*
* There are 3 main (quasi-)classes involved here:
*
* - GMenuProxyPath
* - GMenuProxyGroup
* - GMenuProxy
*
* Each of these classes exists as a parameterised singleton keyed to a
* particular thing:
*
* - GMenuProxyPath represents a D-Bus object path on a particular
* unique bus name on a particular GDBusConnection.
*
* - GMenuProxyGroup represents a particular group on a particular
* GMenuProxyPath.
*
* - GMenuProxy represents a particular menu within a particular
* GMenuProxyGroup.
*
* There are also two (and a half) utility structs:
*
* - PathIdentifier and ConstPathIdentifier
* - GMenuProxyItem
*
* PathIdentifier is the triplet of (GDBusConnection, unique name,
* object path) that uniquely identifies a particular GMenuProxyPath.
* It holds ownership on each of these things, so we have a
* ConstPathIdentifier variant that does not.
*
* We have a 3-level hierarchy of hashtables:
*
* - a global hashtable (g_menu_proxy_paths) maps from PathIdentifier
* to GMenuProxyPath
*
* - each GMenuProxyPath has a hashtable mapping from guint (group
* number) to GMenuProxyGroup
*
* - each GMenuProxyGroup has a hashtable mapping from guint (menu
* number) to GMenuProxy.
*
* In this way, each quintuplet of (connection, bus name, object path,
* group id, menu id) maps to a single GMenuProxy instance that can be
* located via 3 hashtable lookups.
*
* All of the 3 classes are refcounted (GMenuProxyPath and
* GMenuProxyGroup manually, and GMenuProxy by virtue of being a
* GObject). The hashtables do not hold references -- rather, when the
* last reference is dropped, the object is removed from the hashtable.
*
* The hard references go in the other direction: GMenuProxy is created
* as the user requests it and only exists as long as the user holds a
* reference on it. GMenuProxy holds a reference on the GMenuProxyGroup
* from which it came. GMenuProxyGroup holds a reference on
* GMenuProxyPath.
*
* In addition to refcounts, each object has an 'active' variable (ints
* for GMenuProxyPath and GMenuProxyGroup, boolean for GMenuProxy).
*
* - GMenuProxy is inactive when created and becomes active only when
* first queried for information. This prevents extra work from
* happening just by someone acquiring a GMenuProxy (and not
* actually trying to display it yet).
*
* - The active count on GMenuProxyGroup is equal to the number of
* GMenuProxy instances in that group that are active. When the
* active count transitions from 0 to 1, the group calls the 'Start'
* method on the service to begin monitoring that group. When it
* drops from 1 to 0, the group calls the 'End' method to stop
* monitoring.
*
* - The active count on GMenuProxyPath is equal to the number of
* GMenuProxyGroup instances on that path with a non-zero active
* count. When the active count transitions from 0 to 1, the path
* sets up a signal subscription to monitor any changes. The signal
* subscription is taken down when the active count transitions from
* 1 to 0.
*
* When active, GMenuProxyPath gets incoming signals when changes occur.
* If the change signal mentions a group for which we currently have an
* active GMenuProxyGroup, the change signal is passed along to that
* group. If the group is inactive, the change signal is ignored.
*
* Most of the "work" occurs in GMenuProxyGroup. In addition to the
* hashtable of GMenuProxy instances, it keeps a hashtable of the actual
* menu contents, each encoded as GSequence of GMenuProxyItem. It
* initially populates this table with the results of the "Start" method
* call and then updates it according to incoming change signals. If
* the change signal mentions a menu for which we current have an active
* GMenuProxy, the change signal is passed along to that proxy. If the
* proxy is inactive, the change signal is ignored.
*
* GMenuProxyItem is just a pair of hashtables, one for the attributes
* and one for the links of the item (mapping strings to
* other GMenuProxy instances). XXX reconsider this since it means the
* submenu proxies stay around forever.....
*
* Following the "empty is the same as non-existent" rule, the hashtable
* of GSequence of GMenuProxyItem holds NULL for empty menus.
*
* GMenuProxy contains very little functionality of its own. It holds a
* (weak) reference to the GSequence of GMenuProxyItem contained in the
* GMenuProxyGroup. It uses this GSequence to implement the GMenuModel
* interface. It also emits the "items-changed" signal if it is active
* and it was told that the contents of the GSequence changed.
*/
typedef struct _GMenuProxyGroup GMenuProxyGroup;
typedef struct _GMenuProxyPath GMenuProxyPath;
static void g_menu_proxy_group_changed (GMenuProxyGroup *group,
guint menu_id,
gint position,
gint removed,
GVariant *added);
static void g_menu_proxy_changed (GMenuProxy *proxy,
GSequence *items,
gint position,
gint removed,
gint added);
static GMenuProxyGroup * g_menu_proxy_group_get_from_path (GMenuProxyPath *path,
guint group_id);
static GMenuProxy * g_menu_proxy_get_from_group (GMenuProxyGroup *group,
guint menu_id);
/* PathIdentifier {{{1 */
typedef struct
{
GDBusConnection *connection;
gchar *bus_name;
gchar *object_path;
} PathIdentifier;
typedef const struct
{
GDBusConnection *connection;
const gchar *bus_name;
const gchar *object_path;
} ConstPathIdentifier;
static guint
path_identifier_hash (gconstpointer data)
{
ConstPathIdentifier *id = data;
return g_str_hash (id->object_path);
}
static gboolean
path_identifier_equal (gconstpointer a,
gconstpointer b)
{
ConstPathIdentifier *id_a = a;
ConstPathIdentifier *id_b = b;
return id_a->connection == id_b->connection &&
g_str_equal (id_a->bus_name, id_b->bus_name) &&
g_str_equal (id_a->object_path, id_b->object_path);
}
static void
path_identifier_free (PathIdentifier *id)
{
g_object_unref (id->connection);
g_free (id->bus_name);
g_free (id->object_path);
g_slice_free (PathIdentifier, id);
}
static PathIdentifier *
path_identifier_new (ConstPathIdentifier *cid)
{
PathIdentifier *id;
id = g_slice_new (PathIdentifier);
id->connection = g_object_ref (cid->connection);
id->bus_name = g_strdup (cid->bus_name);
id->object_path = g_strdup (cid->object_path);
return id;
}
/* GMenuProxyPath {{{1 */
struct _GMenuProxyPath
{
PathIdentifier *id;
gint ref_count;
GHashTable *groups;
gint active;
guint watch_id;
};
static GHashTable *g_menu_proxy_paths;
static GMenuProxyPath *
g_menu_proxy_path_ref (GMenuProxyPath *path)
{
path->ref_count++;
return path;
}
static void
g_menu_proxy_path_unref (GMenuProxyPath *path)
{
if (--path->ref_count == 0)
{
g_hash_table_remove (g_menu_proxy_paths, path->id);
g_hash_table_unref (path->groups);
path_identifier_free (path->id);
g_slice_free (GMenuProxyPath, path);
}
}
static void
g_menu_proxy_path_signal (GDBusConnection *connection,
const gchar *sender_name,
const gchar *object_path,
const gchar *interface_name,
const gchar *signal_name,
GVariant *parameters,
gpointer user_data)
{
GMenuProxyPath *path = user_data;
GVariantIter *iter;
guint group_id;
guint menu_id;
guint position;
guint removes;
GVariant *adds;
if (!g_variant_is_of_type (parameters, G_VARIANT_TYPE ("(a(uuuuaa{sv}))")))
return;
g_variant_get (parameters, "(a(uuuuaa{sv}))", &iter);
while (g_variant_iter_loop (iter, "(uuuu@aa{sv})", &group_id, &menu_id, &position, &removes, &adds))
{
GMenuProxyGroup *group;
group = g_hash_table_lookup (path->groups, GINT_TO_POINTER (group_id));
if (group != NULL)
g_menu_proxy_group_changed (group, menu_id, position, removes, adds);
}
g_variant_iter_free (iter);
}
static void
g_menu_proxy_path_activate (GMenuProxyPath *path)
{
if (path->active++ == 0)
path->watch_id = g_dbus_connection_signal_subscribe (path->id->connection, path->id->bus_name,
"org.gtk.Menus", "Changed", path->id->object_path,
NULL, G_DBUS_SIGNAL_FLAGS_NONE,
g_menu_proxy_path_signal, path, NULL);
}
static void
g_menu_proxy_path_deactivate (GMenuProxyPath *path)
{
if (--path->active == 0)
g_dbus_connection_signal_unsubscribe (path->id->connection, path->watch_id);
}
static GMenuProxyPath *
g_menu_proxy_path_get (GDBusConnection *connection,
const gchar *bus_name,
const gchar *object_path)
{
ConstPathIdentifier cid = { connection, bus_name, object_path };
GMenuProxyPath *path;
if (g_menu_proxy_paths == NULL)
g_menu_proxy_paths = g_hash_table_new (path_identifier_hash, path_identifier_equal);
path = g_hash_table_lookup (g_menu_proxy_paths, &cid);
if (path == NULL)
{
path = g_slice_new (GMenuProxyPath);
path->id = path_identifier_new (&cid);
path->groups = g_hash_table_new (NULL, NULL);
path->ref_count = 0;
path->active = 0;
g_hash_table_insert (g_menu_proxy_paths, path->id, path);
}
return g_menu_proxy_path_ref (path);
}
/* GMenuProxyGroup, GMenuProxyItem {{{1 */
typedef enum
{
GROUP_OFFLINE,
GROUP_PENDING,
GROUP_ONLINE
} GroupStatus;
struct _GMenuProxyGroup
{
GMenuProxyPath *path;
guint id;
GHashTable *proxies; /* uint -> unowned GMenuProxy */
GHashTable *menus; /* uint -> owned GSequence */
gint ref_count;
GroupStatus state;
gint active;
};
typedef struct
{
GHashTable *attributes;
GHashTable *links;
} GMenuProxyItem;
static GMenuProxyGroup *
g_menu_proxy_group_ref (GMenuProxyGroup *group)
{
group->ref_count++;
return group;
}
static void
g_menu_proxy_group_unref (GMenuProxyGroup *group)
{
if (--group->ref_count == 0)
{
g_assert (group->state == GROUP_OFFLINE);
g_assert (group->active == 0);
g_hash_table_remove (group->path->groups, GINT_TO_POINTER (group->id));
g_hash_table_unref (group->proxies);
g_menu_proxy_path_unref (group->path);
g_slice_free (GMenuProxyGroup, group);
}
}
static void
g_menu_proxy_item_free (gpointer data)
{
GMenuProxyItem *item = data;
g_hash_table_unref (item->attributes);
g_hash_table_unref (item->links);
g_slice_free (GMenuProxyItem, item);
}
static GMenuProxyItem *
g_menu_proxy_group_create_item (GMenuProxyGroup *context,
GVariant *description)
{
GMenuProxyItem *item;
GVariantIter iter;
const gchar *key;
GVariant *value;
item = g_slice_new (GMenuProxyItem);
item->attributes = g_hash_table_new_full (g_str_hash, g_str_equal, g_free, (GDestroyNotify) g_variant_unref);
item->links = g_hash_table_new_full (g_str_hash, g_str_equal, g_free, (GDestroyNotify) g_object_unref);
g_variant_iter_init (&iter, description);
while (g_variant_iter_loop (&iter, "{&sv}", &key, &value))
if (key[0] == ':')
{
if (g_variant_is_of_type (value, G_VARIANT_TYPE ("(uu)")))
{
guint group_id, menu_id;
GMenuProxyGroup *group;
GMenuProxy *proxy;
g_variant_get (value, "(uu)", &group_id, &menu_id);
/* save the hash lookup in a relatively common case */
if (context->id != group_id)
group = g_menu_proxy_group_get_from_path (context->path, group_id);
else
group = g_menu_proxy_group_ref (context);
proxy = g_menu_proxy_get_from_group (group, menu_id);
/* key + 1 to skip the ':' */
g_hash_table_insert (item->links, g_strdup (key + 1), proxy);
g_menu_proxy_group_unref (group);
}
}
else
g_hash_table_insert (item->attributes, g_strdup (key), g_variant_ref (value));
return item;
}
/*
* GMenuProxyGroup can be in three states:
*
* OFFLINE: not subscribed to this group
* PENDING: we made the call to subscribe to this group, but the result
* has not come back yet
* ONLINE: we are fully subscribed
*
* We can get into some nasty situations where we make a call due to an
* activation request but receive a deactivation request before the call
* returns. If another activation request occurs then we could risk
* sending a Start request even though one is already in progress. For
* this reason, we have to carefully consider what to do in each of the
* three states for each of the following situations:
*
* - activation requested
* - deactivation requested
* - Start call finishes
*
* To simplify things a bit, we do not have a callback for the Stop
* call. We just send it and assume that it takes effect immediately.
*
* Activation requested:
* OFFLINE: make the Start call and transition to PENDING
* PENDING: do nothing -- call is already in progress.
* ONLINE: this should not be possible
*
* Deactivation requested:
* OFFLINE: this should not be possible
* PENDING: do nothing -- handle it when the Start call finishes
* ONLINE: send the Stop call and move to OFFLINE immediately
*
* Start call finishes:
* OFFLINE: this should not be possible
* PENDING:
* If we should be active (ie: active count > 0): move to ONLINE
* If not: send Stop call and move to OFFLINE immediately
* ONLINE: this should not be possible
*
* We have to take care with regards to signal subscriptions (ie:
* activation of the GMenuProxyPath). The signal subscription is always
* established when transitioning from OFFLINE to PENDING and taken down
* when transitioning from to OFFLINE (from either PENDING or ONLINE).
*
* Since there are two places where we transition to OFFLINE, we split
* that code out into a separate function.
*/
static void
g_menu_proxy_group_go_offline (GMenuProxyGroup *group)
{
g_menu_proxy_path_deactivate (group->path);
g_dbus_connection_call (group->path->id->connection,
group->path->id->bus_name,
group->path->id->object_path,
"org.gtk.Menus", "End",
g_variant_new_parsed ("([ %u ],)", group->id),
NULL, G_DBUS_CALL_FLAGS_NONE, -1,
NULL, NULL, NULL);
group->state = GROUP_OFFLINE;
}
static void
g_menu_proxy_group_start_ready (GObject *source_object,
GAsyncResult *result,
gpointer user_data)
{
GDBusConnection *connection = G_DBUS_CONNECTION (source_object);
GMenuProxyGroup *group = user_data;
GVariant *reply;
g_assert (group->state == GROUP_PENDING);
reply = g_dbus_connection_call_finish (connection, result, NULL);
if (group->active)
{
group->state = GROUP_ONLINE;
/* If we receive no reply, just act like we got an empty reply. */
if (reply)
{
GVariantIter *iter;
GVariant *items;
guint group_id;
guint menu_id;
g_variant_get (reply, "(a(uuaa{sv}))", &iter);
while (g_variant_iter_loop (iter, "(uu@aa{sv})", &group_id, &menu_id, &items))
if (group_id == group->id)
g_menu_proxy_group_changed (group, menu_id, 0, 0, items);
g_variant_iter_free (iter);
}
}
else
g_menu_proxy_group_go_offline (group);
if (reply)
g_variant_unref (reply);
g_menu_proxy_group_unref (group);
}
static void
g_menu_proxy_group_activate (GMenuProxyGroup *group)
{
if (group->active++ == 0)
{
g_assert (group->state != GROUP_ONLINE);
if (group->state == GROUP_OFFLINE)
{
g_menu_proxy_path_activate (group->path);
g_dbus_connection_call (group->path->id->connection,
group->path->id->bus_name,
group->path->id->object_path,
"org.gtk.Menus", "Start",
g_variant_new_parsed ("([ %u ],)", group->id),
G_VARIANT_TYPE ("(a(uuaa{sv}))"),
G_DBUS_CALL_FLAGS_NONE, -1, NULL,
g_menu_proxy_group_start_ready,
g_menu_proxy_group_ref (group));
group->state = GROUP_PENDING;
}
}
}
static void
g_menu_proxy_group_deactivate (GMenuProxyGroup *group)
{
if (--group->active == 0)
{
g_assert (group->state != GROUP_OFFLINE);
if (group->state == GROUP_ONLINE)
{
/* We are here because nobody is watching, so just free
* everything and don't bother with the notifications.
*/
g_hash_table_remove_all (group->menus);
g_menu_proxy_group_go_offline (group);
}
}
}
static void
g_menu_proxy_group_changed (GMenuProxyGroup *group,
guint menu_id,
gint position,
gint removed,
GVariant *added)
{
GSequenceIter *point;
GVariantIter iter;
GMenuProxy *proxy;
GSequence *items;
GVariant *item;
gint n_added;
/* We could have signals coming to us when we're not active (due to
* some other process having subscribed to this group) or when we're
* pending. In both of those cases, we want to ignore the signal
* since we'll get our own information when we call "Start" for
* ourselves.
*/
if (group->state != GROUP_ONLINE)
return;
items = g_hash_table_lookup (group->menus, GINT_TO_POINTER (menu_id));
if (items == NULL)
{
items = g_sequence_new (g_menu_proxy_item_free);
g_hash_table_insert (group->menus, GINT_TO_POINTER (menu_id), items);
}
point = g_sequence_get_iter_at_pos (items, position + removed);
g_return_if_fail (point != NULL);
if (removed)
{
GSequenceIter *start;
start = g_sequence_get_iter_at_pos (items, position);
g_sequence_remove_range (start, point);
}
n_added = g_variant_iter_init (&iter, added);
while (g_variant_iter_loop (&iter, "@a{sv}", &item))
g_sequence_insert_before (point, g_menu_proxy_group_create_item (group, item));
if (g_sequence_get_length (items) == 0)
{
g_hash_table_remove (group->menus, GINT_TO_POINTER (menu_id));
items = NULL;
}
if ((proxy = g_hash_table_lookup (group->proxies, GINT_TO_POINTER (menu_id))))
g_menu_proxy_changed (proxy, items, position, removed, n_added);
}
static GMenuProxyGroup *
g_menu_proxy_group_get_from_path (GMenuProxyPath *path,
guint group_id)
{
GMenuProxyGroup *group;
group = g_hash_table_lookup (path->groups, GINT_TO_POINTER (group_id));
if (group == NULL)
{
group = g_slice_new (GMenuProxyGroup);
group->path = g_menu_proxy_path_ref (path);
group->id = group_id;
group->proxies = g_hash_table_new (NULL, NULL);
group->menus = g_hash_table_new_full (NULL, NULL, NULL, (GDestroyNotify) g_sequence_free);
group->state = GROUP_OFFLINE;
group->active = 0;
group->ref_count = 0;
g_hash_table_insert (path->groups, GINT_TO_POINTER (group->id), group);
}
return g_menu_proxy_group_ref (group);
}
static GMenuProxyGroup *
g_menu_proxy_group_get (GDBusConnection *connection,
const gchar *bus_name,
const gchar *object_path,
guint group_id)
{
GMenuProxyGroup *group;
GMenuProxyPath *path;
path = g_menu_proxy_path_get (connection, bus_name, object_path);
group = g_menu_proxy_group_get_from_path (path, group_id);
g_menu_proxy_path_unref (path);
return group;
}
/* GMenuProxy {{{1 */
typedef GMenuModelClass GMenuProxyClass;
struct _GMenuProxy
{
GMenuModel parent;
GMenuProxyGroup *group;
guint id;
GSequence *items; /* unowned */
gboolean active;
};
G_DEFINE_TYPE (GMenuProxy, g_menu_proxy, G_TYPE_MENU_MODEL)
static gboolean
g_menu_proxy_is_mutable (GMenuModel *model)
{
return TRUE;
}
static gint
g_menu_proxy_get_n_items (GMenuModel *model)
{
GMenuProxy *proxy = G_MENU_PROXY (model);
if (!proxy->active)
{
g_menu_proxy_group_activate (proxy->group);
proxy->active = TRUE;
}
return proxy->items ? g_sequence_get_length (proxy->items) : 0;
}
static void
g_menu_proxy_get_item_attributes (GMenuModel *model,
gint item_index,
GHashTable **table)
{
GMenuProxy *proxy = G_MENU_PROXY (model);
GMenuProxyItem *item;
GSequenceIter *iter;
g_return_if_fail (proxy->active);
g_return_if_fail (proxy->items);
iter = g_sequence_get_iter_at_pos (proxy->items, item_index);
g_return_if_fail (iter);
item = g_sequence_get (iter);
g_return_if_fail (item);
*table = g_hash_table_ref (item->attributes);
}
static void
g_menu_proxy_get_item_links (GMenuModel *model,
gint item_index,
GHashTable **table)
{
GMenuProxy *proxy = G_MENU_PROXY (model);
GMenuProxyItem *item;
GSequenceIter *iter;
g_return_if_fail (proxy->active);
g_return_if_fail (proxy->items);
iter = g_sequence_get_iter_at_pos (proxy->items, item_index);
g_return_if_fail (iter);
item = g_sequence_get (iter);
g_return_if_fail (item);
*table = g_hash_table_ref (item->links);
}
static void
g_menu_proxy_finalize (GObject *object)
{
GMenuProxy *proxy = G_MENU_PROXY (object);
if (proxy->active)
g_menu_proxy_group_deactivate (proxy->group);
g_hash_table_remove (proxy->group->proxies, GINT_TO_POINTER (proxy->id));
g_menu_proxy_group_unref (proxy->group);
G_OBJECT_CLASS (g_menu_proxy_parent_class)
->finalize (object);
}
static void
g_menu_proxy_init (GMenuProxy *proxy)
{
}
static void
g_menu_proxy_class_init (GMenuProxyClass *class)
{
GObjectClass *object_class = G_OBJECT_CLASS (class);
class->is_mutable = g_menu_proxy_is_mutable;
class->get_n_items = g_menu_proxy_get_n_items;
class->get_item_attributes = g_menu_proxy_get_item_attributes;
class->get_item_links = g_menu_proxy_get_item_links;
object_class->finalize = g_menu_proxy_finalize;
}
static void
g_menu_proxy_changed (GMenuProxy *proxy,
GSequence *items,
gint position,
gint removed,
gint added)
{
proxy->items = items;
if (proxy->active && (removed || added))
g_menu_model_items_changed (G_MENU_MODEL (proxy), position, removed, added);
}
static GMenuProxy *
g_menu_proxy_get_from_group (GMenuProxyGroup *group,
guint menu_id)
{
GMenuProxy *proxy;
proxy = g_hash_table_lookup (group->proxies, GINT_TO_POINTER (menu_id));
if (proxy)
g_object_ref (proxy);
if (proxy == NULL)
{
proxy = g_object_new (G_TYPE_MENU_PROXY, NULL);
proxy->items = g_hash_table_lookup (group->menus, GINT_TO_POINTER (menu_id));
g_hash_table_insert (group->proxies, GINT_TO_POINTER (menu_id), proxy);
proxy->group = g_menu_proxy_group_ref (group);
proxy->id = menu_id;
}
return proxy;
}
/**
* g_menu_proxy_get:
* @connection: a #GDBusConnection
* @bus_name: the bus name which exports the menu model
* @object_path: the object path at which the menu model is exported
*
* Obtains a #GMenuProxy for the menu model which is exported
* at the given @bus_name and @object_path.
*
* Returns: (transfer full): a #GMenuProxy object. Free with g_object_unref().
*/
GMenuProxy *
g_menu_proxy_get (GDBusConnection *connection,
const gchar *bus_name,
const gchar *object_path)
{
GMenuProxyGroup *group;
GMenuProxy *proxy;
group = g_menu_proxy_group_get (connection, bus_name, object_path, 0);
proxy = g_menu_proxy_get_from_group (group, 0);
g_menu_proxy_group_unref (group);
return proxy;
}
/* Epilogue {{{1 */
/* vim:set foldmethod=marker: */

44
gio/gmenuproxy.h Normal file
View File

@ -0,0 +1,44 @@
/*
* Copyright © 2011 Canonical Ltd.
*
* This library 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
* licence, or (at your option) any later version.
*
* This library 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 library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
* USA.
*
* Author: Ryan Lortie <desrt@desrt.ca>
*/
#ifndef __G_MENU_PROXY_H__
#define __G_MENU_PROXY_H__
#include <gio/gdbusconnection.h>
G_BEGIN_DECLS
#define G_TYPE_MENU_PROXY (g_menu_proxy_get_type ())
#define G_MENU_PROXY(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \
G_TYPE_MENU_PROXY, GMenuProxy))
#define G_IS_MENU_PROXY(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \
G_TYPE_MENU_PROXY))
typedef struct _GMenuProxy GMenuProxy;
GType g_menu_proxy_get_type (void) G_GNUC_CONST;
GMenuProxy * g_menu_proxy_get (GDBusConnection *connection,
const gchar *bus_name,
const gchar *object_path);
G_END_DECLS
#endif /* __G_MENU_PROXY_H__ */