KDSoapValue.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 KDSOAPVALUE_H
#define KDSOAPVALUE_H

#include <QtCore/QString>
#include <QtCore/QVariant>
#include <QtCore/QList>
#include <QtCore/QPair>
#include <QtCore/QSet>
#include <QtCore/QVector>
#include <QtCore/QSharedDataPointer>
#include "KDSoapGlobal.h"

#ifndef QT_NO_STL
# include <algorithm>
#endif

// Qt-4.7 errors on QVariant::fromValue<signed char>(), but later versions support it.
#if QT_VERSION < 0x040800
Q_DECLARE_METATYPE(signed char)
#endif

class KDSoapValueList;
class KDSoapNamespacePrefixes;
QT_BEGIN_NAMESPACE
class QXmlStreamWriter;
QT_END_NAMESPACE

class KDSOAP_EXPORT KDSoapValue
{
public:
    KDSoapValue();
    ~KDSoapValue();

    KDSoapValue(const QString& name, const QVariant& valueVariant, const QString& typeNameSpace = QString(), const QString& typeName = QString());
    KDSoapValue(const QString& name, const KDSoapValueList& childValues, const QString& typeNameSpace = QString(), const QString& typeName = QString());

    KDSoapValue(const KDSoapValue& other);

    KDSoapValue& operator=(const KDSoapValue& other) {
        if ( this != &other ) {
            KDSoapValue copy( other );
            swap( copy );
        }
        return *this;
    }

    void swap( KDSoapValue& other ) {
#if QT_VERSION < 0x040600
        qSwap( reinterpret_cast<Private*&>(d), reinterpret_cast<Private*&>(other.d) );
#else
        d.swap( other.d );
#endif
    }

    bool isNull() const;

    bool isNil() const;

    void setNillable(bool nillable);

    QString name() const;

    QString namespaceUri() const;

    void setNamespaceUri(const QString& ns);

    QVariant value() const;

    void setValue(const QVariant& value);

    bool isQualified() const;

    void setQualified(bool qualified);

    KDSoapValueList& childValues() const;

    bool operator==(const KDSoapValue& other) const;

    bool operator!=(const KDSoapValue& other) const;

    void setType(const QString& nameSpace, const QString& type);
    QString typeNs() const;
    QString type() const;

    enum Use
    {
      LiteralUse, 
      EncodedUse  
    };

    QByteArray toXml(Use use = LiteralUse, const QString& messageNamespace = QString()) const;

private:
    // To catch mistakes
    KDSoapValue(QString, QString, QString);

    friend class KDSoapMessageWriter;
    void writeElement(KDSoapNamespacePrefixes& namespacePrefixes, QXmlStreamWriter& writer, KDSoapValue::Use use, const QString& messageNamespace, bool forceQualified) const;
    void writeElementContents(KDSoapNamespacePrefixes& namespacePrefixes, QXmlStreamWriter& writer, KDSoapValue::Use use, const QString& messageNamespace) const;
    void writeChildren(KDSoapNamespacePrefixes& namespacePrefixes, QXmlStreamWriter& writer, KDSoapValue::Use use, const QString& messageNamespace, bool forceQualified) const;

    class Private;
    QSharedDataPointer<Private> d;
};

Q_DECLARE_TYPEINFO( KDSoapValue, Q_MOVABLE_TYPE );

KDSOAP_EXPORT QDebug operator <<(QDebug dbg, const KDSoapValue &value);

KDSOAP_EXPORT uint qHash( const KDSoapValue& value );
inline void qSwap( KDSoapValue & lhs, KDSoapValue & rhs ) { lhs.swap( rhs ); }

#ifndef QT_NO_STL
namespace std {
    template <> inline void swap<KDSoapValue>( KDSoapValue & lhs, KDSoapValue & rhs ) {
        lhs.swap( rhs );
    }
}
#endif

class KDSOAP_EXPORT KDSoapValueList : public QList<KDSoapValue> //krazy:exclude=dpointer
{
public:
    void addArgument(const QString& argumentName, const QVariant& argumentValue, const QString& typeNameSpace = QString(), const QString& typeName = QString());

    KDSoapValue child(const QString& name) const;

    void setArrayType(const QString& nameSpace, const QString& type);
    QString arrayTypeNs() const;
    QString arrayType() const;

    QList<KDSoapValue>& attributes() { return m_attributes; }
    const QList<KDSoapValue>& attributes() const { return m_attributes; }

private:
    QPair<QString, QString> m_arrayType;
    QList<KDSoapValue> m_attributes;

    QVariant d; // for extensions
};

typedef QListIterator<KDSoapValue> KDSoapValueListIterator;

//Q_DECLARE_METATYPE(KDSoapValueList)

#endif // KDSOAPVALUE_H