summaryrefslogtreecommitdiffstats
path: root/src/jsonstream/qtjsonschema/qjsonschemaerror.cpp
blob: a89dc4ff1679755b307b7014233d6e713085f6e9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
/****************************************************************************
**
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
** Contact: http://www.qt-project.org/legal
**
** This file is part of the QtAddOn.JsonStream module of the Qt.
**
** $QT_BEGIN_LICENSE:LGPL$
** GNU Lesser General Public License Usage
** This file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Digia gives you certain additional
** rights. These rights are described in the Digia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3.0 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file. Please review the following information to
** ensure the GNU General Public License version 3.0 requirements will be
** met: http://www.gnu.org/copyleft/gpl.html.
**
**
** $QT_END_LICENSE$
**
****************************************************************************/

#include "qjsonschemaerror.h"

#include <QStringList>
#include <QDebug>

QT_BEGIN_NAMESPACE_JSONSTREAM

const QString QJsonSchemaError::kCodeStr    = QString::fromLatin1("::code");
const QString QJsonSchemaError::kMessageStr = QString::fromLatin1("::message");
const QString QJsonSchemaError::kSourceStr = QString::fromLatin1("::source");
const QString QJsonSchemaError::kCounterStr = QString::fromLatin1("::count");
const QString QJsonSchemaError::kErrorPrefixStr = QString::fromLatin1("::");

/*!
    \class QJsonSchemaError
    \inmodule QtJsonStream
    \brief The QJsonSchemaError class details error conditions from parsing or
    validating JSON objects and schemas.

    The error object includes a code, human-readable message, and the JSON object
    that caused the error.  It may also include the source file/path of the
    offending object.

    In the case of loading multiple schema files from a folder, there may be
    multiple errors.  In this case, each individual error can be found in
    the subErrors() list.

    \sa QJsonSchemaError::ErrorCode
 */

/*!
     \enum QJsonSchemaError::ErrorCode
     \omitvalue NoError
     \value FailedSchemaValidation
         JSON object failed schema validation
     \value InvalidSchemaOperation
         Error somewhere in the schema itself?
     \value InvalidObject
         The JSON object/schema  could not be parsed.
     \value FailedSchemaFileOpenRead
         Schema file could not be opened or read.
     \value InvalidSchemaFolder
         Schema folder does not exist
     \value InvalidSchemaLoading
         Schema loading errors
     \value SchemaWrongParamType
         Schema attribute has an invalid type
     \value SchemaWrongParamValue
         Schema attribute has an invalid value
 */

/*!
  \fn QJsonSchemaError::QJsonSchemaError()

  Creates an empty schema error object.
*/

/*!
  \fn QJsonSchemaError::QJsonSchemaError(const QJsonObject & data)

  Creates an schema error object pertaining to the JSON object \a data.
*/

/*!
  \fn QJsonObject QJsonSchemaError::object() const

  Returns the JSON object that the error pertains to.  If the error is
  the result of an attempt to load a schema, the object will be the schema object.
*/

/*!
  Creates QJsonSchemaError object with specified error \a code and \a message.
*/
QJsonSchemaError::QJsonSchemaError(ErrorCode code, const QString & message)
{
    m_data.insert(kCodeStr, code);
    m_data.insert(kMessageStr, message);
}

/*!
  Returns an error code of the last schema error.
*/
QJsonSchemaError::ErrorCode QJsonSchemaError::errorCode() const
{
    return m_data.isEmpty() ? QJsonSchemaError::NoError : (QJsonSchemaError::ErrorCode)(m_data.value(kCodeStr).toDouble());
}

/*!
  Returns a human readable description of the last schema error.
*/
QString QJsonSchemaError::errorString() const
{
    return m_data.isEmpty() ? QString() : m_data.value(kMessageStr).toString();
}

/*!
  Returns the source of the last schema error.  This is either a filename
  or directory path.  In the case where a schema or object is loaded directly from
  data, this value will be empty.
*/
QString QJsonSchemaError::errorSource() const
{
    return m_data.isEmpty() ? QString() : m_data.value(kSourceStr).toString();
}

/*!
  Returns a list of sub errors.
*/
QList<QJsonSchemaError> QJsonSchemaError::subErrors() const
{
    QList<QJsonSchemaError> errors;
    foreach (QString key, m_data.keys()) {
        if (!key.startsWith(kErrorPrefixStr)) {
            QJsonObject object(m_data[key].toObject());
            if (object.contains(kCodeStr))
                errors.append(QJsonSchemaError(object));
        }
    }

    return errors;
}

QDebug operator <<(QDebug dbg, const QJsonSchemaError &e)
{
    dbg << "SchemaError(" << e.m_data << ")";
    return dbg;
}

QT_END_NAMESPACE_JSONSTREAM