FolksWebServiceFieldDetails

FolksWebServiceFieldDetails — Object representing a web service contact that can have some parameters associated with it.

Synopsis

#define             FOLKS_TYPE_WEB_SERVICE_FIELD_DETAILS
FolksWebServiceFieldDetails * folks_web_service_field_details_new
                                                        (const gchar *value,
                                                         GeeMultiMap *parameters);
struct              FolksWebServiceFieldDetails;
void                folks_web_service_details_change_web_service_addresses
                                                        (FolksWebServiceDetails *self,
                                                         GeeMultiMap *web_service_addresses,
                                                         GAsyncReadyCallback _callback_,
                                                         gpointer _user_data_);
void                folks_web_service_details_change_web_service_addresses_finish
                                                        (FolksWebServiceDetails *self,
                                                         GAsyncResult *_res_,
                                                         GError **error);
GeeMultiMap *       folks_web_service_details_get_web_service_addresses
                                                        (FolksWebServiceDetails *self);
void                folks_web_service_details_set_web_service_addresses
                                                        (FolksWebServiceDetails *self,
                                                         GeeMultiMap *value);
                    FolksWebServiceDetails;

Object Hierarchy

  GObject
   +----FolksAbstractFieldDetails
         +----FolksWebServiceFieldDetails
  GInterface
   +----FolksWebServiceDetails

Prerequisites

FolksWebServiceDetails requires GObject.

Known Implementations

FolksWebServiceDetails is implemented by FolksIndividual.

Properties

  "web-service-addresses"    GeeMultiMap*          : Read / Write

Description

See FolksAbstractFieldDetails.

Details

FOLKS_TYPE_WEB_SERVICE_FIELD_DETAILS

#define FOLKS_TYPE_WEB_SERVICE_FIELD_DETAILS (folks_web_service_field_details_get_type ())

The type for FolksWebServiceFieldDetails.


folks_web_service_field_details_new ()

FolksWebServiceFieldDetails * folks_web_service_field_details_new
                                                        (const gchar *value,
                                                         GeeMultiMap *parameters);

Create a new WebServiceFieldDetails.

value :

the value of the field, a non-empty web service address. [in]

parameters :

initial parameters. See "parameters". A `null` value is equivalent to an empty map of parameters. [in][allow-none]

Returns :

a new WebServiceFieldDetails

Since 0.6.0


struct FolksWebServiceFieldDetails

struct FolksWebServiceFieldDetails;

Object representing a web service contact that can have some parameters associated with it.

See FolksAbstractFieldDetails.

Since 0.6.0


folks_web_service_details_change_web_service_addresses ()

void                folks_web_service_details_change_web_service_addresses
                                                        (FolksWebServiceDetails *self,
                                                         GeeMultiMap *web_service_addresses,
                                                         GAsyncReadyCallback _callback_,
                                                         gpointer _user_data_);

Change the contact's web service addresses.

It's preferred to call this rather than setting "web-service-addresses" directly, as this method gives error notification and will only return once the addresses have been written to the relevant backing store (or the operation's failed).

See also: folks_web_service_details_change_web_service_addresses_finish()

self :

the FolksWebServiceDetails instance

web_service_addresses :

the set of addresses. [in]

_callback_ :

callback to call when the request is satisfied. [scope async]

_user_data_ :

the data to pass to _callback_ function. [closure]

Since 0.6.2


folks_web_service_details_change_web_service_addresses_finish ()

void                folks_web_service_details_change_web_service_addresses_finish
                                                        (FolksWebServiceDetails *self,
                                                         GAsyncResult *_res_,
                                                         GError **error);

Change the contact's web service addresses.

It's preferred to call this rather than setting "web-service-addresses" directly, as this method gives error notification and will only return once the addresses have been written to the relevant backing store (or the operation's failed).

See also: folks_web_service_details_change_web_service_addresses()

self :

the FolksWebServiceDetails instance

_res_ :

a GAsyncResult

error :

location to store the error occuring, or NULL to ignore. [error-domains FolksPropertyError]

Since 0.6.2


folks_web_service_details_get_web_service_addresses ()

GeeMultiMap *       folks_web_service_details_get_web_service_addresses
                                                        (FolksWebServiceDetails *self);

self :

the FolksWebServiceDetails instance to query

Returns :

the value of the "web-service-addresses" property

folks_web_service_details_set_web_service_addresses ()

void                folks_web_service_details_set_web_service_addresses
                                                        (FolksWebServiceDetails *self,
                                                         GeeMultiMap *value);

self :

the FolksWebServiceDetails instance to modify

value :

the new value of the "web-service-addresses" property

FolksWebServiceDetails

typedef struct _FolksWebServiceDetails FolksWebServiceDetails;

Web service contact details.

Since 0.5.0

Property Details

The "web-service-addresses" property

  "web-service-addresses"    GeeMultiMap*          : Read / Write

A mapping of web service to an (unordered) set of web service addresses.

Each mapping is from an arbitrary web service identifier to a set of web service addresses for the contact, listed in no particular order.

Web service addresses are guaranteed to be unique per web service, but not necessarily unique amongst all web services.

Since 0.6.0