Back to Seed Clases

Gio

Classes

Interfaces

Structs

Unions

Enums

Interface Gio.AsyncInitable

Import line:	Gio = imports.gi.Gio;
GIR File:	Gio-2.0.gir
C documentation:	GAsyncInitable
Interface :	AsyncInitable
Implementations:	Gio.DBusConnection, Gio.DBusProxy

This is the asynchronous version of GInitable; it behaves the same
in all ways except that initialization is asynchronous. For more details
see the descriptions on GInitable.
A class may implement both the GInitable and GAsyncInitable interfaces.
Users of objects implementing this are not intended to use the interface
method directly; instead it will be used automatically in various ways.
For C applications you generally just call g_async_initable_new_async()
directly, or indirectly via a foo_thing_new_async() wrapper. This will call
g_async_initable_init_async() under the cover, calling back with NULL and
a set GError on failure.
A typical implementation might look something like this:
|[
enum {
NOT_INITIALIZED,
INITIALIZING,
INITIALIZED
};
static void
_foo_ready_cb (Foo *self)
{
GList *l;
self->priv->state = INITIALIZED;
for (l = self->priv->init_results; l != NULL; l = l->next)
{
GSimpleAsyncResult *simple = l->data;
if (!self->priv->success)
g_simple_async_result_set_error (simple, ...);
g_simple_async_result_complete (simple);
g_object_unref (simple);
}
g_list_free (self->priv->init_results);
self->priv->init_results = NULL;
}
static void
foo_init_async (GAsyncInitable *initable,
int io_priority,
GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data)
{
Foo *self = FOO (initable);
GSimpleAsyncResult *simple;
simple = g_simple_async_result_new (G_OBJECT (initable)
callback,
user_data,
foo_init_async);
switch (self->priv->state)
{
case NOT_INITIALIZED:
_foo_get_ready (self);
self->priv->init_results = g_list_append (self->priv->init_results,
simple);
self->priv->state = INITIALIZING;
break;
case INITIALIZING:
self->priv->init_results = g_list_append (self->priv->init_results,
simple);
break;
case INITIALIZED:
if (!self->priv->success)
g_simple_async_result_set_error (simple, ...);
g_simple_async_result_complete_in_idle (simple);
g_object_unref (simple);
break;
}
}
static gboolean
foo_init_finish (GAsyncInitable *initable,
GAsyncResult *result,
GError **error)
{
g_return_val_if_fail (g_simple_async_result_is_valid (result,
G_OBJECT (initable), foo_init_async), FALSE);
if (g_simple_async_result_propagate_error (G_SIMPLE_ASYNC_RESULT (result),
error))
return FALSE;
return TRUE;
}
static void
foo_async_initable_iface_init (gpointer g_iface,
gpointer data)
{
GAsyncInitableIface *iface = g_iface;
iface->init_async = foo_init_async;
iface->init_finish = foo_init_finish;
}
]|

Properties
None

Methods / Constructors
Method / Constructor		Defined By
	init_async (gint32 *io_priority, Cancellable cancellable, Function callback, void *user_data) : none Starts asynchronous initialization of the object implementing the interface. Starts asynchronous initialization of the object implementing the interface. This must be done before any real use of the object after initial construction. If the object also implements GInitable* you can optionally call g_initable_init() instead. When the initialization is finished, callback will be called. You can then call g_async_initable_init_finish() to get the result of the initialization. Implementations may also support cancellation. If cancellable is not NULL, then initialization can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned. If cancellable is not NULL, and the object doesn't support cancellable initialization, the error G_IO_ERROR_NOT_SUPPORTED will be returned. If this function is not called, or returns with an error, then all operations on the object should fail, generally returning the error G_IO_ERROR_NOT_INITIALIZED. to this function with the same argument should return the same results. Only the first call initializes the object; further calls return the result of the first call. This is so that it's safe to implement the singleton pattern in the GObject constructor function. For classes that also support the GInitable interface, the default implementation of this method will run the g_initable_init() function in a thread, so if you want to support asynchronous initialization via threads, just implement the GAsyncInitable interface without overriding any interface methods. Parameters: gint32 io_priority Required (not null) the I/O priority of the operation. Gio.Cancellable cancellable optional GCancellable object, NULL to ignore. Function (Object *source_object, AsyncResult res, void *user_data) : none Required (not null) a GAsyncReadyCallback* to call when the request is satisfied void* user_data Required (not null) the data to pass to callback function Returns: none	Gio.AsyncInitable
	init_finish (AsyncResult *res) : gboolean Finishes asynchronous initialization and returns the result. Finishes asynchronous initialization and returns the result. See g_async_initable_init_async(). will return FALSE* and set error appropriately if present. Parameters: Gio.AsyncResult res Required (not null) a GAsyncResult. Returns: gboolean TRUE if successful. If an error has occurred, this function	Gio.AsyncInitable
	new_finish (AsyncResult *res) : GObject.Object Finishes the async construction for the various g_async_initable_new calls, returning the created object or NULL* on error. Finishes the async construction for the various g_async_initable_new calls, returning the created object or NULL on error. g_object_unref(). Parameters: Gio.AsyncResult res Required (not null) the GAsyncResult.from the callback Returns: GObject.Object a newly created GObject, or NULL on error. Free with	Gio.AsyncInitable

Events
None