Home · All Classes · All Namespaces · Modules · Functions · Files
Public Slots | List of all members
Tp::Service::ConnectionInterfaceAddressingAdaptor Class Reference

#include <TelepathyQt/_gen/svc-connection.h>

Inheritance diagram for Tp::Service::ConnectionInterfaceAddressingAdaptor:
Inheritance graph
[legend]

Public Slots

Tp::AddressingNormalizationMap GetContactsByVCardField (const QString &field, const QStringList &addresses, const QStringList &interfaces, const QDBusMessage &dbusMessage, Tp::ContactAttributesMap &attributes)
 
Tp::AddressingNormalizationMap GetContactsByURI (const QStringList &URIs, const QStringList &interfaces, const QDBusMessage &dbusMessage, Tp::ContactAttributesMap &attributes)
 

Additional Inherited Members

- Public Member Functions inherited from Tp::AbstractAdaptor
 AbstractAdaptor (const QDBusConnection &connection, QObject *adaptee, QObject *parent)
 
 ~AbstractAdaptor ()
 
QDBusConnection dbusConnection () const
 
QObjectadaptee () const
 
- Public Member Functions inherited from QDBusAbstractAdaptor
 ~QDBusAbstractAdaptor ()
 
- Public Member Functions inherited from QObject
 QObject (QObject *parent)
 
virtual ~QObject ()
 
virtual bool event (QEvent *e)
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 
virtual const QMetaObjectmetaObject () const
 
QString objectName () const
 
void setObjectName (const QString &name)
 
bool isWidgetType () const
 
bool signalsBlocked () const
 
bool blockSignals (bool block)
 
QThreadthread () const
 
void moveToThread (QThread *targetThread)
 
int startTimer (int interval)
 
void killTimer (int id)
 
findChild (const QString &name) const
 
QList< T > findChildren (const QString &name) const
 
QList< T > findChildren (const QRegExp &regExp) const
 
QObjectchild (const char *objName, const char *inheritsClass, bool recursiveSearch) const
 
const QObjectList & children () const
 
void setParent (QObject *parent)
 
void installEventFilter (QObject *filterObj)
 
void removeEventFilter (QObject *obj)
 
bool connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const
 
bool disconnect (const char *signal, const QObject *receiver, const char *method)
 
bool disconnect (const QObject *receiver, const char *method)
 
void dumpObjectTree ()
 
void dumpObjectInfo ()
 
bool setProperty (const char *name, const QVariant &value)
 
QVariant property (const char *name) const
 
QList< QByteArraydynamicPropertyNames () const
 
void destroyed (QObject *obj)
 
QObjectparent () const
 
bool inherits (const char *className) const
 
void deleteLater ()
 
 QObject (QObject *parent, const char *name)
 
void insertChild (QObject *object)
 
void removeChild (QObject *object)
 
bool isA (const char *className) const
 
const char * className () const
 
const char * name () const
 
const char * name (const char *defaultName) const
 
void setName (const char *name)
 
- Static Public Member Functions inherited from QObject
QString tr (const char *sourceText, const char *disambiguation, int n)
 
QString trUtf8 (const char *sourceText, const char *disambiguation, int n)
 
bool connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
 
bool connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
 
bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
 
bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
 
- Protected Member Functions inherited from QDBusAbstractAdaptor
 QDBusAbstractAdaptor (QObject *obj)
 
void setAutoRelaySignals (bool enable)
 
bool autoRelaySignals () const
 
- Protected Member Functions inherited from QObject
QObjectsender () const
 
int senderSignalIndex () const
 
int receivers (const char *signal) const
 
virtual void timerEvent (QTimerEvent *event)
 
virtual void childEvent (QChildEvent *event)
 
virtual void customEvent (QEvent *event)
 
virtual void connectNotify (const char *signal)
 
virtual void disconnectNotify (const char *signal)
 
bool checkConnectArgs (const char *signal, const QObject *object, const char *method)
 
- Static Protected Member Functions inherited from QObject
QByteArray normalizeSignalSlot (const char *signalSlot)
 
- Properties inherited from QObject
 objectName
 

Detailed Description

Adaptor class providing a 1:1 mapping of the D-Bus interface "org.freedesktop.Telepathy.Connection.Interface.Addressing1".

Member Function Documentation

◆ GetContactsByVCardField

Tp::AddressingNormalizationMap Tp::Service::ConnectionInterfaceAddressingAdaptor::GetContactsByVCardField ( const QString field,
const QStringList addresses,
const QStringList interfaces,
const QDBusMessage dbusMessage,
Tp::ContactAttributesMap attributes 
)
slot

Begins a call to the exported D-Bus method GetContactsByVCardField on this object.

