Class ClientProxy

All Implemented Interfaces:
PointerInterface

public class ClientProxy extends DBusProxy
The #GClueClientProxy structure contains only private data and should only be accessed using the provided API.

https://www.freedesktop.org/software/geoclue/docs/libgeoclue/

  • Constructor Details

  • Method Details

    • getClassHandler

      public static ClassHandler getClassHandler()
    • newFinishClientProxy

      public static ClientProxy newFinishClientProxy(@Nonnull AsyncResult res) throws AllocationError
      Finishes an operation started with gclue_client_proxy_new().
      Parameters:
      res - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gclue_client_proxy_new().
      Returns:
      The constructed proxy object or %NULL if @error is set.
      Throws:
      AllocationError
    • newForBusFinishClientProxy

      public static ClientProxy newForBusFinishClientProxy(@Nonnull AsyncResult res) throws AllocationError
      Finishes an operation started with gclue_client_proxy_new_for_bus().
      Parameters:
      res - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gclue_client_proxy_new_for_bus().
      Returns:
      The constructed proxy object or %NULL if @error is set.
      Throws:
      AllocationError
    • newForBusSyncClientProxy

      public static ClientProxy newForBusSyncClientProxy(int bus_type, int flags, @Nonnull Str name, @Nonnull Str object_path, @Nullable Cancellable cancellable) throws AllocationError
      Like gclue_client_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.

      The calling thread is blocked until a reply is received.

      See gclue_client_proxy_new_for_bus() for the asynchronous version of this constructor.
      Parameters:
      bus_type - A #GBusType.
      flags - Flags from the #GDBusProxyFlags enumeration.
      name - A bus name (well-known or unique).
      object_path - An object path.
      cancellable - A #GCancellable or %NULL.
      Returns:
      The constructed proxy object or %NULL if @error is set.
      Throws:
      AllocationError
    • newForBusSyncClientProxy

      public static ClientProxy newForBusSyncClientProxy(int bus_type, int flags, String name, String object_path, @Nullable Cancellable cancellable) throws AllocationError
      Like gclue_client_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.

      The calling thread is blocked until a reply is received.

      See gclue_client_proxy_new_for_bus() for the asynchronous version of this constructor.
      Parameters:
      bus_type - A #GBusType.
      flags - Flags from the #GDBusProxyFlags enumeration.
      name - A bus name (well-known or unique).
      object_path - An object path.
      cancellable - A #GCancellable or %NULL.
      Returns:
      The constructed proxy object or %NULL if @error is set.
      Throws:
      AllocationError
    • newSyncClientProxy

      public static ClientProxy newSyncClientProxy(@Nonnull DBusConnection connection, int flags, @Nullable Str name, @Nonnull Str object_path, @Nullable Cancellable cancellable) throws AllocationError
      Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-GeoClue2-Client.top_of_page">org.freedesktop.GeoClue2.Client</link>. See g_dbus_proxy_new_sync() for more details.

      The calling thread is blocked until a reply is received.

      See gclue_client_proxy_new() for the asynchronous version of this constructor.
      Parameters:
      connection - A #GDBusConnection.
      flags - Flags from the #GDBusProxyFlags enumeration.
      name - A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
      object_path - An object path.
      cancellable - A #GCancellable or %NULL.
      Returns:
      The constructed proxy object or %NULL if @error is set.
      Throws:
      AllocationError
    • newSyncClientProxy

      public static ClientProxy newSyncClientProxy(@Nonnull DBusConnection connection, int flags, String name, String object_path, @Nullable Cancellable cancellable) throws AllocationError
      Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-GeoClue2-Client.top_of_page">org.freedesktop.GeoClue2.Client</link>. See g_dbus_proxy_new_sync() for more details.

      The calling thread is blocked until a reply is received.

      See gclue_client_proxy_new() for the asynchronous version of this constructor.
      Parameters:
      connection - A #GDBusConnection.
      flags - Flags from the #GDBusProxyFlags enumeration.
      name - A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
      object_path - An object path.
      cancellable - A #GCancellable or %NULL.
      Returns:
      The constructed proxy object or %NULL if @error is set.
      Throws:
      AllocationError
    • create

      public static void create(@Nonnull Str desktop_id, int accuracy_level, @Nullable Cancellable cancellable, ClientProxy.OnAsyncReadyCallback callback, @Nullable Pointer user_data)
      A utility function to create a #GClueClientProxy without having to deal with
      a #GClueManager. See also gclue_client_proxy_create_full() which improves
      resource management.

      This is identitcal to calling gclue_client_proxy_create_full() without any
      flags set.

      See #gclue_client_proxy_create_sync() for the synchronous, blocking version
      of this function.
      Parameters:
      desktop_id - The desktop file id (the basename of the desktop file).
      accuracy_level - The requested accuracy level as #GClueAccuracyLevel.
      cancellable - A #GCancellable or %NULL.
      callback - A #GAsyncReadyCallback to call when the results are ready.
      user_data - User data to pass to @callback.
    • createFinish

      public static ClientProxy createFinish(@Nonnull AsyncResult result) throws AllocationError
      Finishes an operation started with gclue_client_proxy_create().
      Parameters:
      result - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gclue_client_proxy_create().
      Returns:
      The constructed proxy object or %NULL if @error is set.
      Throws:
      AllocationError
    • createFull

      public static void createFull(@Nonnull Str desktop_id, int accuracy_level, int flags, @Nullable Cancellable cancellable, ClientProxy.OnAsyncReadyCallback callback, @Nullable Pointer user_data)
      A utility function to create a #GClueClientProxy without having to deal with
      a #GClueManager.

      By setting the #GCLUE_CLIENT_PROXY_CREATE_AUTO_DELETE flag you can ensure
      that the client will be deleted again from the geoclue service when
      it is destroyed. This flag should be used unless you are doing explicit
      resource management.

      See #gclue_client_proxy_create_full_sync() for the synchronous, blocking
      version of this function.
      Parameters:
      desktop_id - The desktop file id (the basename of the desktop file).
      accuracy_level - The requested accuracy level as #GClueAccuracyLevel.
      flags - #GClueClientProxyCreateFlags to modify the creation.
      cancellable - A #GCancellable or %NULL.
      callback - A #GAsyncReadyCallback to call when the results are ready.
      user_data - User data to pass to @callback.
    • createFullFinish

      public static ClientProxy createFullFinish(@Nonnull AsyncResult result) throws AllocationError
      Finishes an operation started with gclue_client_proxy_create_full().
      Parameters:
      result - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gclue_client_proxy_create().
      Returns:
      The constructed proxy object or %NULL if @error is set.
      Throws:
      AllocationError
    • createFullSync

      public static ClientProxy createFullSync(@Nonnull Str desktop_id, int accuracy_level, int flags, @Nullable Cancellable cancellable) throws AllocationError
      The synchronous and blocking version of #gclue_client_proxy_create_full().

      By setting the #GCLUE_CLIENT_PROXY_CREATE_AUTO_DELETE flag you can ensure
      that the client will be deleted again from the geoclue service when
      it is destroyed. This flag should be used unless you are doing explicit
      resource management.
      Parameters:
      desktop_id - The desktop file id (the basename of the desktop file).
      accuracy_level - The requested accuracy level as #GClueAccuracyLevel.
      flags - #GClueClientProxyCreateFlags to modify the creation.
      cancellable - A #GCancellable or %NULL.
      Returns:
      The constructed proxy object or %NULL if @error is set.
      Throws:
      AllocationError
    • createSync

      public static ClientProxy createSync(@Nonnull Str desktop_id, int accuracy_level, @Nullable Cancellable cancellable) throws AllocationError
      The synchronous and blocking version of #gclue_client_proxy_create().
      See also gclue_client_proxy_create_full_sync() which improves resource
      management.

      This function is identical to calling gclue_client_proxy_create_full_sync()
      without any flags set.
      Parameters:
      desktop_id - The desktop file id (the basename of the desktop file).
      accuracy_level - The requested accuracy level as #GClueAccuracyLevel.
      cancellable - A #GCancellable or %NULL.
      Returns:
      The constructed proxy object or %NULL if @error is set.
      Throws:
      AllocationError
    • _new

      public static void _new(@Nonnull DBusConnection connection, int flags, @Nullable Str name, @Nonnull Str object_path, @Nullable Cancellable cancellable, ClientProxy.OnAsyncReadyCallback callback, @Nullable Pointer user_data)
      Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-GeoClue2-Client.top_of_page">org.freedesktop.GeoClue2.Client</link>. See g_dbus_proxy_new() for more details.

      When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()).
      You can then call gclue_client_proxy_new_finish() to get the result of the operation.

      See gclue_client_proxy_new_sync() for the synchronous, blocking version of this constructor.
      Parameters:
      connection - A #GDBusConnection.
      flags - Flags from the #GDBusProxyFlags enumeration.
      name - A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
      object_path - An object path.
      cancellable - A #GCancellable or %NULL.
      callback - A #GAsyncReadyCallback to call when the request is satisfied.
      user_data - User data to pass to @callback.
    • newForBus

      public static void newForBus(int bus_type, int flags, @Nonnull Str name, @Nonnull Str object_path, @Nullable Cancellable cancellable, ClientProxy.OnAsyncReadyCallback callback, @Nullable Pointer user_data)
      Like gclue_client_proxy_new() but takes a #GBusType instead of a #GDBusConnection.

      When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()).
      You can then call gclue_client_proxy_new_for_bus_finish() to get the result of the operation.

      See gclue_client_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
      Parameters:
      bus_type - A #GBusType.
      flags - Flags from the #GDBusProxyFlags enumeration.
      name - A bus name (well-known or unique).
      object_path - An object path.
      cancellable - A #GCancellable or %NULL.
      callback - A #GAsyncReadyCallback to call when the request is satisfied.
      user_data - User data to pass to @callback.
    • asClient

      public Client asClient()
      Implements interface Client. Call this to get access to interface functions.
      Returns:
      Client
    • asAsyncInitable

      public AsyncInitable asAsyncInitable()
      Implements interface AsyncInitable. Call this to get access to interface functions.
      Overrides:
      asAsyncInitable in class DBusProxy
      Returns:
      AsyncInitable
    • asDBusInterface

      public DBusInterface asDBusInterface()
      Implements interface DBusInterface. Call this to get access to interface functions.
      Overrides:
      asDBusInterface in class DBusProxy
      Returns:
      DBusInterface
    • asInitable

      public Initable asInitable()
      Implements interface Initable. Call this to get access to interface functions.
      Overrides:
      asInitable in class DBusProxy
      Returns:
      Initable
    • getTypeID

      public static long getTypeID()
    • getParentTypeID

      public static long getParentTypeID()
    • getTypeSize

      public static TypeSystem.TypeSize getTypeSize()
    • getParentTypeSize

      public static TypeSystem.TypeSize getParentTypeSize()
    • getInstanceSize

      public static int getInstanceSize()