KD SOAP API Documentation 2.2
|
KDSoapJob provides a job-based interface to handle asynchronous KD Soap calls. More...
#include <KDSoapJob.h>
Signals | |
void | finished (KDSoapJob *job) |
Protected Member Functions | |
virtual Q_INVOKABLE void | doStart ()=0 |
void | emitFinished (const KDSoapMessage &reply, const KDSoapHeaders &replyHeaders) |
Protected Member Functions inherited from QObject | |
virtual void | childEvent (QChildEvent *event) |
virtual void | connectNotify (const QMetaMethod &signal) |
virtual void | customEvent (QEvent *event) |
virtual void | disconnectNotify (const QMetaMethod &signal) |
bool | isSignalConnected (const QMetaMethod &signal) const const |
int | receivers (const char *signal) const const |
QObject * | sender () const const |
int | senderSignalIndex () const const |
virtual void | timerEvent (QTimerEvent *event) |
KDSoapJob provides a job-based interface to handle asynchronous KD Soap calls.
For each SOAP operation, kdwsdl2cpp generates a corresponding KDSoapJob subclass. This makes it easier to manage multiple callers in the client application code calling the same functions, preventing callers processing results for calls made from another caller instead of their own calls.
For example, a call to getMothersDay (from the holidays example) using the conventional asynchronous API would look like this:
In this example, all responses to getMothersDay made client
will be received by the slots connected above. Using the job-based API, it becomes:
Now only the result of this specific getMothersDay call will be received by the slot.
Definition at line 52 of file KDSoapJob.h.
Constructs a KD Soap job.
parent | optional parent object |
Definition at line 23 of file KDSoapJob.cpp.
KDSoapJob::~KDSoapJob | ( | ) |
Destructor.
Definition at line 30 of file KDSoapJob.cpp.
|
protectedpure virtual |
|
protected |
Definition at line 55 of file KDSoapJob.cpp.
References QObject::deleteLater(), finished(), QObject::qobject_cast(), reply(), and replyHeaders().
QString KDSoapJob::faultAsString | ( | ) | const |
A human-readable error string describing the fault if the reply message is a fault, an empty string otherwise.
Definition at line 80 of file KDSoapJob.cpp.
emitted when the job is completed, i.e. the reply for the job's request was received. To read the result, call reply() in the connected slot. Do not delete the job, the job will auto-delete itself. This behavior can be changed with setAutoDelete().
job | The job instance that emitted the signal |
Referenced by emitFinished().
bool KDSoapJob::isFault | ( | ) | const |
Returns whether the reply message (see reply()) represents a fault.
Definition at line 75 of file KDSoapJob.cpp.
KDSoapMessage KDSoapJob::reply | ( | ) | const |
Returns the reply message received from the SOAP server once the request was completed. Only valid once the request is completed and finished() was emitted.
Definition at line 65 of file KDSoapJob.cpp.
Referenced by emitFinished().
KDSoapHeaders KDSoapJob::replyHeaders | ( | ) | const |
Returns the reply headers received from the SOAP server once the request was completed. Only valid once the request is completed and finished() was emitted.
Definition at line 70 of file KDSoapJob.cpp.
Referenced by emitFinished().
KDSoapHeaders KDSoapJob::requestHeaders | ( | ) | const |
Returns the reply headers received from the SOAP server once the request was completed. Only valid once the request is completed and finished() was emitted.
Definition at line 35 of file KDSoapJob.cpp.
Defines whether the job should be automatically deleted or not.
Definition at line 50 of file KDSoapJob.cpp.
References QObject::qobject_cast().
void KDSoapJob::setRequestHeaders | ( | const KDSoapHeaders & | headers | ) |
Sets request headers to be sent to the SOAP server. These are sent in addition to the persistent headers set via the client interface.
Definition at line 40 of file KDSoapJob.cpp.
References QObject::qobject_cast().
void KDSoapJob::start | ( | ) |
Starts the job. The job will emit finished() once done.
Definition at line 45 of file KDSoapJob.cpp.
References QMetaObject::invokeMethod(), and Qt::QueuedConnection.