|
Packit |
ae235b |
/* GDBus - GLib D-Bus Library
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* Copyright (C) 2008-2010 Red Hat, Inc.
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* This library is free software; you can redistribute it and/or
|
|
Packit |
ae235b |
* modify it under the terms of the GNU Lesser General Public
|
|
Packit |
ae235b |
* License as published by the Free Software Foundation; either
|
|
Packit |
ae235b |
* version 2.1 of the License, or (at your option) any later version.
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* This library is distributed in the hope that it will be useful,
|
|
Packit |
ae235b |
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
Packit |
ae235b |
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Packit |
ae235b |
* Lesser General Public License for more details.
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* You should have received a copy of the GNU Lesser General
|
|
Packit |
ae235b |
* Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* Author: David Zeuthen <davidz@redhat.com>
|
|
Packit |
ae235b |
*/
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
#include "config.h"
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
#include "gdbusobject.h"
|
|
Packit |
ae235b |
#include "gdbusinterface.h"
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
#include "glibintl.h"
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
/**
|
|
Packit |
ae235b |
* SECTION:gdbusinterface
|
|
Packit |
ae235b |
* @short_description: Base type for D-Bus interfaces
|
|
Packit |
ae235b |
* @include: gio/gio.h
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* The #GDBusInterface type is the base type for D-Bus interfaces both
|
|
Packit |
ae235b |
* on the service side (see #GDBusInterfaceSkeleton) and client side
|
|
Packit |
ae235b |
* (see #GDBusProxy).
|
|
Packit |
ae235b |
*/
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
typedef GDBusInterfaceIface GDBusInterfaceInterface;
|
|
Packit |
ae235b |
G_DEFINE_INTERFACE (GDBusInterface, g_dbus_interface, G_TYPE_OBJECT)
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
static void
|
|
Packit |
ae235b |
g_dbus_interface_default_init (GDBusInterfaceIface *iface)
|
|
Packit |
ae235b |
{
|
|
Packit |
ae235b |
}
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
/* ---------------------------------------------------------------------------------------------------- */
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
/**
|
|
Packit |
ae235b |
* g_dbus_interface_get_info:
|
|
Packit |
ae235b |
* @interface_: An exported D-Bus interface.
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* Gets D-Bus introspection information for the D-Bus interface
|
|
Packit |
ae235b |
* implemented by @interface_.
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* Returns: (transfer none): A #GDBusInterfaceInfo. Do not free.
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* Since: 2.30
|
|
Packit |
ae235b |
*/
|
|
Packit |
ae235b |
GDBusInterfaceInfo *
|
|
Packit |
ae235b |
g_dbus_interface_get_info (GDBusInterface *interface_)
|
|
Packit |
ae235b |
{
|
|
Packit |
ae235b |
g_return_val_if_fail (G_IS_DBUS_INTERFACE (interface_), NULL);
|
|
Packit |
ae235b |
return G_DBUS_INTERFACE_GET_IFACE (interface_)->get_info (interface_);
|
|
Packit |
ae235b |
}
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
/**
|
|
Packit |
ae235b |
* g_dbus_interface_get_object: (skip)
|
|
Packit |
ae235b |
* @interface_: An exported D-Bus interface
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* Gets the #GDBusObject that @interface_ belongs to, if any.
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* It is not safe to use the returned object if @interface_ or
|
|
Packit |
ae235b |
* the returned object is being used from other threads. See
|
|
Packit |
ae235b |
* g_dbus_interface_dup_object() for a thread-safe alternative.
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* Returns: (transfer none): A #GDBusObject or %NULL. The returned
|
|
Packit |
ae235b |
* reference belongs to @interface_ and should not be freed.
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* Since: 2.30
|
|
Packit |
ae235b |
*/
|
|
Packit |
ae235b |
GDBusObject *
|
|
Packit |
ae235b |
g_dbus_interface_get_object (GDBusInterface *interface_)
|
|
Packit |
ae235b |
{
|
|
Packit |
ae235b |
g_return_val_if_fail (G_IS_DBUS_INTERFACE (interface_), NULL);
|
|
Packit |
ae235b |
return G_DBUS_INTERFACE_GET_IFACE (interface_)->get_object (interface_);
|
|
Packit |
ae235b |
}
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
/**
|
|
Packit |
ae235b |
* g_dbus_interface_dup_object: (rename-to g_dbus_interface_get_object)
|
|
Packit |
ae235b |
* @interface_: An exported D-Bus interface.
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* Gets the #GDBusObject that @interface_ belongs to, if any.
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* Returns: (transfer full): A #GDBusObject or %NULL. The returned
|
|
Packit |
ae235b |
* reference should be freed with g_object_unref().
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* Since: 2.32
|
|
Packit |
ae235b |
*/
|
|
Packit |
ae235b |
GDBusObject *
|
|
Packit |
ae235b |
g_dbus_interface_dup_object (GDBusInterface *interface_)
|
|
Packit |
ae235b |
{
|
|
Packit |
ae235b |
GDBusObject *ret;
|
|
Packit |
ae235b |
g_return_val_if_fail (G_IS_DBUS_INTERFACE (interface_), NULL);
|
|
Packit |
ae235b |
if (G_LIKELY (G_DBUS_INTERFACE_GET_IFACE (interface_)->dup_object != NULL))
|
|
Packit |
ae235b |
{
|
|
Packit |
ae235b |
ret = G_DBUS_INTERFACE_GET_IFACE (interface_)->dup_object (interface_);
|
|
Packit |
ae235b |
}
|
|
Packit |
ae235b |
else
|
|
Packit |
ae235b |
{
|
|
Packit |
ae235b |
g_warning ("No dup_object() vfunc on type %s - using get_object() in a way that is not thread-safe.",
|
|
Packit |
ae235b |
g_type_name_from_instance ((GTypeInstance *) interface_));
|
|
Packit |
ae235b |
ret = G_DBUS_INTERFACE_GET_IFACE (interface_)->get_object (interface_);
|
|
Packit |
ae235b |
if (ret != NULL)
|
|
Packit |
ae235b |
g_object_ref (ret);
|
|
Packit |
ae235b |
}
|
|
Packit |
ae235b |
return ret;
|
|
Packit |
ae235b |
}
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
/**
|
|
Packit |
ae235b |
* g_dbus_interface_set_object:
|
|
Packit |
ae235b |
* @interface_: An exported D-Bus interface.
|
|
Packit |
ae235b |
* @object: (nullable): A #GDBusObject or %NULL.
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* Sets the #GDBusObject for @interface_ to @object.
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* Note that @interface_ will hold a weak reference to @object.
|
|
Packit |
ae235b |
*
|
|
Packit |
ae235b |
* Since: 2.30
|
|
Packit |
ae235b |
*/
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_dbus_interface_set_object (GDBusInterface *interface_,
|
|
Packit |
ae235b |
GDBusObject *object)
|
|
Packit |
ae235b |
{
|
|
Packit |
ae235b |
g_return_if_fail (G_IS_DBUS_INTERFACE (interface_));
|
|
Packit |
ae235b |
g_return_if_fail (object == NULL || G_IS_DBUS_OBJECT (object));
|
|
Packit |
ae235b |
G_DBUS_INTERFACE_GET_IFACE (interface_)->set_object (interface_, object);
|
|
Packit |
ae235b |
}
|