Adaptees should export this method as a Qt slot with the following signature: void getContactsByVCardField(const QString& field, const QStringList& addresses, const QStringList& interfaces, const Tp::Service::ConnectionInterfaceAddressingAdaptor::GetContactsByVCardFieldContextPtr &context);

Implementations should call MethodInvocationContext::setFinished (or setFinishedWithError accordingly) on the received context object once the method has finished processing.

Request contacts and retrieve their attributes using a given field in their vCards.

The connection manager should record that these handles are in use by the client who invokes this method, and must not deallocate the handles until the client disconnects from the bus or calls the ConnectionInterface::ReleaseHandles() method.

Parameters
field

The vCard field of the addresses we are requesting. The field name SHOULD be in lower case. Supported fields can be found in \\\ \\link ProtocolInterfaceAddressingInterface::requestPropertyAddressableVCardFields() ProtocolInterfaceAddressingInterface::AddressableVCardFields \\endlink \\htmlonly .

The url vCard field MUST NOT appear here; see \\endhtmlonly GetContactsByURI() \\htmlonly instead.

In practice, protocols have a limited set of URI schemes that make sense to resolve as a contact.
Parameters
addresses
The addresses to get contact handles for. The address types should 
match the given vCard field.
interfaces

A list of strings indicating which D-Bus interfaces the calling process is interested in. All supported attributes from these interfaces, whose values can be obtained without additional network activity, will be in the reply.

Attributes from this interface and from \\\ ConnectionInterface \\htmlonly are always returned, and need not be requested explicitly.

The behavior of this parameter is similar to the same parameter in \\endhtmlonly ConnectionInterfaceContactsInterface::GetContactAttributes() \\htmlonly .

Parameters
attributesOutput parameter

A dictionary mapping the contact handles to contact attributes. If any of the requested addresses are in fact invalid, they are simply omitted from this mapping. If contact attributes are not immediately known, the behaviour is defined by the interface; the attribute should either be omitted from the result or replaced with a default value.

Requested addresses that are not valid or understood for this protocol MUST be omitted from the mapping.

Each contact's attributes will always include at least the identifier that would be obtained by inspecting the handle (org.freedesktop.Telepathy.Connection/contact-id).

Returns

A mapping from requested vCard addresses to the corresponding contact handles.

Requested addresses that are not valid or understood for this protocol MUST be omitted from the mapping.

◆ GetContactsByURI

Tp::AddressingNormalizationMap Tp::Service::ConnectionInterfaceAddressingAdaptor::GetContactsByURI ( const QStringList URIs,
const QStringList interfaces,
const QDBusMessage dbusMessage,
Tp::ContactAttributesMap attributes 
)
slot

Begins a call to the exported D-Bus method GetContactsByURI on this object.

Adaptees should export this method as a Qt slot with the following signature: void getContactsByURI(const QStringList& URIs, const QStringList& interfaces, const Tp::Service::ConnectionInterfaceAddressingAdaptor::GetContactsByURIContextPtr &context);

Implementations should call MethodInvocationContext::setFinished (or setFinishedWithError accordingly) on the received context object once the method has finished processing.

Request contacts and retrieve their attributes using URI addresses.

The connection manager should record that these handles are in use by the client who invokes this method, and must not deallocate the handles until the client disconnects from the bus or calls the ConnectionInterface::ReleaseHandles() method.

Parameters
URIs
The URI addresses to get contact handles for. Supported schemes can 
be found in AddressableURISchemes.
interfaces

A list of strings indicating which D-Bus interfaces the calling process is interested in. All supported attributes from these interfaces, whose values can be obtained without additional network activity, will be in the reply.

Attributes from this interface and from \\\ ConnectionInterface \\htmlonly are always returned, and need not be requested explicitly.

The behavior of this parameter is similar to the same parameter in \\endhtmlonly ConnectionInterfaceContactsInterface::GetContactAttributes() \\htmlonly .

Parameters
attributesOutput parameter

A dictionary mapping the contact handles to contact attributes. If any of the requested addresses are in fact invalid, they are simply omitted from this mapping. If contact attributes are not immediately known, the behaviour is defined by the interface; the attribute should either be omitted from the result or replaced with a default value.

Requested URIs that are not valid or understood for this protocol MUST be omitted from the mapping.

Each contact's attributes will always include at least the identifier that would be obtained by inspecting the handle (org.freedesktop.Telepathy.Connection/contact-id).

Returns

A mapping of requested URIs to the corresponding contact handles.

Requested URIs that are not valid or understood for this protocol MUST be omitted from the mapping.


Copyright © 2008-2011 Collabora Ltd. and Nokia Corporation
Telepathy-Qt 0.9.7