KDSoapServerObjectInterface.h

/****************************************************************************
** Copyright (C) 2010-2013 Klaralvdalens Datakonsult AB.  All rights reserved.
**
** This file is part of the KD Soap library.
**
** Licensees holding valid commercial KD Soap licenses may use this file in
** accordance with the KD Soap Commercial License Agreement provided with
** the Software.
**
**
** This file may be distributed and/or modified under the terms of the
** GNU Lesser General Public License version 2 and version 3 as published by the
** Free Software Foundation and appearing in the file LICENSE.LGPL.txt included.
**
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
**
** Contact info@kdab.com if any conditions of this licensing are not
** clear to you.
**
**********************************************************************/
#ifndef KDSOAPSERVEROBJECTINTERFACE_H
#define KDSOAPSERVEROBJECTINTERFACE_H

#include "KDSoapServerGlobal.h"
#include <KDSoapClient/KDSoapMessage.h>
#include "KDSoapDelayedResponseHandle.h"

#include <QtCore/QObject>
#include <QIODevice>

class KDSoapServerSocket;

class KDSOAPSERVER_EXPORT KDSoapServerObjectInterface
{
public:
    KDSoapServerObjectInterface();
    virtual ~KDSoapServerObjectInterface();

    virtual void processRequest(const KDSoapMessage& request, KDSoapMessage& response, const QByteArray& soapAction);

    virtual QIODevice* processFileRequest(const QString& path, QByteArray &contentType);

    virtual void processRequestWithPath(const KDSoapMessage& request, KDSoapMessage& response, const QByteArray& soapAction, const QString& path);

    KDSoapHeaders requestHeaders() const;

    QByteArray soapAction() const;

    void setResponseHeaders(const KDSoapHeaders& headers);

    void setResponseNamespace(const QString& ns);

    void setFault(const QString& faultCode, const QString& faultString, const QString& faultActor = QString(), const QString& detail = QString());

    bool hasFault() const;

    KDSoapDelayedResponseHandle prepareDelayedResponse(); // only valid during processRequest()
    bool isDelayedResponse() const; // only valid during processRequest()

    void sendDelayedResponse(const KDSoapDelayedResponseHandle& responseHandle, const KDSoapMessage& response);

private:
    friend class KDSoapServerSocket;
    void setServerSocket(KDSoapServerSocket* serverSocket); // only valid during processRequest()
    void setRequestHeaders(const KDSoapHeaders& headers, const QByteArray& soapAction);
    KDSoapHeaders responseHeaders() const;
    QString responseNamespace() const;
    void storeFaultAttributes(KDSoapMessage& message) const;
    class Private;
    Private* const d;
};

QT_BEGIN_NAMESPACE
Q_DECLARE_INTERFACE(KDSoapServerObjectInterface,
                    "com.kdab.KDSoap.ServerObjectInterface/1.0")
QT_END_NAMESPACE

#endif // KDSOAPSERVEROBJECTINTERFACE_H