Providing protobuf and gRPC support for Qt.
Go to file
Alexey Edelev d6586d97a1 Long live mutable getters
The functionality is desirable by some users, we re-enable it.
New API addresses the core issue that is partially related to
QTBUG-119912, but has wider concequences in blind use in user
projects. We add the 'mut' prefix to all mutable getters to make
the mutable access explicit. Overload approach leads to unwanted
detaches not only whe is used be moc-generated code, but also
in user projects if developers do not pay enough attention to
const modifiers of their variables/references. We declined to
restore it, dispite it was the better looking API, in favor to
the code safety.

This also reveals the code clashing scenario, when the overload
might happen if the message has both 'a' and 'mutA' fields in
its definition. This scenario is kindly forbidden by our generator,
and sanitized at very early stages. We expect that it won't happen
in user projects, but even if it will, the solution is to rename
the field when generating Qt code. The serialization/deserialization
do not depend on field naming directly. json_name attribute also
will help to workaround this.

The undocumented ALLOW_MUTABLE_GETTER_CONFLICTS option allows clashing
the mutable getter names, but its usage currently limited by our
internal code only. The reason unfixed QTBUG-119912 issue in moc.
Once the issue is fixed, the moc version check should get the proper
version, but not '99' as for now and the ALLOW_MUTABLE_GETTER_CONFLICTS
will become public.

Another design solution is the use of overloaded functions that
return pointers, like it's done it the reference protobuf. But this
kind of API leaves the pointer ownership undefined and decided to
not be used.

[ChangeLog][Protobuf] The generated messages now have the mutable
getters for the fiels of the message type. The getters have 'mut'
prefix and implicily allocate the respective fields if needed, so the
use of intermediate message objects is not required.

Task-number: QTBUG-119913
Change-Id: I09b9ee37e1fbbe37b9c3cb501e92442da8ad3e4b
Reviewed-by: Dennis Oberst <dennis.oberst@qt.io>
2025-04-04 17:45:22 +02:00
LICENSES Add REUSE.toml files and missing licenses 2024-11-06 14:24:23 +01:00
cmake Point to 'protoc' installation guide when WrapProtoc is not found 2025-02-25 11:10:11 +01:00
coin Fix Axivion analysis configuration for protobuf 2025-03-10 08:47:43 +02:00
examples Add the hint to find the host grpc_cpp_plugin when crosscompiling 2025-03-18 18:08:13 +01:00
src Long live mutable getters 2025-04-04 17:45:22 +02:00
tests Long live mutable getters 2025-04-04 17:45:22 +02:00
.clang-format Update licensing of files with infrastructure type 2025-03-13 15:14:53 +01:00
.cmake.conf Bump version to 6.10.0 2025-01-03 14:15:12 +00:00
.gitattributes Add missing .gitattributes and .tag files 2023-01-18 12:03:33 +02:00
.gitignore gitignore: add qmlls.ini files 2024-12-06 14:02:16 +01:00
.gitreview Add .gitreview file 2025-02-25 15:39:48 +01:00
.tag Add missing .gitattributes and .tag files 2023-01-18 12:03:33 +02:00
CMakeLists.txt Add the missing lookup for QuickTest component 2024-03-11 18:00:41 +01:00
LICENSE.Apache-2.0.txt Add REUSE.toml files and missing licenses 2024-11-06 14:24:23 +01:00
REUSE.toml Update licensing of files with infrastructure type 2025-03-13 15:14:53 +01:00
configure.cmake Long live qtprotobufgen 2022-11-08 10:33:39 +01:00
dependencies.yaml Update dependencies on 'dev' in qt/qtgrpc 2025-04-03 15:51:12 +00:00
licenseRule.json Update licensing of files with infrastructure type 2025-03-13 15:14:53 +01:00
qt_attribution.json Doc: Split up protobuf attributions between tools and tests 2025-01-28 17:33:28 +01:00
qt_cmdline.cmake Long live qtprotobufgen 2022-11-08 10:33:39 +01:00