Top | ![]() |
![]() |
![]() |
![]() |
WockyContactFactoryWockyContactFactory — creates and looks up WockyContact objects |
void | bare-contact-added | Run Last |
void | ll-contact-added | Run Last |
void | resource-contact-added | Run Last |
Provides a way to create WockyContact objects. The objects created this way are cached by the factory and you can eventually look them up without creating them again.
WockyContactFactory *
wocky_contact_factory_new (void
);
Convenience function to create a new WockyContactFactory object.
WockyBareContact * wocky_contact_factory_ensure_bare_contact (WockyContactFactory *factory
,const gchar *bare_jid
);
Returns an instance of WockyBareContact for bare_jid
. The factory cache
is used, but if the contact is not found in the cache, a new
WockyBareContact is created and cached for future use.
a new reference to a WockyBareContact instance, which the caller
is expected to release with g_object_unref()
after use.
WockyBareContact * wocky_contact_factory_lookup_bare_contact (WockyContactFactory *factory
,const gchar *bare_jid
);
Looks up if there's a WockyBareContact for bare_jid
in the cache, and
returns it if it's found.
a borrowed WockyBareContact instance (which the caller should
reference with g_object_ref()
if it will be kept), or NULL
if the
contact is not found.
WockyResourceContact * wocky_contact_factory_ensure_resource_contact (WockyContactFactory *factory
,const gchar *full_jid
);
Returns an instance of WockyResourceContact for full_jid
.
The factory cache is used, but if the resource is not found in the cache,
a new WockyResourceContact is created and cached for future use.
a new reference to a WockyResourceContact instance, which the
caller is expected to release with g_object_unref()
after use.
WockyResourceContact * wocky_contact_factory_lookup_resource_contact (WockyContactFactory *factory
,const gchar *full_jid
);
Looks up if there's a WockyResourceContact for full_jid
in the cache, and
returns it if it's found.
a borrowed WockyResourceContact instance (which the caller should
reference with g_object_ref()
if it will be kept), or NULL
if the
contact is not found.
WockyLLContact * wocky_contact_factory_ensure_ll_contact (WockyContactFactory *factory
,const gchar *jid
);
Returns an instance of WockyLLContact for jid
.
The factory cache is used, but if the contact is not found in the cache,
a new WockyLLContact is created and cached for future use.
a new reference to a WockyLLContact instance, which the
caller is expected to release with g_object_unref()
after use.
WockyLLContact * wocky_contact_factory_lookup_ll_contact (WockyContactFactory *factory
,const gchar *jid
);
Looks up if there's a WockyLLContact for jid
in the cache, and
returns it if it's found.
a borrowed WockyLLContact instance (which the caller should
reference with g_object_ref()
if it will be kept), or NULL
if the
contact is not found.
void wocky_contact_factory_add_ll_contact (WockyContactFactory *factory
,WockyLLContact *contact
);
Adds contact
to the contact factory.
GList *
wocky_contact_factory_get_ll_contacts (WockyContactFactory *factory
);
struct WockyContactFactoryClass { };
The class of a WockyContactFactory.
“bare-contact-added”
signalvoid user_function (WockyContactFactory *wockycontactfactory, GObject *arg1, gpointer user_data)
Flags: Run Last
“ll-contact-added”
signalvoid user_function (WockyContactFactory *wockycontactfactory, GObject *arg1, gpointer user_data)
Flags: Run Last
“resource-contact-added”
signalvoid user_function (WockyContactFactory *wockycontactfactory, GObject *arg1, gpointer user_data)
Flags: Run Last