b955648224
This code predates the public history. I don't know exactly how this worked before, but I guess it's because the QT_USE_NAMESPACE in our headers. If there's _any_ get() function at the global scope, then name lookup stops there and considers _only_ that function. And if that happens to have a compatible signature, good night. Use unqualified lookup instead. That will find the QT_NAMESPACE one, ignoring other overloads at global scope. And when non-namespaced, will emit an ambiguity error in the presence of another matching get() function at global scope. Task-number: QTBUG-111598 Pick-to: 6.5 6.4 6.2 5.15 Change-Id: Iea141ea543193394ba527b414caf31c1f3a2355b Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>
334 lines
11 KiB
C++
334 lines
11 KiB
C++
// Copyright (C) 2016 The Qt Company Ltd.
|
|
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
|
|
|
|
#include "qdbuserror.h"
|
|
|
|
#include <qdebug.h>
|
|
#include <qvarlengtharray.h>
|
|
#include <private/qoffsetstringarray_p.h>
|
|
|
|
#ifndef QT_BOOTSTRAPPED
|
|
#include "qdbus_symbols_p.h"
|
|
#include "qdbusmessage.h"
|
|
#include "qdbusmessage_p.h"
|
|
#endif
|
|
|
|
#ifndef QT_NO_DBUS
|
|
|
|
QT_BEGIN_NAMESPACE
|
|
|
|
QT_IMPL_METATYPE_EXTERN(QDBusError)
|
|
|
|
static constexpr const auto errorMessages = qOffsetStringArray(
|
|
"NoError",
|
|
"other",
|
|
"org.freedesktop.DBus.Error.Failed",
|
|
"org.freedesktop.DBus.Error.NoMemory",
|
|
"org.freedesktop.DBus.Error.ServiceUnknown",
|
|
"org.freedesktop.DBus.Error.NoReply",
|
|
"org.freedesktop.DBus.Error.BadAddress",
|
|
"org.freedesktop.DBus.Error.NotSupported",
|
|
"org.freedesktop.DBus.Error.LimitsExceeded",
|
|
"org.freedesktop.DBus.Error.AccessDenied",
|
|
"org.freedesktop.DBus.Error.NoServer",
|
|
"org.freedesktop.DBus.Error.Timeout",
|
|
"org.freedesktop.DBus.Error.NoNetwork",
|
|
"org.freedesktop.DBus.Error.AddressInUse",
|
|
"org.freedesktop.DBus.Error.Disconnected",
|
|
"org.freedesktop.DBus.Error.InvalidArgs",
|
|
"org.freedesktop.DBus.Error.UnknownMethod",
|
|
"org.freedesktop.DBus.Error.TimedOut",
|
|
"org.freedesktop.DBus.Error.InvalidSignature",
|
|
"org.freedesktop.DBus.Error.UnknownInterface",
|
|
"org.freedesktop.DBus.Error.UnknownObject",
|
|
"org.freedesktop.DBus.Error.UnknownProperty",
|
|
"org.freedesktop.DBus.Error.PropertyReadOnly",
|
|
"org.qtproject.QtDBus.Error.InternalError",
|
|
"org.qtproject.QtDBus.Error.InvalidService",
|
|
"org.qtproject.QtDBus.Error.InvalidObjectPath",
|
|
"org.qtproject.QtDBus.Error.InvalidInterface",
|
|
"org.qtproject.QtDBus.Error.InvalidMember",
|
|
""
|
|
);
|
|
|
|
#ifndef QT_BOOTSTRAPPED
|
|
static inline QDBusError::ErrorType get(const char *name)
|
|
{
|
|
if (!name || !*name)
|
|
return QDBusError::NoError;
|
|
for (int i = 0; i < errorMessages.count(); ++i)
|
|
if (strcmp(name, errorMessages.at(i)) == 0)
|
|
return QDBusError::ErrorType(i);
|
|
return QDBusError::Other;
|
|
}
|
|
#endif
|
|
|
|
/*!
|
|
\class QDBusError
|
|
\inmodule QtDBus
|
|
\since 4.2
|
|
|
|
\brief The QDBusError class represents an error received from the
|
|
D-Bus bus or from remote applications found in the bus.
|
|
|
|
When dealing with the D-Bus bus service or with remote
|
|
applications over D-Bus, a number of error conditions can
|
|
happen. This error conditions are sometimes signalled by a
|
|
returned error value or by a QDBusError.
|
|
|
|
C++ and Java exceptions are a valid analogy for D-Bus errors:
|
|
instead of returning normally with a return value, remote
|
|
applications and the bus may decide to throw an error
|
|
condition. However, the Qt D-Bus implementation does not use the C++
|
|
exception-throwing mechanism, so you will receive QDBusErrors in
|
|
the return reply (see QDBusReply::error()).
|
|
|
|
QDBusError objects are used to inspect the error name and message
|
|
as received from the bus and remote applications. You should not
|
|
create such objects yourself to signal error conditions when
|
|
called from D-Bus: instead, use QDBusMessage::createError() and
|
|
QDBusConnection::send().
|
|
|
|
\sa QDBusConnection::send(), QDBusMessage, QDBusReply
|
|
*/
|
|
|
|
/*!
|
|
\enum QDBusError::ErrorType
|
|
|
|
In order to facilitate verification of the most common D-Bus errors generated by the D-Bus
|
|
implementation and by the bus daemon itself, QDBusError can be compared to a set of pre-defined
|
|
values:
|
|
|
|
\value NoError QDBusError is invalid (i.e., the call succeeded)
|
|
\value Other QDBusError contains an error that is not one of the well-known ones
|
|
\value Failed The call failed (\c org.freedesktop.DBus.Error.Failed)
|
|
\value NoMemory Out of memory (\c org.freedesktop.DBus.Error.NoMemory)
|
|
\value ServiceUnknown The called service is not known
|
|
(\c org.freedesktop.DBus.Error.ServiceUnknown)
|
|
\value NoReply The called method did not reply within the specified timeout
|
|
(\c org.freedesktop.DBus.Error.NoReply)
|
|
\value BadAddress The address given is not valid
|
|
(\c org.freedesktop.DBus.Error.BadAddress)
|
|
\value NotSupported The call/operation is not supported
|
|
(\c org.freedesktop.DBus.Error.NotSupported)
|
|
\value LimitsExceeded The limits allocated to this process/call/connection exceeded the
|
|
pre-defined values (\c org.freedesktop.DBus.Error.LimitsExceeded)
|
|
\value AccessDenied The call/operation tried to access a resource it isn't allowed to
|
|
(\c org.freedesktop.DBus.Error.AccessDenied)
|
|
\value NoServer \e {Documentation doesn't say what this is for}
|
|
(\c org.freedesktop.DBus.Error.NoServer)
|
|
\value Timeout \e {Documentation doesn't say what this is for or how it's used}
|
|
(\c org.freedesktop.DBus.Error.Timeout)
|
|
\value NoNetwork \e {Documentation doesn't say what this is for}
|
|
(\c org.freedesktop.DBus.Error.NoNetwork)
|
|
\value AddressInUse QDBusServer tried to bind to an address that is already in use
|
|
(\c org.freedesktop.DBus.Error.AddressInUse)
|
|
\value Disconnected The call/process/message was sent after QDBusConnection disconnected
|
|
(\c org.freedesktop.DBus.Error.Disconnected)
|
|
\value InvalidArgs The arguments passed to this call/operation are not valid
|
|
(\c org.freedesktop.DBus.Error.InvalidArgs)
|
|
\value UnknownMethod The method called was not found in this object/interface with the
|
|
given parameters (\c org.freedesktop.DBus.Error.UnknownMethod)
|
|
\value TimedOut \e {Documentation doesn't say...}
|
|
(\c org.freedesktop.DBus.Error.TimedOut)
|
|
\value InvalidSignature The type signature is not valid or compatible
|
|
(\c org.freedesktop.DBus.Error.InvalidSignature)
|
|
\value UnknownInterface The interface is not known in this object
|
|
(\c org.freedesktop.DBus.Error.UnknownInterface)
|
|
\value UnknownObject The object path points to an object that does not exist
|
|
(\c org.freedesktop.DBus.Error.UnknownObject)
|
|
\value UnknownProperty The property does not exist in this interface
|
|
(\c org.freedesktop.DBus.Error.UnknownProperty)
|
|
\value PropertyReadOnly The property set failed because the property is read-only
|
|
(\c org.freedesktop.DBus.Error.PropertyReadOnly)
|
|
|
|
\value InternalError An internal error occurred
|
|
|
|
\value InvalidObjectPath The object path provided is invalid.
|
|
|
|
\value InvalidService The service requested is invalid.
|
|
|
|
\value InvalidMember The member is invalid.
|
|
|
|
\value InvalidInterface The interface is invalid.
|
|
*/
|
|
|
|
/*!
|
|
\internal
|
|
Constructs a QDBusError that represents no error.
|
|
*/
|
|
QDBusError::QDBusError()
|
|
: code(NoError)
|
|
{
|
|
// ### This class has an implicit (therefore inline) destructor
|
|
// so the following field cannot be used.
|
|
Q_UNUSED(unused);
|
|
}
|
|
|
|
#ifndef QT_BOOTSTRAPPED
|
|
/*!
|
|
\internal
|
|
Constructs a QDBusError from a DBusError structure.
|
|
*/
|
|
QDBusError::QDBusError(const DBusError *error)
|
|
: code(NoError)
|
|
{
|
|
if (!error || !q_dbus_error_is_set(error))
|
|
return;
|
|
|
|
code = get(error->name);
|
|
msg = QString::fromUtf8(error->message);
|
|
nm = QString::fromUtf8(error->name);
|
|
}
|
|
|
|
/*!
|
|
\internal
|
|
Constructs a QDBusError from a QDBusMessage.
|
|
*/
|
|
QDBusError::QDBusError(const QDBusMessage &qdmsg)
|
|
: code(NoError)
|
|
{
|
|
if (qdmsg.type() != QDBusMessage::ErrorMessage)
|
|
return;
|
|
|
|
code = get(qdmsg.errorName().toUtf8().constData());
|
|
nm = qdmsg.errorName();
|
|
msg = qdmsg.errorMessage();
|
|
}
|
|
#endif
|
|
|
|
/*!
|
|
\internal
|
|
Constructs a QDBusError from a well-known error code
|
|
*/
|
|
QDBusError::QDBusError(ErrorType error, const QString &mess)
|
|
: code(error)
|
|
{
|
|
nm = QLatin1StringView(errorMessages[error]);
|
|
msg = mess;
|
|
}
|
|
|
|
/*!
|
|
\internal
|
|
Constructs a QDBusError from another QDBusError object
|
|
*/
|
|
QDBusError::QDBusError(const QDBusError &other)
|
|
: code(other.code), msg(other.msg), nm(other.nm)
|
|
{
|
|
}
|
|
|
|
/*!
|
|
\internal
|
|
Assignment operator
|
|
*/
|
|
|
|
QDBusError &QDBusError::operator=(const QDBusError &other)
|
|
{
|
|
code = other.code;
|
|
msg = other.msg;
|
|
nm = other.nm;
|
|
return *this;
|
|
}
|
|
|
|
#ifndef QT_BOOTSTRAPPED
|
|
/*!
|
|
\internal
|
|
Assignment operator from a QDBusMessage
|
|
*/
|
|
QDBusError &QDBusError::operator=(const QDBusMessage &qdmsg)
|
|
{
|
|
if (qdmsg.type() == QDBusMessage::ErrorMessage) {
|
|
code = get(qdmsg.errorName().toUtf8().constData());
|
|
nm = qdmsg.errorName();
|
|
msg = qdmsg.errorMessage();
|
|
} else {
|
|
code =NoError;
|
|
nm.clear();
|
|
msg.clear();
|
|
}
|
|
return *this;
|
|
}
|
|
#endif
|
|
|
|
/*!
|
|
Returns this error's ErrorType.
|
|
|
|
\sa ErrorType
|
|
*/
|
|
|
|
QDBusError::ErrorType QDBusError::type() const
|
|
{
|
|
return code;
|
|
}
|
|
|
|
/*!
|
|
Returns this error's name. Error names are similar to D-Bus Interface names, like
|
|
\c org.freedesktop.DBus.InvalidArgs.
|
|
|
|
\sa type()
|
|
*/
|
|
|
|
QString QDBusError::name() const
|
|
{
|
|
return nm;
|
|
}
|
|
|
|
/*!
|
|
Returns the message that the callee associated with this error. Error messages are
|
|
implementation defined and usually contain a human-readable error code, though this does not
|
|
mean it is suitable for your end-users.
|
|
*/
|
|
|
|
QString QDBusError::message() const
|
|
{
|
|
return msg;
|
|
}
|
|
|
|
/*!
|
|
Returns \c true if this is a valid error condition (i.e., if there was an error),
|
|
otherwise false.
|
|
*/
|
|
|
|
bool QDBusError::isValid() const
|
|
{
|
|
return (code != NoError);
|
|
}
|
|
|
|
/*!
|
|
\since 4.3
|
|
Returns the error name associated with error condition \a error.
|
|
*/
|
|
QString QDBusError::errorString(ErrorType error)
|
|
{
|
|
return QLatin1StringView(errorMessages[error]);
|
|
}
|
|
|
|
#ifndef QT_NO_DEBUG_STREAM
|
|
QDebug operator<<(QDebug dbg, const QDBusError &msg)
|
|
{
|
|
QDebugStateSaver saver(dbg);
|
|
dbg.nospace() << "QDBusError(" << msg.name() << ", " << msg.message() << ')';
|
|
return dbg;
|
|
}
|
|
#endif
|
|
|
|
/*!
|
|
\fn void QDBusError::swap(QDBusError &other)
|
|
|
|
Swaps this QDBusError instance with \a other.
|
|
*/
|
|
|
|
QT_END_NAMESPACE
|
|
|
|
#include "moc_qdbuserror.cpp"
|
|
|
|
#endif // QT_NO_DBUS
|
|
|
|
/*
|
|
MSVC2015 has the warning C4503 at the end of the file:
|
|
QtPrivate::StaticStringBuilder<QtPrivate::IndexesList<...> - decorated name length exceeded, name was truncated
|
|
It is used by qOffsetStringArray in a constexpr evaluation and this code does not exist in the object file,
|
|
but we still have the warning or even error with -WX flag
|
|
*/
|
|
QT_WARNING_DISABLE_MSVC(4503)
|