Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Tous les espaces de nom  ·  Toutes les classes  ·  Classes principales  ·  Annotées  ·  Classes groupées  ·  Modules  ·  Fonctions  · 

QDBusContext Class Reference
[QtDBus module]

The QDBusContext class allows slots to determine the D-Bus context of the calls. More...

 #include <QDBusContext>

This class was introduced in Qt 4.3.

Public Functions


Detailed Description

The QDBusContext class allows slots to determine the D-Bus context of the calls.

When a slot is called in an object due to a signal delivery or due to a remote method call, it is sometimes necessary to know the context in which that happened. In particular, if the slot determines that it wants to send the reply at a later opportunity or if it wants to reply with an error, the context is needed.

The QDBusContext class is an alternative to accessing the context that doesn't involve modifying the code generated by the QtDBus XML Compiler (qdbusxml2cpp).

QDBusContext is used by subclassing it from the objects being exported using QDBusConnection::registerObject(). The following example illustrates the usage:

 class MyObject: public QObject,
                 protected QDBusContext
 {
     Q_OBJECT
     QDBusConnection conn;
     QDBusMessage msg;

 ...

 protected slots:
     void process();
 public slots:
     void methodWithError();
     QString methodWithDelayedReply();
 };

 void MyObject::methodWithError()
 {
     sendErrorReply(QDBusError::NotSupported,
                    "The method call 'methodWithError()' is not supported");
 }

 QString MyObject::methodWithDelayedReply()
 {
     conn = connection();
     msg = message();
     setDelayedReply(true);
     QMetaObject::invokeMethod(this, "process", Qt::QueuedConnection);
     return QString();
 }

The example illustrates the two typical uses, that of sending error replies and that of delayed replies.

Note: do not subclass QDBusContext and QDBusAbstractAdaptor at the same time. QDBusContext should appear in the real object, not the adaptor. If it's necessary from the adaptor code to determine the context, use a public inheritance and access the functions via QObject::parent().


Member Function Documentation

QDBusContext::QDBusContext ()

Constructs an empty QDBusContext.

QDBusContext::~QDBusContext ()

An empty destructor.

bool QDBusContext::calledFromDBus () const

Returns true if we are processing a D-Bus call. If this function returns true, the rest of the functions in this class are available.

Accessing those functions when this function returns false is undefined and may lead to crashes.

QDBusConnection QDBusContext::connection () const

Returns the connection from which this call was received.

bool QDBusContext::isDelayedReply () const

Returns true if this call will have a delayed reply.

See also setDelayedReply().

const QDBusMessage & QDBusContext::message () const

Returns the message that generated this call.

void QDBusContext::sendErrorReply ( const QString & name, const QString & msg = QString() ) const

Sends an error name as a reply to the caller. The optional msg parameter is a human-readable text explaining the failure.

If an error is sent, the return value and any output parameters from the called slot will be ignored by QtDBus.

void QDBusContext::sendErrorReply ( QDBusError::ErrorType type, const QString & msg = QString() ) const

This is an overloaded member function, provided for convenience.

Sends an error type as a reply to the caller. The optional msg parameter is a human-readable text explaining the failure.

If an error is sent, the return value and any output parameters from the called slot will be ignored by QtDBus.

void QDBusContext::setDelayedReply ( bool enable ) const

Sets whether this call will have a delayed reply or not.

If enable is false, QtDBus will automatically generate a reply back to the caller, if needed, as soon as the called slot returns.

If enable is true, QtDBus will not generate automatic replies. It will also ignore the return value from the slot and any output parameters. Instead, the called object is responsible for storing the incoming message and send a reply or error at a later time.

Failing to send a reply will result in an automatic timeout error being generated by D-Bus.

See also isDelayedReply().

Publicité

Best Of

Actualités les plus lues

Semaine
Mois
Année
  1. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 44
  2. Microsoft ouvre aux autres compilateurs C++ AMP, la spécification pour la conception d'applications parallèles C++ utilisant le GPU 22
  3. Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  4. RIM : « 13 % des développeurs ont gagné plus de 100 000 $ sur l'AppWord », Qt et open-source au menu du BlackBerry DevCon Europe 0
  5. BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
  6. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
  7. Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
Page suivante

Le Qt Quarterly au hasard

Logo

XQuery et la météo

Qt Quarterly est la revue trimestrielle proposée par Nokia et à destination des développeurs Qt. Ces articles d'une grande qualité technique sont rédigés par des experts Qt. Lire l'article.

Communauté

Ressources

Liens utiles

Contact

  • Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 4.4
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
 
 
 
 
Partenaires

Hébergement Web