LCOV - code coverage report
Current view: top level - glib/gio - gdbusobject.c (source / functions) Hit Total Coverage
Test: unnamed Lines: 15 15 100.0 %
Date: 2024-03-26 05:16:46 Functions: 5 5 100.0 %
Branches: 5 6 83.3 %

           Branch data     Line data    Source code
       1                 :            : /* GDBus - GLib D-Bus Library
       2                 :            :  *
       3                 :            :  * Copyright (C) 2008-2010 Red Hat, Inc.
       4                 :            :  *
       5                 :            :  * SPDX-License-Identifier: LGPL-2.1-or-later
       6                 :            :  *
       7                 :            :  * This library is free software; you can redistribute it and/or
       8                 :            :  * modify it under the terms of the GNU Lesser General Public
       9                 :            :  * License as published by the Free Software Foundation; either
      10                 :            :  * version 2.1 of the License, or (at your option) any later version.
      11                 :            :  *
      12                 :            :  * This library is distributed in the hope that it will be useful,
      13                 :            :  * but WITHOUT ANY WARRANTY; without even the implied warranty of
      14                 :            :  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
      15                 :            :  * Lesser General Public License for more details.
      16                 :            :  *
      17                 :            :  * You should have received a copy of the GNU Lesser General
      18                 :            :  * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
      19                 :            :  *
      20                 :            :  * Author: David Zeuthen <davidz@redhat.com>
      21                 :            :  */
      22                 :            : 
      23                 :            : #include "config.h"
      24                 :            : 
      25                 :            : #include "gdbusobject.h"
      26                 :            : #include "gdbusinterface.h"
      27                 :            : #include "gdbusutils.h"
      28                 :            : 
      29                 :            : #include "glibintl.h"
      30                 :            : 
      31                 :            : /**
      32                 :            :  * GDBusObject:
      33                 :            :  *
      34                 :            :  * The `GDBusObject` type is the base type for D-Bus objects on both
      35                 :            :  * the service side (see [class@Gio.DBusObjectSkeleton]) and the client side
      36                 :            :  * (see [class@Gio.DBusObjectProxy]). It is essentially just a container of
      37                 :            :  * interfaces.
      38                 :            :  */
      39                 :            : 
      40                 :            : typedef GDBusObjectIface GDBusObjectInterface;
      41   [ +  +  +  -  :        499 : G_DEFINE_INTERFACE (GDBusObject, g_dbus_object, G_TYPE_OBJECT)
                   +  + ]
      42                 :            : 
      43                 :            : static void
      44                 :          6 : g_dbus_object_default_init (GDBusObjectIface *iface)
      45                 :            : {
      46                 :            :   /**
      47                 :            :    * GDBusObject::interface-added:
      48                 :            :    * @object: The #GDBusObject emitting the signal.
      49                 :            :    * @interface: The #GDBusInterface that was added.
      50                 :            :    *
      51                 :            :    * Emitted when @interface is added to @object.
      52                 :            :    *
      53                 :            :    * Since: 2.30
      54                 :            :    */
      55                 :          6 :   g_signal_new (I_("interface-added"),
      56                 :            :                 G_TYPE_FROM_INTERFACE (iface),
      57                 :            :                 G_SIGNAL_RUN_LAST,
      58                 :            :                 G_STRUCT_OFFSET (GDBusObjectIface, interface_added),
      59                 :            :                 NULL,
      60                 :            :                 NULL,
      61                 :            :                 NULL,
      62                 :            :                 G_TYPE_NONE,
      63                 :            :                 1,
      64                 :            :                 G_TYPE_DBUS_INTERFACE);
      65                 :            : 
      66                 :            :   /**
      67                 :            :    * GDBusObject::interface-removed:
      68                 :            :    * @object: The #GDBusObject emitting the signal.
      69                 :            :    * @interface: The #GDBusInterface that was removed.
      70                 :            :    *
      71                 :            :    * Emitted when @interface is removed from @object.
      72                 :            :    *
      73                 :            :    * Since: 2.30
      74                 :            :    */
      75                 :          6 :   g_signal_new (I_("interface-removed"),
      76                 :            :                 G_TYPE_FROM_INTERFACE (iface),
      77                 :            :                 G_SIGNAL_RUN_LAST,
      78                 :            :                 G_STRUCT_OFFSET (GDBusObjectIface, interface_removed),
      79                 :            :                 NULL,
      80                 :            :                 NULL,
      81                 :            :                 NULL,
      82                 :            :                 G_TYPE_NONE,
      83                 :            :                 1,
      84                 :            :                 G_TYPE_DBUS_INTERFACE);
      85                 :          6 : }
      86                 :            : 
      87                 :            : /* ---------------------------------------------------------------------------------------------------- */
      88                 :            : 
      89                 :            : /**
      90                 :            :  * g_dbus_object_get_object_path:
      91                 :            :  * @object: A #GDBusObject.
      92                 :            :  *
      93                 :            :  * Gets the object path for @object.
      94                 :            :  *
      95                 :            :  * Returns: A string owned by @object. Do not free.
      96                 :            :  *
      97                 :            :  * Since: 2.30
      98                 :            :  */
      99                 :            : const gchar *
     100                 :         80 : g_dbus_object_get_object_path (GDBusObject *object)
     101                 :            : {
     102                 :         80 :   GDBusObjectIface *iface = G_DBUS_OBJECT_GET_IFACE (object);
     103                 :         80 :   return iface->get_object_path (object);
     104                 :            : }
     105                 :            : 
     106                 :            : /**
     107                 :            :  * g_dbus_object_get_interfaces:
     108                 :            :  * @object: A #GDBusObject.
     109                 :            :  *
     110                 :            :  * Gets the D-Bus interfaces associated with @object.
     111                 :            :  *
     112                 :            :  * Returns: (element-type GDBusInterface) (transfer full): A list of #GDBusInterface instances.
     113                 :            :  *   The returned list must be freed by g_list_free() after each element has been freed
     114                 :            :  *   with g_object_unref().
     115                 :            :  *
     116                 :            :  * Since: 2.30
     117                 :            :  */
     118                 :            : GList *
     119                 :         34 : g_dbus_object_get_interfaces (GDBusObject *object)
     120                 :            : {
     121                 :         34 :   GDBusObjectIface *iface = G_DBUS_OBJECT_GET_IFACE (object);
     122                 :         34 :   return iface->get_interfaces (object);
     123                 :            : }
     124                 :            : 
     125                 :            : /**
     126                 :            :  * g_dbus_object_get_interface:
     127                 :            :  * @object: A #GDBusObject.
     128                 :            :  * @interface_name: A D-Bus interface name.
     129                 :            :  *
     130                 :            :  * Gets the D-Bus interface with name @interface_name associated with
     131                 :            :  * @object, if any.
     132                 :            :  *
     133                 :            :  * Returns: (nullable) (transfer full): %NULL if not found, otherwise a
     134                 :            :  *   #GDBusInterface that must be freed with g_object_unref().
     135                 :            :  *
     136                 :            :  * Since: 2.30
     137                 :            :  */
     138                 :            : GDBusInterface *
     139                 :         52 : g_dbus_object_get_interface (GDBusObject *object,
     140                 :            :                              const gchar *interface_name)
     141                 :            : {
     142                 :         52 :   GDBusObjectIface *iface = G_DBUS_OBJECT_GET_IFACE (object);
     143                 :         52 :   g_return_val_if_fail (g_dbus_is_interface_name (interface_name), NULL);
     144                 :         52 :   return iface->get_interface (object, interface_name);
     145                 :            : }

Generated by: LCOV version 1.14