uid_mapping.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/common/patterns/result.h>
 
#include <atomic>
#include <chrono>
#include <map>
#include <mutex>
#include <optional>
#include <shared_mutex>
#include <string>
#include <string_view>
 
namespace kcenon::pacs::security {
 
class uid_mapping {
public:
    uid_mapping() = default;
 
    explicit uid_mapping(std::string uid_root);
 
    uid_mapping(const uid_mapping& other);
 
    uid_mapping(uid_mapping&& other) noexcept;
 
    auto operator=(const uid_mapping& other) -> uid_mapping&;
 
    auto operator=(uid_mapping&& other) noexcept -> uid_mapping&;
 
    ~uid_mapping() = default;
 
    // ========================================================================
    // Mapping Operations
    // ========================================================================
 
    [[nodiscard]] auto get_or_create(std::string_view original_uid)
        -> kcenon::common::Result<std::string>;
 
    [[nodiscard]] auto get_anonymized(std::string_view original_uid) const
        -> std::optional<std::string>;
 
    [[nodiscard]] auto get_original(std::string_view anonymized_uid) const
        -> std::optional<std::string>;
 
    [[nodiscard]] auto add_mapping(
        std::string_view original_uid,
        std::string_view anonymized_uid
    ) -> kcenon::common::VoidResult;
 
    // ========================================================================
    // Query Operations
    // ========================================================================
 
    [[nodiscard]] auto has_mapping(std::string_view original_uid) const -> bool;
 
    [[nodiscard]] auto size() const -> std::size_t;
 
    [[nodiscard]] auto empty() const -> bool;
 
    // ========================================================================
    // Management Operations
    // ========================================================================
 
    void clear();
 
    auto remove(std::string_view original_uid) -> bool;
 
    // ========================================================================
    // Persistence Operations
    // ========================================================================
 
    [[nodiscard]] auto to_json() const -> std::string;
 
    [[nodiscard]] auto from_json(std::string_view json)
        -> kcenon::common::VoidResult;
 
    auto merge(const uid_mapping& other) -> std::size_t;
 
    // ========================================================================
    // UID Generation
    // ========================================================================
 
    void set_uid_root(std::string root);
 
    [[nodiscard]] auto get_uid_root() const -> std::string;
 
    [[nodiscard]] auto generate_uid() const -> std::string;
 
private:
    std::string uid_root_{"1.2.826.0.1.3680043.8.498.1"};
 
    std::map<std::string, std::string, std::less<>> original_to_anon_;
 
    std::map<std::string, std::string, std::less<>> anon_to_original_;
 
    mutable std::atomic<std::uint64_t> uid_counter_{0};
 
    mutable std::shared_mutex mutex_;
};
 
} // namespace kcenon::pacs::security