From 9073ea57506e4081881355a508a29ea5325b9e8b Mon Sep 17 00:00:00 2001 From: Linus Jahn Date: Mon, 4 Apr 2022 12:51:32 +0200 Subject: ClientExtension: Add handleStanza() overload with e2ee metdata For handling end-to-end-encrypted stanzas it is important to know whether and which encryption was used. This is especially important for replying to IQ stanzas (with the correct encryption). Currently the e2eeMetadata parameter is unused (always nullopt). This is going to change in the following commits. --- src/client/QXmppClientExtension.cpp | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) (limited to 'src/client/QXmppClientExtension.cpp') diff --git a/src/client/QXmppClientExtension.cpp b/src/client/QXmppClientExtension.cpp index 5e16d52a..c5e00c21 100644 --- a/src/client/QXmppClientExtension.cpp +++ b/src/client/QXmppClientExtension.cpp @@ -45,6 +45,43 @@ QList QXmppClientExtension::discoveryIdentities() co return QList(); } +/// +/// \brief You need to implement this method to process incoming XMPP +/// stanzas. +/// +/// You should return true if the stanza was handled and no further +/// processing should occur, or false to let other extensions process +/// the stanza. +/// +/// \deprecated This is deprecated since QXmpp 1.5. Please use +/// QXmppClientExtension::handleStanza(const QDomElement &stanza, +/// const std::optional &e2eeMetadata). +/// Currently both methods are called by the client, so only implement one! +/// +bool QXmppClientExtension::handleStanza(const QDomElement &) +{ + return false; +} + +/// +/// \brief You need to implement this method to process incoming XMPP +/// stanzas. +/// +/// \param stanza The DOM element to be handled. +/// \param e2eeMetadata If the element has been decrypted this contains metdata +/// about the encryption. +/// +/// \return You should return true if the stanza was handled and no further +/// processing should occur, or false to let other extensions process the +/// stanza. +/// +/// \since QXmpp 1.5 +/// +bool QXmppClientExtension::handleStanza(const QDomElement &, const std::optional &) +{ + return false; +} + /// Returns the client which loaded this extension. /// -- cgit v1.2.3