wado_uri_endpoints.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 <optional>
#include <string>
#include <string_view>
 
namespace kcenon::pacs::web {
 
struct rest_server_context;
 
namespace wado_uri {
 
struct wado_uri_request {
    std::string study_uid;
 
    std::string series_uid;
 
    std::string object_uid;
 
    std::string content_type{"application/dicom"};
 
    std::optional<std::string> transfer_syntax;
 
    bool anonymize{false};
 
    std::optional<uint16_t> rows;
 
    std::optional<uint16_t> columns;
 
    std::optional<double> window_center;
 
    std::optional<double> window_width;
 
    std::optional<uint32_t> frame_number;
};
 
struct validation_result {
    bool valid{true};
    int http_status{200};
    std::string error_code;
    std::string error_message;
 
    [[nodiscard]] static validation_result ok() { return {true, 200, "", ""}; }
    [[nodiscard]] static validation_result error(int status,
                                                  std::string code,
                                                  std::string message) {
        return {false, status, std::move(code), std::move(message)};
    }
};
 
[[nodiscard]] wado_uri_request parse_wado_uri_params(
    const char* study_uid,
    const char* series_uid,
    const char* object_uid,
    const char* content_type,
    const char* transfer_syntax,
    const char* anonymize,
    const char* rows,
    const char* columns,
    const char* window_center,
    const char* window_width,
    const char* frame_number);
 
[[nodiscard]] validation_result validate_wado_uri_request(
    const wado_uri_request& request);
 
[[nodiscard]] bool is_supported_content_type(std::string_view content_type);
 
}  // namespace wado_uri
 
namespace endpoints {
 
// Internal function - implementation in cpp file
// Registers WADO-URI endpoints with the Crow app
// Called from rest_server.cpp
 
}  // namespace endpoints
 
}  // namespace kcenon::pacs::web