gouranga

In einem Projekt möchte ich mit Qt auf die XML Rpc Schnittstelle von Sipgate Team zugreifen.

Nach meiner Internetrecherche hat sich folgendes herrausgestellt:

• Qt bringt keine eigene XML Rpc Librarys mit. SOAP ist mit Qt übrings kein Problem.
• Mit geringem Aufwand lässt sich aus den Qt Modulen QtNetwork und QtXML eine eigene XML RPC Lib zusammenschustern.
• Sebastian Wiedenroth und Karl Gratz haben uns mit LibMaia schon einen Großteil der Arbeit abgenommen.
• Für meine Zwecke musste ich nurnoch einige Anpassungen vornehmen (SSL und Auth)

Vorraussetzungen

• Qt 4.6.2
• OpenSSL  (Ich verwende OpenSSL 0.9.8l als fertige Win32 Kompilat mit libs und includes)
• LibMaia

Ich entwickele unter Windows 7 mit VS2005. Eine Anleitung zu Qt und VS2005 findet man bei Ferhat Akgün.

Qt mit OpenSSL Support kompilieren

Nachdem OpenSSL installiert ist müssen wir Qt mit OpenSSL Support backen. Dazu rufen wir configure zusätzliche mit folgenden Flags auf:

-openssl -I pfad_zu_openssl_includes -L pfad_zu_openssl_libs

Bei mir sieht das so aus:
configure -platform win32-msvc2005 -no-qt3support -qt-sql-odbc -qt-sql-sqlite -qt-zlib -qt-libpng -openssl -I C:\OpenSSL\include -L C:\OpenSSL\lib -qt-sql-mysql -opensource -I C:\mysql-5.1.44-win32\include -L C:\mysql-5.1.44-win32\lib\opt -l libmysql

LibMaia

Nachdem wir uns ein Checkout von LibMaia besorgt haben (svn co https://svn.frubar.net/svn/libmaia/trunk/) kompilieren wir das ganze mit

qmake && nmake

Ich empfehle, einen Unterordner wie 3rdparty im Qt Verzeichnis (in der Ebene ,in der auch die Ordner mit eueren Qt Versionen liegen) zu erstellen und dort 3rd-Party Libs wie LibMaia abzulegen.

Macht euerem Projekt jetzt den Include Path mit den Headern sowieso euerem Linker den Include Path mit den Libs und im speziellen maia.lib bekannt. (Wenn ihr wollt könnt ihr natürlich auch die *.h und *.cpps von LibMaia direkt euerem Projekt hinzufügen und euch den vorherigen Schritt sparen)

Frisch ans Werk

Weist zunächst Qt an, die Module QtNetwork und QtXml mitzuladen.

Erstellt jetzt eine Klasse die folgende Slots enthält:

public slots:;
void myFaultResponse(int, const QString &);
void myResponse(QVariant&);

Diese werden benötigt, um auf die asynchronen Antworten der XML RPC API zu reagieren.

In euerer .cpp inkludiert ihr “maiaXmlRpcClient.h”. Ich werde jetzt meinen ersten Testcode benutzen, um euch das weitere vorgehen zu erklären:


#include "xmlrpc.h"
// Client Includes
#include "maiaXmlRpcClient.h"
xmlrpc::xmlrpc(QWidget *parent, Qt::WFlags flags) : QMainWindow(parent, flags)
{
ui.setupUi(this);
// API Url. Kann auch pro Call übergeben oder mit rpcClient->setUrl gesetzt werden.
QUrl targetUrl = QUrl("https://api.sipgate.net/RPC2");
targetUrl.setUserName("euere@sipgate.kontaktdaten");
targetUrl.setPassword("euerpasswort");
// Erstellt den Client. Der zweite Parameter ist ein QObjekt als Parent für die automatische
// Objektzerstörung, wie bei Qt üblich
MaiaXmlRpcClient* rpcClient = new MaiaXmlRpcClient(targetUrl, this);
// Ein erstellen, wie von der Sipgate Api für ClientIdentify verlangt
QVariantMap clientArgs;
clientArgs["ClientName"] = QString("AWinKD Sipgate Plugin");
clientArgs["ClientVersion"] = QString("0.1");
clientArgs["ClientVendor"] = QString("Steffen Görtz");
// In ein packen
QVariantList args;
args << clientArgs;
// Methode samurai.ClientIdentify ausführen und Antwort sowieso Errormethode connecten
rpcClient->call("samurai.ClientIdentify", args,
this, SLOT(myResponse(QVariant&)), this, SLOT(myFaultResponse(int, const QString &)));
}
void xmlrpc::myFaultResponse(int errorCode, const QString &errorMsg) {
qDebug() << "Fehler (" << errorCode << ") :" << errorMsg;
}
void xmlrpc::myResponse(QVariant &response) {
;
}


Wer in Qt schnell über eine Verzeichnisstruktur iterieren will, der nutzt dazu QDirIterator.
Die Qt Dokumentation meint dazu:

 QDirIterator it("/etc", QDirIterator::Subdirectories);
 while (it.hasNext()) {
     qDebug() << it.next();
 
     // /etc/.
     // /etc/..
     // /etc/X11
     // /etc/X11/fs
     // ...
 }

Nichts besonders, sowas kann heutzutage jedes Framework – und Java von Haus aus.

Jetzt wirds awesome: QDirIterator greift nicht direkt auf das Dateisystem zu (Architekturbedingt macht das bei einem plattformunabhängigen Framework auch keinen Sinn), sondern über Ableitungen von QAbstractFileEngineIterator. Und so ermöglicht QDirIterator auch den Zugriff auf in die Applikation kompilierte Resourcen:

QDirIterator it(":/subitems");
 while (it.hasNext()) {
     qDebug() << it.next();
 
    // :/subitems/globe.png
    // :/subitems/pin.png
    // :/subitems/light_bulb.png
     // ...
 }

Awesome!