container_adapter.h

Go to the documentation of this file.

// BSD 3-Clause License
// Copyright (c) 2021-2025, 🍀☀🌕🌥 🌊
// See the LICENSE file in the project root for full license information.
 
#pragma once
 
#include <kcenon/pacs/core/dicom_dataset.h>
#include <kcenon/pacs/core/dicom_element.h>
#include <kcenon/pacs/core/dicom_tag.h>
#include <kcenon/pacs/encoding/vr_type.h>
 
#include <kcenon/common/patterns/result.h>
 
#include <container.h>
 
#include <cstdint>
#include <span>
#include <string>
#include <vector>
 
namespace kcenon::pacs::integration {
 
class container_adapter {
public:
    template <typename T>
    using Result = kcenon::common::Result<T>;
 
    // =========================================================================
    // VR to Container Value Mapping
    // =========================================================================
 
    [[nodiscard]] static auto to_container_value(const core::dicom_element& element)
        -> container_module::optimized_value;
 
    [[nodiscard]] static auto from_container_value(
        core::dicom_tag tag,
        encoding::vr_type vr,
        const container_module::optimized_value& val) -> core::dicom_element;
 
    // =========================================================================
    // Dataset Serialization
    // =========================================================================
 
    [[nodiscard]] static auto serialize_dataset(const core::dicom_dataset& dataset)
        -> std::shared_ptr<container_module::value_container>;
 
    [[nodiscard]] static auto deserialize_dataset(
        const container_module::value_container& container)
        -> Result<core::dicom_dataset>;
 
    // =========================================================================
    // Binary Serialization
    // =========================================================================
 
    [[nodiscard]] static auto to_binary(const core::dicom_dataset& dataset)
        -> std::vector<uint8_t>;
 
    [[nodiscard]] static auto from_binary(std::span<const uint8_t> data)
        -> Result<core::dicom_dataset>;
 
    // =========================================================================
    // Utility Functions
    // =========================================================================
 
    [[nodiscard]] static auto get_container_type(encoding::vr_type vr) noexcept
        -> container_module::value_types;
 
    [[nodiscard]] static constexpr auto maps_to_string(encoding::vr_type vr) noexcept
        -> bool {
        return encoding::is_string_vr(vr);
    }
 
    [[nodiscard]] static constexpr auto maps_to_numeric(encoding::vr_type vr) noexcept
        -> bool {
        return encoding::is_numeric_vr(vr);
    }
 
    [[nodiscard]] static constexpr auto maps_to_binary(encoding::vr_type vr) noexcept
        -> bool {
        return encoding::is_binary_vr(vr);
    }
 
private:
    static constexpr std::string_view kProtocolVersion = "1.0.0";
 
    static constexpr std::string_view kVersionKey = "_pacs_version";
 
    static constexpr std::string_view kElementCountKey = "_element_count";
 
    [[nodiscard]] static auto make_element_key(core::dicom_tag tag,
                                                encoding::vr_type vr)
        -> std::string;
 
    [[nodiscard]] static auto parse_element_key(std::string_view key)
        -> std::optional<std::pair<core::dicom_tag, encoding::vr_type>>;
 
    [[nodiscard]] static auto sequence_to_container(
        const core::dicom_element& element)
        -> std::shared_ptr<container_module::value_container>;
 
    [[nodiscard]] static auto container_to_sequence(
        const container_module::value_container& container)
        -> std::vector<core::dicom_dataset>;
};
 
}  // namespace kcenon::pacs::integration