[22202] JSON to DynamicData deserializer

[juanlofer-eprosima]

Description

This PR is a follow-up of #4780, in which a DynamicData to JSON serializer was introduced. Here a new utility method is introduced to perform the inverse transformation, i.e. from JSON to DynamicData. In addition, json_serialize method has been modified to:

• Handle enums with base type other that int32
• Improve wide characters and strings handling
• Increase overall robustness
• Decrease 'complexity' through higher encapsulation

Contributor Checklist

• Commit messages follow the project guidelines.
• The code follows the style guidelines of this project.
• Tests that thoroughly check the new feature have been added/Regression tests checking the bug and its fix have been added; the added tests pass locally
• Any new/modified methods have been properly documented using Doxygen.
• N/A Any new configuration API has an equivalent XML API (with the corresponding XSD extension)
• N/A Changes are backport compatible: they do NOT break ABI nor change library core behavior.
• Changes are API compatible.
• New feature has been added to the versions.md file (if applicable).
• New feature has been documented/Current behavior is correctly described in the documentation.
  • Related documentation PR: [22202] JSON to DynamicData deserializer Fast-DDS-docs#1093
• N/A Applicable backports have been included in the description.

Reviewer Checklist

• The PR has a milestone assigned.
• The title and description correctly express the PR's purpose.
• Check contributor checklist is correct.
• If this is a critical bug fix, backports to the critical-only supported branches have been requested.
• Check CI results: changes do not issue any warning.
• Check CI results: failing tests are unrelated with the changes.

[Copilot]

Pull Request Overview

This PR introduces a JSON-to-DynamicData deserializer (json_deserialize), integrates it into the public utils API, and adds round-trip tests to verify JSON serialization and deserialization.

• Add json_deserialize entry point in utils.hpp/utils.cpp and implement logic in json_dynamic_data.hpp/.cpp.
• Update CMakeLists and versions.md to include the new deserializer.
• Extend unit and feature tests to cover JSON → DynamicData deserialization and round-trip equality.

Reviewed Changes

Copilot reviewed 17 out of 17 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/cpp/fastdds/xtypes/utils.hpp / utils.cpp	Expose and implement json_deserialize wrapper
src/cpp/fastdds/xtypes/serializers/json/json_dynamic_data.hpp / .cpp	Core JSON → DynamicData logic
src/cpp/fastdds/xtypes/serializers/json/dynamic_data_json.hpp / .cpp	Adjust array/element parameter naming and include fixes
test/unittest/dds/xtypes/serializers/json/DynDataJSONTests.cpp	Add deserialization and round-trip assertions
test/feature/dynamic_types/DynamicTypesTests.cpp	Include JSON deserialization in feature tests
src/cpp/CMakeLists.txt / versions.md	Register new source file and document new feature

Comments suppressed due to low confidence (2)

test/unittest/dds/xtypes/serializers/json/DynDataJSONTests.cpp:83

• Consider adding negative tests for json_deserialize, such as invalid JSON input and type-mismatch cases, to verify error handling and return codes.

            EXPECT_TRUE(dyn_data->equals(dyn_data_from_json));

versions.md:25

• [nitpick] For consistency with other list entries, add a space after the leading asterisk: * Add new JSON to DynamicData deserializer....

* Add new JSON to DynamicData deserializer (`json_deserialize`).

[Carlosespicur]

LGTM