// Copyright (C) 2022 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 #include #include #include #include #include #include #include #include QT_BEGIN_NAMESPACE static std::string nullTerminate(QLatin1StringView l1) noexcept { return l1.isNull() ? std::string{} : std::string{l1.data(), size_t(l1.size())}; } /*! \class QProtobufMessage \inmodule QtProtobuf \brief Base class for all protobuf messages. Provides access to the properties of a message, using setProperty() and property(), without depending on what the message is. */ /*! \internal Used from generated classes to construct the QProtobufMessage base class. Internally the \a metaObject is used to query QMetaProperty */ QProtobufMessage::QProtobufMessage(const QMetaObject *metaObject, const QtProtobufPrivate::QProtobufPropertyOrdering *ordering) : d_ptr(new QProtobufMessagePrivate(metaObject, ordering)) { } /*! \internal Allows constructing QProtobufMessage using the private message implementation from the derived class. */ QProtobufMessage::QProtobufMessage(QProtobufMessagePrivate &dd) : d_ptr(&dd) { } QT_DEFINE_QESDP_SPECIALIZATION_DTOR(QProtobufMessagePrivate) QProtobufMessagePrivate::QProtobufMessagePrivate(const QMetaObject *metaObject, const QtProtobufPrivate::QProtobufPropertyOrdering *ordering) : metaObject(metaObject), ordering(ordering) { } QProtobufMessagePrivate::~QProtobufMessagePrivate() = default; /*! \internal */ int QProtobufMessagePrivate::propertyIndex(QAnyStringView propertyName) const { return propertyName.visit([this](auto propertyName) { if constexpr (std::is_same_v) { return metaObject->indexOfProperty(propertyName.toLatin1().constData()); } else if constexpr (std::is_same_v) { return metaObject->indexOfProperty(propertyName.toString().toLatin1().constData()); } else if constexpr (std::is_same_v) { return metaObject->indexOfProperty(nullTerminate(propertyName).data()); } return -1; }); } void QProtobufMessagePrivate::storeUnknownEntry(QProtobufMessage *message, QByteArrayView entry, int fieldNumber) { Q_ASSERT(message); message->d_ptr.detach(); message->d_ptr->unknownEntries[fieldNumber].append(entry.toByteArray()); } std::optional QProtobufMessagePrivate::metaProperty(QAnyStringView name) const { const int index = propertyIndex(name); const QMetaProperty property = metaObject->property(index); if (property.isValid()) return property; return std::nullopt; } std::optional QProtobufMessagePrivate::metaProperty(QtProtobufPrivate::QProtobufFieldInfo info) const { const int propertyIndex = info.propertyIndex() + metaObject->propertyOffset(); const QMetaProperty metaProperty = metaObject->property(propertyIndex); if (metaProperty.isValid()) return metaProperty; return std::nullopt; } /*! Set the property \a propertyName to the value stored in \a value. If the \a propertyName isn't a known fields, then the value is ignored, and the function returns \c false. Returns \c false if it fails to store the \a value on the property. Otherwise \c{true}. */ bool QProtobufMessage::setProperty(QAnyStringView propertyName, const QVariant &value) { Q_D(QProtobufMessage); if (auto mp = d->metaProperty(propertyName)) return mp->writeOnGadget(this, value); return false; } /*! \overload \since 6.6 */ bool QProtobufMessage::setProperty(QAnyStringView propertyName, QVariant &&value) { Q_D(QProtobufMessage); if (auto mp = d->metaProperty(propertyName)) return mp->writeOnGadget(this, std::move(value)); return false; } /*! Get the value of the property \a propertyName. If the \a propertyName isn't known then the returned QVariant is invalid. */ QVariant QProtobufMessage::property(QAnyStringView propertyName) const { Q_D(const QProtobufMessage); if (const auto mp = d->metaProperty(propertyName)) return mp->readOnGadget(this); return {}; } /*! \internal */ QProtobufMessage::QProtobufMessage(const QProtobufMessage &other) = default; /*! \internal */ QProtobufMessage &QProtobufMessage::operator=(const QProtobufMessage &other) = default; /*! \internal */ QProtobufMessage::~QProtobufMessage() = default; /*! \since 6.8 Returns the pointer to the property ordering of the derived protobuf message. */ const QtProtobufPrivate::QProtobufPropertyOrdering *QProtobufMessage::propertyOrdering() const { Q_D(const QProtobufMessage); return d->ordering; } /*! \internal */ bool comparesEqual(const QProtobufMessage &lhs, const QProtobufMessage &rhs) noexcept { if (lhs.d_ptr == rhs.d_ptr) return true; return lhs.d_func()->unknownEntries == rhs.d_func()->unknownEntries; } namespace QtProtobufPrivate { /*! \internal */ extern QProtobufMessagePointer constructMessageByName(const QString &messageType); } /*! Constructs QProtobufMessage using \a messageType. Returns a pointer to the constructed QProtobufMessage. This function attempts to create a message with a type that matches \a messageType. If \a messageType is unknown, the function returns \nullptr. If the message is not found in the registry, the function returns \nullptr. The function caller is given ownership of the constructed message. */ QProtobufMessagePointer QProtobufMessage::constructByName(const QString &messageType) { return QtProtobufPrivate::constructMessageByName(messageType); } /*! \typedef QProtobufMessagePointer \relates QProtobufMessage \inmodule QtProtobuf Synonym for std::unique_ptr. Use this to manage the lifetime of dynamically allocated QProtobufMessages, such as those created by calling QProtobufMessage::constructByName. */ /*! \class QProtobufMessageDeleter \inmodule QtProtobuf \brief Calls the destructor of the child class of a QProtobufMessage. This class calls the destructor of a protobuf message using the meta-type system. It is intended to be used with smart pointers, such as std::unique_ptr. \sa QProtobufMessagePointer */ /*! Destroys the message pointed to by \a ptr. This is intended for use with smart pointers. \sa QProtobufMessagePointer */ void QProtobufMessageDeleter::operator()(QProtobufMessage *ptr) const noexcept { if (!ptr) return; const QMetaObject *mobj = ptr->d_ptr->metaObject; QMetaType type = mobj->metaType(); type.destroy(ptr); } /*! Returns the field numbers that were not known to QtProtobuf during deserialization. \since 6.7 */ QList QProtobufMessage::unknownFieldNumbers() const { Q_D(const QProtobufMessage); return d->unknownEntries.keys(); } /*! Returns the unknown \a field values sorted as they were received from the wire. \since 6.7 */ QList QProtobufMessage::unknownFieldData(qint32 field) const { Q_D(const QProtobufMessage); return d->unknownEntries.value(field); } /*! \since 6.8 Serializes this protobuf message into a QByteArray using \a serializer. \sa deserialize() */ QByteArray QProtobufMessage::serialize(QAbstractProtobufSerializer *serializer) const { return serializer->serialize(this); } /*! \since 6.8 Deserializes this protobuf message from a QByteArray \a data using \a serializer. Returns \c true if deserialization was successful, otherwise \c false. \sa serialize() */ bool QProtobufMessage::deserialize(QAbstractProtobufSerializer *serializer, QByteArrayView data) { return serializer->deserialize(this, data); } static bool isProtobufMessage(QMetaType type) { if (const auto *mo = type.metaObject(); mo && mo->inherits(&QProtobufMessage::staticMetaObject)) return true; return false; } using StaticMetaCallFn = void (*)(QObject *, QMetaObject::Call, int, void **); QMetaObject *buildMetaObject(QMetaType key, QMetaType value, StaticMetaCallFn metaCall) { using namespace Qt::StringLiterals; QMetaObjectBuilder builder; builder.addProperty("key", key.name(), key); if (isProtobufMessage(key)) { auto propBuilder = builder.addProperty("has_key", "bool", QMetaType(QMetaType::Bool)); propBuilder.setWritable(false); } builder.addProperty("value", value.name(), value); if (isProtobufMessage(value)) { auto propBuilder = builder.addProperty("has_value", "bool", QMetaType(QMetaType::Bool)); propBuilder.setWritable(false); } builder.setClassName("QProtobufMapEntry<"_ba + key.name() + ", " + value.name() + '>'); builder.setSuperClass(&QProtobufMapEntryBase::staticMetaObject); builder.setStaticMetacallFunction(metaCall); builder.setFlags(MetaObjectFlag::PropertyAccessInStaticMetaCall); return builder.toMetaObject(); } QtProtobufPrivate::FieldFlags getFlagForType(QMetaType type) { using FieldFlag = QtProtobufPrivate::FieldFlag; QtProtobufPrivate::FieldFlags flag = {}; if (isProtobufMessage(type)) flag |= FieldFlag::Message | FieldFlag::ExplicitPresence; if (type.flags() & QMetaType::IsEnumeration) flag |= FieldFlag::Enum; if (QByteArrayView(type.name()).startsWith("QList<")) // Surely there's a better way flag |= FieldFlag::Repeated; if (QByteArrayView(type.name()).startsWith("QHash<")) // Surely there's a better way flag |= FieldFlag::Map; flag |= FieldFlag::Optional; // Hardcoded for MapEntry uses... // Need to get this info:: // NonPacked = 0x1, // Oneof = 0x02, // Optional = 0x04, // Repeated = 0x40, // Map = 0x80, return flag; } QtProtobufPrivate::QProtobufPropertyOrdering::Data *buildMapEntryOrdering(QMetaType key, QMetaType value) { using namespace QtProtobufPrivate; QProtobufPropertyOrderingBuilder builder("MapEntry"); const auto keyFlags = getFlagForType(key); builder.addV0Field("key", 1, 0, keyFlags); const uint valueIndex = keyFlags.testFlag(FieldFlag::ExplicitPresence) ? 2 : 1; builder.addV0Field("value", 2, valueIndex, getFlagForType(value)); return builder.build(); } class QProtobufMapEntryBasePrivate : public QProtobufMessagePrivate { Q_DISABLE_COPY_MOVE(QProtobufMapEntryBasePrivate) public: QProtobufMapEntryBasePrivate(QMetaType key, QMetaType value, StaticMetaCallFn metaCall); ~QProtobufMapEntryBasePrivate() override; QtProtobufPrivate::QProtobufPropertyOrdering::Data *data = nullptr; QtProtobufPrivate::QProtobufPropertyOrdering mutableOrdering{}; QMetaObject *mutableMetaObject = nullptr; }; QProtobufMapEntryBase::QProtobufMapEntryBase(QMetaType key, QMetaType value, StaticMetaCallFn metaCall) : QProtobufMessage(*new QProtobufMapEntryBasePrivate(key, value, metaCall)) { } QProtobufMapEntryBasePrivate::QProtobufMapEntryBasePrivate(QMetaType key, QMetaType value, StaticMetaCallFn metaCall) : QProtobufMessagePrivate(), data(buildMapEntryOrdering(key, value)), mutableMetaObject(buildMetaObject(key, value, metaCall)) { mutableOrdering.data = data; QProtobufMessagePrivate::ordering = &mutableOrdering; QProtobufMessagePrivate::metaObject = mutableMetaObject; } QProtobufMapEntryBase::~QProtobufMapEntryBase() = default; QProtobufMapEntryBasePrivate::~QProtobufMapEntryBasePrivate() { data->~Data(); free(data); free(mutableMetaObject); } QT_END_NAMESPACE #include "moc_qprotobufmessage.cpp"