Uploaded image for project: 'Qt'
  1. Qt
  2. QTBUG-103951

Document what Qt provides for serialization and what should be used in different use cases

    XMLWordPrintable

Details

    • User Story
    • Resolution: Fixed
    • P1: Critical
    • 6.4.3, 6.4, 6.5.0
    • 6.4
    • Core: Other
    • None
    • All
    • 13
    • Foundation Sprint 64, Foundation Sprint 65, Foundation Sprint 66, Foundation Sprint 67, Foundation Sprint 68, Foundation Sprint 69, Foundation Sprint 70, Foundation Sprint 71, Foundation Sprint 72
    • bd7f23f34 (6.4), 57a4c0d73 (dev)

    Description

      With the introduction of an overhauled Overview documentation Qt is going to get close to 4 different API for serialization.

      As the implementation is groomed and collected in one folder: 

      https://code.qt.io/cgit/qt/qtbase.git/tree/src/corelib/serialization

      the documentation side is not that advanced... 

      Qt Documentation has a page about serialization (https://doc.qt.io/qt-6/datastreamformat.html) but for some reasons, it does only speaks of Qt data types, whereas there are means for serialization with non-Qt data types too.

      There were attempts to improve and generalize it:

      https://wiki.qt.io/Rethinking_serialization_for_Qt6

      And give an overview:

      https://www.qt.io/blog/2018/05/31/serialization-in-and-with-qt

      With Qt Protocol Buffers, serialization is different, since the use needs to define via proto files and cannot use Qt Protocol Buffers for already existing types.

      As a PM I would like to make sure that Qt users will get an overview of that Qt provides for serialization and some guidance what should or should not be used in which cases

      Additionally, it would be good to make sure that there are examples for all API sets. Some API, for example, QCbor does not have an example app. On the other side QJson provides an example app

      Attachments

        Issue Links

          No reviews matched the request. Check your Options in the drop-down menu of this sections header.

          Activity

            People

              javyas Jaishree Vyas
              vminenko Vladimir Minenko
              Vladimir Minenko Vladimir Minenko
              Alex Blasche Alex Blasche
              Votes:
              0 Vote for this issue
              Watchers:
              6 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved:

                Gerrit Reviews

                  There are 2 open Gerrit changes