QXmpp Version:0.3.91
|
The QXmppTransferManager class provides support for sending and receiving files. More...
#include <QXmppTransferManager.h>
Public Slots | |
QXmppTransferJob * | sendFile (const QString &jid, const QString &filePath, const QString &sid=QString()) |
QXmppTransferJob * | sendFile (const QString &jid, QIODevice *device, const QXmppTransferFileInfo &fileInfo, const QString &sid=QString()) |
Signals | |
void | fileReceived (QXmppTransferJob *job) |
void | jobStarted (QXmppTransferJob *job) |
This signal is emitted whenever a transfer job is started. | |
void | jobFinished (QXmppTransferJob *job) |
Public Member Functions | |
QXmppTransferManager () | |
QString | proxy () const |
void | setProxy (const QString &proxyJid) |
bool | proxyOnly () const |
void | setProxyOnly (bool proxyOnly) |
QXmppTransferJob::Methods | supportedMethods () const |
void | setSupportedMethods (QXmppTransferJob::Methods methods) |
Properties | |
QString | proxy |
bool | proxyOnly |
QXmppTransferJob::Methods | supportedMethods |
The QXmppTransferManager class provides support for sending and receiving files.
Stream initiation is performed as described in XEP-0095: Stream Initiation and XEP-0096: SI File Transfer. The actual file transfer is then performed using either XEP-0065: SOCKS5 Bytestreams or XEP-0047: In-Band Bytestreams.
To make use of this manager, you need to instantiate it and load it into the QXmppClient instance as follows:
QXmppTransferManager *manager = new QXmppTransferManager; client->addExtension(manager);
QXmppTransferManager::QXmppTransferManager | ( | ) |
Constructs a QXmppTransferManager to handle incoming and outgoing file transfers.
void QXmppTransferManager::fileReceived | ( | QXmppTransferJob * | job | ) | [signal] |
This signal is emitted when a new file transfer offer is received.
To accept the transfer job, call the job's QXmppTransferJob::accept() method. To refuse the transfer job, call the job's QXmppTransferJob::abort() method.
void QXmppTransferManager::jobFinished | ( | QXmppTransferJob * | job | ) | [signal] |
This signal is emitted whenever a transfer job is finished.
QXmppTransferJob * QXmppTransferManager::sendFile | ( | const QString & | jid, |
QIODevice * | device, | ||
const QXmppTransferFileInfo & | fileInfo, | ||
const QString & | sid = QString() |
||
) | [slot] |
Send file to a remote party.
The remote party will be given the choice to accept or refuse the transfer.
QXmppTransferJob * QXmppTransferManager::sendFile | ( | const QString & | jid, |
const QString & | filePath, | ||
const QString & | sid = QString() |
||
) | [slot] |
Send file to a remote party.
The remote party will be given the choice to accept or refuse the transfer.
void QXmppTransferManager::setProxy | ( | const QString & | proxyJid | ) |
Set the JID of the SOCKS5 bytestream proxy to use for outgoing transfers.
If you set a proxy, when you send a file the proxy will be offered to the recipient in addition to your own IP addresses.
void QXmppTransferManager::setProxyOnly | ( | bool | proxyOnly | ) |
Set whether the proxy should systematically be used for outgoing SOCKS5 bytestream transfers.
void QXmppTransferManager::setSupportedMethods | ( | QXmppTransferJob::Methods | methods | ) |
Set the supported stream methods. This allows you to selectively enable or disable stream methods (In-Band or SOCKS5 bytestreams).
The methods argument is a combination of zero or more QXmppTransferJob::Method.
QString QXmppTransferManager::proxy [read, write] |
Return the JID of the bytestream proxy to use for outgoing transfers.
bool QXmppTransferManager::proxyOnly [read, write] |
Return whether the proxy will systematically be used for outgoing SOCKS5 bytestream transfers.
QXmppTransferJob::Methods QXmppTransferManager::supportedMethods [read, write] |
Return the supported stream methods.
The methods are a combination of zero or more QXmppTransferJob::Method.