KDSoapClientInterface.h

/****************************************************************************
** Copyright (C) 2010-2014 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(SoapVersion version);

    SoapVersion soapVersion();

    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

private:
    friend class KDSoapThreadTask;

    KDSoapClientInterfacePrivate * const d;
};

#endif // KDSOAPCLIENTINTERFACE_H