KDSoapClientInterface.h

/****************************************************************************
** Copyright (C) 2010-2020 Klaralvdalens Datakonsult AB, a KDAB Group company, info@kdab.com.
** 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.1 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 KDSOAPCLIENTINTERFACE_H
#define KDSOAPCLIENTINTERFACE_H

#include <QtCore/QtGlobal>
#include <QtCore/QString>
#include "KDSoapMessage.h"
#include "KDSoapPendingCall.h"

class KDSoapAuthentication;
class KDSoapSslHandler;
class KDSoapClientInterfacePrivate;
QT_BEGIN_NAMESPACE
class QSslError;
class QSslConfiguration;
class QNetworkCookieJar;
class QNetworkProxy;
QT_END_NAMESPACE

class KDSOAP_EXPORT KDSoapClientInterface
{
public:
    enum SoapVersion {
        SOAP1_1 = 1,
        SOAP1_2 = 2
    };

    explicit KDSoapClientInterface(const QString &endPoint, const QString &messageNamespace);
    ~KDSoapClientInterface();

    KDSoapPendingCall asyncCall(const QString &method, const KDSoapMessage &message,
                                const QString &soapAction = QString(),
                                const KDSoapHeaders &headers = KDSoapHeaders());

    KDSoapMessage call(const QString &method, const KDSoapMessage &message,
                       const QString &soapAction = QString(),
                       const KDSoapHeaders &headers = KDSoapHeaders());

    void callNoReply(const QString &method, const KDSoapMessage &message,
                     const QString &soapAction = QString(),
                     const KDSoapHeaders &headers = KDSoapHeaders());

    void setAuthentication(const KDSoapAuthentication &authentication);

    void setHeader(const QString &name, const KDSoapMessage &header);

    void setSoapVersion(KDSoapClientInterface::SoapVersion version);

    KDSoapClientInterface::SoapVersion soapVersion() const;

    QString endPoint() const;

    void setEndPoint(const QString &endPoint);

    QNetworkCookieJar *cookieJar() const;

    void setCookieJar(QNetworkCookieJar *jar);

    QNetworkProxy proxy() const;

    void setProxy(const QNetworkProxy &proxy);

    void setRawHTTPHeaders(const QMap<QByteArray, QByteArray> &headers);

    enum Style {
        RPCStyle,       
        DocumentStyle   
    };

    void setStyle(Style style);

    Style style() const;

    KDSoapHeaders lastResponseHeaders() const;

    void ignoreSslErrors();

#ifndef QT_NO_OPENSSL

    void ignoreSslErrors(const QList<QSslError> &errors);
#endif

    KDSoapSslHandler *sslHandler() const;

#ifndef QT_NO_OPENSSL

    QSslConfiguration sslConfiguration() const;

    void setSslConfiguration(const QSslConfiguration &config);
#endif

    int timeout() const;

    void setTimeout(int msecs);

private:
    friend class KDSoapThreadTask;

    KDSoapClientInterfacePrivate *const d;
};

#endif // KDSOAPCLIENTINTERFACE_H