#include <uid_mapping.h>

Collaboration diagram for kcenon::pacs::security::uid_mapping:

Public Member Functions
	uid_mapping ()=default
	Default constructor - creates empty mapping.

	uid_mapping (std::string uid_root)
	Constructor with custom UID root.

	uid_mapping (const uid_mapping &other)
	Copy constructor (creates independent copy of mappings)

	uid_mapping (uid_mapping &&other) noexcept
	Move constructor.

auto	operator= (const uid_mapping &other) -> uid_mapping &
	Copy assignment.

auto	operator= (uid_mapping &&other) noexcept -> uid_mapping &
	Move assignment.

	~uid_mapping ()=default
	Default destructor.

auto	get_or_create (std::string_view original_uid) -> kcenon::common::Result< std::string >
	Get existing mapping or create new one.

auto	get_anonymized (std::string_view original_uid) const -> std::optional< std::string >
	Get existing mapping without creating new one.

auto	get_original (std::string_view anonymized_uid) const -> std::optional< std::string >
	Get original UID from anonymized UID (reverse lookup)

auto	add_mapping (std::string_view original_uid, std::string_view anonymized_uid) -> kcenon::common::VoidResult
	Add a specific mapping.

auto	has_mapping (std::string_view original_uid) const -> bool
	Check if an original UID has been mapped.

auto	size () const -> std::size_t
	Get the number of mappings.

auto	empty () const -> bool
	Check if the mapping is empty.

void	clear ()
	Clear all mappings.

auto	remove (std::string_view original_uid) -> bool
	Remove a specific mapping.

auto	to_json () const -> std::string
	Export mappings to JSON format.

auto	from_json (std::string_view json) -> kcenon::common::VoidResult
	Import mappings from JSON format.

auto	merge (const uid_mapping &other) -> std::size_t
	Merge mappings from another uid_mapping.

void	set_uid_root (std::string root)
	Set the UID root for generated UIDs.

auto	get_uid_root () const -> std::string
	Get the current UID root.

auto	generate_uid () const -> std::string
	Generate a new unique UID.

Private Attributes
std::string	uid_root_ {"1.2.826.0.1.3680043.8.498.1"}
	UID root for generated UIDs (default: pacs_system root)

std::map< std::string, std::string, std::less<> >	original_to_anon_
	Forward mapping: original -> anonymized.

std::map< std::string, std::string, std::less<> >	anon_to_original_
	Reverse mapping: anonymized -> original.

std::atomic< std::uint64_t >	uid_counter_ {0}
	Counter for UID generation.

std::shared_mutex	mutex_
	Mutex for thread-safe access.

Detailed Description

Examples: dcm_anonymize/main.cpp.

Definition at line 59 of file uid_mapping.h.

Constructor & Destructor Documentation

◆ uid_mapping() [1/4]

kcenon::pacs::security::uid_mapping::uid_mapping ( )

default

Default constructor - creates empty mapping.

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

◆ uid_mapping() [2/4]

kcenon::pacs::security::uid_mapping::uid_mapping ( std::string uid_root )

explicit

Constructor with custom UID root.

Parameters

uid_root Custom root for generated UIDs (e.g., "1.2.3.4")

Definition at line 20 of file uid_mapping.cpp.

21 : uid_root_{std::move(uid_root)} {}

kcenon::pacs::security::uid_mapping::uid_root_

std::string uid_root_

UID root for generated UIDs (default: pacs_system root)

Definition uid_mapping.h:237

◆ uid_mapping() [3/4]

kcenon::pacs::security::uid_mapping::uid_mapping ( const uid_mapping & other )

Copy constructor (creates independent copy of mappings)

Definition at line 23 of file uid_mapping.cpp.

                                                 {
    std::shared_lock lock(other.mutex_);
    uid_root_ = other.uid_root_;
    original_to_anon_ = other.original_to_anon_;
    anon_to_original_ = other.anon_to_original_;
    uid_counter_.store(other.uid_counter_.load());
}

References anon_to_original_, original_to_anon_, kcenon::pacs::security::other, uid_counter_, and uid_root_.

◆ uid_mapping() [4/4]

kcenon::pacs::security::uid_mapping::uid_mapping ( uid_mapping && other )

noexcept

Move constructor.

Definition at line 31 of file uid_mapping.cpp.

                                                     {
    std::unique_lock lock(other.mutex_);
    uid_root_ = std::move(other.uid_root_);
    original_to_anon_ = std::move(other.original_to_anon_);
    anon_to_original_ = std::move(other.anon_to_original_);
    uid_counter_.store(other.uid_counter_.load());
}

References kcenon::pacs::security::other.

