QObexServerSession Class Reference
[QtBaseModule]

Handling errors and Abort requests

If an error occurs while running the server, error() will be called with the corresponding error. The server should override this function to perform any clean-up actions that might be necessary.

The error() function is also called when an OBEX client sends an Abort request to cancel a multi-packet request such as Put or Get. When an Abort request is received, the server will automatically respond with QObex::Success and call error() with the error argument set to QObexServerSession::Aborted. Therefore, if a server supports the Put or Get requests, it should override error() so that it can be notified of Abort requests and perform any clean-up actions that might be necessary.

See also QObexClientSession and Simple OBEX Demo.

Member Type Documentation

enum QObexServerSession::Error

These are the errors that may be passed to QObexServerSession::error().

Member Function Documentation

QObexServerSession::QObexServerSession ( QIODevice * device, QObject * parent = 0 )

Constructs an OBEX server session that uses device for the transport connection. The parent is the QObject parent.

The device must be opened, or else the service will be unable to receive any client requests.

QObexServerSession::~QObexServerSession ()   [pure virtual]

Destroys the server session.

void QObexServerSession::authenticationRequired ( QObexAuthenticationChallenge * challenge )   [signal]

This signal is emitted when a client requires the server to authenticate itself before proceeding with the current request.

The challenge provides the details of the authentication challenge sent by the client. The challenge object can then be filled in with the username and password that should be sent back to the client in order to authenticate this server.

The server will not be notified if the client rejects the authentication details provided in challenge; in this case, it is likely that the client will simply disconnect from the server.

This signal is not emitted if the protected slot for the current request has denied the request by returning a response code other than QObex::Success.

Note: It is not possible to use a QueuedConnection to connect to this signal, as the server will not send back a username and password (and so authentication will fail) if the challenge has not been filled in with new information when the signal returns.

void QObexServerSession::authenticationResponse ( const QObexAuthenticationResponse & response, bool * accept )   [signal]

This signal is emitted if the server has previously issued an authentication challenge to indicate that the client must authenticate itself before proceeding with the current request, and the client has now responded with an authentication response containing a username and password for authentication.

Set accept to true if the authentication details in response are correct. If accept is set to true, the corresponding slot for the current request will be called after this signal is emitted. Otherwise, the request will automatically be denied with a QObex::Unauthorized response, and error() will be called with QObexServerSession::AuthenticationFailed.

You can issue an authentication challenge to a client by responding to a request with QObex::Unauthorized and a QObexHeader object that includes an authentication challenge (by calling QObexHeader::setAuthenticationChallenge()).

Note: It is not possible to use a QueuedConnection to connect to this signal, as accept will automatically be set to false if its value has not been set when the signal returns.

void QObexServerSession::close ()

Closes the service. The service will no longer receive client requests.

QObex::ResponseCode QObexServerSession::connect ( const QObexHeader & header )   [protected slot]

Called when a Connect request is received with header.

If your server supports Connect requests, override this slot and return QObex::Success to allow the request to continue. If you return any other response code, the request will be denied. The default implementation returns QObex::NotImplemented.

QObex::ResponseCode QObexServerSession::dataAvailable ( const char * data, qint64 size )   [virtual protected]

Called each time the server receives body data for a Put request. The data is the received data and size is the data length. If size is 0, then all body data has been received.

If your server supports Put requests, override this function to read and store the data. The data will not be buffered and made available elsewhere, so it must be read at this point. Return QObex::Success to allow the request to continue, or any other response code to stop the request.

The default implementation returns QObex::InternalServerError.

See also put().

QObex::ResponseCode QObexServerSession::disconnect ( const QObexHeader & header )   [protected slot]

Called when a Disconnect request is received with header.

If your server supports Disconnect requests, override this slot and return QObex::Success to allow the request to continue. If you return any other response code, the request will be denied. The default implementation returns QObex::NotImplemented.

Note: Clients may terminate the transport connection without sending a Disconnect request, so you should not necessarily expect to receive this request.

void QObexServerSession::error ( QObexServerSession::Error error, const QString & errorString )   [virtual protected]

Called when an error occurs while running the server. The error is the error that has occurred, and errorString is a human-readable description of the error.

Override this to provide custom error handling functionality. The default implementation prints the warning to the console, and also calls close() if the error is QObexServerSession::ConnectionError.

void QObexServerSession::finalResponseSent ( QObex::Request request )   [signal]

This signal is emitted when the server has sent the final response for the specified request.

Note this signal not emitted if the request was aborted, or if the server responded with QObex::NotImplemented because the corresponding request slot was not implemented by this server session.

QObex::ResponseCode QObexServerSession::get ( const QObexHeader & header )   [protected slot]

Called when a Get request is received with header.

If your server supports Get requests, override this slot and return QObex::Success to allow the request to continue. If you return any other response code, the request will be denied. The default implementation returns QObex::NotImplemented.

If you override this slot, you should also override provideData() to provide the body data that will be sent back to the client, and also override error() so you can be notified if the client aborts the request.

See also provideData() and error().

QObex::ResponseCode QObexServerSession::provideData ( const char ** data, qint64 * size )   [virtual protected]

Called each time the server is required to send body data back to the client for a Get request.

If your server supports Get requests, override this function and set data to the body data to be sent and size to the length of the data. If all body data has been sent, set size to zero. Return QObex::Success to allow the request to continue, or any other response code to stop the request.

The default implementation returns QObex::InternalServerError.

Note: The subclass is responsible for ensuring that data remains valid until the next call to provideData(), or until all data has been sent.

See also get().

QObex::ResponseCode QObexServerSession::put ( const QObexHeader & header )   [protected slot]

Called when a Put request is received with header.

If your server supports Put requests, override this slot and return QObex::Success to allow the request to continue. If you return any other response code, the request will be denied. The default implementation returns QObex::NotImplemented.

If you override this slot, you should also override dataAvailable() to read the body data that is received during the request, and also override error() so you can be notified if the client aborts the request.

See also dataAvailable() and error().

QObex::ResponseCode QObexServerSession::putDelete ( const QObexHeader & header )   [protected slot]

Called when a Put-Delete request is received with header.

If your server supports Put-Delete requests, override this slot and return QObex::Success to allow the request to continue. If you return any other response code, the request will be denied. The default implementation returns QObex::NotImplemented.

QIODevice * QObexServerSession::sessionDevice ()

Returns the device used by this server session, as provided in the constructor.

void QObexServerSession::setNextResponseHeader ( const QObexHeader & header )   [protected]

Sets the session to send header in the next server response for the current request.

This might be useful, for example, to give the client some information about the file that is about to be sent back in response to a Get request:

    protected slots:
        QObex::ResponseCode get(const QObexHeader &header)
        {
            QString requestedFilename = header.name();
            QFile file(requestedFilename);
            if (file.open(QIODevice::ReadOnly)) {
                QObexHeader header;
                header.setLength(file.size());
                setNextResponseHeader(header);
            }

            return QObex::Success;
        }

QObex::ResponseCode QObexServerSession::setPath ( const QObexHeader & header, QObex::SetPathFlags flags )   [protected slot]

Called when a SetPath request is received with header and flags.

If your server supports SetPath requests, override this slot and return QObex::Success to allow the request to continue. If you return any other response code, the request will be denied. The default implementation returns QObex::NotImplemented.