◆ ~uid_mapping()

kcenon::pacs::security::uid_mapping::~uid_mapping ( )

default

Default destructor.

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

Member Function Documentation

◆ add_mapping()

auto kcenon::pacs::security::uid_mapping::add_mapping	(	std::string_view	original_uid,
		std::string_view	anonymized_uid ) -> kcenon::common::VoidResult

nodiscard

Add a specific mapping.

Adds a mapping between original and anonymized UIDs. Fails if the original UID is already mapped to a different value.

Parameters

original_uid	The original UID
anonymized_uid	The anonymized UID

Returns: Result indicating success or error

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

Definition at line 111 of file uid_mapping.cpp.

                            {
    std::unique_lock lock(mutex_);
 
    auto existing = original_to_anon_.find(original_uid);
    if (existing != original_to_anon_.end()) {
        if (existing->second != anonymized_uid) {
            return kcenon::common::make_error<std::monostate>(
                1,
                "Original UID already mapped to different value",
                "uid_mapping"
            );
        }
        return kcenon::common::ok();
    }
 
    std::string original_str{original_uid};
    std::string anon_str{anonymized_uid};
 
    original_to_anon_[original_str] = anon_str;
    anon_to_original_[anon_str] = original_str;
 
    return kcenon::common::ok();
}

◆ clear()

void kcenon::pacs::security::uid_mapping::clear ( )

Clear all mappings.

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

Definition at line 153 of file uid_mapping.cpp.

                        {
    std::unique_lock lock(mutex_);
    original_to_anon_.clear();
    anon_to_original_.clear();
}

References anon_to_original_, mutex_, and original_to_anon_.

◆ empty()

auto kcenon::pacs::security::uid_mapping::empty ( ) const -> bool

nodiscard

Check if the mapping is empty.

Returns: true if no mappings exist

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h, and dcm_anonymize/main.cpp.

Definition at line 148 of file uid_mapping.cpp.

                                      {
    std::shared_lock lock(mutex_);
    return original_to_anon_.empty();
}

References mutex_, and original_to_anon_.

Referenced by main().

Here is the caller graph for this function:

◆ from_json()

auto kcenon::pacs::security::uid_mapping::from_json ( std::string_view json ) -> kcenon::common::VoidResult

nodiscard

Import mappings from JSON format.

Parameters

json	JSON string containing mappings

Returns: Result indicating success or error

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h, and dcm_anonymize/main.cpp.

Definition at line 198 of file uid_mapping.cpp.

                              {
    // Simple JSON parsing - in production, use a proper JSON library
    // This is a placeholder implementation
    return kcenon::common::make_error<std::monostate>(
        1, "JSON parsing not yet implemented", "uid_mapping"
    );
}

◆ generate_uid()

auto kcenon::pacs::security::uid_mapping::generate_uid ( ) const -> std::string

nodiscard

Generate a new unique UID.

Returns: A new UID string

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

Definition at line 233 of file uid_mapping.cpp.

                                                  {
    // Generate UID based on timestamp and counter
    auto now = std::chrono::system_clock::now();
    auto timestamp = std::chrono::duration_cast<std::chrono::microseconds>(
        now.time_since_epoch()
    ).count();
 
    auto counter = uid_counter_.fetch_add(1);
 
    // Random component for additional uniqueness
    std::random_device rd;
    std::mt19937 gen(rd());
    std::uniform_int_distribution<std::uint32_t> dist(0, 999999);
    auto random_part = dist(gen);
 
    std::ostringstream oss;
    oss << uid_root_ << "." << timestamp << "." << counter << "." << random_part;
 
    return oss.str();
}

References uid_counter_, and uid_root_.

◆ get_anonymized()

auto kcenon::pacs::security::uid_mapping::get_anonymized ( std::string_view original_uid ) const -> std::optional<std::string>

nodiscard

Get existing mapping without creating new one.

Parameters

original_uid The original UID to look up

Returns: Optional containing the anonymized UID, or nullopt if not found

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

Definition at line 91 of file uid_mapping.cpp.

                              {
    std::shared_lock lock(mutex_);
    auto it = original_to_anon_.find(original_uid);
    if (it != original_to_anon_.end()) {
        return it->second;
    }
    return std::nullopt;
}

◆ get_or_create()

auto kcenon::pacs::security::uid_mapping::get_or_create ( std::string_view original_uid ) -> kcenon::common::Result<std::string>

nodiscard

Get existing mapping or create new one.

If the original UID has been mapped before, returns the existing anonymized UID. Otherwise, generates a new UID and stores the mapping.

Parameters

original_uid The original UID to map

Returns: Result containing the anonymized UID

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

Definition at line 61 of file uid_mapping.cpp.

                                     {
    // First try read-only lookup
    {
        std::shared_lock lock(mutex_);
        auto it = original_to_anon_.find(original_uid);
        if (it != original_to_anon_.end()) {
            return it->second;
        }
    }
 
    // Need to create new mapping - upgrade to write lock
    std::unique_lock lock(mutex_);
 
    // Double-check after acquiring write lock
    auto it = original_to_anon_.find(original_uid);
    if (it != original_to_anon_.end()) {
        return it->second;
    }
 
    // Generate new UID
    auto new_uid = generate_uid();
    std::string original_str{original_uid};
 
    original_to_anon_[original_str] = new_uid;
    anon_to_original_[new_uid] = original_str;
 
    return new_uid;
}

Referenced by kcenon::pacs::security::anonymizer::apply_action().

Here is the caller graph for this function:

◆ get_original()

auto kcenon::pacs::security::uid_mapping::get_original ( std::string_view anonymized_uid ) const -> std::optional<std::string>

nodiscard

Get original UID from anonymized UID (reverse lookup)

Parameters

anonymized_uid The anonymized UID to look up

Returns: Optional containing the original UID, or nullopt if not found

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

Definition at line 101 of file uid_mapping.cpp.

                              {
    std::shared_lock lock(mutex_);
    auto it = anon_to_original_.find(anonymized_uid);
    if (it != anon_to_original_.end()) {
        return it->second;
    }
    return std::nullopt;
}

◆ get_uid_root()

auto kcenon::pacs::security::uid_mapping::get_uid_root ( ) const -> std::string

nodiscard

Get the current UID root.

Returns: The UID root string

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

Definition at line 228 of file uid_mapping.cpp.

                                                  {
    std::shared_lock lock(mutex_);
    return uid_root_;
}

References mutex_, and uid_root_.

◆ has_mapping()

auto kcenon::pacs::security::uid_mapping::has_mapping ( std::string_view original_uid ) const -> bool

nodiscard

Check if an original UID has been mapped.

Parameters

original_uid The original UID to check

Returns: true if a mapping exists

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

Definition at line 138 of file uid_mapping.cpp.

                                                                       {
    std::shared_lock lock(mutex_);
    return original_to_anon_.contains(original_uid);
}

◆ merge()

auto kcenon::pacs::security::uid_mapping::merge ( const uid_mapping & other ) -> std::size_t

Merge mappings from another uid_mapping.

Adds all mappings from 'other' that don't conflict with existing mappings.

Parameters

other The uid_mapping to merge from

Returns: Number of mappings added

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

Definition at line 207 of file uid_mapping.cpp.

                                                             {
    std::shared_lock other_lock(other.mutex_);
    std::unique_lock this_lock(mutex_);
 
    std::size_t added = 0;
    for (const auto& [original, anon] : other.original_to_anon_) {
        if (!original_to_anon_.contains(original)) {
            original_to_anon_[original] = anon;
            anon_to_original_[anon] = original;
            ++added;
        }
    }
 
    return added;
}

References kcenon::pacs::security::other.

◆ operator=() [1/2]

auto kcenon::pacs::security::uid_mapping::operator= ( const uid_mapping & other ) -> uid_mapping&

Copy assignment.

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

Definition at line 39 of file uid_mapping.cpp.

                                                                    {
    if (this != &other) {
        std::scoped_lock lock(mutex_, other.mutex_);
        uid_root_ = other.uid_root_;
        original_to_anon_ = other.original_to_anon_;
        anon_to_original_ = other.anon_to_original_;
        uid_counter_.store(other.uid_counter_.load());
    }
    return *this;
}

References kcenon::pacs::security::other.

◆ operator=() [2/2]

auto kcenon::pacs::security::uid_mapping::operator= ( uid_mapping && other ) -> uid_mapping&

noexcept

Move assignment.

Definition at line 50 of file uid_mapping.cpp.

                                                                        {
    if (this != &other) {
        std::scoped_lock lock(mutex_, other.mutex_);
        uid_root_ = std::move(other.uid_root_);
        original_to_anon_ = std::move(other.original_to_anon_);
        anon_to_original_ = std::move(other.anon_to_original_);
        uid_counter_.store(other.uid_counter_.load());
    }
    return *this;
}

References kcenon::pacs::security::other.

◆ remove()

auto kcenon::pacs::security::uid_mapping::remove ( std::string_view original_uid ) -> bool

Remove a specific mapping.

Parameters

original_uid The original UID to remove

Returns: true if a mapping was removed

Definition at line 159 of file uid_mapping.cpp.

                                                            {
    std::unique_lock lock(mutex_);
 
    auto it = original_to_anon_.find(original_uid);
    if (it == original_to_anon_.end()) {
        return false;
    }
 
    auto anon_uid = it->second;
    original_to_anon_.erase(it);
    anon_to_original_.erase(anon_uid);
 
    return true;
}

◆ set_uid_root()

void kcenon::pacs::security::uid_mapping::set_uid_root ( std::string root )

Set the UID root for generated UIDs.

Parameters

root	The UID root (e.g., "1.2.3.4")

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

Definition at line 223 of file uid_mapping.cpp.

                                             {
    std::unique_lock lock(mutex_);
    uid_root_ = std::move(root);
}

References mutex_, and uid_root_.

◆ size()

auto kcenon::pacs::security::uid_mapping::size ( ) const -> std::size_t

nodiscard

Get the number of mappings.

Returns: The count of UID mappings

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h, and dcm_anonymize/main.cpp.

Definition at line 143 of file uid_mapping.cpp.

                                          {
    std::shared_lock lock(mutex_);
    return original_to_anon_.size();
}

References mutex_, and original_to_anon_.

Referenced by main().

Here is the caller graph for this function:

◆ to_json()

auto kcenon::pacs::security::uid_mapping::to_json ( ) const -> std::string

nodiscard

Export mappings to JSON format.

Returns: JSON string containing all mappings

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h, and dcm_anonymize/main.cpp.

Definition at line 174 of file uid_mapping.cpp.

                                             {
    std::shared_lock lock(mutex_);
 
    std::ostringstream oss;
    oss << "{\n";
    oss << "  \"uid_root\": \"" << uid_root_ << "\",\n";
    oss << "  \"mappings\": [\n";
 
    bool first = true;
    for (const auto& [original, anon] : original_to_anon_) {
        if (!first) {
            oss << ",\n";
        }
        oss << "    {\"original\": \"" << original
            << "\", \"anonymized\": \"" << anon << "\"}";
        first = false;
    }
 
    oss << "\n  ]\n";
    oss << "}";
 
    return oss.str();
}

References mutex_, original_to_anon_, and uid_root_.

Member Data Documentation

◆ anon_to_original_

std::map<std::string, std::string, std::less<> > kcenon::pacs::security::uid_mapping::anon_to_original_

private

Reverse mapping: anonymized -> original.

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

Definition at line 243 of file uid_mapping.h.

Referenced by clear(), and uid_mapping().

◆ mutex_

std::shared_mutex kcenon::pacs::security::uid_mapping::mutex_

mutableprivate

Mutex for thread-safe access.

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

Definition at line 249 of file uid_mapping.h.

Referenced by clear(), empty(), get_uid_root(), set_uid_root(), size(), and to_json().

◆ original_to_anon_

std::map<std::string, std::string, std::less<> > kcenon::pacs::security::uid_mapping::original_to_anon_

private

Forward mapping: original -> anonymized.

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

Definition at line 240 of file uid_mapping.h.

Referenced by clear(), empty(), size(), to_json(), and uid_mapping().

◆ uid_counter_

std::atomic<std::uint64_t> kcenon::pacs::security::uid_mapping::uid_counter_ {0}

mutableprivate

Counter for UID generation.

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

Definition at line 246 of file uid_mapping.h.

246{0};

Referenced by generate_uid(), and uid_mapping().

◆ uid_root_

std::string kcenon::pacs::security::uid_mapping::uid_root_ {"1.2.826.0.1.3680043.8.498.1"}

private

UID root for generated UIDs (default: pacs_system root)

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/security/uid_mapping.h.

Definition at line 237 of file uid_mapping.h.

237{"1.2.826.0.1.3680043.8.498.1"};

Referenced by generate_uid(), get_uid_root(), set_uid_root(), to_json(), and uid_mapping().

The documentation for this class was generated from the following files:

include/kcenon/pacs/security/uid_mapping.h
src/security/uid_mapping.cpp

Public Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ uid_mapping() [1/4]

◆ uid_mapping() [2/4]

◆ uid_mapping() [3/4]

◆ uid_mapping() [4/4]

◆ ~uid_mapping()

Member Function Documentation

◆ add_mapping()

◆ clear()

◆ empty()

◆ from_json()

◆ generate_uid()

◆ get_anonymized()

◆ get_or_create()

◆ get_original()

◆ get_uid_root()

◆ has_mapping()

◆ merge()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ remove()

◆ set_uid_root()

◆ size()

◆ to_json()

Member Data Documentation

◆ anon_to_original_

◆ mutex_

◆ original_to_anon_

◆ uid_counter_

◆ uid_root_